ID3DXAnimationController::KeyTrackWeight method

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

Syntax

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

Parameters

Track [in]

Type: UINT

Identifier of the track to modify.

NewWeight [in]

Type: FLOAT

New weight of the track.

StartTime [in]

Type: DOUBLE

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

Duration [in]

Type: DOUBLE

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

Transition [in]

Type: D3DXTRANSITION_TYPE

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

Return value

Type: D3DXEVENTHANDLE

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

Requirement Value
Header
D3dx9anim.h
Library
D3dx9.lib

See also

ID3DXAnimationController