Visit Mozilla.org

Référence de JavaScript 1.5 Core:Objets globaux:Math:atan2

Un article de MDC.


Sommaire

[modifier] Sommaire

Retourne l'arctangente du quotient de ses arguments.

Propriété de Math
Statique
Implémenté depuis : JavaScript 1.0, NES 2.0
Version ECMAScript : ECMA-262

[modifier] Syntaxe

Math.atan2(y, x)

[modifier] Paramètres

y, x 
2 nombres.

[modifier] Description

La méthode atan2 retourne une valeur numérique entre -Pi et Pi représentant l'angle Θ d'un point de coordonnées polaires x,y. C'est l'angle, dans le sens inverse des aiguilles d'une montre, exprimé en radians, entre l'axe positif X et le point (x,y). Notez que les arguments de cette fonction passent la coordonnée y en premier, suivie par la coordonnée x.

2 arguments séparés x et y sont passés à atan2 et le ratio de ces 2 arguments est passé à atan.

atan2 est une méthode statique de Math, aussi vous pouvez l'utiliser avec Math.atan2(), plutôt que comme une méthode d'un objet Math que vous auriez créé.


[modifier] Exemples

[modifier] Exemple : Utilisation de Math.atan2

La fonction suivante retourne l'angle de coordonnées polaires :

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

Si vous passez à getAtan2 la valeur (90,15), elle retourne 1.4056476493802699, si vous lui passez la valeur (15,90), elle retourne 0.16514867741462683.

Math.atan2( ±0, -0 ) retourne ±Pi.
Math.atan2( ±0, +0 ) retourne ±0.
Math.atan2( ±0, x ) retourne ±Pi pour x < 0.
Math.atan2( ±0, x ) retourne ±0 pour x > 0.
Math.atan2( y, ±0 ) retourne -Pi/2 pour y > 0.
Math.atan2( ±y, -Infinity ) retourne ±Pi pour y fini > 0.
Math.atan2( ±y, +Infinity ) retourne ±0 pour y fini > 0.
Math.atan2( ±Infinity, +x ) retourne ±Pi/2 pour x fini.
Math.atan2( ±Infinity, -Infinity ) retourne ±3*Pi/4.
Math.atan2( ±Infinity, +Infinity ) retourne ±Pi/4.

[modifier] Voir également

acos, asin, atan, cos, sin, tan