IDCompositionRotateTransform3D interface

Represents a 3D transformation that affects the rotation of a visual along an arbitrary axis in 3D space. The coordinate system is rotated around the specified center point.

When to implement

Client applications do not implement IDCompositionRotateTransform3D; custom implementations are not supported.

Members

The IDCompositionRotateTransform3D interface inherits from IDCompositionTransform3D. IDCompositionRotateTransform3D also has these types of members:

Methods

The IDCompositionRotateTransform3D interface has these methods.

MethodDescription
SetAngle Overloaded.

Changes or animates the value of the Angle property of a 3D rotation transform. The Angle property specifies the rotation angle, in degrees. The default value is zero.

SetAxisX Overloaded.

Changes or animates the value of the AxisX property of a 3D rotation transform. The AxisX property specifies the x-coordinate for the axis vector of rotation. The default value is zero.

SetAxisY Overloaded.

Changes or animates the value of the AxisY property of a rotation transform. The AxisY property specifies the y-coordinate for the axis vector of rotation. The default value is zero.

SetAxisZ Overloaded.

Changes or animates the value of the AxisZ property of a 3D rotation transform. The AxisZ property specifies the z-coordinate for the axis vector of rotation. The default value is 1.0.

SetCenterX Overloaded.

Changes or animates the value of the CenterX property of a 3D rotation transform. The CenterX property specifies the x-coordinate of the point about which the rotation is performed. The default value is zero.

SetCenterY Overloaded.

Changes or animates the value of the CenterY property of a 3D rotation transform. The CenterY property specifies the y-coordinate of the point about which the rotation is performed. The default value is zero.

SetCenterZ Overloaded.

Changes or animates the value of the CenterZ property of a 3D rotation transform. The CenterZ property specifies the z-coordinate of the point about which the rotation is performed. The default value is zero.

 

Remarks

A 3D rotate transform represents the following 4-by-4 matrix:

Four-by-four 3D rotate transformation matrix

where the offsetX, offsetY, and offsetZ values of the matrix are the following:

Values of the four-by-four 3D rotate transformation matrix

The effect is to rotate the coordinate system clockwise or counter-clockwise around the specified axis, and to apply the corresponding translation such that the center point does not move.

A new 3D rotation transform object has a default static value of zero for the Angle, CenterX, CenterY, AxisX, and AxisY properties, and a default static value of 1.0 for the AxisZ property.

When setting the axis to a non-default value, you should always set all three axis properties (AxisX, AxisY, and AxisZ).

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Dcomp.h

Library

Dcomp.lib

DLL

Dcomp.dll

See also

IDCompositionEffectGroup::SetTransform3D
IDCompositionTransform3D
IDCompositionVisual::SetEffect

 

 

Community Additions

ADD
Show:
© 2014 Microsoft