| -api-id | -api-type |
|---|---|
T:Windows.UI.Xaml.Media.Media3D.Matrix3D |
winrt struct |
Represents a 4 × 4 matrix that is used for transformations in a 3-D space. Used as a value for Matrix3DProjection.ProjectionMatrix.
<Matrix3DProjection ProjectionMatrix="m11, m12, m13, m14,
m21, m22, m23, m24, m31, m32, m33, m34, offsetX, offsetY, offsetZ, m44" />
- or -
<!--xmlns:m3d="using:Windows.UI.Xaml.Media.Media3D"-->
<m3d:Matrix3D>
m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, offsetX, offsetY, offsetZ, m44
</m3d:Matrix3D>The value of the first row and first column of this Matrix3D.
The value of the first row and second column of this Matrix3D.
The value of the first row and third column of this Matrix3D.
The value of the first row and fourth column of this Matrix3D.
The value of the second row and first column of this Matrix3D.
The value of the second row and second column of this Matrix3D.
The value of the second row and third column of this Matrix3D.
The value of the second row and fourth column of this Matrix3D.
The value of the third row and first column of this Matrix3D.
The value of the third row and second column of this Matrix3D.
The value of the third row and third column of this Matrix3D.
The value of the third row and fourth column of this Matrix3D.
The value of the fourth row and first column of this Matrix3D.
The value of the fourth row and second column of this Matrix3D.
The value of the fourth row and third column of this Matrix3D.
The value of the fourth row and fourth column of this Matrix3D.
You can use the Matrix3DProjection and Matrix3D types for more complex semi–3-D scenarios than are possible with the PlaneProjection type. Matrix3DProjection provides a complete 3-D transform matrix to apply to any UIElement (you use this as a value for the UIElement.Projection property). The matrix lets you apply arbitrary model transform matrices and perspective matrices to visual elements.
Matrix3D has this row-vector syntax:
| M11 | M12 | M13 | M14 |
| M21 | M22 | M23 | M24 |
| M31 | M32 | M33 | M34 |
| OffsetX | OffsetY | OffsetZ | M44 |
Because the fourth column is accessible, Matrix3D can represent both affine and non-affine transforms.
Matrix3D values can be declared in XAML, but the syntax is limited, and different than what you might expect based on how other Windows Runtime structures (like Thickness) support values for XAML UI:+ The most typical usage for Matrix3D-type properties is to rely on the initialization string behavior that's built-in to the Matrix3D type, and set any value that uses a Matrix3D value as an attribute. You specify a string in the "initialization text" format for constructing a Matrix3D value: 16 separate Double values each separated by comma or space. You can see this format used in the XAML in "Examples" below.
- There's only one existing property that uses a Matrix3D value: Matrix3DProjection.ProjectionMatrix. So that's what's shown as the primary XAML syntax here.
- The secondary XAML syntax shown has an actual Matrix3D object element. But note that it has a XAML namespace prefix. The Windows.UI.Xaml.Media.Media3D namespace was not included in the set of code namespaces that the Windows Runtime XAML parser uses for the default XAML namespace. In order to use the Matrix3D as an element in XAML, you have to include an xmlns declaration in your XAML that references Windows.UI.Xaml.Media.Media3D by a ** using:** statement. Then qualify the Matrix3D with the xmlns prefix you mapped for the types in Windows.UI.Xaml.Media.Media3D.
- Even once you do this mapping, the Matrix3D object element can't have attribute values for setting the 16 properties, it's not enabled by the XAML parser (other XAML structures have special-case handling for properties-as-attribute syntax; Matrix3D happens to not have this). You still have to use the initialization text that sets the 16 values as consecutive atoms of a string. In this case the string is contained as the "inner text" / content of the Matrix3D object element.
- As you can see the object element syntax isn't any easier to read or use than the inline attribute syntax for Matrix3DProjection.ProjectionMatrix, so the verbose Matrix3D object element syntax isn't common.
If you are using a Microsoft .NET language (C# or Microsoft Visual Basic), or in Visual C++ component extensions (C++/CX), then Matrix3D has non-data members available, and its data members are exposed as read-write properties, not fields.
If you are programming with C++ using the Windows Runtime Template Library (WRL), then only the data member fields exist as members of Matrix3D, and you cannot use the utility methods or properties listed in the members table. WRL code can access similar utility methods that exist on the Matrix3DHelper class.
You can't set properties of Matrix3D in XAML with individual XAML attributes. You have to initialize a Matrix3D object element using an initialization string that specifies all 16 values, or use attribute syntax for Matrix3DProjection.ProjectionMatrix that uses this same string format.
This example uses a simple Matrix3D matrix to transform the image in the X and Y directions when you click the image.
[!code-xamlMatrix3DProjectionSimple]
[!code-csharpMatrix3DProjectionSimple_code]
[!code-xamlMatrix3DProjectionXAML]
[!code-xamlMatrix3DProjectionSample]
[!code-csharpMatrix3DProjectionSample_code]
Matrix3DHelper, Matrix3DProjection, UIElement.Projection, 3-D perspective effects for XAML UI projection.md), UIElement.Projection, 3-D perspective effects for XAML UI