nuclear@0: /* nuclear@0: Open Asset Import Library (assimp) nuclear@0: ---------------------------------------------------------------------- nuclear@0: nuclear@0: Copyright (c) 2006-2012, assimp team nuclear@0: All rights reserved. nuclear@0: nuclear@0: Redistribution and use of this software in source and binary forms, nuclear@0: with or without modification, are permitted provided that the nuclear@0: following conditions are met: nuclear@0: nuclear@0: * Redistributions of source code must retain the above nuclear@0: copyright notice, this list of conditions and the nuclear@0: following disclaimer. nuclear@0: nuclear@0: * Redistributions in binary form must reproduce the above nuclear@0: copyright notice, this list of conditions and the nuclear@0: following disclaimer in the documentation and/or other nuclear@0: materials provided with the distribution. nuclear@0: nuclear@0: * Neither the name of the assimp team, nor the names of its nuclear@0: contributors may be used to endorse or promote products nuclear@0: derived from this software without specific prior nuclear@0: written permission of the assimp team. nuclear@0: nuclear@0: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS nuclear@0: "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT nuclear@0: LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR nuclear@0: A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT nuclear@0: OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, nuclear@0: SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT nuclear@0: LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, nuclear@0: DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY nuclear@0: THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT nuclear@0: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE nuclear@0: OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. nuclear@0: nuclear@0: ---------------------------------------------------------------------- nuclear@0: */ nuclear@0: nuclear@0: /** Defines a post processing step to limit the number of bones affecting a single vertex. */ nuclear@0: #ifndef AI_LIMITBONEWEIGHTSPROCESS_H_INC nuclear@0: #define AI_LIMITBONEWEIGHTSPROCESS_H_INC nuclear@0: nuclear@0: #include "BaseProcess.h" nuclear@0: nuclear@0: struct aiMesh; nuclear@0: class LimitBoneWeightsTest; nuclear@0: nuclear@0: namespace Assimp nuclear@0: { nuclear@0: nuclear@0: // NOTE: If you change these limits, don't forget to change the nuclear@0: // corresponding values in all Assimp ports nuclear@0: nuclear@0: // ********************************************************** nuclear@0: // Java: ConfigProperty.java, nuclear@0: // ConfigProperty.DEFAULT_BONE_WEIGHT_LIMIT nuclear@0: // ********************************************************** nuclear@0: nuclear@0: #if (!defined AI_LMW_MAX_WEIGHTS) nuclear@0: # define AI_LMW_MAX_WEIGHTS 0x4 nuclear@0: #endif // !! AI_LMW_MAX_WEIGHTS nuclear@0: nuclear@0: // --------------------------------------------------------------------------- nuclear@0: /** This post processing step limits the number of bones affecting a vertex nuclear@0: * to a certain maximum value. If a vertex is affected by more than that number nuclear@0: * of bones, the bone weight with the least influence on this vertex are removed. nuclear@0: * The other weights on this bone are then renormalized to assure the sum weight nuclear@0: * to be 1. nuclear@0: */ nuclear@0: class LimitBoneWeightsProcess : public BaseProcess nuclear@0: { nuclear@0: public: nuclear@0: nuclear@0: LimitBoneWeightsProcess(); nuclear@0: ~LimitBoneWeightsProcess(); nuclear@0: nuclear@0: public: nuclear@0: // ------------------------------------------------------------------- nuclear@0: /** Returns whether the processing step is present in the given flag. nuclear@0: * @param pFlags The processing flags the importer was called with. nuclear@0: * A bitwise combination of #aiPostProcessSteps. nuclear@0: * @return true if the process is present in this flag fields, nuclear@0: * false if not. nuclear@0: */ nuclear@0: bool IsActive( unsigned int pFlags) const; nuclear@0: nuclear@0: // ------------------------------------------------------------------- nuclear@0: /** Called prior to ExecuteOnScene(). nuclear@0: * The function is a request to the process to update its configuration nuclear@0: * basing on the Importer's configuration property list. nuclear@0: */ nuclear@0: void SetupProperties(const Importer* pImp); nuclear@0: nuclear@0: public: nuclear@0: nuclear@0: // ------------------------------------------------------------------- nuclear@0: /** Limits the bone weight count for all vertices in the given mesh. nuclear@0: * @param pMesh The mesh to process. nuclear@0: */ nuclear@0: void ProcessMesh( aiMesh* pMesh); nuclear@0: nuclear@0: // ------------------------------------------------------------------- nuclear@0: /** Executes the post processing step on the given imported data. nuclear@0: * At the moment a process is not supposed to fail. nuclear@0: * @param pScene The imported data to work at. nuclear@0: */ nuclear@0: void Execute( aiScene* pScene); nuclear@0: nuclear@0: nuclear@0: public: nuclear@0: nuclear@0: // ------------------------------------------------------------------- nuclear@0: /** Describes a bone weight on a vertex */ nuclear@0: struct Weight nuclear@0: { nuclear@0: unsigned int mBone; ///< Index of the bone nuclear@0: float mWeight; ///< Weight of that bone on this vertex nuclear@0: Weight() { } nuclear@0: Weight( unsigned int pBone, float pWeight) nuclear@0: { nuclear@0: mBone = pBone; nuclear@0: mWeight = pWeight; nuclear@0: } nuclear@0: nuclear@0: /** Comparision operator to sort bone weights by descending weight */ nuclear@0: bool operator < (const Weight& pWeight) const nuclear@0: { nuclear@0: return mWeight > pWeight.mWeight; nuclear@0: } nuclear@0: }; nuclear@0: nuclear@0: public: nuclear@0: /** Maximum number of bones influencing any single vertex. */ nuclear@0: unsigned int mMaxWeights; nuclear@0: }; nuclear@0: nuclear@0: } // end of namespace Assimp nuclear@0: nuclear@0: #endif // AI_LIMITBONEWEIGHTSPROCESS_H_INC