IXRMatrix3D (Compact 2013)

Article
04/19/2017

3/28/2014

This C++ class represents a three-dimensional (3-D) space that is represented by a 4 × 4 matrix.

Syntax

class IXRMatrix3D : public IXRDependencyObject

Inheritance Hierarchy

IXRDependencyObject

IXRMatrix3D

Methods

Method	Description
IXRMatrix3D::GetM11	Retrieves the multiplier value to apply to the points in the first row and first column of a 3-D matrix.
IXRMatrix3D::GetM12	Retrieves the multiplier value to apply to the points in the first row and second column of a 3-D matrix.
IXRMatrix3D::GetM13	Retrieves the multiplier value to apply to the points in the first row and third column of a 3-D matrix.
IXRMatrix3D::GetM14	Retrieves the multiplier value to apply to the points in the first row and fourth column of a 3-D matrix.
IXRMatrix3D::GetM21	Retrieves the multiplier value to apply to the points in the second row and first column of a 3-D matrix.
IXRMatrix3D::GetM22	Retrieves the multiplier value to apply to the points in the second row and second column of a 3-D matrix.
IXRMatrix3D::GetM23	Retrieves the multiplier value to apply to the points in the second row and third column of a 3-D matrix.
IXRMatrix3D::GetM24	Retrieves the multiplier value to apply to the points in the second row and fourth column of a 3-D matrix.
IXRMatrix3D::GetM31	Retrieves the multiplier value to apply to the points in the third row and first column of a 3-D matrix.
IXRMatrix3D::GetM32	Retrieves the multiplier value to apply to the points in the third row and second column of a 3-D matrix.
IXRMatrix3D::GetM33	Retrieves the multiplier value to apply to the points in the third row and third column of a 3-D matrix.
IXRMatrix3D::GetM34	Retrieves the multiplier value to apply to the points in the third row and fourth column of a 3-D matrix.
IXRMatrix3D::GetM44	Retrieves the multiplier value to apply to the points in the fourth row and fourth column of a 3-D matrix.
IXRMatrix3D::GetOffsetX	Retrieves the multiplier value to apply to the points in the fourth row and first column of a 3-D matrix.
IXRMatrix3D::GetOffsetY	Retrieves the multiplier value to apply to the points in the fourth row and second column of a 3-D matrix.
IXRMatrix3D::GetOffsetZ	Retrieves the multiplier value to apply to the points in the fourth row and third column of a 3-D matrix.
IXRMatrix3D::SetM11	Sets the multiplier value to apply to the points in the first row and first column of a 3-D matrix.
IXRMatrix3D::SetM12	Sets the multiplier value to apply to the points in the first row and second column of a 3-D matrix.
IXRMatrix3D::SetM13	Sets the multiplier value to apply to the points in the first row and third column of a 3-D matrix.
IXRMatrix3D::SetM14	Sets the multiplier value to apply to the points in the first row and fourth column of a 3-D matrix.
IXRMatrix3D::SetM21	Sets the multiplier value to apply to the points in the second row and first column of a 3-D matrix.
IXRMatrix3D::SetM22	Sets the multiplier value to apply to the points in the second row and second column of a 3-D matrix.
IXRMatrix3D::SetM23	Sets the multiplier value to apply to the points in the second row and third column of a 3-D matrix.
IXRMatrix3D::SetM24	Sets the multiplier value to apply to the points in the second row and fourth column of a 3-D matrix.
IXRMatrix3D::SetM31	Sets the multiplier value to apply to the points in the third row and first column of a 3-D matrix.
IXRMatrix3D::SetM32	Sets the multiplier value to apply to the points in the third row and second column of a 3-D matrix.
IXRMatrix3D::SetM33	Sets the multiplier value to apply to the points in the third row and third column of a 3-D matrix.
IXRMatrix3D::SetM34	Sets the multiplier value to apply to the points in the third row and fourth column of a 3-D matrix.
IXRMatrix3D::SetM44	Sets the multiplier value to apply to the points in the fourth row and fourth column of a 3-D matrix.
IXRMatrix3D::SetOffsetX	Sets the multiplier value to apply to the points in the fourth row and first column of a 3-D matrix.
IXRMatrix3D::SetOffsetY	Sets the multiplier value to apply to the points in the fourth row and second column of a 3-D matrix.
IXRMatrix3D::SetOffsetZ	Sets the multiplier value to apply to the points in the fourth row and third column of a 3-D matrix.

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 transform a UI object in 3-D space, create a custom IXRMatrix3D object, create an IXRMatrix3DProjection object, and pass the IXRMatrix3D object into IXRMatrix3DProjection::SetProjectionMatrix. Then, transform the UI object by passing the IXRMatrix3DProjection object into its inherited method IXRUIElement::SetProjection.

To define a custom 3-D transformation, specify a multiplier value for members of the 3-D matrix, such as M1 and M2, by using the Set methods. For information about setting these values, see Matrices on MSDN.

Or, you can define the 3-D matrix by using the methods on IXRPlaneProjection. After you do this, you can obtain the resulting IXRMatrix3D object by calling its method IXRPlaneProjection::GetProjectionMatrix.

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

You can also define a 3-D matrix 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 defining this attribute in the source XAML for your application, see Matrix3D Structure on MSDN.

.NET Framework Equivalent

System.Windows.Media.Matrix3D

Requirements

Header	XamlRuntime.h
sysgen	SYSGEN_XAML_RUNTIME