ID3DXAnimationController::RegisterAnimationOutput

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

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 Values

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_INVALIDCALL, E_OUTOFMEMORY.

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.

Requirements

Header: Declared in D3dx9anim.h.