assimp/code/AssetLib/MD5/MD5Parser.h

460 lines
13 KiB
C
Raw Normal View History

/*
Open Asset Import Library (assimp)
----------------------------------------------------------------------
Copyright (c) 2006-2023, assimp team
2017-05-09 17:57:36 +00:00
All rights reserved.
2015-05-19 03:52:10 +00:00
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 team.
2015-05-19 03:52:10 +00:00
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
2015-05-19 03:52:10 +00:00
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
2015-05-19 03:52:10 +00:00
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
2015-05-19 03:52:10 +00:00
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.
----------------------------------------------------------------------
*/
2022-09-20 19:03:58 +00:00
#pragma once
/** @file MD5Parser.h
* @brief Definition of the .MD5 parser class.
* http://www.modwiki.net/wiki/MD5_(file_format)
*/
#ifndef AI_MD5PARSER_H_INCLUDED
#define AI_MD5PARSER_H_INCLUDED
2016-06-06 20:04:29 +00:00
#include <assimp/types.h>
#include <assimp/ParsingUtils.h>
#include <vector>
2022-09-20 19:03:58 +00:00
#include <cstdint>
struct aiFace;
2022-09-20 19:03:58 +00:00
namespace Assimp {
namespace MD5 {
// ---------------------------------------------------------------------------
/** Represents a single element in a MD5 file
2015-05-19 03:52:10 +00:00
*
* Elements are always contained in sections.
*/
2022-09-20 19:03:58 +00:00
struct Element {
2015-05-19 03:57:13 +00:00
//! Points to the starting point of the element
//! Whitespace at the beginning and at the end have been removed,
//! Elements are terminated with \0
char* szStart;
//! Original line number (can be used in error messages
//! if a parsing error occurs)
unsigned int iLineNumber;
};
2022-09-20 19:03:58 +00:00
using ElementList = std::vector<Element>;
// ---------------------------------------------------------------------------
/** Represents a section of a MD5 file (such as the mesh or the joints section)
2015-05-19 03:52:10 +00:00
*
* A section is always enclosed in { and } brackets.
*/
2022-09-20 19:03:58 +00:00
struct Section {
2015-05-19 03:57:13 +00:00
//! Original line number (can be used in error messages
//! if a parsing error occurs)
unsigned int iLineNumber;
2015-05-19 03:57:13 +00:00
//! List of all elements which have been parsed in this section.
ElementList mElements;
2015-05-19 03:57:13 +00:00
//! Name of the section
std::string mName;
2015-05-19 03:57:13 +00:00
//! For global elements: the value of the element as string
//! if !length() the section is not a global element
2015-05-19 03:57:13 +00:00
std::string mGlobalValue;
};
2022-09-20 19:03:58 +00:00
using SectionList = std::vector<Section>;
// ---------------------------------------------------------------------------
/** Basic information about a joint
*/
2022-09-20 19:03:58 +00:00
struct BaseJointDescription {
2015-05-19 03:57:13 +00:00
//! Name of the bone
aiString mName;
2015-05-19 03:57:13 +00:00
//! Parent index of the bone
int mParentIndex;
};
// ---------------------------------------------------------------------------
/** Represents a bone (joint) descriptor in a MD5Mesh file
*/
2022-09-20 19:03:58 +00:00
struct BoneDesc : BaseJointDescription {
2015-05-19 03:57:13 +00:00
//! Absolute position of the bone
aiVector3D mPositionXYZ;
2015-05-19 03:57:13 +00:00
//! Absolute rotation of the bone
aiVector3D mRotationQuat;
aiQuaternion mRotationQuatConverted;
2015-05-19 03:57:13 +00:00
//! Absolute transformation of the bone
//! (temporary)
aiMatrix4x4 mTransform;
2015-05-19 03:57:13 +00:00
//! Inverse transformation of the bone
//! (temporary)
aiMatrix4x4 mInvTransform;
2015-05-19 03:57:13 +00:00
//! Internal
unsigned int mMap;
};
2022-09-20 19:03:58 +00:00
using BoneList = std::vector<BoneDesc>;
// ---------------------------------------------------------------------------
/** Represents a bone (joint) descriptor in a MD5Anim file
*/
2022-09-20 19:03:58 +00:00
struct AnimBoneDesc : BaseJointDescription {
2015-05-19 03:57:13 +00:00
//! Flags (AI_MD5_ANIMATION_FLAG_xxx)
unsigned int iFlags;
2015-05-19 03:57:13 +00:00
//! Index of the first key that corresponds to this anim bone
unsigned int iFirstKeyIndex;
};
2022-09-20 19:03:58 +00:00
using AnimBoneList = std::vector< AnimBoneDesc >;
// ---------------------------------------------------------------------------
/** Represents a base frame descriptor in a MD5Anim file
*/
2022-09-20 19:03:58 +00:00
struct BaseFrameDesc {
2015-05-19 03:57:13 +00:00
aiVector3D vPositionXYZ;
aiVector3D vRotationQuat;
};
2022-09-20 19:03:58 +00:00
using BaseFrameList = std::vector<BaseFrameDesc>;
// ---------------------------------------------------------------------------
/** Represents a camera animation frame in a MDCamera file
*/
2022-09-20 19:03:58 +00:00
struct CameraAnimFrameDesc : BaseFrameDesc {
2015-05-19 03:57:13 +00:00
float fFOV;
};
2022-09-20 19:03:58 +00:00
using CameraFrameList = std::vector<CameraAnimFrameDesc>;
// ---------------------------------------------------------------------------
/** Represents a frame descriptor in a MD5Anim file
*/
2022-09-20 19:03:58 +00:00
struct FrameDesc {
2015-05-19 03:57:13 +00:00
//! Index of the frame
unsigned int iIndex;
2015-05-19 03:57:13 +00:00
//! Animation keyframes - a large blob of data at first
std::vector< float > mValues;
};
2022-09-20 19:03:58 +00:00
using FrameList = std::vector<FrameDesc>;
// ---------------------------------------------------------------------------
/** Represents a vertex descriptor in a MD5 file
*/
2018-09-21 14:07:09 +00:00
struct VertexDesc {
2018-09-21 14:25:27 +00:00
VertexDesc() AI_NO_EXCEPT
: mFirstWeight(0), mNumWeights(0) {
2018-09-21 14:07:09 +00:00
// empty
}
//! UV coordinate of the vertex
2015-05-19 03:57:13 +00:00
aiVector2D mUV;
2015-05-19 03:57:13 +00:00
//! Index of the first weight of the vertex in
//! the vertex weight list
unsigned int mFirstWeight;
2015-05-19 03:57:13 +00:00
//! Number of weights assigned to this vertex
unsigned int mNumWeights;
};
2022-09-20 19:03:58 +00:00
using VertexList = std::vector<VertexDesc>;
// ---------------------------------------------------------------------------
/** Represents a vertex weight descriptor in a MD5 file
*/
2022-09-20 19:03:58 +00:00
struct WeightDesc {
2015-05-19 03:57:13 +00:00
//! Index of the bone to which this weight refers
unsigned int mBone;
2015-05-19 03:57:13 +00:00
//! The weight value
float mWeight;
2015-05-19 03:57:13 +00:00
//! The offset position of this weight
// ! (in the coordinate system defined by the parent bone)
aiVector3D vOffsetPosition;
};
2022-09-20 19:03:58 +00:00
using WeightList = std::vector<WeightDesc>;
using FaceList = std::vector<aiFace>;
// ---------------------------------------------------------------------------
/** Represents a mesh in a MD5 file
*/
2022-09-20 19:03:58 +00:00
struct MeshDesc {
2015-05-19 03:57:13 +00:00
//! Weights of the mesh
WeightList mWeights;
2015-05-19 03:57:13 +00:00
//! Vertices of the mesh
VertexList mVertices;
2015-05-19 03:57:13 +00:00
//! Faces of the mesh
FaceList mFaces;
2015-05-19 03:57:13 +00:00
//! Name of the shader (=texture) to be assigned to the mesh
aiString mShader;
};
2022-09-20 19:03:58 +00:00
using MeshList = std::vector<MeshDesc>;
// ---------------------------------------------------------------------------
// Convert a quaternion to its usual representation
inline void ConvertQuaternion (const aiVector3D& in, aiQuaternion& out) {
2015-05-19 03:57:13 +00:00
out.x = in.x;
out.y = in.y;
out.z = in.z;
2015-05-19 03:57:13 +00:00
const float t = 1.0f - (in.x*in.x) - (in.y*in.y) - (in.z*in.z);
2022-09-20 19:03:58 +00:00
if (t < 0.0f) {
2015-05-19 03:57:13 +00:00
out.w = 0.0f;
2022-09-20 19:03:58 +00:00
} else {
out.w = std::sqrt (t);
}
// Assimp convention.
out.w *= -1.f;
}
// ---------------------------------------------------------------------------
/** Parses the data sections of a MD5 mesh file
*/
2022-09-20 19:03:58 +00:00
class MD5MeshParser {
public:
2015-05-19 03:57:13 +00:00
// -------------------------------------------------------------------
/** Constructs a new MD5MeshParser instance from an existing
* preparsed list of file sections.
*
* @param mSections List of file sections (output of MD5Parser)
*/
explicit MD5MeshParser(SectionList& mSections);
2015-05-19 03:57:13 +00:00
//! List of all meshes
MeshList mMeshes;
2015-05-19 03:57:13 +00:00
//! List of all joints
BoneList mJoints;
};
// remove this flag if you need to the bounding box data
#define AI_MD5_PARSE_NO_BOUNDS
// ---------------------------------------------------------------------------
/** Parses the data sections of a MD5 animation file
*/
2022-09-20 19:03:58 +00:00
class MD5AnimParser {
public:
2015-05-19 03:57:13 +00:00
// -------------------------------------------------------------------
/** Constructs a new MD5AnimParser instance from an existing
* preparsed list of file sections.
*
* @param mSections List of file sections (output of MD5Parser)
*/
explicit MD5AnimParser(SectionList& mSections);
2015-05-19 03:52:10 +00:00
2015-05-19 03:57:13 +00:00
//! Output frame rate
float fFrameRate;
2015-05-19 03:57:13 +00:00
//! List of animation bones
AnimBoneList mAnimatedBones;
2015-05-19 03:57:13 +00:00
//! List of base frames
BaseFrameList mBaseFrames;
2015-05-19 03:57:13 +00:00
//! List of animation frames
FrameList mFrames;
2015-05-19 03:57:13 +00:00
//! Number of animated components
unsigned int mNumAnimatedComponents;
};
// ---------------------------------------------------------------------------
/** Parses the data sections of a MD5 camera animation file
*/
2022-09-20 19:03:58 +00:00
class MD5CameraParser {
public:
2015-05-19 03:57:13 +00:00
// -------------------------------------------------------------------
/** Constructs a new MD5CameraParser instance from an existing
* preparsed list of file sections.
*
* @param mSections List of file sections (output of MD5Parser)
*/
explicit MD5CameraParser(SectionList& mSections);
2015-05-19 03:57:13 +00:00
//! Output frame rate
float fFrameRate;
2015-05-19 03:57:13 +00:00
//! List of cuts
std::vector<unsigned int> cuts;
2015-05-19 03:57:13 +00:00
//! Frames
CameraFrameList frames;
};
// ---------------------------------------------------------------------------
/** Parses the block structure of MD5MESH and MD5ANIM files (but does no
* further processing)
*/
2022-09-20 19:03:58 +00:00
class MD5Parser {
public:
2015-05-19 03:57:13 +00:00
// -------------------------------------------------------------------
/** Constructs a new MD5Parser instance from an existing buffer.
*
* @param buffer File buffer
* @param fileSize Length of the file in bytes (excluding a terminal 0)
*/
MD5Parser(char* buffer, unsigned int fileSize);
2015-05-19 03:57:13 +00:00
// -------------------------------------------------------------------
/** Report a specific error message and throw an exception
* @param error Error message to be reported
2016-04-03 00:38:00 +00:00
* @param line Index of the line where the error occurred
2015-05-19 03:57:13 +00:00
*/
AI_WONT_RETURN static void ReportError(const char* error, unsigned int line) AI_WONT_RETURN_SUFFIX;
2015-05-19 03:57:13 +00:00
// -------------------------------------------------------------------
/** Report a specific warning
* @param warn Warn message to be reported
2016-04-03 00:38:00 +00:00
* @param line Index of the line where the error occurred
2015-05-19 03:57:13 +00:00
*/
static void ReportWarning(const char* warn, unsigned int line);
// -------------------------------------------------------------------
/** Report a specific error
* @param error Error message to be reported
*/
AI_WONT_RETURN void ReportError (const char* error) AI_WONT_RETURN_SUFFIX;
// -------------------------------------------------------------------
/** Report a specific warning
* @param error Warn message to be reported
*/
void ReportWarning (const char* warn);
2015-05-19 03:57:13 +00:00
//! List of all sections which have been read
SectionList mSections;
private:
2015-05-19 03:57:13 +00:00
bool ParseSection(Section& out);
void ParseHeader();
2022-09-20 19:03:58 +00:00
bool SkipLine(const char* in, const char** out);
bool SkipLine( );
2023-01-16 08:12:35 +00:00
bool SkipSpacesAndLineEnd( const char* in, const char** out);
2022-09-20 19:03:58 +00:00
bool SkipSpacesAndLineEnd();
bool SkipSpaces();
2015-05-19 03:57:13 +00:00
private:
2015-05-19 03:57:13 +00:00
char* buffer;
2022-09-20 19:03:58 +00:00
char* bufferEnd;
2015-05-19 03:57:13 +00:00
unsigned int fileSize;
unsigned int lineNumber;
};
2022-09-20 19:03:58 +00:00
// -------------------------------------------------------------------
inline void MD5Parser::ReportWarning (const char* warn) {
return ReportWarning(warn, lineNumber);
}
// -------------------------------------------------------------------
inline void MD5Parser::ReportError(const char* error) {
ReportError(error, lineNumber);
}
2022-09-20 19:03:58 +00:00
// -------------------------------------------------------------------
inline bool MD5Parser::SkipLine(const char* in, const char** out) {
++lineNumber;
return Assimp::SkipLine(in ,out);
}
// -------------------------------------------------------------------
inline bool MD5Parser::SkipLine( ) {
return SkipLine(buffer,(const char**)&buffer);
}
// -------------------------------------------------------------------
inline bool MD5Parser::SkipSpacesAndLineEnd( const char* in, const char** out) {
if (in == bufferEnd) {
*out = in;
return false;
}
bool bHad = false, running = true;
2022-09-20 19:03:58 +00:00
while (running) {
if( *in == '\r' || *in == '\n') {
// we open files in binary mode, so there could be \r\n sequences ...
2022-09-20 19:03:58 +00:00
if (!bHad) {
bHad = true;
++lineNumber;
}
} else if (*in == '\t' || *in == ' ') {
bHad = false;
} else {
break;
2022-09-20 19:03:58 +00:00
}
++in;
if (in == bufferEnd) {
break;
}
}
*out = in;
return *in != '\0';
}
// -------------------------------------------------------------------
inline bool MD5Parser::SkipSpacesAndLineEnd() {
return SkipSpacesAndLineEnd(buffer,(const char**)&buffer);
}
// -------------------------------------------------------------------
inline bool MD5Parser::SkipSpaces() {
return Assimp::SkipSpaces((const char**)&buffer);
}
} // namespace Assimp
} // namespace MD5
#endif // AI_MD5PARSER_H_INCLUDED