Matrix Structure

Définition

Espace de noms:

Windows.UI.Xaml.Media

Représente une matrice de transformation affine 3 × 3 utilisée pour les transformations dans un espace à deux dimensions.

public value class Matrix

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
struct Matrix

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public struct Matrix

Public Structure Matrix

<Matrix .../>
- or -
<object property="m11,m12,m21,m22,offsetX,offsetY"/>
- or -
<object property="m11 m12 m21 m22 offsetX offsetY"/>
-or-
<object property="Identity"/>

Héritage

ValueType

Matrix

Attributs

ContractVersionAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple XAML définit une matrice qui fournit des données pour un MatrixTransform appliqué à une forme rectangulaire. Dans ce cas, la matrice combine un décalage (OffsetX et OffsetY) et un décalage (M12). Notez que ce même effet aurait pu être produit en combinant un TranslateTransform et un SkewTransform. L’utilisation d’une matrice unique ou de combinaisons de transformations discrètes est une question de style de codage ; les résultats sont identiques.

<Rectangle Width="100" Height="100" Fill="Red">
    <Rectangle.RenderTransform>
        <MatrixTransform Matrix="1,0,0,1,200,0">
        </MatrixTransform>
    </Rectangle.RenderTransform>
</Rectangle>

Remarques

Une matrice 3×3 est utilisée pour les transformations dans un plan x-y bidimensionnel. Les matrices de transformations affines peuvent être multipliées pour former un nombre quelconque de transformations linéaires, par exemple la rotation et l’inclinaison, puis la translation. Une matrice de transformation affine ayant sa colonne finale égale à (0, 0, 1), seuls les membres des deux premières colonnes doivent être spécifiés. Notez que les vecteurs sont exprimés en tant que vecteurs de ligne, et non en tant que vecteurs de colonne.

Une matrice est stockée à l’aide de l’ordre des lignes principales et a la structure suivante :

M11	M12	0
M21	M22	0
OffsetX	OffsetY	1

Les membres de la dernière ligne, OffsetX et OffsetY, représentent les valeurs de traduction.

Dans les méthodes et les propriétés, la matrice de transformation est généralement spécifiée en tant que vecteur avec seulement six membres, comme suit : (M11, M12, M21, M22, OffsetX, OffsetY)

Bien que vous puissiez utiliser une structure Matrix directement pour traduire des points individuels, ou avec un MatrixTransform pour transformer des objets, le Windows Runtime fournit également un ensemble de classes qui peuvent transformer des objets sans travailler directement avec des matrices :

• RotateTransform
• ScaleTransform
• SkewTransform
• TranslateTransform

Les propriétés d’une matrice peuvent être animées (sous forme d’une ou plusieurs animations DoubleAnimation ou DoubleAnimationUsingKeyFrames).

Matrix est la valeur de propriété de la propriété MatrixTransform.Matrix . Les types associés peuvent être utilisés pour les matrices de transformation dans un espace tridimensionnel, puis utilisés pour une projection. Consultez Matrix3D et Matrix3DProjection.

Projections de langage et membres de Matrix

Si vous utilisez un langage Microsoft .NET (C# ou Microsoft Visual Basic), ou dans des extensions de composants Visual C++ (C++/CX), Matrix dispose de membres non-data disponibles, et ses membres de données sont exposés en tant que propriétés en lecture-écriture, et non en tant que champs.

Si vous programmez avec C++ à l’aide de la bibliothèque de modèles Windows Runtime (WRL), seuls les champs membres de données existent en tant que membres de Matrix et vous ne pouvez pas utiliser les méthodes ou propriétés d’utilitaire répertoriées dans la table membres. Le code WRL peut accéder à des méthodes utilitaires similaires qui existent sur la classe MatrixHelper .

Champs

M11	Valeur de la première ligne et de la première colonne de cette structure matrix.
M12	Valeur de la première ligne et de la deuxième colonne de cette structure matrix.
M21	Valeur de la deuxième ligne et de la première colonne de cette structure matrix.
M22	Valeur de la deuxième ligne et de la deuxième colonne de cette structure matrix.
OffsetX	Obtient ou définit la valeur de la troisième ligne et de la première colonne de cette structure matrix.
OffsetY	Obtient ou définit la valeur de la troisième ligne et de la deuxième colonne de cette structure matrice.