ID3DXAnimationController::KeyTrackWeight Method

Keys, or sets the track weight. The weight is used as a multiplier when combining two tracks together.

Syntax

HRESULT KeyTrackWeight(      

    DWORD Track,
    FLOAT NewWeight,
    DOUBLE StartTime,
    DOUBLE Duration,
    DWORD Method
);

Parameters

Track

[in] Track to modify.

NewWeight

[in] New weight of the track.

StartTime

[in] Global time key. Specifies the global time that the change will take place.

Duration

[in]  Transition time which specifies how long the smooth transition will take to complete.

Method

[in] Specifies the transition type between tracks. For more information, see D3DXTRANSITIONTYPE.

Return Value

If the method succeeds, the return value is D3D_OK.

If the method 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

The weight is used like a multiplier to determine how much of this track to blend together with other tracks.