assimp/code/AssetLib/X/XFileParser.h

159 lines
5.7 KiB
C++

/*
Open Asset Import Library (assimp)
----------------------------------------------------------------------
Copyright (c) 2006-2020, assimp 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 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.
----------------------------------------------------------------------
*/
/** @file Helper class to parse a XFile into a temporary structure */
#ifndef AI_XFILEPARSER_H_INC
#define AI_XFILEPARSER_H_INC
#include <string>
#include <vector>
#include <assimp/types.h>
namespace Assimp {
namespace XFile {
struct Node;
struct Mesh;
struct Scene;
struct Material;
struct Animation;
struct AnimBone;
}
/**
* @brief The XFileParser reads a XFile either in text or binary form and builds a temporary
* data structure out of it.
*/
class XFileParser {
public:
/// Constructor. Creates a data structure out of the XFile given in the memory block.
/// @param pBuffer Null-terminated memory buffer containing the XFile
explicit XFileParser( const std::vector<char>& pBuffer);
/// Destructor. Destroys all imported data along with it
~XFileParser();
/// Returns the temporary representation of the imported data.
XFile::Scene* GetImportedData() const { return mScene; }
protected:
void ParseFile();
void ParseDataObjectTemplate();
void ParseDataObjectFrame( XFile::Node *pParent);
void ParseDataObjectTransformationMatrix( aiMatrix4x4& pMatrix);
void ParseDataObjectMesh( XFile::Mesh* pMesh);
void ParseDataObjectSkinWeights( XFile::Mesh* pMesh);
void ParseDataObjectSkinMeshHeader( XFile::Mesh* pMesh);
void ParseDataObjectMeshNormals( XFile::Mesh* pMesh);
void ParseDataObjectMeshTextureCoords( XFile::Mesh* pMesh);
void ParseDataObjectMeshVertexColors( XFile::Mesh* pMesh);
void ParseDataObjectMeshMaterialList( XFile::Mesh* pMesh);
void ParseDataObjectMaterial( XFile::Material* pMaterial);
void ParseDataObjectAnimTicksPerSecond();
void ParseDataObjectAnimationSet();
void ParseDataObjectAnimation( XFile::Animation* pAnim);
void ParseDataObjectAnimationKey( XFile::AnimBone *pAnimBone);
void ParseDataObjectTextureFilename( std::string& pName);
void ParseUnknownDataObject();
//! places pointer to next begin of a token, and ignores comments
void FindNextNoneWhiteSpace();
//! returns next valid token. Returns empty string if no token there
std::string GetNextToken();
//! reads header of data object including the opening brace.
//! returns false if error happened, and writes name of object
//! if there is one
void readHeadOfDataObject(std::string *poName = nullptr);
//! checks for closing curly brace, throws exception if not there
void CheckForClosingBrace();
//! checks for one following semicolon, throws exception if not there
void CheckForSemicolon();
//! checks for a separator char, either a ',' or a ';'
void CheckForSeparator();
/// tests and possibly consumes a separator char, but does nothing if there was no separator
void TestForSeparator();
//! reads a x file style string
void GetNextTokenAsString( std::string& poString);
void ReadUntilEndOfLine();
unsigned short ReadBinWord();
unsigned int ReadBinDWord();
unsigned int ReadInt();
ai_real ReadFloat();
aiVector2D ReadVector2();
aiVector3D ReadVector3();
aiColor3D ReadRGB();
aiColor4D ReadRGBA();
/** Throws an exception with a line number and the given text. */
template<typename... T>
AI_WONT_RETURN void ThrowException(T&&... args) AI_WONT_RETURN_SUFFIX;
/**
* @brief Filters the imported hierarchy for some degenerated cases that some exporters produce.
* @param pData The sub-hierarchy to filter
*/
void FilterHierarchy( XFile::Node* pNode);
protected:
unsigned int mMajorVersion, mMinorVersion; ///< version numbers
bool mIsBinaryFormat; ///< true if the file is in binary, false if it's in text form
unsigned int mBinaryFloatSize; ///< float size in bytes, either 4 or 8
unsigned int mBinaryNumCount; /// < counter for number arrays in binary format
const char* mP;
const char* mEnd;
unsigned int mLineNumber; ///< Line number when reading in text format
XFile::Scene* mScene; ///< Imported data
};
} //! ns Assimp
#endif // AI_XFILEPARSER_H_INC