ID3DXAnimationController::KeyTrackWeight

Sets an event key that changes the weight of an animation track. The weight is used as a multiplier when combining multiple tracks together.

D3DXEVENTHANDLE KeyTrackWeight(
  UINT Track,
  FLOAT NewWeight,
  DOUBLE StartTime,
  DOUBLE Duration,
  D3DXTRANSITION_TYPE Transition
);

Parameters

Track

[in] Identifier of the track to modify.

NewWeight

[in] New weight of the track.

StartTime

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

Duration

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

Transition

[in] Specifies the transition type used for transitioning between weights. See D3DXTRANSITION_TYPE.

Return Values

Event handle to the priority blend event. NULL is returned if one or more of the input parameters is invalid, or no free event is available.

Remarks

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

Requirements

Header: Declared in D3dx9anim.h.