/* Free Asset Import Library (ASSIMP) ---------------------------------------------------------------------- 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. ---------------------------------------------------------------------- */ /** @file Defines the helper data structures for importing ASE files */ #ifndef AI_ASEFILEHELPER_H_INC #define AI_ASEFILEHELPER_H_INC #include #include #include #include #include "../include/aiTypes.h" #include "../include/aiMesh.h" #include "../include/aiAnim.h" // for some helper routines like IsSpace() #include "PlyParser.h" // ASE is quite similar to 3ds. We can reuse some structures #include "3DSLoader.h" namespace Assimp { // http://wiki.beyondunreal.com/Legacy:ASE_File_Format namespace ASE { using namespace Dot3DS; // --------------------------------------------------------------------------- /** Helper structure representing an ASE material */ struct Material : public Dot3DS::Material { //! Default constructor Material() : pcInstance(NULL), bNeed (false) {} //! Ambient texture channel Texture sTexAmbient; //! Contains all sub materials of this material std::vector avSubMaterials; //! MaterialHelper object MaterialHelper* pcInstance; //! Can we remove this material? bool bNeed; }; // --------------------------------------------------------------------------- /** Helper structure to represent an ASE file face */ struct Face : public Dot3DS::Face { //! Default constructor. Initializes everything with 0 Face() { mColorIndices[0] = mColorIndices[1] = mColorIndices[2] = 0; for (unsigned int i = 0; i < AI_MAX_NUMBER_OF_TEXTURECOORDS;++i) { amUVIndices[i][0] = amUVIndices[i][1] = amUVIndices[i][2] = 0; } iMaterial = DEFAULT_MATINDEX; iFace = 0; } //! special value to indicate that no material index has //! been assigned to a face. The default material index //! will replace this value later. static const unsigned int DEFAULT_MATINDEX = 0xFFFFFFFF; //! Indices into the list of vertices unsigned int mIndices[3]; //! Indices into each list of texture coordinates unsigned int amUVIndices[AI_MAX_NUMBER_OF_TEXTURECOORDS][3]; //! Index into the list of vertex colors unsigned int mColorIndices[3]; //! (Sub)Material index to be assigned to this face unsigned int iMaterial; //! Index of the face. It is not specified whether it is //! a requirement of the file format that all faces are //! written in sequential order, so we have to expect this case unsigned int iFace; }; // --------------------------------------------------------------------------- /** Helper structure to represent an ASE file mesh */ struct Mesh { //! Constructor. Creates a default name for the mesh Mesh() { static int iCnt = 0; std::stringstream ss(mName); ss << "%%_UNNAMED_" << iCnt++ << "_%%"; // use 2 texture vertex components by default for (unsigned int c = 0; c < AI_MAX_NUMBER_OF_TEXTURECOORDS;++c) this->mNumUVComponents[c] = 2; } std::string mName; //! vertex positions std::vector mPositions; //! List of all faces loaded std::vector mFaces; //! List of all texture coordinate sets std::vector amTexCoords[AI_MAX_NUMBER_OF_TEXTURECOORDS]; //! List of all vertex color sets. std::vector mVertexColors; //! List of normal vectors std::vector mNormals; //! Transformation matrix of the mesh aiMatrix4x4 mTransform; //! Material index of the mesh unsigned int iMaterialIndex; //! Number of vertex components for each UVW set unsigned int mNumUVComponents[AI_MAX_NUMBER_OF_TEXTURECOORDS]; }; // --------------------------------------------------------------------------------- /** \brief Class to parse ASE files */ class Parser { private: Parser() {} public: //! Construct a parser from a given input file which is //! guaranted to be terminated with zero. Parser (const char* szFile); // ------------------------------------------------------------------- //! Parses the file into the parsers internal representation void Parse(); private: // ------------------------------------------------------------------- //! Parse the *SCENE block in a file void ParseLV1SceneBlock(); // ------------------------------------------------------------------- //! Parse the *MATERIAL_LIST block in a file void ParseLV1MaterialListBlock(); // ------------------------------------------------------------------- //! Parse a *GEOMOBJECT block in a file //! \param mesh Mesh object to be filled void ParseLV1GeometryObjectBlock(Mesh& mesh); // ------------------------------------------------------------------- //! Parse a *MATERIAL blocks in a material list //! \param mat Material structure to be filled void ParseLV2MaterialBlock(Material& mat); // ------------------------------------------------------------------- //! Parse a *NODE_TM block in a file //! \param mesh Mesh object to be filled void ParseLV2NodeTransformBlock(Mesh& mesh); // ------------------------------------------------------------------- //! Parse a *MESH block in a file //! \param mesh Mesh object to be filled void ParseLV2MeshBlock(Mesh& mesh); // ------------------------------------------------------------------- //! Parse the *MAP_XXXXXX blocks in a material //! \param map Texture structure to be filled void ParseLV3MapBlock(Texture& map); // ------------------------------------------------------------------- //! Parse a *MESH_VERTEX_LIST block in a file //! \param iNumVertices Value of *MESH_NUMVERTEX, if present. //! Otherwise zero. This is used to check the consistency of the file. //! A warning is sent to the logger if the validations fails. //! \param mesh Mesh object to be filled void ParseLV3MeshVertexListBlock( unsigned int iNumVertices,Mesh& mesh); // ------------------------------------------------------------------- //! Parse a *MESH_FACE_LIST block in a file //! \param iNumFaces Value of *MESH_NUMFACES, if present. //! Otherwise zero. This is used to check the consistency of the file. //! A warning is sent to the logger if the validations fails. //! \param mesh Mesh object to be filled void ParseLV3MeshFaceListBlock( unsigned int iNumFaces,Mesh& mesh); // ------------------------------------------------------------------- //! Parse a *MESH_TVERT_LIST block in a file //! \param iNumVertices Value of *MESH_NUMTVERTEX, if present. //! Otherwise zero. This is used to check the consistency of the file. //! A warning is sent to the logger if the validations fails. //! \param mesh Mesh object to be filled //! \param iChannel Output UVW channel void ParseLV3MeshTListBlock( unsigned int iNumVertices,Mesh& mesh, unsigned int iChannel = 0); // ------------------------------------------------------------------- //! Parse a *MESH_TFACELIST block in a file //! \param iNumFaces Value of *MESH_NUMTVFACES, if present. //! Otherwise zero. This is used to check the consistency of the file. //! A warning is sent to the logger if the validations fails. //! \param mesh Mesh object to be filled //! \param iChannel Output UVW channel void ParseLV3MeshTFaceListBlock( unsigned int iNumFaces,Mesh& mesh, unsigned int iChannel = 0); // ------------------------------------------------------------------- //! Parse an additional mapping channel //! (specified via *MESH_MAPPINGCHANNEL) //! \param iChannel Channel index to be filled //! \param mesh Mesh object to be filled void ParseLV3MappingChannel( unsigned int iChannel, Mesh& mesh); // ------------------------------------------------------------------- //! Parse a *MESH_CVERTLIST block in a file //! \param iNumVertices Value of *MESH_NUMCVERTEX, if present. //! Otherwise zero. This is used to check the consistency of the file. //! A warning is sent to the logger if the validations fails. //! \param mesh Mesh object to be filled void ParseLV3MeshCListBlock( unsigned int iNumVertices, Mesh& mesh); // ------------------------------------------------------------------- //! Parse a *MESH_CFACELIST block in a file //! \param iNumFaces Value of *MESH_NUMCVFACES, if present. //! Otherwise zero. This is used to check the consistency of the file. //! A warning is sent to the logger if the validations fails. //! \param mesh Mesh object to be filled void ParseLV3MeshCFaceListBlock( unsigned int iNumFaces, Mesh& mesh); // ------------------------------------------------------------------- //! Parse a *MESH_NORMALS block in a file //! \param mesh Mesh object to be filled void ParseLV3MeshNormalListBlock(Mesh& mesh); // ------------------------------------------------------------------- //! Parse a *MESH_FACE block in a file //! \param out receive the face data void ParseLV4MeshFace(ASE::Face& out); // ------------------------------------------------------------------- //! Parse a *MESH_VERT block in a file //! (also works for MESH_TVERT, MESH_CFACE, MESH_VERTCOL ...) //! \param apOut Output buffer (3 floats) //! \param rIndexOut Output index void ParseLV4MeshFloatTriple(float* apOut, unsigned int& rIndexOut); // ------------------------------------------------------------------- //! Parse a *MESH_VERT block in a file //! (also works for MESH_TVERT, MESH_CFACE, MESH_VERTCOL ...) //! \param apOut Output buffer (3 floats) void ParseLV4MeshFloatTriple(float* apOut); // ------------------------------------------------------------------- //! Parse a *MESH_TFACE block in a file //! (also works for MESH_CFACE) //! \param apOut Output buffer (3 ints) //! \param rIndexOut Output index void ParseLV4MeshLongTriple(unsigned int* apOut, unsigned int& rIndexOut); // ------------------------------------------------------------------- //! Parse a *MESH_TFACE block in a file //! (also works for MESH_CFACE) //! \param apOut Output buffer (3 ints) void ParseLV4MeshLongTriple(unsigned int* apOut); // ------------------------------------------------------------------- //! Parse a single float element //! \param fOut Output float void ParseLV4MeshFloat(float& fOut); // ------------------------------------------------------------------- //! Parse a single int element //! \param iOut Output integer void ParseLV4MeshLong(unsigned int& iOut); // ------------------------------------------------------------------- //! Skip the opening bracket at the beginning of a complex statement bool SkipOpeningBracket(); // ------------------------------------------------------------------- //! Skip everything to the next: '*' or '\0' bool SkipToNextToken(); // ------------------------------------------------------------------- //! Skip the current section until the token after the closing }. //! This function handles embedded subsections correctly bool SkipSection(); // ------------------------------------------------------------------- //! Output a warning to the logger //! \param szWarn Warn message void LogWarning(const char* szWarn); // ------------------------------------------------------------------- //! Output an error to the logger //! \param szWarn Error message void LogError(const char* szWarn); public: //! Pointer to current data const char* m_szFile; //! background color to be passed to the viewer //! QNAN if none was found aiColor3D m_clrBackground; //! Base ambient color to be passed to all materials //! QNAN if none was found aiColor3D m_clrAmbient; //! List of all materials found in the file std::vector m_vMaterials; //! List of all meshes found in the file std::vector m_vMeshes; //! Current line in the file unsigned int iLineNumber; }; };}; #endif // !! include guard