ltanimtracker.h

#ifndef __LTANIMTRACKER_H__
#define __LTANIMTRACKER_H__

#ifndef __LTBASEDEFS_H__
#include "ltbasedefs.h"
#endif


class LTAnimTracker;
class AnimTimeRef;
class AnimKeyFrame;
class Model;
class ModelAnim;
class AnimInfo;
class ModelInstance;


typedef void (*StringKeyCallback)(LTAnimTracker *pTracker, 
    AnimKeyFrame *pFrame);




/*!
All the info on where we are in the animation.
*/
class FrameLocator
{
public:
                    
    void            Clear()
    {
        m_iAnim = 0;
        m_iFrame = 0;
        m_Time = 0;
    }

    uint16          m_iAnim;
    uint16          m_iFrame;
    uint32          m_Time; //! Milliseconds
};




/*!
References a specific time in an animation.
*/
class AnimTimeRef
{
public:

    AnimTimeRef() {
        m_iWeightSet = INVALID_MODEL_WEIGHTSET;
        Clear();
    }

    void Init(Model *pModel, 
        uint32 iAnim1=0, uint32 iFrame1=0,
        uint32 iAnim2=0, uint32 iFrame2=0,
        float percent=0.0f)
    {
        m_pModel = pModel;
        
        m_Prev.m_iAnim = (uint16)iAnim1;
        m_Prev.m_iFrame = (uint16)iFrame1;
        m_Prev.m_Time = 0;

        m_Cur.m_iAnim = (uint16)iAnim2;
        m_Cur.m_iFrame = (uint16)iFrame2;
        m_Cur.m_Time = 0;

        m_Percent = percent;
    }

    void Clear() {
        Init(LTNULL, 0, 0, 0, 0, 0.0f);
    }

    bool IsValid();
    ModelAnim *GetAnim1();
    ModelAnim *GetAnim2();

public:

/*!
Set it between the specified keyframes on the specified animation.
*/
    bool SetKeyframePosition(uint32 iAnim, uint32 iFrame1, 
        uint32 iFrame2, float fPercent);
     

    Model *m_pModel;

/*!
This tells exactly where we want the vertices set up.
*/
    FrameLocator m_Prev;
    FrameLocator m_Cur;

/*!
Percentage between the two frames.  Must be between 0 and 1.
*/
    float m_Percent;



/*!  If multiple \b LTAnimTracker objects are being used together,
this tells how to blend each one. This is ignored for the first weight
set.  */
    uint32 m_iWeightSet;
};



/*!
Animation tracker for model instances.

\note
Game code should \em never touch the internals of this structure or 
call any of its functions. It should use the \b ILTModel functions to 
access these.
*/
class LTAnimTracker {
public:

	LTAnimTracker()
	{
/*!
Movement encoding hint.
*/
		m_hHintNode = INVALID_MODEL_NODE;
		m_hLastHintAnim = INVALID_MODEL_ANIM;
		m_dwLastHintTime = 0;
		m_tfLastHint.m_Pos.Init();
		m_tfLastHint.m_Rot.Init();
		m_bDirty = true;
	}

/*!
Tells if the frame locators are on valid frames.
*/
    bool			IsValid();
    
    ModelAnim*      GetCurAnim();
    ModelAnim*      GetPrevAnim();

    AnimInfo*       GetCurAnimInfo();
    AnimInfo*       GetPrevAnimInfo();

    AnimKeyFrame*   GetCurFrame();
    AnimKeyFrame*   GetPrevFrame();
    
    bool			AllowInvalid();



/*!
Get/set its linked list info.
*/
    LTAnimTracker *	GetNext()						{return (LTAnimTracker*)m_Link.m_pNext;}
    void			SetNext(LTAnimTracker *pNext)	{m_Link.m_pNext = (LTLink*)pNext;}
    ModelInstance*  GetModelInstance()				{return (ModelInstance*)m_Link.m_pData;}
    void			SetModelInstance(ModelInstance *pInst) {m_Link.m_pData = pInst;}
    Model*			GetModel()						{return m_TimeRef.m_pModel;}
    void			SetModel(Model *pModel)			{m_TimeRef.m_pModel = pModel;}


public:
    LTLink m_Link;

/*!
Set this if you want to be notified of string keys.
*/
    StringKeyCallback m_StringKeyCallback;

/*!
Stuff used to track where it is in the keyframes.
*/
    uint32 m_CurKey;

/*!
Combination of \b AT_ flags above.
*/
    uint16 m_Flags;

/*!
How far we have ve interpolated between \b prev and \b cur
(when switching animations).  Set to \b NOT_INTERPOLATING
if not interpolating.
*/
    uint16 m_InterpolationMS;

/*!
Factor with which to change the animation rate, default = 1.0.
*/
    float m_RateModifier ;                                        
    AnimTimeRef m_TimeRef;


/*!
Reference / identifier for engine-managed tracker
*/      
    ANIMTRACKERID m_ID;

/*!
Movement encoding hint.
*/

	HMODELNODE		m_hHintNode;
	HMODELANIM		m_hLastHintAnim;
	uint32			m_dwLastHintTime;
	LTransform		m_tfLastHint;

/*!
Tracker dirty?
*/
	//NEW
	bool			m_bDirty;
};

#endif  //! __LTANIMTRACKER_H__