XMVectorATan2-Funktion (directxmath.h)

Artikel
02/29/2024

Berechnet den Arctangent von Y/X.

Syntax

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

Parameter

[in] Y

Erster Vektor.

[in] X

Zweiter Vektor.

Rückgabewert

Gibt einen Vektor zurück. Jede Komponente ist das Arktangent der entsprechenden Y-Komponente geteilt durch die entsprechende X-Komponente . Jede Komponente befindet sich im Bereich (-PI/2, PI/2).

XMVectorATan2 gibt die folgenden Werte für die angegebenen speziellen Eingabewerte zurück.

Eingabewert	Rückgabewert
Y == 0 und X < 0	Pi mit demselben Vorzeichen wie Y
Y == 0 und X > 0	0 mit demselben Vorzeichen wie Y
Y != 0 und X == 0	Pi / 2 mit demselben Vorzeichen wie Y
X == - Unendlichkeit und Y ist endlich	Pi mit demselben Vorzeichen wie Y
X == + Unendlichkeit und Y ist endlich	0 mit demselben Vorzeichen wie Y
Y == Unendlichkeit und X ist endlich	Pi / 2 mit demselben Vorzeichen wie Y
Y == Unendlichkeit und X == -Unendlichkeit	3Pi / 4 mit demselben Vorzeichen wie Y
Y == Unendlichkeit und X == +Unendlich	Pi / 4 mit demselben Vorzeichen wie Y

Hinweise

Diese Funktion verwendet eine Minimax-Näherung von 17 Grad.

Plattformanforderungen

Microsoft Visual Studio 2010 oder Microsoft Visual Studio 2012 mit dem Windows SDK für Windows 8. Unterstützt für Win32-Desktop-Apps, Windows Store-Apps und Windows Phone 8-Apps.