Partager via


Fonction XMQuaternionRotationRollPitchYawFromVector (directxmath.h)

Calcule un quaternion de rotation à partir d’un vecteur contenant les angles d’Euler (tangage, lacet et roulis).

Syntaxe

XMVECTOR XM_CALLCONV XMQuaternionRotationRollPitchYawFromVector(
  [in] FXMVECTOR Angles
) noexcept;

Paramètres

[in] Angles

Vecteur 3D contenant les angles d’Euler dans l’ordre axe x (tangage), puis axe y (lacet), puis axe z (roulis). L’élément W est ignoré.

Valeur retournée

Retourne le quaternion de rotation.

Remarques

Les fonctions quaternion DirectXMath utilisent un vecteur XMVECTOR 4 pour représenter des quaternions, où les composants X, Y et Z sont la partie vectorielle et le composant W est la partie scalaire.

Les angles sont mesurés dans le sens des aiguilles d’une montre lorsque vous regardez le long de l’axe de rotation vers l’origine. Il s’agit d’un système de coordonnées gaucher. Pour utiliser des coordonnées à droite, annulez les trois angles.

L’ordre des transformations est d’abord roll, puis pitch, puis yaw. Les rotations sont toutes appliquées dans le cadre de coordonnées global.

Notes

Cette fonction prend les angles de l’axe X, de l’axe Y et de l’axe Z comme paramètres d’entrée. L’affectation des étiquettes pitch à l’axe des X, lacet à l’axe y et roll à l’axe z est une tâche courante pour les jeux et les graphiques par ordinateur, car elle correspond aux systèmes de coordonnées « view » classiques. Il existe bien sûr d’autres façons d’attribuer ces étiquettes lors de l’utilisation d’autres systèmes de coordonnées (par exemple, roll peut être l’axe des X, tanger l’axe y et yaw l’axe z).

Configuration requise pour la plateforme

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 avec le Kit de développement logiciel (SDK) Windows pour Windows 8. Pris en charge pour les applications de bureau Win32, les applications du Windows Store et Windows Phone 8 applications.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête directxmath.h

Voir aussi

Fonctions quaternion de la bibliothèque DirectXMath