D3DXCreateKeyFrameInterpolator Function

Creates a scale, rotate, and translate (SRT) key frame interpolator object from the given set of keys.

Syntax

HRESULT D3DXCreateKeyFrameInterpolator(      

    LPCSTR Name,
    LPD3DXKEY_VECTOR3 ScaleKeys,
    UINT NumScaleKeys,
    LPD3DXKEY_QUATERNION RotationKeys,
    UINT NumRotationKeys,
    LPD3DXKEY_VECTOR3 TranslateKeys,
    UINT NumTranslationKeys,
    DOUBLE ScaleInputTimeBy,
    LPD3DXKEYFRAMEINTERPOLATOR *ppNewInterpolator
);

Parameters

Name

[in] Interpolator name.

ScaleKeys

[in] Array of scale key vectors.

NumScaleKeys

[in] Number of elements in RotationKeys array.

RotationKeys

[in] Array of rotation key quaternions. See D3DXKEY_QUATERNION.

NumRotationKeys

[in] Number of elements in RotationKeys array.

TranslateKeys

[in] Array of translation key vectors. See D3DXKEY_VECTOR3.

NumTranslationKeys

[in] Number of elements in TranslateKeys array.

ScaleInputTimeBy

[in] All key times are scaled by this factor.

ppNewInterpolator

[out, retval] Returns the keyframe interpolator interface. See ID3DXKeyFrameInterpolator.

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.

Function Information

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