Defines
#define	orxANIMSET_KU32_FLAG_LINK_STATIC 0x00020000
#define	orxANIMSET_KU32_FLAG_NONE 0x00000000
#define	orxANIMSET_KU32_FLAG_REFERENCE_LOCK 0x00010000
#define	orxANIMSET_KU32_LINK_FLAG_CLEAR_TARGET 0x80000000
#define	orxANIMSET_KU32_LINK_FLAG_IMMEDIATE_CUT 0x40000000
#define	orxANIMSET_KU32_LINK_FLAG_LOOP_COUNTER 0x10000000
#define	orxANIMSET_KU32_LINK_FLAG_NONE 0x00000000
#define	orxANIMSET_KU32_LINK_FLAG_PRIORITY 0x20000000
#define	orxANIMSET_KU32_MAX_ANIM_NUMBER 128
Typedefs
typedef struct __orxANIMSET_t	orxANIMSET
typedef struct __orxANIMSET_LINK_TABLE_t	orxANIMSET_LINK_TABLE
Functions
orxDLLAPI orxHANDLE orxFASTCALL	orxAnimSet_AddAnim (orxANIMSET _pstAnimSet, orxANIM _pstAnim)
orxDLLAPI orxHANDLE orxFASTCALL	orxAnimSet_AddLink (orxANIMSET *_pstAnimSet, orxHANDLE _hSrcAnim, orxHANDLE _hDstAnim)
orxDLLAPI void orxFASTCALL	orxAnimSet_AddReference (orxANIMSET *_pstAnimSet)
orxDLLAPI orxANIMSET_LINK_TABLE *orxFASTCALL	orxAnimSet_CloneLinkTable (const orxANIMSET *_pstAnimSet)
orxDLLAPI orxHANDLE orxFASTCALL	orxAnimSet_ComputeAnim (orxANIMSET _pstAnimSet, orxHANDLE _hSrcAnim, orxHANDLE _hDstAnim, orxFLOAT _pfTime, orxANIMSET_LINK_TABLE _pstLinkTable, orxBOOL _pbCut, orxBOOL *_pbClearTarget)
orxDLLAPI orxANIMSET *orxFASTCALL	orxAnimSet_Create (orxU32 _u32Size)
orxDLLAPI orxANIMSET *orxFASTCALL	orxAnimSet_CreateFromConfig (const orxSTRING _zConfigID)
orxDLLAPI orxSTATUS orxFASTCALL	orxAnimSet_Delete (orxANIMSET *_pstAnimSet)
orxDLLAPI void orxFASTCALL	orxAnimSet_DeleteLinkTable (orxANIMSET_LINK_TABLE *_pstLinkTable)
orxDLLAPI void orxFASTCALL	orxAnimSet_Exit ()
orxDLLAPI orxANIM *orxFASTCALL	orxAnimSet_GetAnim (const orxANIMSET *_pstAnimSet, orxHANDLE _hAnimHandle)
orxDLLAPI orxU32 orxFASTCALL	orxAnimSet_GetAnimCounter (const orxANIMSET *_pstAnimSet)
orxDLLAPI orxHANDLE orxFASTCALL	orxAnimSet_GetAnimHandleFromID (const orxANIMSET *_pstAnimSet, orxU32 _u32AnimID)
orxDLLAPI orxU32 orxFASTCALL	orxAnimSet_GetAnimStorageSize (const orxANIMSET *_pstAnimSet)
orxDLLAPI orxHANDLE orxFASTCALL	orxAnimSet_GetLink (const orxANIMSET *_pstAnimSet, orxHANDLE _hSrcAnim, orxHANDLE _hDstAnim)
orxDLLAPI orxU32 orxFASTCALL	orxAnimSet_GetLinkProperty (const orxANIMSET *_pstAnimSet, orxHANDLE _hLinkHandle, orxU32 _u32Property)
orxDLLAPI orxSTATUS orxFASTCALL	orxAnimSet_Init ()
orxDLLAPI orxSTATUS orxFASTCALL	orxAnimSet_RemoveAllAnims (orxANIMSET *_pstAnimSet)
orxDLLAPI orxSTATUS orxFASTCALL	orxAnimSet_RemoveAnim (orxANIMSET *_pstAnimSet, orxHANDLE _hAnimHandle)
orxDLLAPI orxSTATUS orxFASTCALL	orxAnimSet_RemoveLink (orxANIMSET *_pstAnimSet, orxHANDLE _hLinkHandle)
orxDLLAPI void orxFASTCALL	orxAnimSet_RemoveReference (orxANIMSET *_pstAnimSet)
orxDLLAPI orxSTATUS orxFASTCALL	orxAnimSet_SetLinkProperty (orxANIMSET *_pstAnimSet, orxHANDLE _hLinkHandle, orxU32 _u32Property, orxU32 _u32Value)
orxDLLAPI void orxFASTCALL	orxAnimSet_Setup ()

