D3DXCreateAnimationSet Function

Creates an animation set, given a set of interpolators.

Syntax

HRESULT D3DXCreateAnimationSet(      

    LPCSTR Name,
    LPD3DXINTERPOLATOR *ppInterpolators,
    UINT NumInterpolators,
    LPD3DXANIMATIONSET *ppAnimSet
);

Parameters

Name

[in] Name of the animation set.

ppInterpolators

[in] Array of interpolators. See ID3DXInterpolator.

NumInterpolators

[in] Number of elements in the array of interpolators.

ppAnimSet

[out, retval] Returns the animation set interface. See ID3DXAnimationSet.

Return Value

If the function succeeds, the return value is D3D_OK.

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

D3DERR_INVALIDCALL	The method call is invalid. For example, a method's parameter may have an invalid value.
E_OUTOFMEMORY	Microsoft?Direct3D?could not allocate sufficient memory to complete the call.

Remarks

A walk cycle can be implemented using an animation set, which can also be called a frame hierarchy. The frame hierarchy consists of nodes in a tree. Each node is associated with one or more mesh objects and a transformation matrix. Each node uses an interpolator to encapsulate the transformation matrix.

Function Information

Header	d3dx9anim.h
Import library	d3dx9.lib
Minimum operating systems	Windows 98