IXRPlaneProjection (Compact 2013)

Article
04/19/2017

3/28/2014

This C++ class applies a three-dimensional (3-D) transformation to a UI object.

Syntax

class IXRPlaneProjection : public IXRProjection

Inheritance Hierarchy

IXRProjection

IXRPlaneProjection

Methods

Method	Description
IXRPlaneProjection::GetCenterOfRotationX	Retrieves the x-coordinate of the center of rotation of the object to rotate.
IXRPlaneProjection::GetCenterOfRotationY	Retrieves the y-coordinate of the center of rotation of the object to rotate.
IXRPlaneProjection::GetCenterOfRotationZ	Retrieves the z-coordinate of the center of rotation of the object to rotate.
IXRPlaneProjection::GetGlobalOffsetX	Retrieves the translation distance of the object along the x-axis of the screen.
IXRPlaneProjection::GetGlobalOffsetY	Retrieves the translation distance of the object along the y-axis of the screen.
IXRPlaneProjection::GetGlobalOffsetZ	Retrieves the translation distance of the object along the z-axis of the screen.
IXRPlaneProjection::GetLocalOffsetX	Retrieves the translation distance of the object along the x-axis of the screen.
IXRPlaneProjection::GetLocalOffsetY	Retrieves the translation distance of the object along the y-axis of the object.
IXRPlaneProjection::GetLocalOffsetZ	Retrieves the translation distance of the object along the z-axis of the object.
IXRPlaneProjection::GetProjectionMatrix	Retrieves the IXRMatrix3D object that defines a 3-D transformation.
IXRPlaneProjection::GetRotationX	Retrieves the number of degrees to rotate the object around the x-axis of rotation.
IXRPlaneProjection::GetRotationY	Retrieves the number of degrees to rotate the object around the y-axis of rotation.
IXRPlaneProjection::GetRotationZ	Retrieves the number of degrees to rotate the object around the z-axis of rotation.
IXRPlaneProjection::SetCenterOfRotationX	Sets the x-coordinate of the center of rotation of the object to rotate.
IXRPlaneProjection::SetCenterOfRotationY	Sets the y-coordinate of the center of rotation of the object to rotate.
IXRPlaneProjection::SetCenterOfRotationZ	Sets the z-coordinate of the center of rotation of the object to rotate.
IXRPlaneProjection::SetGlobalOffsetX	Sets the translation distance of the object along the x-axis of the screen.
IXRPlaneProjection::SetGlobalOffsetY	Sets the translation distance of the object along the y-axis of the screen.
IXRPlaneProjection::SetGlobalOffsetZ	Sets the translation distance of the object along the z-axis of the screen.
IXRPlaneProjection::SetLocalOffsetX	Sets the translation distance of the object along the x-axis of the screen.
IXRPlaneProjection::SetLocalOffsetY	Sets the translation of the object along the y-axis of the screen.
IXRPlaneProjection::SetLocalOffsetZ	Sets the translation distance of the object along the z-axis of the screen.
IXRPlaneProjection::SetRotationX	Sets the number of degrees to rotate the object around the x-axis of rotation.
IXRPlaneProjection::SetRotationY	Sets the number of degrees to rotate the object around the y-axis of rotation.
IXRPlaneProjection::SetRotationZ	Sets the number of degrees to rotate the object around the z-axis of rotation.

Thread Safety

Members of this class are thread-safe if you previously called IXRApplication::CreateHostFromXaml and supplied it with an XRWindowCreateParams structure that has AllowsMultipleThreadAccess set to true.

Remarks

To make an object appear as if it is projecting into three-dimensional space, you can define a perspective transformation for it by using the methods of IXRPlaneProjection.

To apply a 3-D transformation to an object that derives from IXRUIElement, create an IXRPlaneProjection object and then provide it in a call to IXRUIElement::SetProjection.

When you create a class instance, use an IXRPlaneProjectionPtr smart pointer instead of a raw interface pointer. For more information, see XRPtr<Interface>.

You can also define a perspective transformation in Microsoft Silverlight 3 XAML. For information about the differences between XAML in XAML for Windows Embedded and Silverlight 3, see Differences Between Microsoft Silverlight 3 and XAML for Windows Embedded. For more information about how to define this element in the source XAML for your application, see the PlaneProjection Class on MSDN.

.NET Framework Equivalent

System.Windows.Media.PlaneProjection

Requirements

Header	XamlRuntime.h
sysgen	SYSGEN_XAML_RUNTIME