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.