XMVectorATan2Est-Funktion (directxmath.h)

Artikel
08/23/2023

Schätzt den Bogen von Y/X.

Syntax

XMVECTOR XM_CALLCONV XMVectorATan2Est(
  [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 eine Schätzung des Bogens der entsprechenden Y-Komponente geteilt durch die entsprechende X-Komponente . Jede Komponente befindet sich im Bereich (-PI/2, PI/2).

XMVectorATan2Est 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

Est Funktionen bieten eine höhere Leistung auf Kosten einer reduzierten Genauigkeit. Est Funktionen eignen sich für nicht kritische Berechnungen, bei denen die Genauigkeit für die Geschwindigkeit geopfert werden kann. Die genaue Menge der verlorenen Genauigkeit und Geschwindigkeitssteigerung ist plattformabhängig.

Diese Funktion verwendet eine 9-Grad-Minimax-Näherung.

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.