IXRMatrix (Compact 2013)
3/28/2014
This class represents a two-dimensional plane that has four flexible quadrants.
Syntax
class IXRMatrix : public IXRDependencyObject
Inheritance Hierarchy
IXRMatrix
Methods
Method |
Description |
---|---|
Retrieves the multiplier value that is applied to the points in the first row and first column of this matrix. |
|
Retrieves the multiplier value that is applied to the points in the first row and second column of this matrix. |
|
Retrieves the multiplier value that is applied to the points in the second row and first column of this matrix. |
|
Retrieves the multiplier value that is applied to the points in the second row and second column of this matrix. |
|
Retrieves the amount by which this matrix is moved along the x-axis, offset from the upper-left coordinate. |
|
Retrieves the amount by which this matrix is moved down the y-axis, offset from the upper-left coordinate. |
|
Retrieves a value that indicates whether this matrix is an identity matrix. |
|
Sets the multiplier value to apply to the points in the first row and first column of this matrix. |
|
Sets the multiplier value to apply to the points in the first row and second column of this matrix. |
|
Sets the multiplier value to apply to the points in the second row and first column of this matrix. |
|
Sets the multiplier value to apply to the points in the second row and second column of this matrix. |
|
Sets the amount by which to move this matrix along the x-axis, offset from the upper-left coordinate. |
|
Sets the amount by which to move this matrix down the y-axis, offset from the upper-left coordinate. |
|
Transforms the specified source x,y coordinate by using the math defined in this matrix and returns the target x,y coordinate. |
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
You can use the IXRMatrix object to define a custom transformation that you can apply to a UI object. IXRMatrix lets you combine the effects available in IXRScaleTransform, IXRSkewTransform, IXRTranslateTransform, and IXRRotateTransform. You can also control the intensity of each effect by using multiplier values. You can create a unique transformation for an object by using different multiplier values for M11, M12, M21, and M22. Then, you can set this IXRMatrix instance as the value of an IXRMatrixTransform, which is in turn set for a particular UI object.
You can create a custom IXRMatrix object that defines a matrix transformation, and supply it in a call to IXRMatrixTransform::SetMatrix.
As an alternative to performing custom matrix mathematics by using IXRMatrix, you can combine transformations by creating an IXRTransformGroup object and apply multiple transformations to a UI object.
When you create a class instance, use an IXRMatrixPtr smart pointer instead of a raw interface pointer. For more information, see XRPtr<Interface>.
You can also define a matrix as an attribute 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 Matrix Structure on MSDN.
.NET Framework Equivalent
Requirements
Header |
XamlRuntime.h |
sysgen |
SYSGEN_XAML_RUNTIME |