IInertiaProcessor::get_InitialAngularVelocity method (manipulations.h)

The InitialAngularVelocity property specifies the rotational (angular) velocity of the target when movement begins.

This property is read/write.

Syntax

HRESULT get_InitialAngularVelocity(
  FLOAT *velocity
);

Parameters

velocity

Return value

None

Remarks

DesiredRotation and DesiredAngularDeceleration are mutually exclusive. If one is set, the other should be NaN. If the DesiredRotation property is set, the API will set the DesiredAngularDeceleration property so that the object will stop after the desired number of radians. The unit of angular acceleration is radians.

If inertia processing has already started, setting InitialAngularVelocity will reset the inertia engine to the initial state with new velocity values applied.

Call this function to set the initial state of inertia. You would call this function most likely during the ManipulationCompleted event of the IManipulationProcessor or in the constructor of the IInertiaProcessor interface.

Requirements

See also

DesiredRotation

GetAngularVelocity

Handling Inertia in Unmanaged Code

IInertiaProcessor

Inertia Mechanics

InitialExpansionVelocity

Properties