1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/libs/assimp/LimitBoneWeightsProcess.h	Sat Feb 01 19:58:19 2014 +0200
     1.3 @@ -0,0 +1,141 @@
     1.4 +/*
     1.5 +Open Asset Import Library (assimp)
     1.6 +----------------------------------------------------------------------
     1.7 +
     1.8 +Copyright (c) 2006-2012, assimp team
     1.9 +All rights reserved.
    1.10 +
    1.11 +Redistribution and use of this software in source and binary forms, 
    1.12 +with or without modification, are permitted provided that the 
    1.13 +following conditions are met:
    1.14 +
    1.15 +* Redistributions of source code must retain the above
    1.16 +  copyright notice, this list of conditions and the
    1.17 +  following disclaimer.
    1.18 +
    1.19 +* Redistributions in binary form must reproduce the above
    1.20 +  copyright notice, this list of conditions and the
    1.21 +  following disclaimer in the documentation and/or other
    1.22 +  materials provided with the distribution.
    1.23 +
    1.24 +* Neither the name of the assimp team, nor the names of its
    1.25 +  contributors may be used to endorse or promote products
    1.26 +  derived from this software without specific prior
    1.27 +  written permission of the assimp team.
    1.28 +
    1.29 +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
    1.30 +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
    1.31 +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
    1.32 +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 
    1.33 +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    1.34 +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 
    1.35 +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    1.36 +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 
    1.37 +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
    1.38 +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
    1.39 +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    1.40 +
    1.41 +----------------------------------------------------------------------
    1.42 +*/
    1.43 +
    1.44 +/** Defines a post processing step to limit the number of bones affecting a single vertex. */
    1.45 +#ifndef AI_LIMITBONEWEIGHTSPROCESS_H_INC
    1.46 +#define AI_LIMITBONEWEIGHTSPROCESS_H_INC
    1.47 +
    1.48 +#include "BaseProcess.h"
    1.49 +
    1.50 +struct aiMesh;
    1.51 +class LimitBoneWeightsTest;
    1.52 +
    1.53 +namespace Assimp
    1.54 +{
    1.55 +
    1.56 +// NOTE: If you change these limits, don't forget to change the
    1.57 +// corresponding values in all Assimp ports
    1.58 +
    1.59 +// **********************************************************
    1.60 +// Java: ConfigProperty.java, 
    1.61 +//  ConfigProperty.DEFAULT_BONE_WEIGHT_LIMIT
    1.62 +// **********************************************************
    1.63 +
    1.64 +#if (!defined AI_LMW_MAX_WEIGHTS)
    1.65 +#	define AI_LMW_MAX_WEIGHTS	0x4
    1.66 +#endif // !! AI_LMW_MAX_WEIGHTS
    1.67 +
    1.68 +// ---------------------------------------------------------------------------
    1.69 +/** This post processing step limits the number of bones affecting a vertex
    1.70 +* to a certain maximum value. If a vertex is affected by more than that number
    1.71 +* of bones, the bone weight with the least influence on this vertex are removed.
    1.72 +* The other weights on this bone are then renormalized to assure the sum weight
    1.73 +* to be 1.
    1.74 +*/
    1.75 +class LimitBoneWeightsProcess : public BaseProcess
    1.76 +{
    1.77 +public:
    1.78 +
    1.79 +	LimitBoneWeightsProcess();
    1.80 +	~LimitBoneWeightsProcess();
    1.81 +
    1.82 +public:
    1.83 +	// -------------------------------------------------------------------
    1.84 +	/** Returns whether the processing step is present in the given flag.
    1.85 +	* @param pFlags The processing flags the importer was called with. 
    1.86 +	*   A bitwise combination of #aiPostProcessSteps.
    1.87 +	* @return true if the process is present in this flag fields, 
    1.88 +	*   false if not.
    1.89 +	*/
    1.90 +	bool IsActive( unsigned int pFlags) const;
    1.91 +
    1.92 +	// -------------------------------------------------------------------
    1.93 +	/** Called prior to ExecuteOnScene().
    1.94 +	* The function is a request to the process to update its configuration
    1.95 +	* basing on the Importer's configuration property list.
    1.96 +	*/
    1.97 +	void SetupProperties(const Importer* pImp);
    1.98 +
    1.99 +public:
   1.100 +
   1.101 +	// -------------------------------------------------------------------
   1.102 +	/** Limits the bone weight count for all vertices in the given mesh.
   1.103 +	* @param pMesh The mesh to process.
   1.104 +	*/
   1.105 +	void ProcessMesh( aiMesh* pMesh);
   1.106 +
   1.107 +	// -------------------------------------------------------------------
   1.108 +	/** Executes the post processing step on the given imported data.
   1.109 +	* At the moment a process is not supposed to fail.
   1.110 +	* @param pScene The imported data to work at.
   1.111 +	*/
   1.112 +	void Execute( aiScene* pScene);
   1.113 +
   1.114 +
   1.115 +public:
   1.116 +
   1.117 +	// -------------------------------------------------------------------
   1.118 +	/** Describes a bone weight on a vertex */
   1.119 +	struct Weight
   1.120 +	{
   1.121 +		unsigned int mBone; ///< Index of the bone
   1.122 +		float mWeight;      ///< Weight of that bone on this vertex
   1.123 +		Weight() { }
   1.124 +		Weight( unsigned int pBone, float pWeight) 
   1.125 +		{
   1.126 +			mBone = pBone; 
   1.127 +			mWeight = pWeight; 
   1.128 +		}
   1.129 +
   1.130 +		/** Comparision operator to sort bone weights by descending weight */
   1.131 +		bool operator < (const Weight& pWeight) const
   1.132 +		{ 
   1.133 +			return mWeight > pWeight.mWeight;
   1.134 +		}
   1.135 +	};
   1.136 +
   1.137 +public:
   1.138 +	/** Maximum number of bones influencing any single vertex. */
   1.139 +	unsigned int mMaxWeights;
   1.140 +};
   1.141 +
   1.142 +} // end of namespace Assimp
   1.143 +
   1.144 +#endif // AI_LIMITBONEWEIGHTSPROCESS_H_INC