Visit Mozilla.org

Dokumentacja języka JavaScript 1.5:Obiekty:Math:atan2

z Mozilla Developer Center, polskiego centrum programistów Mozilli.


Spis treści

[edytuj] Podsumowanie

Zwraca kąta (w radianach) utworzony przez oś OX i prostą przechodzącą przez punkt o podanych współrzędnych.

Metoda obiektu: Math

statyczna

Zaimplementowana w: JavaScript 1.0, NES 2.0
Wersja ECMA: ECMA-262

[edytuj] Składnia

Math.atan2(y, x)

[edytuj] Parametry

y, x 
liczby.

[edytuj] Opis

Metoda atan2 zwraca wartość liczbową pomiędzy -pi a pi, reprezentującą kąt theta punktu (x,y). Kąt ten, mierzony w radianach, został utworzony przez dodatnią oś OX i punkt (x,y), z obrotem w kierunku przeciwnym do ruchu wskazówek zegara. Należy zwrócić uwagę na to, że pierwszym argumentem tej funkcji jest współrzędna y, a x jest argumentem drugim.

Do metody atan2 przekazywane są osobno argumenty x i y, podczas gdy do metody atan przekazywany jest stosunek tych dwóch wartości.

Ponieważ atan2 jest statyczną metodą obiektu Math, zawsze odwołujemy się do niej poprzez Math.atan2(), a nie jak do metody instancji obiektu Math utworzonej przez użytkownika.

[edytuj] Przykłady

[edytuj] Przykład: Zastosowanie Math.atan2

Poniższa funkcja zwraca kąt o polarnych współrzędnych:

function getAtan2(x,y) {
   return Math.atan2(x,y)
}

Jeśli funkcji getAtan2 przekazane zostaną wartości (90,15), zwróci ona 1.4056476493802699; jeśli przekazane zostaną jej wartości (15,90), zwróci 0.16514867741462683.

[edytuj] Zobacz także

acos, asin, atan, cos, sin, tan