D3DXMatrixTransformation, fonction (D3DX10Math.h)

Notes

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

Génère une matrice de transformation. Les arguments NULL sont traités comme des transformations d’identité.

Syntaxe

D3DXMATRIX* D3DXMatrixTransformation(
  _Inout_       D3DXMATRIX     *pOut,
  _In_    const D3DXVECTOR3    *pScalingCenter,
  _In_    const D3DXQUATERNION *pScalingRotation,
  _In_    const D3DXVECTOR3    *pScaling,
  _In_    const D3DXVECTOR3    *pRotationCenter,
  _In_    const D3DXQUATERNION *pRotation,
  _In_    const D3DXVECTOR3    *pTranslation
);

Paramètres

pOut [in, out]

Type : D3DXMATRIX*

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

pScalingCenter [in]

Type : const D3DXVECTOR3*

Pointeur vers un D3DXVECTOR3, identifiant le point central de mise à l’échelle. Si cet argument a la valeur NULL, une matrice_sc d’identité M est appliquée à la formule dans Remarques.

pScalingRotation [in]

Type : const D3DXQUATERNION*

Pointeur vers un D3DXQUATERNION qui spécifie la rotation de mise à l’échelle. Si cet argument a la valeur NULL, une matrice d’identité M_sr est appliquée à la formule dans Notes.

pScaling [in]

Type : const D3DXVECTOR3*

Pointeur vers une structure D3DXVECTOR3, le vecteur de mise à l’échelle. Si cet argument a la valeur NULL, une matrice Ms d’identité est appliquée à la formule dans Notes.

pRotationCenter [in]

Type : const D3DXVECTOR3*

Pointeur vers une structure D3DXVECTOR3, point qui identifie le centre de rotation. Si cet argument a la valeur NULL, une matrice_{d’identité M rc} est appliquée à la formule dans Remarques.

pRotation [in]

Type : const D3DXQUATERNION*

Pointeur vers une structure D3DXQUATERNION qui spécifie la rotation. Si cet argument a la valeur NULL, une matrice M_r d’identité est appliquée à la formule dans Remarques.

pTranslation [in]

Type : const D3DXVECTOR3*

Pointeur vers une structure D3DXVECTOR3, 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 la matrice de transformation.

Notes

Cette fonction calcule la matrice de transformation avec la formule suivante, avec la concaténation de matrice évaluée dans l’ordre de gauche à droite :

M_out = (M_sc)⁻¹ * (M_sr)⁻¹* Ms * M_sr * M_sc * (M_rc)⁻¹* M_r * M_rc * Mt

où :

M_out = matrice de sortie (pOut)

M_sc = matrice de centre de mise à l’échelle (pScalingCenter)

M_sr = matrice de rotation de mise à l’échelle (pScalingRotation)

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

M_rc = centre de la matrice de rotation (pRotationCenter)

M_r = matrice de rotation (pRotation)

Mt = matrice de traduction (pTranslation)

La valeur de retour pour cette fonction est la même valeur retournée dans le paramètre pOut. De cette façon, la fonction D3DXMatrixTransformation peut être utilisée comme paramètre pour une autre fonction.

Pour les transformations 2D, utilisez D3DXMatrixTransformation2D.

Spécifications

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

Voir aussi

Fonctions mathématiques