XMVectorATan2 函式 (directxmath.h)

發行項
02/26/2024

計算 Y/X 的反正切值。

語法

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

參數

[in] Y

第一個向量。

[in] X

第二個向量。

傳回值

傳回向量。每個元件都是相對應的 Y 元件的反正切值，除以對應的 X 元件。每個元件都位於 (-PI/2、PI/2) 範圍內。

XMVectorATan2 會傳回指定之特殊輸入值的下列值。

輸入值	傳回值
Y == 0 和 X < 0	與 Y 相同的符號 Pi
Y == 0 和 X > 0	與 Y 相同的符號 0
Y ！= 0 和 X == 0	Pi / 2 與 Y 相同的符號
X == -Infinity 和 Y 是有限的	與 Y 相同的符號 Pi
X == +Infinity 且 Y 有限	與 Y 相同的符號 0
Y == 無限大且 X 有限	Pi / 2 與 Y 相同的符號
Y == Infinity 和 X == -Infinity	3Pi / 4 與 Y 相同的符號
Y == Infinity 和 X == +Infinity	Pi / 4 與 Y 相同的符號

備註

此函式使用 17 度 minimax 近似值。

平臺需求

Microsoft Visual Studio 2010 或 Microsoft Visual Studio 2012 搭配 Windows SDK for Windows 8。支援 Win32 傳統型應用程式、Windows 市集應用程式和 Windows Phone 8 個應用程式。

規格需求

需求	值
目標平台	Windows
標頭	directxmath.h (包含 DirectXMath.h)

另請參閱

超量向量函式

XMVectorATan2Est

XMVectorATanEst