nevrax.org : docs

00001 
00007 /* Copyright, 2000-2002 Nevrax Ltd.
00008  *
00009  * This file is part of NEVRAX NEL.
00010  * NEVRAX NEL is free software; you can redistribute it and/or modify
00011  * it under the terms of the GNU General Public License as published by
00012  * the Free Software Foundation; either version 2, or (at your option)
00013  * any later version.
00014 
00015  * NEVRAX NEL is distributed in the hope that it will be useful, but
00016  * WITHOUT ANY WARRANTY; without even the implied warranty of
00017  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
00018  * General Public License for more details.
00019 
00020  * You should have received a copy of the GNU General Public License
00021  * along with NEVRAX NEL; see the file COPYING. If not, write to the
00022  * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
00023  * MA 02111-1307, USA.
00024  */
00025 
00026 #ifndef NL_ANIMATION_OPTIMIZER_H
00027 #define NL_ANIMATION_OPTIMIZER_H
00028 
00029 #include "nel/misc/types_nl.h"
00030 #include "nel/misc/quat.h"
00031 #include "nel/misc/vectord.h"
00032 
00033 
00034 namespace NL3D 
00035 {
00036 
00037 using   NLMISC::CQuat;
00038 using   NLMISC::CQuatD;
00039 using   NLMISC::CVector;
00040 using   NLMISC::CVectorD;
00041 
00042 class   CAnimation;
00043 class   ITrack;
00044 
00045 // ***************************************************************************
00054 class CAnimationOptimizer
00055 {
00056 public:
00057 
00059         CAnimationOptimizer();
00060 
00070         void            setQuaternionThreshold(double lowPrecThre, double highPrecThre);
00071 
00079         void            setVectorThreshold(double lowPrecThre, double highPrecThre);
00080 
00086         void            addLowPrecisionTrack(const std::string &name);
00087 
00089         void            clearLowPrecisionTracks();
00090 
00094         void            setSampleFrameRate(float frameRate);
00095 
00096 
00101         void            optimize(const CAnimation &animIn, CAnimation &animOut);
00102 
00103 
00104 // ******************
00105 private:
00106         float           _SampleFrameRate;
00107         double          _QuaternionThresholdLowPrec;
00108         double          _QuaternionThresholdHighPrec;
00109         double          _QuaternionThreshold;
00110         double          _VectorThresholdLowPrec;
00111         double          _VectorThresholdHighPrec;
00112         double          _VectorThreshold;
00113 
00114 
00115         // see addLowPrecisionTrack
00116         std::vector<std::string>        _LowPrecTrackKeyName;
00117 
00118         // For Sampling of Quaternion Tracks.
00119         std::vector<uint16>             _TimeList;
00120         std::vector<CQuat>              _QuatKeyList;
00121 
00122         // For Sampling of Vector Tracks.
00123         std::vector<CVector>    _VectorKeyList;
00124 
00125 private:
00126 
00127         // Clone a ITrack (using a CMemStream)
00128         ITrack          *cloneTrack(const ITrack        *trackIn);
00129 
00130         // true if the track can be optimized.
00131         bool            isTrackOptimisable(const ITrack *trackIn);
00132 
00133         // return an optimized version of trackIn. Type returned should be different (eg: CTrackSampledQuat)
00134         ITrack          *optimizeTrack(const ITrack     *trackIn);
00135 
00136         // see addLowPrecisionTrack()
00137         bool            isLowPrecisionTrack(const std::string &trackName);
00138 
00139 
00141         // @{
00142 
00147         void            sampleQuatTrack(const ITrack *trackIn, float beginTime, float endTime, uint numSamples);
00148 
00152         bool            testConstantQuatTrack();
00153 
00156         void            optimizeQuatTrack();
00157 
00161         bool            nearlySameQuaternion(const CQuatD &quat0, const CQuatD &quat1);
00162 
00163         // @}
00164 
00165 
00167         // @{
00168 
00172         void            sampleVectorTrack(const ITrack *trackIn, float beginTime, float endTime, uint numSamples);
00173 
00176         bool            testConstantVectorTrack();
00177 
00180         void            optimizeVectorTrack();
00181 
00184         bool            nearlySameVector(const CVectorD &v0, const CVectorD &v1);
00185 
00186         // @}
00187 
00188 };
00189 
00190 
00191 } // NL3D
00192 
00193 
00194 #endif // NL_ANIMATION_OPTIMIZER_H
00195 
00196 /* End of animation_optimizer.h */