MathArctan2

Возвращает в радианах значение угла, тангенс которого равен отношению двух указанных чисел.

double  MathArctan2(
   double  y      // y-координата точки
   double  x      // x-координата точки
   );

Параметры

y

[in]  Число, представляющее координату Y.

x

[in]  Число, представляющее координату X.

Возвращаемое значение

MathArctan2 возвращает значение угла θ в диапазоне от -π до π радиан, так что MathTan(θ)=y/x.

Обратите внимание на следующее:

  • Для (x, y) в квадранте 1, 0 < θ < π/2
  • Для (x, y) в квадранте 2, π/2 < θ≤π
  • Для (x, y) в квадранте 3, -π < θ < -π/2
  • Для (x, y) в квадранте 4, -π/2 < θ < 0

Для точек за пределами указанных квадрантов возвращаемое значение указано ниже:

  • Если y равно 0, и x не является отрицательным, то θ = 0.
  • Если y равно 0, и x является отрицательным, то θ = π.
  • Если y — положительное число, а x равно 0, то θ = π/2.
  • Если y — отрицательное число, а х равно 0, то θ = -π/2.
  • Если y равен 0, и х равен 0, то θ = 0.

Примечание

Вместо функции MathArctan2() можно использовать функцию atan2().