2008-05-09 17:24:28 +00:00
|
|
|
/*
|
2008-05-22 10:20:31 +00:00
|
|
|
Open Asset Import Library (ASSIMP)
|
2008-05-09 17:24:28 +00:00
|
|
|
----------------------------------------------------------------------
|
|
|
|
|
|
|
|
Copyright (c) 2006-2008, ASSIMP Development Team
|
|
|
|
All rights reserved.
|
|
|
|
|
|
|
|
Redistribution and use of this software in source and binary forms,
|
|
|
|
with or without modification, are permitted provided that the
|
|
|
|
following conditions are met:
|
|
|
|
|
|
|
|
* Redistributions of source code must retain the above
|
|
|
|
copyright notice, this list of conditions and the
|
|
|
|
following disclaimer.
|
|
|
|
|
|
|
|
* Redistributions in binary form must reproduce the above
|
|
|
|
copyright notice, this list of conditions and the
|
|
|
|
following disclaimer in the documentation and/or other
|
|
|
|
materials provided with the distribution.
|
|
|
|
|
|
|
|
* Neither the name of the ASSIMP team, nor the names of its
|
|
|
|
contributors may be used to endorse or promote products
|
|
|
|
derived from this software without specific prior
|
|
|
|
written permission of the ASSIMP Development Team.
|
|
|
|
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
|
|
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
|
|
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
|
|
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
|
|
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
|
|
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
|
|
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
|
2008-08-08 15:18:28 +00:00
|
|
|
/** @file Defines the helper data structures for importing MD3 files.
|
|
|
|
http://linux.ucla.edu/~phaethon/q3/formats/md3format.html
|
|
|
|
*/
|
2008-05-05 12:36:31 +00:00
|
|
|
#ifndef AI_MD3FILEHELPER_H_INC
|
|
|
|
#define AI_MD3FILEHELPER_H_INC
|
|
|
|
|
|
|
|
#include <string>
|
|
|
|
#include <vector>
|
|
|
|
#include <sstream>
|
|
|
|
|
|
|
|
#include "../include/aiTypes.h"
|
|
|
|
#include "../include/aiMesh.h"
|
|
|
|
#include "../include/aiAnim.h"
|
|
|
|
|
2008-08-08 15:18:28 +00:00
|
|
|
#include "./Compiler/pushpack1.h"
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-08-08 15:18:28 +00:00
|
|
|
namespace Assimp {
|
|
|
|
namespace MD3 {
|
2008-05-05 12:36:31 +00:00
|
|
|
|
|
|
|
#define AI_MD3_MAGIC_NUMBER_BE 'IDP3'
|
|
|
|
#define AI_MD3_MAGIC_NUMBER_LE '3PDI'
|
|
|
|
|
|
|
|
// common limitations
|
|
|
|
#define AI_MD3_VERSION 15
|
|
|
|
#define AI_MD3_MAXQPATH 64
|
|
|
|
#define AI_MD3_MAX_FRAMES 1024
|
|
|
|
#define AI_MD3_MAX_TAGS 16
|
|
|
|
#define AI_MD3_MAX_SURFACES 32
|
|
|
|
#define AI_MD3_MAX_SHADERS 256
|
|
|
|
#define AI_MD3_MAX_VERTS 4096
|
|
|
|
#define AI_MD3_MAX_TRIANGLES 8192
|
|
|
|
|
|
|
|
// master scale factor for all vertices in a MD3 model
|
|
|
|
#define AI_MD3_XYZ_SCALE (1.0f/64.0f)
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
2008-05-09 17:24:28 +00:00
|
|
|
/** \brief Data structure for the MD3 main header
|
2008-05-05 12:36:31 +00:00
|
|
|
*/
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
struct Header
|
|
|
|
{
|
2008-05-09 17:24:28 +00:00
|
|
|
//! magic number
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t IDENT;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! file format version
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t VERSION;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! original name in .pak archive
|
2008-05-05 12:36:31 +00:00
|
|
|
unsigned char NAME[ AI_MD3_MAXQPATH ];
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! unknown
|
2008-05-05 12:36:31 +00:00
|
|
|
int32_t FLAGS;
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! number of frames in the file
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t NUM_FRAMES;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! number of tags in the file
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t NUM_TAGS;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! number of surfaces in the file
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t NUM_SURFACES;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! number of skins in the file
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t NUM_SKINS;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! offset of the first frame
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t OFS_FRAMES;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! offset of the first tag
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t OFS_TAGS;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! offset of the first surface
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t OFS_SURFACES;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! end of file
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t OFS_EOF;
|
2008-05-05 12:36:31 +00:00
|
|
|
} PACK_STRUCT;
|
|
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
2008-05-09 17:24:28 +00:00
|
|
|
/** \brief Data structure for the frame header
|
2008-05-05 12:36:31 +00:00
|
|
|
*/
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
struct Frame
|
|
|
|
{
|
|
|
|
// no need to define this, we won't need
|
|
|
|
} PACK_STRUCT;
|
|
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
2008-05-09 17:24:28 +00:00
|
|
|
/** \brief Data structure for the tag header
|
2008-05-05 12:36:31 +00:00
|
|
|
*/
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
struct Tag
|
|
|
|
{
|
|
|
|
// no need to define this, we won't need
|
|
|
|
} PACK_STRUCT;
|
|
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
2008-05-09 17:24:28 +00:00
|
|
|
/** \brief Data structure for the surface header
|
2008-05-05 12:36:31 +00:00
|
|
|
*/
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
struct Surface
|
|
|
|
{
|
2008-05-09 17:24:28 +00:00
|
|
|
//! magic number
|
2008-05-05 12:36:31 +00:00
|
|
|
int32_t IDENT;
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! original name of the surface
|
2008-05-05 12:36:31 +00:00
|
|
|
unsigned char NAME[ AI_MD3_MAXQPATH ];
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! unknown
|
2008-05-05 12:36:31 +00:00
|
|
|
int32_t FLAGS;
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! number of frames in the surface
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t NUM_FRAMES;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! number of shaders in the surface
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t NUM_SHADER;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! number of vertices in the surface
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t NUM_VERTICES;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! number of triangles in the surface
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t NUM_TRIANGLES;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! offset to the triangle data
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t OFS_TRIANGLES;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! offset to the shader data
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t OFS_SHADERS;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! offset to the texture coordinate data
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t OFS_ST;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! offset to the vertex/normal data
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t OFS_XYZNORMAL;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! offset to the end of the Surface object
|
2008-05-05 12:36:31 +00:00
|
|
|
int32_t OFS_END;
|
|
|
|
} PACK_STRUCT;
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
2008-05-09 17:24:28 +00:00
|
|
|
/** \brief Data structure for a shader
|
2008-05-05 12:36:31 +00:00
|
|
|
*/
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
struct Shader
|
|
|
|
{
|
2008-05-09 17:24:28 +00:00
|
|
|
//! filename of the shader
|
2008-05-05 12:36:31 +00:00
|
|
|
unsigned char NAME[ AI_MD3_MAXQPATH ];
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! index of the shader
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t SHADER_INDEX;
|
2008-05-05 12:36:31 +00:00
|
|
|
} PACK_STRUCT;
|
|
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
2008-05-09 17:24:28 +00:00
|
|
|
/** \brief Data structure for a triangle
|
2008-05-05 12:36:31 +00:00
|
|
|
*/
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
struct Triangle
|
|
|
|
{
|
2008-05-09 17:24:28 +00:00
|
|
|
//! triangle indices
|
2008-06-22 10:09:26 +00:00
|
|
|
uint32_t INDEXES[3];
|
2008-05-05 12:36:31 +00:00
|
|
|
} PACK_STRUCT;
|
|
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
2008-05-09 17:24:28 +00:00
|
|
|
/** \brief Data structure for an UV coord
|
2008-05-05 12:36:31 +00:00
|
|
|
*/
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
struct TexCoord
|
|
|
|
{
|
2008-05-09 17:24:28 +00:00
|
|
|
//! UV coordinates
|
2008-05-05 12:36:31 +00:00
|
|
|
float U,V;
|
|
|
|
} PACK_STRUCT;
|
|
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
2008-05-09 17:24:28 +00:00
|
|
|
/** \brief Data structure for a vertex
|
2008-05-05 12:36:31 +00:00
|
|
|
*/
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
struct Vertex
|
|
|
|
{
|
2008-05-09 17:24:28 +00:00
|
|
|
//! X/Y/Z coordinates
|
2008-05-05 12:36:31 +00:00
|
|
|
int16_t X,Y,Z;
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
//! encoded normal vector
|
2008-06-22 10:09:26 +00:00
|
|
|
uint16_t NORMAL;
|
2008-05-05 12:36:31 +00:00
|
|
|
} PACK_STRUCT;
|
|
|
|
|
2008-08-08 15:18:28 +00:00
|
|
|
#include "./Compiler/poppack1.h"
|
2008-05-05 12:36:31 +00:00
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
/** \brief Unpack a Q3 16 bit vector to its full float3 representation
|
|
|
|
*
|
|
|
|
* \param p_iNormal Input normal vector in latitude/longitude form
|
|
|
|
* \param p_afOut Pointer to an array of three floats to receive the result
|
|
|
|
*
|
|
|
|
* \note This has been taken from q3 source (misc_model.c)
|
|
|
|
*/
|
|
|
|
// ---------------------------------------------------------------------------
|
2008-06-22 10:09:26 +00:00
|
|
|
inline void LatLngNormalToVec3(uint16_t p_iNormal, float* p_afOut)
|
2008-05-05 12:36:31 +00:00
|
|
|
{
|
2008-06-22 10:09:26 +00:00
|
|
|
float lat = (float)(( p_iNormal >> 8u ) & 0xff);
|
2008-05-05 12:36:31 +00:00
|
|
|
float lng = (float)(( p_iNormal & 0xff ));
|
|
|
|
lat *= 3.141926f/128.0f;
|
|
|
|
lng *= 3.141926f/128.0f;
|
|
|
|
|
|
|
|
p_afOut[0] = cosf(lat) * sinf(lng);
|
|
|
|
p_afOut[1] = sinf(lat) * sinf(lng);
|
|
|
|
p_afOut[2] = cosf(lng);
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
/** \brief Pack a Q3 normal into 16bit latitute/longitude representation
|
|
|
|
* \param p_vIn Input vector
|
|
|
|
* \param p_iOut Output normal
|
|
|
|
*
|
|
|
|
* \note This has been taken from q3 source (mathlib.c)
|
|
|
|
*/
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
inline void Vec3NormalToLatLng( const aiVector3D& p_vIn, uint16_t& p_iOut )
|
|
|
|
{
|
|
|
|
// check for singularities
|
|
|
|
if ( 0.0f == p_vIn[0] && 0.0f == p_vIn[1] )
|
|
|
|
{
|
|
|
|
if ( p_vIn[2] > 0.0f )
|
|
|
|
{
|
|
|
|
((unsigned char*)&p_iOut)[0] = 0;
|
|
|
|
((unsigned char*)&p_iOut)[1] = 0; // lat = 0, long = 0
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
((unsigned char*)&p_iOut)[0] = 128;
|
|
|
|
((unsigned char*)&p_iOut)[1] = 0; // lat = 0, long = 128
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
int a, b;
|
|
|
|
|
|
|
|
a = int(57.2957795f * ( atan2f( p_vIn[1], p_vIn[0] ) ) * (255.0f / 360.0f ));
|
|
|
|
a &= 0xff;
|
|
|
|
|
|
|
|
b = int(57.2957795f * ( acosf( p_vIn[2] ) ) * ( 255.0f / 360.0f ));
|
|
|
|
b &= 0xff;
|
|
|
|
|
|
|
|
((unsigned char*)&p_iOut)[0] = b; // longitude
|
|
|
|
((unsigned char*)&p_iOut)[1] = a; // lattitude
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2008-08-17 15:04:10 +00:00
|
|
|
}
|
|
|
|
}
|
2008-05-05 12:36:31 +00:00
|
|
|
|
|
|
|
#endif // !! AI_MD3FILEHELPER_H_INC
|