diff options
Diffstat (limited to 'src/3rdparty/assimp/code/X3DImporter.hpp')
| -rw-r--r-- | src/3rdparty/assimp/code/X3DImporter.hpp | 833 |
1 files changed, 0 insertions, 833 deletions
diff --git a/src/3rdparty/assimp/code/X3DImporter.hpp b/src/3rdparty/assimp/code/X3DImporter.hpp deleted file mode 100644 index 468db5f3e..000000000 --- a/src/3rdparty/assimp/code/X3DImporter.hpp +++ /dev/null @@ -1,833 +0,0 @@ -/* -Open Asset Import Library (assimp) ----------------------------------------------------------------------- - -Copyright (c) 2006-2017, 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 X3DImporter.hpp -/// \brief X3D-format files importer for Assimp. -/// \date 2015-2016 -/// \author smal.root@gmail.com -// Thanks to acorn89 for support. - -#ifndef INCLUDED_AI_X3D_IMPORTER_H -#define INCLUDED_AI_X3D_IMPORTER_H - -#include "X3DImporter_Node.hpp" - -// Header files, Assimp. -#include <assimp/DefaultLogger.hpp> -#include <assimp/importerdesc.h> -#include <assimp/ProgressHandler.hpp> -#include <assimp/types.h> -#include "BaseImporter.h" -#include "irrXMLWrapper.h" -#include "FIReader.hpp" -//#include <regex> - -namespace Assimp { - -/// \class X3DImporter -/// Class that holding scene graph which include: groups, geometry, metadata etc. -/// -/// Limitations. -/// -/// Pay attention that X3D is format for interactive graphic and simulations for web browsers. -/// So not all features can be imported using Assimp. -/// -/// Unsupported nodes: -/// CAD geometry component: -/// "CADAssembly", "CADFace", "CADLayer", "CADPart", "IndexedQuadSet", "QuadSet" -/// Core component: -/// "ROUTE", "ExternProtoDeclare", "ProtoDeclare", "ProtoInstance", "ProtoInterface", "WorldInfo" -/// Distributed interactive simulation (DIS) component: -/// "DISEntityManager", "DISEntityTypeMapping", "EspduTransform", "ReceiverPdu", "SignalPdu", "TransmitterPdu" -/// Cube map environmental texturing component: -/// "ComposedCubeMapTexture", "GeneratedCubeMapTexture", "ImageCubeMapTexture" -/// Environmental effects component: -/// "Background", "Fog", "FogCoordinate", "LocalFog", "TextureBackground" -/// Environmental sensor component: -/// "ProximitySensor", "TransformSensor", "VisibilitySensor" -/// Followers component: -/// "ColorChaser", "ColorDamper", "CoordinateChaser", "CoordinateDamper", "OrientationChaser", "OrientationDamper", "PositionChaser", -/// "PositionChaser2D", "PositionDamper", "PositionDamper2D", "ScalarChaser", "ScalarDamper", "TexCoordChaser2D", "TexCoordDamper2D" -/// Geospatial component: -/// "GeoCoordinate", "GeoElevationGrid", "GeoLocation", "GeoLOD", "GeoMetadata", "GeoOrigin", "GeoPositionInterpolator", "GeoProximitySensor", -/// "GeoTouchSensor", "GeoTransform", "GeoViewpoint" -/// Humanoid Animation (H-Anim) component: -/// "HAnimDisplacer", "HAnimHumanoid", "HAnimJoint", "HAnimSegment", "HAnimSite" -/// Interpolation component: -/// "ColorInterpolator", "CoordinateInterpolator", "CoordinateInterpolator2D", "EaseInEaseOut", "NormalInterpolator", "OrientationInterpolator", -/// "PositionInterpolator", "PositionInterpolator2D", "ScalarInterpolator", "SplinePositionInterpolator", "SplinePositionInterpolator2D", -/// "SplineScalarInterpolator", "SquadOrientationInterpolator", -/// Key device sensor component: -/// "KeySensor", "StringSensor" -/// Layering component: -/// "Layer", "LayerSet", "Viewport" -/// Layout component: -/// "Layout", "LayoutGroup", "LayoutLayer", "ScreenFontStyle", "ScreenGroup" -/// Navigation component: -/// "Billboard", "Collision", "LOD", "NavigationInfo", "OrthoViewpoint", "Viewpoint", "ViewpointGroup" -/// Networking component: -/// "EXPORT", "IMPORT", "Anchor", "LoadSensor" -/// NURBS component: -/// "Contour2D", "ContourPolyline2D", "CoordinateDouble", "NurbsCurve", "NurbsCurve2D", "NurbsOrientationInterpolator", "NurbsPatchSurface", -/// "NurbsPositionInterpolator", "NurbsSet", "NurbsSurfaceInterpolator", "NurbsSweptSurface", "NurbsSwungSurface", "NurbsTextureCoordinate", -/// "NurbsTrimmedSurface" -/// Particle systems component: -/// "BoundedPhysicsModel", "ConeEmitter", "ExplosionEmitter", "ForcePhysicsModel", "ParticleSystem", "PointEmitter", "PolylineEmitter", -/// "SurfaceEmitter", "VolumeEmitter", "WindPhysicsModel" -/// Picking component: -/// "LinePickSensor", "PickableGroup", "PointPickSensor", "PrimitivePickSensor", "VolumePickSensor" -/// Pointing device sensor component: -/// "CylinderSensor", "PlaneSensor", "SphereSensor", "TouchSensor" -/// Rendering component: -/// "ClipPlane" -/// Rigid body physics: -/// "BallJoint", "CollidableOffset", "CollidableShape", "CollisionCollection", "CollisionSensor", "CollisionSpace", "Contact", "DoubleAxisHingeJoint", -/// "MotorJoint", "RigidBody", "RigidBodyCollection", "SingleAxisHingeJoint", "SliderJoint", "UniversalJoint" -/// Scripting component: -/// "Script" -/// Programmable shaders component: -/// "ComposedShader", "FloatVertexAttribute", "Matrix3VertexAttribute", "Matrix4VertexAttribute", "PackagedShader", "ProgramShader", "ShaderPart", -/// "ShaderProgram", -/// Shape component: -/// "FillProperties", "LineProperties", "TwoSidedMaterial" -/// Sound component: -/// "AudioClip", "Sound" -/// Text component: -/// "FontStyle", "Text" -/// Texturing3D Component: -/// "ComposedTexture3D", "ImageTexture3D", "PixelTexture3D", "TextureCoordinate3D", "TextureCoordinate4D", "TextureTransformMatrix3D", -/// "TextureTransform3D" -/// Texturing component: -/// "MovieTexture", "MultiTexture", "MultiTextureCoordinate", "MultiTextureTransform", "PixelTexture", "TextureCoordinateGenerator", -/// "TextureProperties", -/// Time component: -/// "TimeSensor" -/// Event Utilities component: -/// "BooleanFilter", "BooleanSequencer", "BooleanToggle", "BooleanTrigger", "IntegerSequencer", "IntegerTrigger", "TimeTrigger", -/// Volume rendering component: -/// "BlendedVolumeStyle", "BoundaryEnhancementVolumeStyle", "CartoonVolumeStyle", "ComposedVolumeStyle", "EdgeEnhancementVolumeStyle", -/// "IsoSurfaceVolumeData", "OpacityMapVolumeStyle", "ProjectionVolumeStyle", "SegmentedVolumeData", "ShadedVolumeStyle", -/// "SilhouetteEnhancementVolumeStyle", "ToneMappedVolumeStyle", "VolumeData" -/// -/// Supported nodes: -/// Core component: -/// "MetadataBoolean", "MetadataDouble", "MetadataFloat", "MetadataInteger", "MetadataSet", "MetadataString" -/// Geometry2D component: -/// "Arc2D", "ArcClose2D", "Circle2D", "Disk2D", "Polyline2D", "Polypoint2D", "Rectangle2D", "TriangleSet2D" -/// Geometry3D component: -/// "Box", "Cone", "Cylinder", "ElevationGrid", "Extrusion", "IndexedFaceSet", "Sphere" -/// Grouping component: -/// "Group", "StaticGroup", "Switch", "Transform" -/// Lighting component: -/// "DirectionalLight", "PointLight", "SpotLight" -/// Networking component: -/// "Inline" -/// Rendering component: -/// "Color", "ColorRGBA", "Coordinate", "IndexedLineSet", "IndexedTriangleFanSet", "IndexedTriangleSet", "IndexedTriangleStripSet", "LineSet", -/// "PointSet", "TriangleFanSet", "TriangleSet", "TriangleStripSet", "Normal" -/// Shape component: -/// "Shape", "Appearance", "Material" -/// Texturing component: -/// "ImageTexture", "TextureCoordinate", "TextureTransform" -/// -/// Limitations of attribute "USE". -/// If "USE" is set then node must be empty, like that: -/// <Node USE='name'/> -/// not the -/// <Node USE='name'><!-- something --> </Node> -/// -/// Ignored attributes: "creaseAngle", "convex", "solid". -/// -/// Texture coordinates generating: only for Sphere, Cone, Cylinder. In all other case used PLANE mapping. -/// It's better that Assimp main code has powerful texture coordinates generator. Then is not needed to -/// duplicate this code in every importer. -/// -/// Lighting limitations. -/// If light source placed in some group with "DEF" set. And after that some node is use it group with "USE" attribute then -/// you will get error about duplicate light sources. That's happening because Assimp require names for lights but do not like -/// duplicates of it )). -/// -/// Color for faces. -/// That's happening when attribute "colorPerVertex" is set to "false". But Assimp do not hold how many colors has mesh and require -/// equal length for mVertices and mColors. You will see the colors but vertices will use call which last used in "colorIdx". -/// -/// That's all for now. Enjoy -/// -class X3DImporter : public BaseImporter -{ -public: - std::list<CX3DImporter_NodeElement*> NodeElement_List;///< All elements of scene graph. - -public: - /***********************************************/ - /****************** Functions ******************/ - /***********************************************/ - - /// Default constructor. - X3DImporter(); - - /// Default destructor. - ~X3DImporter(); - - /***********************************************/ - /******** Functions: parse set, public *********/ - /***********************************************/ - - /// Parse X3D file and fill scene graph. The function has no return value. Result can be found by analyzing the generated graph. - /// Also exception can be thrown if trouble will found. - /// \param [in] pFile - name of file to be parsed. - /// \param [in] pIOHandler - pointer to IO helper object. - void ParseFile( const std::string& pFile, IOSystem* pIOHandler ); - - /***********************************************/ - /********* Functions: BaseImporter set *********/ - /***********************************************/ - - bool CanRead( const std::string& pFile, IOSystem* pIOHandler, bool pCheckSig ) const; - void GetExtensionList( std::set<std::string>& pExtensionList ); - void InternReadFile( const std::string& pFile, aiScene* pScene, IOSystem* pIOHandler ); - const aiImporterDesc* GetInfo()const; - - -private: - /// Disabled copy constructor. - X3DImporter(const X3DImporter& pScene); - - /// Disabled assign operator. - X3DImporter& operator=(const X3DImporter& pScene); - - /// Clear all temporary data. - void Clear(); - - /***********************************************/ - /************* Functions: find set *************/ - /***********************************************/ - - /// Find requested node element. Search will be made in all existing nodes. - /// \param [in] pID - ID of requested element. - /// \param [in] pType - type of requested element. - /// \param [out] pElement - pointer to pointer to item found. - /// \return true - if the element is found, else - false. - bool FindNodeElement_FromRoot(const std::string& pID, const CX3DImporter_NodeElement::EType pType, CX3DImporter_NodeElement** pElement); - - /// Find requested node element. Search will be made from pointed node down to childs. - /// \param [in] pStartNode - pointer to start node. - /// \param [in] pID - ID of requested element. - /// \param [in] pType - type of requested element. - /// \param [out] pElement - pointer to pointer to item found. - /// \return true - if the element is found, else - false. - bool FindNodeElement_FromNode(CX3DImporter_NodeElement* pStartNode, const std::string& pID, const CX3DImporter_NodeElement::EType pType, - CX3DImporter_NodeElement** pElement); - - /// Find requested node element. For "Node"'s accounting flag "Static". - /// \param [in] pName - name of requested element. - /// \param [in] pType - type of requested element. - /// \param [out] pElement - pointer to pointer to item found. - /// \return true - if the element is found, else - false. - bool FindNodeElement(const std::string& pName, const CX3DImporter_NodeElement::EType pType, CX3DImporter_NodeElement** pElement); - - /***********************************************/ - /********* Functions: postprocess set **********/ - /***********************************************/ - - /// \return transformation matrix from global coordinate system to local. - aiMatrix4x4 PostprocessHelper_Matrix_GlobalToCurrent() const; - - /// Check if child elements of node element is metadata and add it to temporary list. - /// \param [in] pNodeElement - node element where metadata is searching. - /// \param [out] pList - temporary list for collected metadata. - void PostprocessHelper_CollectMetadata(const CX3DImporter_NodeElement& pNodeElement, std::list<CX3DImporter_NodeElement*>& pList) const; - - /// Check if type of node element is metadata. E.g. <MetadataSet>, <MetadataString>. - /// \param [in] pType - checked type. - /// \return true - if the type corresponds to the metadata. - bool PostprocessHelper_ElementIsMetadata(const CX3DImporter_NodeElement::EType pType) const; - - /// Check if type of node element is geometry object and can be used to build mesh. E.g. <Box>, <Arc2D>. - /// \param [in] pType - checked type. - /// \return true - if the type corresponds to the mesh. - bool PostprocessHelper_ElementIsMesh(const CX3DImporter_NodeElement::EType pType) const; - - /// Read CX3DImporter_NodeElement_Light, create aiLight and add it to list of the lights. - /// \param [in] pNodeElement - reference to lisght element(<DirectionalLight>, <PointLight>, <SpotLight>). - /// \param [out] pSceneLightList - reference to list of the lights. - void Postprocess_BuildLight(const CX3DImporter_NodeElement& pNodeElement, std::list<aiLight*>& pSceneLightList) const; - - /// Create filled structure with type \ref aiMaterial from \ref CX3DImporter_NodeElement. This function itseld extract - /// all needed data from scene graph. - /// \param [in] pNodeElement - reference to material element(<Appearance>). - /// \param [out] pMaterial - pointer to pointer to created material. *pMaterial must be nullptr. - void Postprocess_BuildMaterial(const CX3DImporter_NodeElement& pNodeElement, aiMaterial** pMaterial) const; - - /// Create filled structure with type \ref aiMaterial from \ref CX3DImporter_NodeElement. This function itseld extract - /// all needed data from scene graph. - /// \param [in] pNodeElement - reference to geometry object. - /// \param [out] pMesh - pointer to pointer to created mesh. *pMesh must be nullptr. - void Postprocess_BuildMesh(const CX3DImporter_NodeElement& pNodeElement, aiMesh** pMesh) const; - - /// Create aiNode from CX3DImporter_NodeElement. Also function check children and make recursive call. - /// \param [out] pNode - pointer to pointer to created node. *pNode must be nullptr. - /// \param [in] pNodeElement - CX3DImporter_NodeElement which read. - /// \param [out] pSceneNode - aiNode for filling. - /// \param [out] pSceneMeshList - list with aiMesh which belong to scene. - /// \param [out] pSceneMaterialList - list with aiMaterial which belong to scene. - /// \param [out] pSceneLightList - list with aiLight which belong to scene. - void Postprocess_BuildNode(const CX3DImporter_NodeElement& pNodeElement, aiNode& pSceneNode, std::list<aiMesh*>& pSceneMeshList, - std::list<aiMaterial*>& pSceneMaterialList, std::list<aiLight*>& pSceneLightList) const; - - /// To create mesh and material kept in <Schape>. - /// \param pShapeNodeElement - reference to node element which kept <Shape> data. - /// \param pNodeMeshInd - reference to list with mesh indices. When pShapeNodeElement will read new mesh index will be added to this list. - /// \param pSceneMeshList - reference to list with meshes. When pShapeNodeElement will read new mesh will be added to this list. - /// \param pSceneMaterialList - reference to list with materials. When pShapeNodeElement will read new material will be added to this list. - void Postprocess_BuildShape(const CX3DImporter_NodeElement_Shape& pShapeNodeElement, std::list<unsigned int>& pNodeMeshInd, - std::list<aiMesh*>& pSceneMeshList, std::list<aiMaterial*>& pSceneMaterialList) const; - - /// Check if child elements of node element is metadata and add it to scene node. - /// \param [in] pNodeElement - node element where metadata is searching. - /// \param [out] pSceneNode - scene node in which metadata will be added. - void Postprocess_CollectMetadata(const CX3DImporter_NodeElement& pNodeElement, aiNode& pSceneNode) const; - - /***********************************************/ - /************* Functions: throw set ************/ - /***********************************************/ - - /// Call that function when argument is out of range and exception must be raised. - /// \throw DeadlyImportError. - /// \param [in] pArgument - argument name. - void Throw_ArgOutOfRange(const std::string& pArgument); - - /// Call that function when close tag of node not found and exception must be raised. - /// E.g.: - /// <Scene> - /// <Shape> - /// </Scene> <!--- shape not closed ---> - /// \throw DeadlyImportError. - /// \param [in] pNode - node name in which exception happened. - void Throw_CloseNotFound(const std::string& pNode); - - /// Call that function when string value can not be converted to floating point value and exception must be raised. - /// \param [in] pAttrValue - attribute value. - /// \throw DeadlyImportError. - void Throw_ConvertFail_Str2ArrF(const std::string& pAttrValue); - - /// Call that function when in node defined attributes "DEF" and "USE" and exception must be raised. - /// E.g.: <Box DEF="BigBox" USE="MegaBox"> - /// \throw DeadlyImportError. - void Throw_DEF_And_USE(); - - /// Call that function when attribute name is incorrect and exception must be raised. - /// \param [in] pAttrName - attribute name. - /// \throw DeadlyImportError. - void Throw_IncorrectAttr(const std::string& pAttrName); - - /// Call that function when attribute value is incorrect and exception must be raised. - /// \param [in] pAttrName - attribute name. - /// \throw DeadlyImportError. - void Throw_IncorrectAttrValue(const std::string& pAttrName); - - /// Call that function when some type of nodes are defined twice or more when must be used only once and exception must be raised. - /// E.g.: - /// <Shape> - /// <Box/> <!--- first geometry node ---> - /// <Sphere/> <!--- second geometry node. raise exception ---> - /// </Shape> - /// \throw DeadlyImportError. - /// \param [in] pNodeType - type of node which defined one more time. - /// \param [in] pDescription - message about error. E.g. what the node defined while exception raised. - void Throw_MoreThanOnceDefined(const std::string& pNodeType, const std::string& pDescription); - - /// Call that function when count of opening and closing tags which create group(e.g. <Group>) are not equal and exception must be raised. - /// E.g.: - /// <Scene> - /// <Transform> <!--- first grouping node begin ---> - /// <Group> <!--- second grouping node begin ---> - /// </Transform> <!--- first grouping node end ---> - /// </Scene> <!--- one grouping node still not closed ---> - /// \throw DeadlyImportError. - /// \param [in] pNode - node name in which exception happened. - void Throw_TagCountIncorrect(const std::string& pNode); - - /// Call that function when defined in "USE" element are not found in graph and exception must be raised. - /// \param [in] pAttrValue - "USE" attribute value. - /// \throw DeadlyImportError. - void Throw_USE_NotFound(const std::string& pAttrValue); - - /***********************************************/ - /************** Functions: LOG set *************/ - /***********************************************/ - - /// Short variant for calling \ref DefaultLogger::get()->info() - void LogInfo(const std::string& pMessage) { DefaultLogger::get()->info(pMessage); } - - /***********************************************/ - /************** Functions: XML set *************/ - /***********************************************/ - - /// Check if current node is empty: <node />. If not then exception will throwed. - void XML_CheckNode_MustBeEmpty(); - - /// Check if current node name is equal to pNodeName. - /// \param [in] pNodeName - name for checking. - /// return true if current node name is equal to pNodeName, else - false. - bool XML_CheckNode_NameEqual(const std::string& pNodeName) { return mReader->getNodeName() == pNodeName; } - - /// Skip unsupported node and report about that. Depend on node name can be skipped begin tag of node all whole node. - /// \param [in] pParentNodeName - parent node name. Used for reporting. - void XML_CheckNode_SkipUnsupported(const std::string& pParentNodeName); - - /// Search for specified node in file. XML file read pointer(mReader) will point to found node or file end after search is end. - /// \param [in] pNodeName - requested node name. - /// return true - if node is found, else - false. - bool XML_SearchNode(const std::string& pNodeName); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \return read data. - bool XML_ReadNode_GetAttrVal_AsBool(const int pAttrIdx); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \return read data. - float XML_ReadNode_GetAttrVal_AsFloat(const int pAttrIdx); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \return read data. - int32_t XML_ReadNode_GetAttrVal_AsI32(const int pAttrIdx); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsCol3f(const int pAttrIdx, aiColor3D& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsVec2f(const int pAttrIdx, aiVector2D& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsVec3f(const int pAttrIdx, aiVector3D& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsArrB(const int pAttrIdx, std::vector<bool>& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsArrI32(const int pAttrIdx, std::vector<int32_t>& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsArrF(const int pAttrIdx, std::vector<float>& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsArrD(const int pAttrIdx, std::vector<double>& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsListCol3f(const int pAttrIdx, std::list<aiColor3D>& pValue); - - /// \overload void XML_ReadNode_GetAttrVal_AsListCol3f(const int pAttrIdx, std::vector<aiColor3D>& pValue) - void XML_ReadNode_GetAttrVal_AsArrCol3f(const int pAttrIdx, std::vector<aiColor3D>& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsListCol4f(const int pAttrIdx, std::list<aiColor4D>& pValue); - - /// \overload void XML_ReadNode_GetAttrVal_AsListCol4f(const int pAttrIdx, std::list<aiColor4D>& pValue) - void XML_ReadNode_GetAttrVal_AsArrCol4f(const int pAttrIdx, std::vector<aiColor4D>& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsListVec2f(const int pAttrIdx, std::list<aiVector2D>& pValue); - - /// \overload void XML_ReadNode_GetAttrVal_AsListVec2f(const int pAttrIdx, std::list<aiVector2D>& pValue) - void XML_ReadNode_GetAttrVal_AsArrVec2f(const int pAttrIdx, std::vector<aiVector2D>& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsListVec3f(const int pAttrIdx, std::list<aiVector3D>& pValue); - - /// \overload void XML_ReadNode_GetAttrVal_AsListVec3f(const int pAttrIdx, std::list<aiVector3D>& pValue) - void XML_ReadNode_GetAttrVal_AsArrVec3f(const int pAttrIdx, std::vector<aiVector3D>& pValue); - - /// Read attribute value. - /// \param [in] pAttrIdx - attribute index (\ref mReader->getAttribute* set). - /// \param [out] pValue - read data. - void XML_ReadNode_GetAttrVal_AsListS(const int pAttrIdx, std::list<std::string>& pValue); - - /***********************************************/ - /******* Functions: geometry helper set *******/ - /***********************************************/ - - /// Make point on surface oXY. - /// \param [in] pAngle - angle in radians between radius-vector of point and oX axis. Angle extends from the oX axis counterclockwise to the radius-vector. - /// \param [in] pRadius - length of radius-vector. - /// \return made point coordinates. - aiVector3D GeometryHelper_Make_Point2D(const float pAngle, const float pRadius); - - /// Make 2D figure - linear circular arc with center in (0, 0). The z-coordinate is 0. The arc extends from the pStartAngle counterclockwise - /// to the pEndAngle. If pStartAngle and pEndAngle have the same value, a circle is specified. If the absolute difference between pStartAngle - /// and pEndAngle is greater than or equal to 2pi, a circle is specified. - /// \param [in] pStartAngle - angle in radians of start of the arc. - /// \param [in] pEndAngle - angle in radians of end of the arc. - /// \param [in] pRadius - radius of the arc. - /// \param [out] pNumSegments - number of segments in arc. In other words - tesselation factor. - /// \param [out] pVertices - generated vertices. - void GeometryHelper_Make_Arc2D(const float pStartAngle, const float pEndAngle, const float pRadius, size_t pNumSegments, std::list<aiVector3D>& pVertices); - - /// Create line set from point set. - /// \param [in] pPoint - input points list. - /// \param [out] pLine - made lines list. - void GeometryHelper_Extend_PointToLine(const std::list<aiVector3D>& pPoint, std::list<aiVector3D>& pLine); - - /// Create CoordIdx of line set from CoordIdx of polyline set. - /// \param [in] pPolylineCoordIdx - vertices indices divided by delimiter "-1". Must contain faces with two or more indices. - /// \param [out] pLineCoordIdx - made CoordIdx of line set. - void GeometryHelper_Extend_PolylineIdxToLineIdx(const std::list<int32_t>& pPolylineCoordIdx, std::list<int32_t>& pLineCoordIdx); - - /// Make 3D body - rectangular parallelepiped with center in (0, 0). QL mean quadlist (\sa pVertices). - /// \param [in] pSize - scale factor for body for every axis. E.g. (1, 2, 1) mean: X-size and Z-size - 1, Y-size - 2. - /// \param [out] pVertices - generated vertices. The list of vertices is grouped in quads. - void GeometryHelper_MakeQL_RectParallelepiped(const aiVector3D& pSize, std::list<aiVector3D>& pVertices); - - /// Create faces array from vertices indices array. - /// \param [in] pCoordIdx - vertices indices divided by delimiter "-1". - /// \param [in] pFaces - created faces array. - /// \param [in] pPrimitiveTypes - type of primitives in faces. - void GeometryHelper_CoordIdxStr2FacesArr(const std::vector<int32_t>& pCoordIdx, std::vector<aiFace>& pFaces, unsigned int& pPrimitiveTypes) const; - - /// Add colors to mesh. - /// a. If colorPerVertex is FALSE, colours are applied to each face, as follows: - /// If the colorIndex field is not empty, one colour is used for each face of the mesh. There shall be at least as many indices in the - /// colorIndex field as there are faces in the mesh. The colorIndex field shall not contain any negative entries. - /// If the colorIndex field is empty, the colours in the X3DColorNode node are applied to each face of the mesh in order. - /// There shall be at least as many colours in the X3DColorNode node as there are faces. - /// b. If colorPerVertex is TRUE, colours are applied to each vertex, as follows: - /// If the colorIndex field is not empty, colours are applied to each vertex of the mesh in exactly the same manner that the coordIndex - /// field is used to choose coordinates for each vertex from the <Coordinate> node. The colorIndex field shall contain end-of-face markers (-1) - /// in exactly the same places as the coordIndex field. - /// If the colorIndex field is empty, the coordIndex field is used to choose colours from the X3DColorNode node. - /// \param [in] pMesh - mesh for adding data. - /// \param [in] pCoordIdx - vertices indices divided by delimiter "-1". - /// \param [in] pColorIdx - color indices for every vertex divided by delimiter "-1" if \ref pColorPerVertex is true. if \ref pColorPerVertex is false - /// then pColorIdx contain color indices for every faces and must not contain delimiter "-1". - /// \param [in] pColors - defined colors. - /// \param [in] pColorPerVertex - if \ref pColorPerVertex is true then color in \ref pColors defined for every vertex, if false - for every face. - void MeshGeometry_AddColor(aiMesh& pMesh, const std::vector<int32_t>& pCoordIdx, const std::vector<int32_t>& pColorIdx, - const std::list<aiColor4D>& pColors, const bool pColorPerVertex) const; - - /// \overload void MeshGeometry_AddColor(aiMesh& pMesh, const std::list<int32_t>& pCoordIdx, const std::list<int32_t>& pColorIdx, const std::list<aiColor4D>& pColors, const bool pColorPerVertex) const; - void MeshGeometry_AddColor(aiMesh& pMesh, const std::vector<int32_t>& pCoordIdx, const std::vector<int32_t>& pColorIdx, - const std::list<aiColor3D>& pColors, const bool pColorPerVertex) const; - - /// Add colors to mesh. - /// \param [in] pMesh - mesh for adding data. - /// \param [in] pColors - defined colors. - /// \param [in] pColorPerVertex - if \ref pColorPerVertex is true then color in \ref pColors defined for every vertex, if false - for every face. - void MeshGeometry_AddColor(aiMesh& pMesh, const std::list<aiColor4D>& pColors, const bool pColorPerVertex) const; - - /// \overload void MeshGeometry_AddColor(aiMesh& pMesh, const std::list<aiColor4D>& pColors, const bool pColorPerVertex) const - void MeshGeometry_AddColor(aiMesh& pMesh, const std::list<aiColor3D>& pColors, const bool pColorPerVertex) const; - - /// Add normals to mesh. Function work similar to \ref MeshGeometry_AddColor; - void MeshGeometry_AddNormal(aiMesh& pMesh, const std::vector<int32_t>& pCoordIdx, const std::vector<int32_t>& pNormalIdx, - const std::list<aiVector3D>& pNormals, const bool pNormalPerVertex) const; - - /// Add normals to mesh. Function work similar to \ref MeshGeometry_AddColor; - void MeshGeometry_AddNormal(aiMesh& pMesh, const std::list<aiVector3D>& pNormals, const bool pNormalPerVertex) const; - - /// Add texture coordinates to mesh. Function work similar to \ref MeshGeometry_AddColor; - void MeshGeometry_AddTexCoord(aiMesh& pMesh, const std::vector<int32_t>& pCoordIdx, const std::vector<int32_t>& pTexCoordIdx, - const std::list<aiVector2D>& pTexCoords) const; - - /// Add texture coordinates to mesh. Function work similar to \ref MeshGeometry_AddColor; - void MeshGeometry_AddTexCoord(aiMesh& pMesh, const std::list<aiVector2D>& pTexCoords) const; - - /// Create mesh. - /// \param [in] pCoordIdx - vertices indices divided by delimiter "-1". - /// \param [in] pVertices - vertices of mesh. - /// \return created mesh. - aiMesh* GeometryHelper_MakeMesh(const std::vector<int32_t>& pCoordIdx, const std::list<aiVector3D>& pVertices) const; - - /***********************************************/ - /******** Functions: parse set private *********/ - /***********************************************/ - - /// Create node element with type "Node" in scene graph. That operation is needed when you enter to X3D group node - /// like <Group>, <Transform> etc. When exiting from X3D group node(e.g. </Group>) \ref ParseHelper_Node_Exit must - /// be called. - /// \param [in] pStatic - flag: if true then static node is created(e.g. <StaticGroup>). - void ParseHelper_Group_Begin(const bool pStatic = false); - - /// Make pNode as current and enter deeper for parsing child nodes. At end \ref ParseHelper_Node_Exit must be called. - /// \param [in] pNode - new current node. - void ParseHelper_Node_Enter(CX3DImporter_NodeElement* pNode); - - /// This function must be called when exiting from X3D group node(e.g. </Group>). \ref ParseHelper_Group_Begin. - void ParseHelper_Node_Exit(); - - /// Attribute values of floating point types can take form ".x"(without leading zero). irrXMLReader can not read this form of values and it - /// must be converted to right form - "0.xxx". - /// \param [in] pInStr - pointer to input string which can contain incorrect form of values. - /// \param [out[ pOutString - output string with right form of values. - void ParseHelper_FixTruncatedFloatString(const char* pInStr, std::string& pOutString); - - /// Check if current node has nodes of type X3DMetadataObject. Why we must do it? Because X3DMetadataObject can be in any non-empty X3DNode. - /// Meaning that X3DMetadataObject can be in any non-empty node in <Scene>. - /// \return true - if metadata node are found and parsed, false - metadata not found. - bool ParseHelper_CheckRead_X3DMetadataObject(); - - /// Check if current node has nodes of type X3DGeometricPropertyNode. X3DGeometricPropertyNode - /// X3DGeometricPropertyNode inheritors: - /// <FogCoordinate>, <HAnimDisplacer>, <Color>, <ColorRGBA>, <Coordinate>, <CoordinateDouble>, <GeoCoordinate>, <Normal>, - /// <MultiTextureCoordinate>, <TextureCoordinate>, <TextureCoordinate3D>, <TextureCoordinate4D>, <TextureCoordinateGenerator>, - /// <FloatVertexAttribute>, <Matrix3VertexAttribute>, <Matrix4VertexAttribute>. - /// \return true - if nodes are found and parsed, false - nodes not found. - bool ParseHelper_CheckRead_X3DGeometricPropertyNode(); - - /// Parse <X3D> node of the file. - void ParseNode_Root(); - - /// Parse <head> node of the file. - void ParseNode_Head(); - - /// Parse <Scene> node of the file. - void ParseNode_Scene(); - - /// Parse child nodes of <Metadata*> node. - /// \param [in] pNodeName - parsed node name. Must be set because that function is general and name needed for checking the end - /// and error reporing. - /// \param [in] pParentElement - parent metadata element. - void ParseNode_Metadata(CX3DImporter_NodeElement* pParentElement, const std::string& pNodeName); - - /// Parse <MetadataBoolean> node of the file. - void ParseNode_MetadataBoolean(); - - /// Parse <MetadataDouble> node of the file. - void ParseNode_MetadataDouble(); - - /// Parse <MetadataFloat> node of the file. - void ParseNode_MetadataFloat(); - - /// Parse <MetadataInteger> node of the file. - void ParseNode_MetadataInteger(); - - /// Parse <MetadataSet> node of the file. - void ParseNode_MetadataSet(); - - /// \fn void ParseNode_MetadataString() - /// Parse <MetadataString> node of the file. - void ParseNode_MetadataString(); - - /// Parse <Arc2D> node of the file. - void ParseNode_Geometry2D_Arc2D(); - - /// Parse <ArcClose2D> node of the file. - void ParseNode_Geometry2D_ArcClose2D(); - - /// Parse <Circle2D> node of the file. - void ParseNode_Geometry2D_Circle2D(); - - /// Parse <Disk2D> node of the file. - void ParseNode_Geometry2D_Disk2D(); - - /// Parse <Polyline2D> node of the file. - void ParseNode_Geometry2D_Polyline2D(); - - /// Parse <Polypoint2D> node of the file. - void ParseNode_Geometry2D_Polypoint2D(); - - /// Parse <Rectangle2D> node of the file. - void ParseNode_Geometry2D_Rectangle2D(); - - /// Parse <TriangleSet2D> node of the file. - void ParseNode_Geometry2D_TriangleSet2D(); - - /// Parse <Box> node of the file. - void ParseNode_Geometry3D_Box(); - - /// Parse <Cone> node of the file. - void ParseNode_Geometry3D_Cone(); - - /// Parse <Cylinder> node of the file. - void ParseNode_Geometry3D_Cylinder(); - - /// Parse <ElevationGrid> node of the file. - void ParseNode_Geometry3D_ElevationGrid(); - - /// Parse <Extrusion> node of the file. - void ParseNode_Geometry3D_Extrusion(); - - /// Parse <IndexedFaceSet> node of the file. - void ParseNode_Geometry3D_IndexedFaceSet(); - - /// Parse <Sphere> node of the file. - void ParseNode_Geometry3D_Sphere(); - - /// Parse <Group> node of the file. And create new node in scene graph. - void ParseNode_Grouping_Group(); - - /// Doing actions at an exit from <Group>. Walk up in scene graph. - void ParseNode_Grouping_GroupEnd(); - - /// Parse <StaticGroup> node of the file. And create new node in scene graph. - void ParseNode_Grouping_StaticGroup(); - - /// Doing actions at an exit from <StaticGroup>. Walk up in scene graph. - void ParseNode_Grouping_StaticGroupEnd(); - - /// Parse <Switch> node of the file. And create new node in scene graph. - void ParseNode_Grouping_Switch(); - - /// Doing actions at an exit from <Switch>. Walk up in scene graph. - void ParseNode_Grouping_SwitchEnd(); - - /// Parse <Transform> node of the file. And create new node in scene graph. - void ParseNode_Grouping_Transform(); - - /// Doing actions at an exit from <Transform>. Walk up in scene graph. - void ParseNode_Grouping_TransformEnd(); - - /// Parse <Color> node of the file. - void ParseNode_Rendering_Color(); - - /// Parse <ColorRGBA> node of the file. - void ParseNode_Rendering_ColorRGBA(); - - /// Parse <Coordinate> node of the file. - void ParseNode_Rendering_Coordinate(); - - /// Parse <Normal> node of the file. - void ParseNode_Rendering_Normal(); - - /// Parse <IndexedLineSet> node of the file. - void ParseNode_Rendering_IndexedLineSet(); - - /// Parse <IndexedTriangleFanSet> node of the file. - void ParseNode_Rendering_IndexedTriangleFanSet(); - - /// Parse <IndexedTriangleSet> node of the file. - void ParseNode_Rendering_IndexedTriangleSet(); - - /// Parse <IndexedTriangleStripSet> node of the file. - void ParseNode_Rendering_IndexedTriangleStripSet(); - - /// Parse <LineSet> node of the file. - void ParseNode_Rendering_LineSet(); - - /// Parse <PointSet> node of the file. - void ParseNode_Rendering_PointSet(); - - /// Parse <TriangleFanSet> node of the file. - void ParseNode_Rendering_TriangleFanSet(); - - /// Parse <TriangleSet> node of the file. - void ParseNode_Rendering_TriangleSet(); - - /// Parse <TriangleStripSet> node of the file. - void ParseNode_Rendering_TriangleStripSet(); - - /// Parse <ImageTexture> node of the file. - void ParseNode_Texturing_ImageTexture(); - - /// Parse <TextureCoordinate> node of the file. - void ParseNode_Texturing_TextureCoordinate(); - - /// Parse <TextureTransform> node of the file. - void ParseNode_Texturing_TextureTransform(); - - /// Parse <Shape> node of the file. - void ParseNode_Shape_Shape(); - - /// Parse <Appearance> node of the file. - void ParseNode_Shape_Appearance(); - - /// Parse <Material> node of the file. - void ParseNode_Shape_Material(); - - /// Parse <Inline> node of the file. - void ParseNode_Networking_Inline(); - - /// Parse <DirectionalLight> node of the file. - void ParseNode_Lighting_DirectionalLight(); - - /// Parse <PointLight> node of the file. - void ParseNode_Lighting_PointLight(); - - /// Parse <SpotLight> node of the file. - void ParseNode_Lighting_SpotLight(); - -private: - /***********************************************/ - /******************** Types ********************/ - /***********************************************/ - - /***********************************************/ - /****************** Constants ******************/ - /***********************************************/ - static const aiImporterDesc Description; - //static const std::regex pattern_nws; - //static const std::regex pattern_true; - - - /***********************************************/ - /****************** Variables ******************/ - /***********************************************/ - CX3DImporter_NodeElement* NodeElement_Cur;///< Current element. - std::unique_ptr<FIReader> mReader;///< Pointer to XML-reader object - IOSystem *mpIOHandler; -};// class X3DImporter - -}// namespace Assimp - -#endif // INCLUDED_AI_X3D_IMPORTER_H |