MathArctan2

Retorna em radianos o valor de um ângulo cuja tangente é igual ao quociente de dois números especificados.

double  MathArctan2(
   double  y      // coordenada y do ponto
   double  x      // coordenada x do ponto
   );

Parâmetros

y

[in]  Número representando a coordenada Y.

x

[in]  Número representando a coordenada X.

Valor retornado

MathArctan2 retorna o valor do ângulo θ no intervalo de -π a π radianos, tal que MathTan(θ)=y/x.

Observe o seguinte:

  • Para (x, y) no quadrante 1, 0 < θ < π/2
  • Para (x, y) no quadrante 2, π/2 < θ≤π
  • Para (x, y) no quadrante 3, -π < θ < -π/2
  • Para (x, y) no quadrante 4, -π/2 < θ < 0

Para os pontos fora dos quadrantes indicados, o valor retornado é especificado abaixo:

  • Se y é igual a 0 e x não é negativo, θ = 0.
  • Se y é igual a 0 e x é negativo, θ = π.
  • Se y é um número positivo, e x é igual a 0, θ = π/2.
  • Se y é um número negativo, e x é igual a 0, θ = -π/2.
  • Se y é igual a 0 e x é igual a 0, θ = 0.

Observação

Em vez da função MathArctan2(), pode ser usada a função atan2().