Fonction XMVectorATan2Est (directxmath.h)

Article
08/23/2023

Estime l’arctangente de Y/X.

Syntaxe

XMVECTOR XM_CALLCONV XMVectorATan2Est(
  [in] FXMVECTOR Y,
  [in] FXMVECTOR X
) noexcept;

Paramètres

[in] Y

Premier vecteur.

[in] X

Deuxième vecteur.

Valeur retournée

Retourne un vecteur. Chaque composant est une estimation de l’arctangente du composant Y correspondant divisé par le composant X correspondant. Chaque composant se trouve dans la plage (-PI/2, PI/2).

XMVectorATan2Est retourne les valeurs suivantes pour les valeurs d’entrée spéciales spécifiées.

Valeur d'entrée	Valeur renvoyée
Y == 0 et X < 0	Pi avec le même signe que Y
Y == 0 et X > 0	0 avec le même signe que Y
Y != 0 et X == 0	Pi / 2 avec le même signe que Y
X == -Infini et Y est fini	Pi avec le même signe que Y
X == +Infini et Y est fini	0 avec le même signe que Y
Y == Infini et X est fini	Pi / 2 avec le même signe que Y
Y == Infini et X == -Infini	3Pi / 4 avec le même signe que Y
Y == Infini et X == +Infini	Pi / 4 avec le même signe que Y

Notes

Est les fonctions offrent des performances accrues au détriment d’une précision réduite. Est les fonctions conviennent aux calculs non critiques où la précision peut être sacrifiée pour la vitesse. La quantité exacte de perte de précision et d’augmentation de la vitesse dépend de la plateforme.

Cette fonction utilise une approximation minimale de 9 degrés.

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.