Home

nevrax.com

Nevrax.org News Mailing-list Documentation CVS Bugs License

Documentation                       Search   key.h Go to the documentation of this file. /* Copyright, 2001 Nevrax Ltd. * * This file is part of NEVRAX NEL. * NEVRAX NEL is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2, or (at your option) * any later version. * NEVRAX NEL is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * General Public License for more details. * You should have received a copy of the GNU General Public License * along with NEVRAX NEL; see the file COPYING. If not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, * MA 02111-1307, USA. */ #ifndef NL_KEY_H #define NL_KEY_H #include "nel/misc/types_nl.h" #include "nel/misc/vector.h" #include "nel/misc/quat.h" #include "nel/misc/stream.h" #include "nel/misc/rgba.h" // NOT TESTED, JUST COMPILED. FOR PURPOSE ONLY. namespace NL3D { // *************************************************************************** template<class T> class CKey { public: typedef T TValueType; public: void serial (NLMISC::IStream& f) throw (NLMISC::EStream) { // Version number (void)f.serialVersion (0); // Serial the value f.serial (Value); }; T Value; // ********************* public: // PRIVATE. used by ITrackKeyFramer, not serialised (compiled). // 1/(nextKeyTime-thisKeyTime). float OODeltaTime; }; // *************************************************************************** template<class T> class CKeyTCB : public CKey<T> { public: void serial (NLMISC::IStream& f) throw (NLMISC::EStream) { // Version number (void)f.serialVersion (0); // Serial the value f.serial (Value); f.serial (Tension); f.serial (Continuity); f.serial (Bias); f.serial (EaseTo); f.serial (EaseFrom); }; float Tension; float Continuity; float Bias; float EaseTo; float EaseFrom; // ********************* public: // PRIVATE. used by ITrackKeyFramer, not serialised (compiled). // computed tangents. T TanTo, TanFrom; // computed ease parameters, with next key. float Ease0, Ease1; float EaseK, EaseKOverEase0, EaseKOverEase1; }; // *************************************************************************** template<class T> class CKeyBezier : public CKey<T> { public: void serial (NLMISC::IStream& f) throw (NLMISC::EStream) { // Version number (void)f.serialVersion (0); // Serial the value f.serial (Value); f.serial (InTan); f.serial (OutTan); f.serial (Step); }; // @{ T InTan; T OutTan; bool Step; // @} }; // *************************************************************************** // Special implementation for Quaternions. // *************************************************************************** // *************************************************************************** class CKeyTCB<NLMISC::CAngleAxis> : public CKey<NLMISC::CAngleAxis> { public: void serial (NLMISC::IStream& f) throw (NLMISC::EStream) { // Version number (void)f.serialVersion (0); // Serial the value f.serial (Value); f.serial (Tension); f.serial (Continuity); f.serial (Bias); f.serial (EaseTo); f.serial (EaseFrom); }; float Tension; float Continuity; float Bias; float EaseTo; float EaseFrom; // ********************* public: // PRIVATE. used by ITrackKeyFramer, not serialised (compiled). // Local AngleAxis to the preceding Key (axis is in local basis, unlike "Value" where the axis is in World space ). NLMISC::CAngleAxis LocalAngleAxis; // computed quaternions/tangents. NLMISC::CQuat Quat, A, B; // computed ease parameters, with next key. float Ease0, Ease1; float EaseK, EaseKOverEase0, EaseKOverEase1; }; // *************************************************************************** class CKeyBezier<NLMISC::CQuat> : public CKey<NLMISC::CQuat> { public: void serial (NLMISC::IStream& f) throw (NLMISC::EStream) { // Version number (void)f.serialVersion (0); // Serial the value f.serial (Value); }; // ********************* public: // PRIVATE. used by ITrackKeyFramer, not serialised (compiled). // computed quaternions/tangents. NLMISC::CQuat A; }; // *************************************************************************** // Predefined types // *************************************************************************** // ** Const - Linear keys typedef CKey<std::string> CKeyString; typedef CKey<bool> CKeyBool; typedef CKey<float> CKeyFloat; typedef CKey<NLMISC::CVector> CKeyVector; typedef CKey<NLMISC::CQuat> CKeyQuat; typedef CKey<NLMISC::CRGBA> CKeyRGBA; typedef CKey<sint32> CKeyInt; // NB: For precision and optimisation (space/speed), RGBA and sint32 const/linear tracks use CKeyRGBA and CKeyInt keys repsectively. // ** TCB keys typedef CKeyTCB<float> CKeyTCBFloat; typedef CKeyTCB<NLMISC::CVector> CKeyTCBVector; typedef CKeyTCB<NLMISC::CAngleAxis> CKeyTCBQuat; // NB: RGBA and sint32 TCB tracks use CKeyTCBVector and CKeyTCBFloat respectively. // ** Bezier keys typedef CKeyBezier<float> CKeyBezierFloat; typedef CKeyBezier<NLMISC::CVector> CKeyBezierVector; typedef CKeyBezier<NLMISC::CQuat> CKeyBezierQuat; // NB: RGBA and sint32 bezier tracks use CKeyBezierVector and CKeyBezierFloat respectively. } // NL3D #endif // NL_KEY_H /* End of key.h */