D3DXMatrixAffineTransformation2D, fonction (D3dx9math. h)
Crée une matrice de transformation affine 2D dans le plan XY. Les arguments null sont traités comme des transformations d’identité.
Syntaxe
D3DXMATRIX* D3DXMatrixAffineTransformation2D(
_Inout_ D3DXMATRIX *pOut,
_In_ FLOAT Scaling,
_In_ const D3DXVECTOR2 *pRotationCenter,
_In_ FLOAT Rotation,
_In_ const D3DXVECTOR2 *pTranslation
);
Paramètres
-
moue [ in, out]
-
Type : D3DXMATRIX*
Pointeur vers la structure D3DXMATRIX qui est le résultat de l’opération.
-
Mise à l’échelle [ dans]
-
Type : float
Facteur d’échelle.
-
pRotationCenter [ dans]
-
Type : const D3DXVECTOR2 *
Pointeur vers une structure D3DXVECTOR2 , point identifiant le centre de rotation. Si cet argument a la valeur null, une matrice Identity M RC est appliquée à la formule dans la section Notes.
-
Rotation [ dans]
-
Type : float
Angle de rotation.
-
pTranslation [ dans]
-
Type : const D3DXVECTOR2 *
Pointeur vers une structure D3DXVECTOR2 représentant la translation. Si cet argument a la valeur null, une matrice Identity MT est appliquée à la formule dans la section Notes.
Valeur retournée
Type : D3DXMATRIX*
Pointeur vers une structure D3DXMATRIX qui est une matrice de transformation affine.
Remarques
Cette fonction calcule la matrice de transformation affine avec la formule suivante, avec la concaténation de matrice évaluée dans l’ordre de gauche à droite :
Mout = MS * (MRC) ⁻ ¹ * mr * mRC * MT
où :
M out = matrice de sortie (moue)
MS = matrice de mise à l’échelle (mise à l’échelle)
M RC = Centre de rotation de la matrice (pRotationCenter)
M r = matrice de rotation (rotation)
MT = matrice de translation (pTranslation)
La valeur de retour de cette fonction est la même que celle retournée dans le paramètre moue. De cette façon, la fonction D3DXMatrixAffineTransformation2D peut être utilisée comme paramètre pour une autre fonction.
Pour les transformations affines 3D, utilisez D3DXMatrixAffineTransformation.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|