Detailed Description

Animation (Set) Module. Allows to creates and handle Sets of Anims. It consists of a structure containing Anims and their relations. It also contains functions for handling and accessing them. AnimSets are structures. They thus can be referenced by Anim Pointers.

Define Documentation

#define orxANIMSET_KU32_FLAG_LINK_STATIC 0x00020000

If not static, animpointer should duplicate the link table upon linking/creation.

Definition at line 62 of file orxAnimSet.h.

#define orxANIMSET_KU32_FLAG_NONE 0x00000000

AnimSet flags No flags.

Definition at line 59 of file orxAnimSet.h.

#define orxANIMSET_KU32_FLAG_REFERENCE_LOCK 0x00010000

If there's already a reference on it, the AnimSet is locked for changes.

Definition at line 61 of file orxAnimSet.h.

#define orxANIMSET_KU32_LINK_FLAG_CLEAR_TARGET 0x80000000

Anim link should clear target when used

Definition at line 71 of file orxAnimSet.h.

#define orxANIMSET_KU32_LINK_FLAG_IMMEDIATE_CUT 0x40000000

Anim link should update with an immediate cut

Definition at line 70 of file orxAnimSet.h.

#define orxANIMSET_KU32_LINK_FLAG_LOOP_COUNTER 0x10000000

Anim link uses a counter

Definition at line 68 of file orxAnimSet.h.

#define orxANIMSET_KU32_LINK_FLAG_NONE 0x00000000

AnimSet Link Flags No flags.

Definition at line 66 of file orxAnimSet.h.

#define orxANIMSET_KU32_LINK_FLAG_PRIORITY 0x20000000

Anim link has priority

Definition at line 69 of file orxAnimSet.h.

#define orxANIMSET_KU32_MAX_ANIM_NUMBER 128

AnimSet defines Maximum number of Anims for an Anim set structure

Definition at line 75 of file orxAnimSet.h.

Typedef Documentation

typedef struct __orxANIMSET_t orxANIMSET

Internal AnimSet structure

Definition at line 80 of file orxAnimSet.h.

typedef struct __orxANIMSET_LINK_TABLE_t orxANIMSET_LINK_TABLE

Internal Link Table structure

Definition at line 84 of file orxAnimSet.h.

Function Documentation

orxDLLAPI orxHANDLE orxFASTCALL orxAnimSet_AddAnim	(	orxANIMSET *	_pstAnimSet,
		orxANIM *	_pstAnim
	)

Adds an Anim to an AnimSet

Parameters:

[in]	_pstAnimSet	Concerned AnimSet
[in]	_pstAnim	Anim to add

Returns:: Anim handle in the specified AnimSet

orxDLLAPI orxHANDLE orxFASTCALL orxAnimSet_AddLink	(	orxANIMSET *	_pstAnimSet,
		orxHANDLE	_hSrcAnim,
		orxHANDLE	_hDstAnim
	)

Adds a link between two Anims of the AnimSet

Parameters:

[in]	_pstAnimSet	Concerned AnimSet
[in]	_hSrcAnim	Source Anim of the link
[in]	_hDstAnim	Destination Anim of the link

