vrshoot

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

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 /*
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 Defines a post processing step to compute UV coordinates
nuclear@0 42 from abstract mappings, such as box or spherical*/
nuclear@0 43 #ifndef AI_COMPUTEUVMAPPING_H_INC
nuclear@0 44 #define AI_COMPUTEUVMAPPING_H_INC
nuclear@0 45
nuclear@0 46 #include "BaseProcess.h"
nuclear@0 47 #include "assimp/mesh.h"
nuclear@0 48
nuclear@0 49 class ComputeUVMappingTest;
nuclear@0 50 namespace Assimp
nuclear@0 51 {
nuclear@0 52
nuclear@0 53 // ---------------------------------------------------------------------------
nuclear@0 54 /** ComputeUVMappingProcess - converts special mappings, such as spherical,
nuclear@0 55 * cylindrical or boxed to proper UV coordinates for rendering.
nuclear@0 56 */
nuclear@0 57 class ComputeUVMappingProcess : public BaseProcess
nuclear@0 58 {
nuclear@0 59 public:
nuclear@0 60 ComputeUVMappingProcess();
nuclear@0 61 ~ComputeUVMappingProcess();
nuclear@0 62
nuclear@0 63 public:
nuclear@0 64
nuclear@0 65 // -------------------------------------------------------------------
nuclear@0 66 /** Returns whether the processing step is present in the given flag field.
nuclear@0 67 * @param pFlags The processing flags the importer was called with. A bitwise
nuclear@0 68 * combination of #aiPostProcessSteps.
nuclear@0 69 * @return true if the process is present in this flag fields, false if not.
nuclear@0 70 */
nuclear@0 71 bool IsActive( unsigned int pFlags) const;
nuclear@0 72
nuclear@0 73 // -------------------------------------------------------------------
nuclear@0 74 /** Executes the post processing step on the given imported data.
nuclear@0 75 * At the moment a process is not supposed to fail.
nuclear@0 76 * @param pScene The imported data to work at.
nuclear@0 77 */
nuclear@0 78 void Execute( aiScene* pScene);
nuclear@0 79
nuclear@0 80 protected:
nuclear@0 81
nuclear@0 82 // -------------------------------------------------------------------
nuclear@0 83 /** Computes spherical UV coordinates for a mesh
nuclear@0 84 *
nuclear@0 85 * @param mesh Mesh to be processed
nuclear@0 86 * @param axis Main axis
nuclear@0 87 * @param out Receives output UV coordinates
nuclear@0 88 */
nuclear@0 89 void ComputeSphereMapping(aiMesh* mesh,const aiVector3D& axis,
nuclear@0 90 aiVector3D* out);
nuclear@0 91
nuclear@0 92 // -------------------------------------------------------------------
nuclear@0 93 /** Computes cylindrical UV coordinates for a mesh
nuclear@0 94 *
nuclear@0 95 * @param mesh Mesh to be processed
nuclear@0 96 * @param axis Main axis
nuclear@0 97 * @param out Receives output UV coordinates
nuclear@0 98 */
nuclear@0 99 void ComputeCylinderMapping(aiMesh* mesh,const aiVector3D& axis,
nuclear@0 100 aiVector3D* out);
nuclear@0 101
nuclear@0 102 // -------------------------------------------------------------------
nuclear@0 103 /** Computes planar UV coordinates for a mesh
nuclear@0 104 *
nuclear@0 105 * @param mesh Mesh to be processed
nuclear@0 106 * @param axis Main axis
nuclear@0 107 * @param out Receives output UV coordinates
nuclear@0 108 */
nuclear@0 109 void ComputePlaneMapping(aiMesh* mesh,const aiVector3D& axis,
nuclear@0 110 aiVector3D* out);
nuclear@0 111
nuclear@0 112 // -------------------------------------------------------------------
nuclear@0 113 /** Computes cubic UV coordinates for a mesh
nuclear@0 114 *
nuclear@0 115 * @param mesh Mesh to be processed
nuclear@0 116 * @param out Receives output UV coordinates
nuclear@0 117 */
nuclear@0 118 void ComputeBoxMapping(aiMesh* mesh, aiVector3D* out);
nuclear@0 119
nuclear@0 120 private:
nuclear@0 121
nuclear@0 122 // temporary structure to describe a mapping
nuclear@0 123 struct MappingInfo
nuclear@0 124 {
nuclear@0 125 MappingInfo(aiTextureMapping _type)
nuclear@0 126 : type (_type)
nuclear@0 127 , axis (0.f,1.f,0.f)
nuclear@0 128 , uv (0u)
nuclear@0 129 {}
nuclear@0 130
nuclear@0 131 aiTextureMapping type;
nuclear@0 132 aiVector3D axis;
nuclear@0 133 unsigned int uv;
nuclear@0 134
nuclear@0 135 bool operator== (const MappingInfo& other)
nuclear@0 136 {
nuclear@0 137 return type == other.type && axis == other.axis;
nuclear@0 138 }
nuclear@0 139 };
nuclear@0 140 };
nuclear@0 141
nuclear@0 142 } // end of namespace Assimp
nuclear@0 143
nuclear@0 144 #endif // AI_COMPUTEUVMAPPING_H_INC