IInertiaProcessor::put_DesiredRotation method (manipulations.h)

The DesiredRotation property specifies how far the current inertia processor object should manipulate the target object in radians.

This property is read/write.

Syntax

HRESULT put_DesiredRotation(
  FLOAT rotation
);

Parameters

rotation

Return value

None

Remarks

DesiredRotation and DesiredAngularDeceleration are mutually exclusive. If one is set, the other should be NaN.

If inertia processing has already started, setting DesiredRotation will reset the inertia engine to the initial state with new deceleration value 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

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header manipulations.h (include Manipulations.h)

See also

DesiredAngularDeceleration

Handling Inertia in Unmanaged Code

IInertiaProcessor

Inertia Mechanics

InitialAngularVelocity

Properties