Returns:: Handle of the created link / orxHANDLE_UNDEFINED

orxDLLAPI void orxFASTCALL orxAnimSet_AddReference ( orxANIMSET * _pstAnimSet )

Adds a reference to an AnimSet

Parameters:

[in] _pstAnimSet Concerned AnimSet

orxDLLAPI orxANIMSET_LINK_TABLE* orxFASTCALL orxAnimSet_CloneLinkTable ( const orxANIMSET * _pstAnimSet )

Clones an AnimSet Link Table

Parameters:

[in] _pstAnimSet AnimSet to clone

Returns:: An internally allocated clone of the AnimSet

orxDLLAPI orxHANDLE orxFASTCALL orxAnimSet_ComputeAnim	(	orxANIMSET *	_pstAnimSet,
		orxHANDLE	_hSrcAnim,
		orxHANDLE	_hDstAnim,
		orxFLOAT *	_pfTime,
		orxANIMSET_LINK_TABLE *	_pstLinkTable,
		orxBOOL *	_pbCut,
		orxBOOL *	_pbClearTarget
	)

Computes active Anim given current and destination Anim handles & a relative timestamp

Parameters:

[in]	_pstAnimSet	Concerned AnimSet
[in]	_hSrcAnim	Source (current) Anim handle
[in]	_hDstAnim	Destination Anim handle, if none (auto mode) set it to orxHANDLE_UNDEFINED
[in,out]	_pfTime	Pointer to the current timestamp relative to the source Anim (time elapsed since the beginning of this anim)
[in,out]	_pstLinkTable	Anim Pointer link table (updated if AnimSet link table isn't static, when using loop counters for example)
[out]	_pbCut	Animation has been cut
[out]	_pbClearTarget	Animation has requested a target clearing

Returns:: Current Anim handle. If it's not the source one, _pu32Time will contain the new timestamp, relative to the new Anim

orxDLLAPI orxANIMSET* orxFASTCALL orxAnimSet_Create ( orxU32 _u32Size )

Creates an empty AnimSet

Parameters:

[in] _u32Size Storage size return Created orxANIMSET / orxNULL

orxDLLAPI orxANIMSET* orxFASTCALL orxAnimSet_CreateFromConfig ( const orxSTRING _zConfigID )

Creates an animation set from config

Parameters:

[in] _zConfigID Config ID

Returns:: orxANIMSET / orxNULL

orxDLLAPI orxSTATUS orxFASTCALL orxAnimSet_Delete ( orxANIMSET * _pstAnimSet )

Deletes an AnimSet

Parameters:

[in] _pstAnimSet AnimSet to delete

orxDLLAPI void orxFASTCALL orxAnimSet_DeleteLinkTable ( orxANIMSET_LINK_TABLE * _pstLinkTable )

Deletes a Link table

Parameters:

[in] _pstLinkTable Link table to delete (should have been created using the clone function)

orxDLLAPI void orxFASTCALL orxAnimSet_Exit ( )

Exits from the AnimSet module

orxDLLAPI orxANIM* orxFASTCALL orxAnimSet_GetAnim	(	const orxANIMSET *	_pstAnimSet,
		orxHANDLE	_hAnimHandle
	)

AnimSet Anim get accessor

Parameters:

[in]	_pstAnimSet	Concerned AnimSet
[in]	_hAnimHandle	Anim handle

Returns:: Anim pointer / orxNULL

orxDLLAPI orxU32 orxFASTCALL orxAnimSet_GetAnimCounter ( const orxANIMSET * _pstAnimSet )

AnimSet Anim counter get accessor

Parameters:

[in] _pstAnimSet Concerned AnimSet

Returns:: Anim counter / orxU32_UNDEFINED

orxDLLAPI orxHANDLE orxFASTCALL orxAnimSet_GetAnimHandleFromID	(	const orxANIMSET *	_pstAnimSet,
		orxU32	_u32AnimID
	)

Gets animation handle from ID

Parameters:

[in]	_pstAnimSet	Concerned AnimSet
[in]	_u32AnimID	Animation ID (config's animation name CRC)

Returns:: Anim handle / orxHANDLE_UNDEFINED

orxDLLAPI orxU32 orxFASTCALL orxAnimSet_GetAnimStorageSize ( const orxANIMSET * _pstAnimSet )

AnimSet Anim storage size get accessor

Parameters:

[in] _pstAnimSet Concerned AnimSet

Returns:: AnimSet Storage size / orxU32_UNDEFINED

orxDLLAPI orxHANDLE orxFASTCALL orxAnimSet_GetLink	(	const orxANIMSET *	_pstAnimSet,
		orxHANDLE	_hSrcAnim,
		orxHANDLE	_hDstAnim
	)

Gets a direct link between two Anims, if exists

Parameters:

[in]	_pstAnimSet	Concerned AnimSet
[in]	_hSrcAnim	Handle of the source Anim
[in]	_hDstAnim	Handle of the destination Anim

Returns:: Handle of the direct link, orxHANDLE_UNDEFINED if none

orxDLLAPI orxU32 orxFASTCALL orxAnimSet_GetLinkProperty	(	const orxANIMSET *	_pstAnimSet,
		orxHANDLE	_hLinkHandle,
		orxU32	_u32Property
	)

Gets a link property

Parameters:

[in]	_pstAnimSet	Concerned AnimSet
[in]	_hLinkHandle	Handle of the concerned link
[in]	_u32Property	ID of the property to get

Returns:: Property value / orx32_Undefined

orxDLLAPI orxSTATUS orxFASTCALL orxAnimSet_Init ( )

Inits the AnimSet module

Returns:: orxSTATUS_SUCCESS / orxSTATUS_FAILURE

orxDLLAPI orxSTATUS orxFASTCALL orxAnimSet_RemoveAllAnims ( orxANIMSET * _pstAnimSet )

Removes all Anim from the AnimSet

Parameters:

[in] _pstAnimSet Concerned AnimSet

Returns:: orxSTATUS_SUCCESS / orxSTATUS_FAILURE

orxDLLAPI orxSTATUS orxFASTCALL orxAnimSet_RemoveAnim	(	orxANIMSET *	_pstAnimSet,
		orxHANDLE	_hAnimHandle
	)

Removes an Anim from an AnimSet

Parameters:

[in]	_pstAnimSet	Concerned AnimSet
[in]	_hAnimHandle	Handle of the anim to remove

Returns:: orxSTATUS_SUCESS / orxSTATUS_FAILURE

orxDLLAPI orxSTATUS orxFASTCALL orxAnimSet_RemoveLink	(	orxANIMSET *	_pstAnimSet,
		orxHANDLE	_hLinkHandle
	)

Removes a link from the AnimSet

Parameters:

[in]	_pstAnimSet	Concerned AnimSet
[in]	_hLinkHandle	Handle of the link

Returns:: orxSTATUS_SUCCESS / orxSTATUS_FAILURE

orxDLLAPI void orxFASTCALL orxAnimSet_RemoveReference ( orxANIMSET * _pstAnimSet )

Removes a reference from an AnimSet

Parameters:

[in] _pstAnimSet Concerned AnimSet

orxDLLAPI orxSTATUS orxFASTCALL orxAnimSet_SetLinkProperty	(	orxANIMSET *	_pstAnimSet,
		orxHANDLE	_hLinkHandle,
		orxU32	_u32Property,
		orxU32	_u32Value
	)

Sets a link property

Parameters:

[in]	_pstAnimSet	Concerned AnimSet
[in]	_hLinkHandle	Handle of the concerned link
[in]	_u32Property	ID of the property to set
[in]	_u32Value	Value of the property to set

Returns:: orxSTATUS_SUCCESS / orxSTATUS_FAILURE

orxDLLAPI void orxFASTCALL orxAnimSet_Setup ( )

AnimSet module setup

OrxAnimSet

Defines

Typedefs

Functions

Detailed Description

Define Documentation

Typedef Documentation

Function Documentation