Fonction D3DXMatrixAffineTransformation2D (D3DX10Math.h)

Notes

La bibliothèque d’utilitaireS D3DX est déconseillée. Nous vous recommandons d’utiliser DirectXMath à la place.

Génère une matrice de transformation affine 2D dans le plan x-y. Les arguments NULL sont traités comme des transformations d’identité.

Syntaxe

D3DXMATRIX* D3DXMatrixAffineTransformation2D(
  _In_       D3DXMATRIX  *pOut,
  _In_       FLOAT       Scaling,
  _In_ const D3DXVECTOR2 *pRotationCenter,
  _In_       FLOAT       Rotation,
  _In_ const D3DXVECTOR2 *pTranslation
);

Paramètres

pOut [in]

Type : D3DXMATRIX*

Pointeur vers le D3DXMATRIX qui est le résultat de l’opération.

Mise à l’échelle [in]

Type : FLOAT

Facteur de mise à l’échelle.

pRotationCenter [in]

Type : const D3DXVECTOR2*

Pointeur vers un D3DXVECTOR2, un point identifiant le centre de rotation. Si cet argument a la valeur NULL, une matrice M_rc d’identité est appliquée à la formule dans Remarques.

Rotation [in]

Type : FLOAT

Angle de rotation.

pTranslation [in]

Type : const D3DXVECTOR2*

Pointeur vers un D3DXVECTOR2 représentant la traduction. Si cet argument a la valeur NULL, une matrice Mt d’identité est appliquée à la formule dans Remarques.

Valeur retournée

Type : D3DXMATRIX*

Pointeur vers une structure D3DXMATRIX qui est une matrice de transformation affine.

Notes

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 :

M_out = Ms * (M_rc)-1 * M_r * M_rc * Mt

où :

M_out = matrice de sortie (pOut)

Ms = matrice de mise à l’échelle (mise à l’échelle)

M_rc = matrice de centre de rotation (pRotationCenter)

M_r = matrice de rotation (Rotation)

Mt = matrice de traduction (pTranslation)

La valeur de retour de cette fonction est la même valeur retournée dans le paramètre pOut. 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.

Spécifications

Condition requise	Valeur
En-tête	D3DX10Math.h
Bibliothèque	D3DX10.lib

Voir aussi

Fonctions mathématiques