vrshoot

annotate libs/assimp/SkeletonMeshBuilder.h @ 0:b2f14e535253

find changesets by author, revision, files, or words in the commit message
initial commit
author John Tsiombikas <nuclear@member.fsf.org>
date Sat, 01 Feb 2014 19:58:19 +0200
parents
children
rev   line source
nuclear@0 1 /** Helper class to construct a dummy mesh for file formats containing only motion data */
nuclear@0 2
nuclear@0 3 /*
nuclear@0 4 Open Asset Import Library (assimp)
nuclear@0 5 ----------------------------------------------------------------------
nuclear@0 6
nuclear@0 7 Copyright (c) 2006-2012, assimp team
nuclear@0 8 All rights reserved.
nuclear@0 9
nuclear@0 10 Redistribution and use of this software in source and binary forms,
nuclear@0 11 with or without modification, are permitted provided that the
nuclear@0 12 following conditions are met:
nuclear@0 13
nuclear@0 14 * Redistributions of source code must retain the above
nuclear@0 15 copyright notice, this list of conditions and the
nuclear@0 16 following disclaimer.
nuclear@0 17
nuclear@0 18 * Redistributions in binary form must reproduce the above
nuclear@0 19 copyright notice, this list of conditions and the
nuclear@0 20 following disclaimer in the documentation and/or other
nuclear@0 21 materials provided with the distribution.
nuclear@0 22
nuclear@0 23 * Neither the name of the assimp team, nor the names of its
nuclear@0 24 contributors may be used to endorse or promote products
nuclear@0 25 derived from this software without specific prior
nuclear@0 26 written permission of the assimp team.
nuclear@0 27
nuclear@0 28 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
nuclear@0 29 "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
nuclear@0 30 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
nuclear@0 31 A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
nuclear@0 32 OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
nuclear@0 33 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
nuclear@0 34 LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
nuclear@0 35 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
nuclear@0 36 THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
nuclear@0 37 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
nuclear@0 38 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
nuclear@0 39
nuclear@0 40 ----------------------------------------------------------------------
nuclear@0 41 */
nuclear@0 42
nuclear@0 43 /** @file SkeletonMeshBuilder.h
nuclear@0 44 * Declares SkeletonMeshBuilder, a tiny utility to build dummy meshes
nuclear@0 45 * for animation skeletons.
nuclear@0 46 */
nuclear@0 47
nuclear@0 48 #ifndef AI_SKELETONMESHBUILDER_H_INC
nuclear@0 49 #define AI_SKELETONMESHBUILDER_H_INC
nuclear@0 50
nuclear@0 51 #include <vector>
nuclear@0 52 #include "assimp/mesh.h"
nuclear@0 53
nuclear@0 54 struct aiScene;
nuclear@0 55 struct aiNode;
nuclear@0 56
nuclear@0 57 namespace Assimp {
nuclear@0 58
nuclear@0 59 // ---------------------------------------------------------------------------
nuclear@0 60 /**
nuclear@0 61 * This little helper class constructs a dummy mesh for a given scene
nuclear@0 62 * the resembles the node hierarchy. This is useful for file formats
nuclear@0 63 * that don't carry any mesh data but only animation data.
nuclear@0 64 */
nuclear@0 65 class SkeletonMeshBuilder
nuclear@0 66 {
nuclear@0 67 public:
nuclear@0 68
nuclear@0 69 // -------------------------------------------------------------------
nuclear@0 70 /** The constructor processes the given scene and adds a mesh there.
nuclear@0 71 *
nuclear@0 72 * Does nothing if the scene already has mesh data.
nuclear@0 73 * @param pScene The scene for which a skeleton mesh should be constructed.
nuclear@0 74 * @param root The node to start with. NULL is the scene root
nuclear@0 75 * @param bKnobsOnly Set this to true if you don't want the connectors
nuclear@0 76 * between the knobs representing the nodes.
nuclear@0 77 */
nuclear@0 78 SkeletonMeshBuilder( aiScene* pScene, aiNode* root = NULL,
nuclear@0 79 bool bKnobsOnly = false);
nuclear@0 80
nuclear@0 81 protected:
nuclear@0 82
nuclear@0 83 // -------------------------------------------------------------------
nuclear@0 84 /** Recursively builds a simple mesh representation for the given node
nuclear@0 85 * and also creates a joint for the node that affects this part of
nuclear@0 86 * the mesh.
nuclear@0 87 * @param pNode The node to build geometry for.
nuclear@0 88 */
nuclear@0 89 void CreateGeometry( const aiNode* pNode);
nuclear@0 90
nuclear@0 91 // -------------------------------------------------------------------
nuclear@0 92 /** Creates the mesh from the internally accumulated stuff and returns it.
nuclear@0 93 */
nuclear@0 94 aiMesh* CreateMesh();
nuclear@0 95
nuclear@0 96 // -------------------------------------------------------------------
nuclear@0 97 /** Creates a dummy material and returns it. */
nuclear@0 98 aiMaterial* CreateMaterial();
nuclear@0 99
nuclear@0 100 protected:
nuclear@0 101 /** space to assemble the mesh data: points */
nuclear@0 102 std::vector<aiVector3D> mVertices;
nuclear@0 103
nuclear@0 104 /** faces */
nuclear@0 105 struct Face
nuclear@0 106 {
nuclear@0 107 unsigned int mIndices[3];
nuclear@0 108 Face();
nuclear@0 109 Face( unsigned int p0, unsigned int p1, unsigned int p2)
nuclear@0 110 { mIndices[0] = p0; mIndices[1] = p1; mIndices[2] = p2; }
nuclear@0 111 };
nuclear@0 112 std::vector<Face> mFaces;
nuclear@0 113
nuclear@0 114 /** bones */
nuclear@0 115 std::vector<aiBone*> mBones;
nuclear@0 116
nuclear@0 117 bool mKnobsOnly;
nuclear@0 118 };
nuclear@0 119
nuclear@0 120 } // end of namespace Assimp
nuclear@0 121
nuclear@0 122 #endif // AI_SKELETONMESHBUILDER_H_INC