vrshoot

annotate libs/assimp/ConvertToLHProcess.h @ 1:e7ca128b8713

find changesets by author, revision, files, or words in the commit message
looks nice :)
author John Tsiombikas <nuclear@member.fsf.org>
date Sun, 02 Feb 2014 00:35:22 +0200
parents
children
rev   line source
nuclear@0 1 /*
nuclear@0 2 Open Asset Import Library (assimp)
nuclear@0 3 ----------------------------------------------------------------------
nuclear@0 4
nuclear@0 5 Copyright (c) 2006-2012, assimp team
nuclear@0 6 All rights reserved.
nuclear@0 7
nuclear@0 8 Redistribution and use of this software in source and binary forms,
nuclear@0 9 with or without modification, are permitted provided that the
nuclear@0 10 following conditions are met:
nuclear@0 11
nuclear@0 12 * Redistributions of source code must retain the above
nuclear@0 13 copyright notice, this list of conditions and the
nuclear@0 14 following disclaimer.
nuclear@0 15
nuclear@0 16 * Redistributions in binary form must reproduce the above
nuclear@0 17 copyright notice, this list of conditions and the
nuclear@0 18 following disclaimer in the documentation and/or other
nuclear@0 19 materials provided with the distribution.
nuclear@0 20
nuclear@0 21 * Neither the name of the assimp team, nor the names of its
nuclear@0 22 contributors may be used to endorse or promote products
nuclear@0 23 derived from this software without specific prior
nuclear@0 24 written permission of the assimp team.
nuclear@0 25
nuclear@0 26 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
nuclear@0 27 "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
nuclear@0 28 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
nuclear@0 29 A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
nuclear@0 30 OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
nuclear@0 31 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
nuclear@0 32 LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
nuclear@0 33 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
nuclear@0 34 THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
nuclear@0 35 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
nuclear@0 36 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
nuclear@0 37
nuclear@0 38 ----------------------------------------------------------------------
nuclear@0 39 */
nuclear@0 40
nuclear@0 41 /** @file MakeLeftHandedProcess.h
nuclear@0 42 * @brief Defines a bunch of post-processing steps to handle
nuclear@0 43 * coordinate system conversions.
nuclear@0 44 *
nuclear@0 45 * - LH to RH
nuclear@0 46 * - UV origin upper-left to lower-left
nuclear@0 47 * - face order cw to ccw
nuclear@0 48 */
nuclear@0 49 #ifndef AI_CONVERTTOLHPROCESS_H_INC
nuclear@0 50 #define AI_CONVERTTOLHPROCESS_H_INC
nuclear@0 51
nuclear@0 52 #include "assimp/types.h"
nuclear@0 53 #include "BaseProcess.h"
nuclear@0 54
nuclear@0 55 struct aiMesh;
nuclear@0 56 struct aiNodeAnim;
nuclear@0 57
nuclear@0 58 namespace Assimp {
nuclear@0 59
nuclear@0 60 // -----------------------------------------------------------------------------------
nuclear@0 61 /** @brief The MakeLeftHandedProcess converts all imported data to a left-handed
nuclear@0 62 * coordinate system.
nuclear@0 63 *
nuclear@0 64 * This implies a mirroring of the Z axis of the coordinate system. But to keep
nuclear@0 65 * transformation matrices free from reflections we shift the reflection to other
nuclear@0 66 * places. We mirror the meshes and adapt the rotations.
nuclear@0 67 *
nuclear@0 68 * @note RH-LH and LH-RH is the same, so this class can be used for both
nuclear@0 69 */
nuclear@0 70 class MakeLeftHandedProcess : public BaseProcess
nuclear@0 71 {
nuclear@0 72
nuclear@0 73
nuclear@0 74 public:
nuclear@0 75 MakeLeftHandedProcess();
nuclear@0 76 ~MakeLeftHandedProcess();
nuclear@0 77
nuclear@0 78 // -------------------------------------------------------------------
nuclear@0 79 bool IsActive( unsigned int pFlags) const;
nuclear@0 80
nuclear@0 81 // -------------------------------------------------------------------
nuclear@0 82 void Execute( aiScene* pScene);
nuclear@0 83
nuclear@0 84 protected:
nuclear@0 85
nuclear@0 86 // -------------------------------------------------------------------
nuclear@0 87 /** Recursively converts a node and all of its children
nuclear@0 88 */
nuclear@0 89 void ProcessNode( aiNode* pNode, const aiMatrix4x4& pParentGlobalRotation);
nuclear@0 90
nuclear@0 91 // -------------------------------------------------------------------
nuclear@0 92 /** Converts a single mesh to left handed coordinates.
nuclear@0 93 * This means that positions, normals and tangents are mirrored at
nuclear@0 94 * the local Z axis and the order of all faces are inverted.
nuclear@0 95 * @param pMesh The mesh to convert.
nuclear@0 96 */
nuclear@0 97 void ProcessMesh( aiMesh* pMesh);
nuclear@0 98
nuclear@0 99 // -------------------------------------------------------------------
nuclear@0 100 /** Converts a single material to left-handed coordinates
nuclear@0 101 * @param pMat Material to convert
nuclear@0 102 */
nuclear@0 103 void ProcessMaterial( aiMaterial* pMat);
nuclear@0 104
nuclear@0 105 // -------------------------------------------------------------------
nuclear@0 106 /** Converts the given animation to LH coordinates.
nuclear@0 107 * The rotation and translation keys are transformed, the scale keys
nuclear@0 108 * work in local space and can therefore be left untouched.
nuclear@0 109 * @param pAnim The bone animation to transform
nuclear@0 110 */
nuclear@0 111 void ProcessAnimation( aiNodeAnim* pAnim);
nuclear@0 112 };
nuclear@0 113
nuclear@0 114
nuclear@0 115 // ---------------------------------------------------------------------------
nuclear@0 116 /** Postprocessing step to flip the face order of the imported data
nuclear@0 117 */
nuclear@0 118 class FlipWindingOrderProcess : public BaseProcess
nuclear@0 119 {
nuclear@0 120 friend class Importer;
nuclear@0 121
nuclear@0 122 public:
nuclear@0 123 /** Constructor to be privately used by Importer */
nuclear@0 124 FlipWindingOrderProcess();
nuclear@0 125
nuclear@0 126 /** Destructor, private as well */
nuclear@0 127 ~FlipWindingOrderProcess();
nuclear@0 128
nuclear@0 129 // -------------------------------------------------------------------
nuclear@0 130 bool IsActive( unsigned int pFlags) const;
nuclear@0 131
nuclear@0 132 // -------------------------------------------------------------------
nuclear@0 133 void Execute( aiScene* pScene);
nuclear@0 134
nuclear@0 135 protected:
nuclear@0 136 void ProcessMesh( aiMesh* pMesh);
nuclear@0 137 };
nuclear@0 138
nuclear@0 139 // ---------------------------------------------------------------------------
nuclear@0 140 /** Postprocessing step to flip the UV coordinate system of the import data
nuclear@0 141 */
nuclear@0 142 class FlipUVsProcess : public BaseProcess
nuclear@0 143 {
nuclear@0 144 friend class Importer;
nuclear@0 145
nuclear@0 146 public:
nuclear@0 147 /** Constructor to be privately used by Importer */
nuclear@0 148 FlipUVsProcess();
nuclear@0 149
nuclear@0 150 /** Destructor, private as well */
nuclear@0 151 ~FlipUVsProcess();
nuclear@0 152
nuclear@0 153 // -------------------------------------------------------------------
nuclear@0 154 bool IsActive( unsigned int pFlags) const;
nuclear@0 155
nuclear@0 156 // -------------------------------------------------------------------
nuclear@0 157 void Execute( aiScene* pScene);
nuclear@0 158
nuclear@0 159 protected:
nuclear@0 160 void ProcessMesh( aiMesh* pMesh);
nuclear@0 161 void ProcessMaterial( aiMaterial* mat);
nuclear@0 162 };
nuclear@0 163
nuclear@0 164 } // end of namespace Assimp
nuclear@0 165
nuclear@0 166 #endif // AI_CONVERTTOLHPROCESS_H_INC