2008-11-12 17:07:44 +00:00
|
|
|
/** Defines the collada loader class */
|
|
|
|
|
|
|
|
/*
|
2012-02-03 03:38:30 +00:00
|
|
|
Open Asset Import Library (assimp)
|
2008-11-12 17:07:44 +00:00
|
|
|
----------------------------------------------------------------------
|
|
|
|
|
2012-02-03 03:38:30 +00:00
|
|
|
Copyright (c) 2006-2012, assimp team
|
2008-11-12 17:07:44 +00:00
|
|
|
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.
|
|
|
|
|
2012-02-03 03:38:30 +00:00
|
|
|
* Neither the name of the assimp team, nor the names of its
|
2008-11-12 17:07:44 +00:00
|
|
|
contributors may be used to endorse or promote products
|
|
|
|
derived from this software without specific prior
|
2012-02-03 03:38:30 +00:00
|
|
|
written permission of the assimp team.
|
2008-11-12 17:07:44 +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
|
|
|
|
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.
|
|
|
|
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef AI_COLLADALOADER_H_INC
|
|
|
|
#define AI_COLLADALOADER_H_INC
|
|
|
|
|
|
|
|
#include "BaseImporter.h"
|
|
|
|
#include "ColladaParser.h"
|
|
|
|
|
|
|
|
namespace Assimp
|
|
|
|
{
|
|
|
|
|
2008-12-04 17:06:26 +00:00
|
|
|
struct ColladaMeshIndex
|
|
|
|
{
|
|
|
|
std::string mMeshID;
|
|
|
|
size_t mSubMesh;
|
|
|
|
std::string mMaterial;
|
|
|
|
ColladaMeshIndex( const std::string& pMeshID, size_t pSubMesh, const std::string& pMaterial)
|
|
|
|
: mMeshID( pMeshID), mSubMesh( pSubMesh), mMaterial( pMaterial)
|
|
|
|
{ }
|
|
|
|
|
|
|
|
bool operator < (const ColladaMeshIndex& p) const
|
|
|
|
{
|
|
|
|
if( mMeshID == p.mMeshID)
|
|
|
|
{
|
|
|
|
if( mSubMesh == p.mSubMesh)
|
|
|
|
return mMaterial < p.mMaterial;
|
|
|
|
else
|
|
|
|
return mSubMesh < p.mSubMesh;
|
|
|
|
} else
|
|
|
|
{
|
|
|
|
return mMeshID < p.mMeshID;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2008-11-12 17:07:44 +00:00
|
|
|
/** Loader class to read Collada scenes. Collada is over-engineered to death, with every new iteration bringing
|
|
|
|
* more useless stuff, so I limited the data to what I think is useful for games.
|
|
|
|
*/
|
|
|
|
class ColladaLoader : public BaseImporter
|
|
|
|
{
|
2011-08-01 20:58:31 +00:00
|
|
|
public:
|
2008-11-12 17:07:44 +00:00
|
|
|
ColladaLoader();
|
|
|
|
~ColladaLoader();
|
|
|
|
|
2011-08-01 20:58:31 +00:00
|
|
|
|
2008-11-12 17:07:44 +00:00
|
|
|
public:
|
|
|
|
/** Returns whether the class can handle the format of the given file.
|
|
|
|
* See BaseImporter::CanRead() for details. */
|
General
- Added format auto-detection to most loaders
- Simplified BaseImporter::CanRead() with some utility methods
- improved fast_atof -> no overruns anymore. Fuck you, irrlicht.
- added assimp_cmd tool to allow command line model processing. Mainly adebugging tool for internal purposes, but others might find it useful, too.
- vc8/vc9: revision number is now written to DLL version header
- mkutil: some batch scripts to simplify tagging & building of release versions
- some API cleanup
- fixing some doxygen markup (+now explicit use of @file <filename>)
- Icon for assimp_view and assimp_cmd
3DS
- Normal vectors are not anymore inverted in some cases
- Improved pivot handling
- Improved handling of x-flipped meshes
Collada
- fixed a minor bug (visual_scene element)
LWS
- WIP implementation. No animations yet, some bugs and crashes.
- Animation system remains disabled, WIP code
- many test files for LWS, but most of them test the anim support, which is, read above, currently disabled.
STL
- fixing a log warning which appears for every model
- added binary&ascii test spider, exported from truespace
MD3
- Cleaning up output tags for automatically joined player models.
IRR
- Fixing coordinate system issues.
- Instance handling improved.
- Some of the reported crashes not yet fixed.
PretransformVertices
- Numerous performance improvements.
- Added config option to preserve the hierarchy during the step.
RemoveRedundantMaterials
- Added config option to specify a list of materials which are kept in every case.
UNREAL
- Added support for the old unreal data format (*.a,*.d,*.uc)
- tested only with exports from Milkshape
- more Unreal stuff to come soon
git-svn-id: https://assimp.svn.sourceforge.net/svnroot/assimp/trunk@356 67173fc5-114c-0410-ac8e-9d2fd5bffc1f
2009-03-05 22:32:13 +00:00
|
|
|
bool CanRead( const std::string& pFile, IOSystem* pIOHandler, bool checkSig) const;
|
2008-11-12 17:07:44 +00:00
|
|
|
|
|
|
|
protected:
|
2012-04-22 22:26:26 +00:00
|
|
|
/** Return importer meta information.
|
|
|
|
* See #BaseImporter::GetInfo for the details
|
2008-11-12 17:07:44 +00:00
|
|
|
*/
|
2012-04-22 22:26:26 +00:00
|
|
|
const aiImporterDesc* GetInfo () const;
|
2008-11-12 17:07:44 +00:00
|
|
|
|
2012-06-21 15:24:50 +00:00
|
|
|
void SetupProperties(const Importer* pImp);
|
|
|
|
|
2008-11-12 17:07:44 +00:00
|
|
|
/** Imports the given file into the given scene structure.
|
|
|
|
* See BaseImporter::InternReadFile() for details
|
|
|
|
*/
|
|
|
|
void InternReadFile( const std::string& pFile, aiScene* pScene, IOSystem* pIOHandler);
|
|
|
|
|
|
|
|
/** Recursively constructs a scene node for the given parser node and returns it. */
|
2008-11-26 15:45:34 +00:00
|
|
|
aiNode* BuildHierarchy( const ColladaParser& pParser, const Collada::Node* pNode);
|
2008-11-12 17:07:44 +00:00
|
|
|
|
2009-02-08 22:55:51 +00:00
|
|
|
/** Resolve node instances */
|
|
|
|
void ResolveNodeInstances( const ColladaParser& pParser, const Collada::Node* pNode,
|
2010-09-13 14:40:25 +00:00
|
|
|
std::vector<const Collada::Node*>& resolved);
|
2009-02-08 22:55:51 +00:00
|
|
|
|
2008-11-25 17:58:11 +00:00
|
|
|
/** Builds meshes for the given node and references them */
|
2009-02-08 22:55:51 +00:00
|
|
|
void BuildMeshesForNode( const ColladaParser& pParser, const Collada::Node* pNode,
|
|
|
|
aiNode* pTarget);
|
|
|
|
|
2009-03-27 20:43:22 +00:00
|
|
|
/** Creates a mesh for the given ColladaMesh face subset and returns the newly created mesh */
|
|
|
|
aiMesh* CreateMesh( const ColladaParser& pParser, const Collada::Mesh* pSrcMesh, const Collada::SubMesh& pSubMesh,
|
|
|
|
const Collada::Controller* pSrcController, size_t pStartVertex, size_t pStartFace);
|
|
|
|
|
2009-02-08 22:55:51 +00:00
|
|
|
/** Builds cameras for the given node and references them */
|
|
|
|
void BuildCamerasForNode( const ColladaParser& pParser, const Collada::Node* pNode,
|
|
|
|
aiNode* pTarget);
|
|
|
|
|
|
|
|
/** Builds lights for the given node and references them */
|
|
|
|
void BuildLightsForNode( const ColladaParser& pParser, const Collada::Node* pNode,
|
|
|
|
aiNode* pTarget);
|
2008-11-25 17:58:11 +00:00
|
|
|
|
|
|
|
/** Stores all meshes in the given scene */
|
|
|
|
void StoreSceneMeshes( aiScene* pScene);
|
|
|
|
|
2009-02-08 22:55:51 +00:00
|
|
|
/** Stores all materials in the given scene */
|
|
|
|
void StoreSceneMaterials( aiScene* pScene);
|
|
|
|
|
|
|
|
/** Stores all lights in the given scene */
|
|
|
|
void StoreSceneLights( aiScene* pScene);
|
|
|
|
|
|
|
|
/** Stores all cameras in the given scene */
|
|
|
|
void StoreSceneCameras( aiScene* pScene);
|
|
|
|
|
2009-02-11 20:56:05 +00:00
|
|
|
/** Stores all textures in the given scene */
|
|
|
|
void StoreSceneTextures( aiScene* pScene);
|
|
|
|
|
2009-04-06 17:00:03 +00:00
|
|
|
/** Stores all animations
|
|
|
|
* @param pScene target scene to store the anims
|
|
|
|
*/
|
|
|
|
void StoreAnimations( aiScene* pScene, const ColladaParser& pParser);
|
|
|
|
|
|
|
|
/** Stores all animations for the given source anim and its nested child animations
|
|
|
|
* @param pScene target scene to store the anims
|
|
|
|
* @param pSrcAnim the source animation to process
|
|
|
|
* @param pPrefix Prefix to the name in case of nested animations
|
|
|
|
*/
|
|
|
|
void StoreAnimations( aiScene* pScene, const ColladaParser& pParser, const Collada::Animation* pSrcAnim, const std::string pPrefix);
|
|
|
|
|
|
|
|
/** Constructs the animation for the given source anim */
|
|
|
|
void CreateAnimation( aiScene* pScene, const ColladaParser& pParser, const Collada::Animation* pSrcAnim, const std::string& pName);
|
|
|
|
|
2008-12-04 17:06:26 +00:00
|
|
|
/** Constructs materials from the collada material definitions */
|
2012-03-21 22:17:42 +00:00
|
|
|
void BuildMaterials( ColladaParser& pParser, aiScene* pScene);
|
2008-12-04 17:06:26 +00:00
|
|
|
|
2009-02-08 22:55:51 +00:00
|
|
|
/** Fill materials from the collada material definitions */
|
|
|
|
void FillMaterials( const ColladaParser& pParser, aiScene* pScene);
|
|
|
|
|
|
|
|
/** Resolve UV channel mappings*/
|
|
|
|
void ApplyVertexToEffectSemanticMapping(Collada::Sampler& sampler,
|
|
|
|
const Collada::SemanticMappingTable& table);
|
|
|
|
|
|
|
|
/** Add a texture and all of its sampling properties to a material*/
|
2011-08-22 20:22:51 +00:00
|
|
|
void AddTexture ( aiMaterial& mat, const ColladaParser& pParser,
|
2009-02-08 22:55:51 +00:00
|
|
|
const Collada::Effect& effect,
|
|
|
|
const Collada::Sampler& sampler,
|
|
|
|
aiTextureType type, unsigned int idx = 0);
|
|
|
|
|
2008-12-04 17:06:26 +00:00
|
|
|
/** Resolves the texture name for the given effect texture entry */
|
2010-06-04 14:36:41 +00:00
|
|
|
aiString FindFilenameForEffectTexture( const ColladaParser& pParser,
|
2009-02-08 22:55:51 +00:00
|
|
|
const Collada::Effect& pEffect, const std::string& pName);
|
2008-12-04 17:06:26 +00:00
|
|
|
|
2009-01-12 00:00:13 +00:00
|
|
|
/** Converts a path read from a collada file to the usual representation */
|
2009-04-06 17:00:03 +00:00
|
|
|
void ConvertPath( aiString& ss);
|
|
|
|
|
|
|
|
/** Reads a float value from an accessor and its data array.
|
|
|
|
* @param pAccessor The accessor to use for reading
|
|
|
|
* @param pData The data array to read from
|
|
|
|
* @param pIndex The index of the element to retrieve
|
|
|
|
* @param pOffset Offset into the element, for multipart elements such as vectors or matrices
|
|
|
|
* @return the specified value
|
|
|
|
*/
|
|
|
|
float ReadFloat( const Collada::Accessor& pAccessor, const Collada::Data& pData, size_t pIndex, size_t pOffset) const;
|
|
|
|
|
|
|
|
/** Reads a string value from an accessor and its data array.
|
|
|
|
* @param pAccessor The accessor to use for reading
|
|
|
|
* @param pData The data array to read from
|
|
|
|
* @param pIndex The index of the element to retrieve
|
|
|
|
* @return the specified value
|
|
|
|
*/
|
|
|
|
const std::string& ReadString( const Collada::Accessor& pAccessor, const Collada::Data& pData, size_t pIndex) const;
|
|
|
|
|
|
|
|
/** Recursively collects all nodes into the given array */
|
|
|
|
void CollectNodes( const aiNode* pNode, std::vector<const aiNode*>& poNodes) const;
|
|
|
|
|
|
|
|
/** Finds a node in the collada scene by the given name */
|
2010-01-10 10:38:52 +00:00
|
|
|
const Collada::Node* FindNode( const Collada::Node* pNode, const std::string& pName) const;
|
2010-06-04 14:36:41 +00:00
|
|
|
/** Finds a node in the collada scene by the given SID */
|
|
|
|
const Collada::Node* FindNodeBySID( const Collada::Node* pNode, const std::string& pSID) const;
|
2010-01-10 10:38:52 +00:00
|
|
|
|
2010-06-04 14:36:41 +00:00
|
|
|
/** Finds a proper name for a node derived from the collada-node's properties */
|
2014-09-05 01:50:37 +00:00
|
|
|
std::string FindNameForNode( const Collada::Node* pNode);
|
2009-01-12 00:00:13 +00:00
|
|
|
|
2008-11-12 17:07:44 +00:00
|
|
|
protected:
|
|
|
|
/** Filename, for a verbose error message */
|
|
|
|
std::string mFileName;
|
2008-11-25 17:58:11 +00:00
|
|
|
|
|
|
|
/** Which mesh-material compound was stored under which mesh ID */
|
2008-12-04 17:06:26 +00:00
|
|
|
std::map<ColladaMeshIndex, size_t> mMeshIndexByID;
|
|
|
|
|
|
|
|
/** Which material was stored under which index in the scene */
|
|
|
|
std::map<std::string, size_t> mMaterialIndexByName;
|
2008-11-25 17:58:11 +00:00
|
|
|
|
|
|
|
/** Accumulated meshes for the target scene */
|
|
|
|
std::vector<aiMesh*> mMeshes;
|
2009-02-08 22:55:51 +00:00
|
|
|
|
|
|
|
/** Temporary material list */
|
|
|
|
std::vector<std::pair<Collada::Effect*, aiMaterial*> > newMats;
|
|
|
|
|
|
|
|
/** Temporary camera list */
|
|
|
|
std::vector<aiCamera*> mCameras;
|
|
|
|
|
|
|
|
/** Temporary light list */
|
|
|
|
std::vector<aiLight*> mLights;
|
2009-02-11 20:56:05 +00:00
|
|
|
|
|
|
|
/** Temporary texture list */
|
|
|
|
std::vector<aiTexture*> mTextures;
|
2009-04-06 17:00:03 +00:00
|
|
|
|
|
|
|
/** Accumulated animations for the target scene */
|
|
|
|
std::vector<aiAnimation*> mAnims;
|
2012-06-21 15:24:50 +00:00
|
|
|
|
|
|
|
bool noSkeletonMesh;
|
2013-07-27 01:34:48 +00:00
|
|
|
bool ignoreUpDirection;
|
2015-02-18 16:20:03 +00:00
|
|
|
bool invertTransparency;
|
2014-09-05 01:50:37 +00:00
|
|
|
|
|
|
|
/** Used by FindNameForNode() to generate unique node names */
|
|
|
|
unsigned int mNodeNameCounter;
|
2008-11-12 17:07:44 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
} // end of namespace Assimp
|
|
|
|
|
|
|
|
#endif // AI_COLLADALOADER_H_INC
|