2008-10-15 16:12:18 +00:00
|
|
|
/** Defines the BHV motion capturing loader class */
|
|
|
|
|
|
|
|
/*
|
2012-02-03 03:38:30 +00:00
|
|
|
Open Asset Import Library (assimp)
|
2008-10-15 16:12:18 +00:00
|
|
|
----------------------------------------------------------------------
|
|
|
|
|
2015-06-28 19:48:25 +00:00
|
|
|
Copyright (c) 2006-2015, assimp team
|
2008-10-15 16:12:18 +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-10-15 16:12:18 +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-10-15 16:12:18 +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.
|
|
|
|
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
|
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
|
|
|
/** @file BVHLoader.h
|
|
|
|
* @brief Biovision BVH import
|
|
|
|
*/
|
|
|
|
|
2008-10-15 16:12:18 +00:00
|
|
|
#ifndef AI_BVHLOADER_H_INC
|
|
|
|
#define AI_BVHLOADER_H_INC
|
|
|
|
|
|
|
|
#include "BaseImporter.h"
|
|
|
|
|
2015-04-15 19:22:26 +00:00
|
|
|
struct aiNode;
|
|
|
|
|
2008-10-15 16:12:18 +00:00
|
|
|
namespace Assimp
|
|
|
|
{
|
|
|
|
|
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
|
|
|
// --------------------------------------------------------------------------------
|
|
|
|
/** Loader class to read Motion Capturing data from a .bvh file.
|
|
|
|
*
|
|
|
|
* This format only contains a hierarchy of joints and a series of keyframes for
|
|
|
|
* the hierarchy. It contains no actual mesh data, but we generate a dummy mesh
|
|
|
|
* inside the loader just to be able to see something.
|
2008-10-15 16:12:18 +00:00
|
|
|
*/
|
|
|
|
class BVHLoader : public BaseImporter
|
|
|
|
{
|
|
|
|
|
2008-10-19 21:44:12 +00:00
|
|
|
/** Possible animation channels for which the motion data holds the values */
|
|
|
|
enum ChannelType
|
|
|
|
{
|
|
|
|
Channel_PositionX,
|
|
|
|
Channel_PositionY,
|
|
|
|
Channel_PositionZ,
|
|
|
|
Channel_RotationX,
|
|
|
|
Channel_RotationY,
|
|
|
|
Channel_RotationZ
|
|
|
|
};
|
|
|
|
|
|
|
|
/** Collected list of node. Will be bones of the dummy mesh some day, addressed by their array index */
|
|
|
|
struct Node
|
|
|
|
{
|
|
|
|
const aiNode* mNode;
|
|
|
|
std::vector<ChannelType> mChannels;
|
|
|
|
std::vector<float> mChannelValues; // motion data values for that node. Of size NumChannels * NumFrames
|
|
|
|
|
|
|
|
Node() { }
|
|
|
|
Node( const aiNode* pNode) : mNode( pNode) { }
|
|
|
|
};
|
|
|
|
|
2011-08-01 20:58:31 +00:00
|
|
|
public:
|
2008-10-15 16:12:18 +00:00
|
|
|
|
2011-08-01 20:58:31 +00:00
|
|
|
BVHLoader();
|
2008-10-15 16:12:18 +00:00
|
|
|
~BVHLoader();
|
|
|
|
|
|
|
|
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 cs) const;
|
2008-10-15 16:12:18 +00:00
|
|
|
|
2012-06-21 15:24:50 +00:00
|
|
|
void SetupProperties(const Importer* pImp);
|
2012-04-22 22:26:26 +00:00
|
|
|
const aiImporterDesc* GetInfo () const;
|
|
|
|
|
2008-10-15 16:12:18 +00:00
|
|
|
protected:
|
2012-04-22 22:26:26 +00:00
|
|
|
|
2008-10-15 16:12:18 +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);
|
|
|
|
|
|
|
|
protected:
|
|
|
|
/** Reads the file */
|
|
|
|
void ReadStructure( aiScene* pScene);
|
|
|
|
|
|
|
|
/** Reads the hierarchy */
|
|
|
|
void ReadHierarchy( aiScene* pScene);
|
|
|
|
|
|
|
|
/** Reads a node and recursively its childs and returns the created node. */
|
|
|
|
aiNode* ReadNode();
|
|
|
|
|
2008-10-19 21:44:12 +00:00
|
|
|
/** Reads an end node and returns the created node. */
|
|
|
|
aiNode* ReadEndSite( const std::string& pParentName);
|
|
|
|
|
2008-10-15 16:12:18 +00:00
|
|
|
/** Reads a node offset for the given node */
|
|
|
|
void ReadNodeOffset( aiNode* pNode);
|
|
|
|
|
2008-10-19 21:44:12 +00:00
|
|
|
/** Reads the animation channels into the given node */
|
|
|
|
void ReadNodeChannels( BVHLoader::Node& pNode);
|
2008-10-15 16:12:18 +00:00
|
|
|
|
|
|
|
/** Reads the motion data */
|
|
|
|
void ReadMotion( aiScene* pScene);
|
|
|
|
|
|
|
|
/** Retrieves the next token */
|
|
|
|
std::string GetNextToken();
|
|
|
|
|
|
|
|
/** Reads the next token as a float */
|
|
|
|
float GetNextTokenAsFloat();
|
|
|
|
|
|
|
|
/** Aborts the file reading with an exception */
|
2015-02-13 12:45:36 +00:00
|
|
|
AI_WONT_RETURN void ThrowException( const std::string& pError) AI_WONT_RETURN_SUFFIX;
|
2008-10-15 16:12:18 +00:00
|
|
|
|
2008-10-19 21:44:12 +00:00
|
|
|
/** Constructs an animation for the motion data and stores it in the given scene */
|
|
|
|
void CreateAnimation( aiScene* pScene);
|
|
|
|
|
2008-10-15 16:12:18 +00:00
|
|
|
protected:
|
|
|
|
/** Filename, for a verbose error message */
|
|
|
|
std::string mFileName;
|
|
|
|
|
|
|
|
/** Buffer to hold the loaded file */
|
|
|
|
std::vector<char> mBuffer;
|
|
|
|
|
|
|
|
/** Next char to read from the buffer */
|
|
|
|
std::vector<char>::const_iterator mReader;
|
|
|
|
|
|
|
|
/** Current line, for error messages */
|
|
|
|
unsigned int mLine;
|
|
|
|
|
2008-10-19 21:44:12 +00:00
|
|
|
/** Collected list of nodes. Will be bones of the dummy mesh some day, addressed by their array index.
|
|
|
|
* Also contain the motion data for the node's channels
|
|
|
|
*/
|
|
|
|
std::vector<Node> mNodes;
|
|
|
|
|
|
|
|
/** basic Animation parameters */
|
|
|
|
float mAnimTickDuration;
|
|
|
|
unsigned int mAnimNumFrames;
|
2012-06-21 15:24:50 +00:00
|
|
|
|
|
|
|
bool noSkeletonMesh;
|
2008-10-15 16:12:18 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
} // end of namespace Assimp
|
|
|
|
|
2008-11-09 15:57:03 +00:00
|
|
|
#endif // AI_BVHLOADER_H_INC
|