Fungsi XMVectorATan2 (directxmath.h)

Artikel
08/23/2023

Menghitung arka tangen Y/X.

Sintaks

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

Parameter

[in] Y

Vektor pertama.

[in] X

Vektor kedua.

Nilai kembali

Mengembalikan vektor. Setiap komponen adalah arka tangen dari komponen Y yang sesuai dibagi dengan komponen X yang sesuai. Setiap komponen berada dalam rentang (-PI/2, PI/2).

XMVectorATan2 mengembalikan nilai berikut untuk nilai input khusus yang ditentukan.

Nilai Input	Tampilkan Nilai
Y == 0 dan X < 0	Pi dengan tanda yang sama dengan Y
Y == 0 dan X > 0	0 dengan tanda yang sama dengan Y
Y != 0 dan X == 0	Pi / 2 dengan tanda yang sama dengan Y
X == -Tak terbatas dan Y terbatas	Pi dengan tanda yang sama dengan Y
X == +Tak terbatas dan Y terbatas	0 dengan tanda yang sama dengan Y
Y == Infinity dan X terbatas	Pi / 2 dengan tanda yang sama dengan Y
Y == Infinity dan X == -Infinity	3Pi / 4 dengan tanda yang sama dengan Y
Y == Infinity dan X == +Infinity	Pi / 4 dengan tanda yang sama dengan Y

Keterangan

Fungsi ini menggunakan perkiraan minimax 17 derajat.

Persyaratan Platform

Microsoft Visual Studio 2010 atau Microsoft Visual Studio 2012 dengan Windows SDK untuk Windows 8. Didukung untuk aplikasi desktop Win32, aplikasi Windows Store, dan aplikasi Windows Phone 8.