Função XMVectorATan2Est (directxmath.h)

Artigo
08/23/2023

Estima o arcotangente de Y/X.

Sintaxe

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

Parâmetros

[in] Y

Primeiro vetor.

[in] X

Segundo vetor.

Valor retornado

Retorna um vetor. Cada componente é uma estimativa do arctangent do componente Y correspondente dividido pelo componente X correspondente. Cada componente está no intervalo (-PI/2, PI/2).

XMVectorATan2Est retorna os valores a seguir para os valores de entrada especiais especificados.

Valor de entrada	Valor Retornado
Y == 0 e X < 0	Pi com o mesmo sinal que Y
Y == 0 e X > 0	0 com o mesmo sinal que Y
Y != 0 e X == 0	Pi/2 com o mesmo sinal que Y
X == -Infinity e Y é finito	Pi com o mesmo sinal que Y
X == +Infinito e Y é finito	0 com o mesmo sinal que Y
Y == Infinito e X é finito	Pi/2 com o mesmo sinal que Y
Y == Infinito e X == -Infinity	3Pi/4 com o mesmo sinal que Y
Y == Infinito e X == +Infinito	Pi/4 com o mesmo sinal que Y

Comentários

Est as funções oferecem maior desempenho em detrimento da precisão reduzida. Est as funções são apropriadas para cálculos não críticos em que a precisão pode ser sacrificada por velocidade. A quantidade exata de precisão perdida e aumento de velocidade dependem da plataforma.

Essa função usa uma aproximação minimax de 9 graus.

Requisitos da plataforma

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 com o SDK do Windows para Windows 8. Com suporte para aplicativos da área de trabalho Win32, aplicativos da Windows Store e aplicativos Windows Phone 8.