assimp/code/AssetLib/X/XFileParser.h

/*
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