d3d9.dllRegisterAnimationOutput
Microsoft DirectX 9.0 SDK Update (October 2004)

ID3DXAnimationController::RegisterAnimationOutput Method


Adds an animation output to the animation controller and registers pointers for scale, rotate, and translate (SRT) transformations.

Syntax

HRESULT RegisterAnimationOutput(      

    LPCSTR Name,     D3DXMATRIX *pMatrix,     D3DXVECTOR3 *pScale,     D3DXQUATERNION *pRotation,     D3DXVECTOR3 *pTranslation );

Parameters

Name
[in] Name of the animation output.
pMatrix
[in] Pointer to a D3DXMATRIX structure containing SRT transformation data. Can be NULL.
pScale
[in] Pointer to a D3DXVECTOR3 vector that describes the scale of the animation set. Can be NULL.
pRotation
[in] Pointer to a D3DXQUATERNION quaternion that describes the rotation of the animation set. Can be NULL.
pTranslation
[in] Pointer to a D3DXVECTOR3 vector that describes the translation of the animation set. Can be NULL.

Return Value

If the method succeeds, the return value is S_OK.

If the method fails, the return value can be one of the following values.

D3DERR_INVALIDCALLThe method call is invalid. For example, a method's parameter may have an invalid value.
E_OUTOFMEMORYMicrosoft Direct3D could not allocate sufficient memory to complete the call.


Remarks

If the animation output is already registered, pMatrix will be filled with the input transformation data.

Animation sets created with D3DXLoadMeshHierarchyFromX automatically register all loaded animation sets.



© 2004 Microsoft Corporation. All rights reserved.
Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center.