Fonction XMQuaternionRotationRollPitchYaw (directxmath.h)

Calcule un quaternion de rotation basé sur le tangage, le lacet et le roulis (angles Euler).

Syntaxe

XMVECTOR XM_CALLCONV XMQuaternionRotationRollPitchYaw(
  [in] float Pitch,
  [in] float Yaw,
  [in] float Roll
) noexcept;

Paramètres

[in] Pitch

Angle de rotation autour de l’axe X, en radians.

[in] Yaw

Angle de rotation autour de l’axe y, en radians.

[in] Roll

Angle de rotation autour de l’axe z, en radians.

Valeur retournée

Retourne le quaternion de rotation.

Notes

Les fonctions quaternion DirectXMath utilisent un vecteur XMVECTOR 4 pour représenter les 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 les coordonnées droites, annulez les trois angles.

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

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 à l’axe x, le lacet à l’axe Y et le roulis à l’axe des zs est une affectation courante pour les jeux et les graphiques informatiques, 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 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 SDK Windows pour Windows 8. Pris en charge pour les applications de bureau Win32, les applications du Windows Store et les applications Windows Phone 8.

Spécifications

Plateforme cible	Windows
En-tête	directxmath.h

Voir aussi

Fonctions Quaternion de la bibliothèque DirectXMath