ATan2()

Syntaxe

Resultat.f(d) = ATan2(X.f(d), Y.f(d))
Description
Renvoie l'angle formé par la droite qui passe par (X;Y) et par l'origine (0;0) d'une part et par l'axe des abscisses (axe des X) d'autre part.

Arguments

X.f ou X.d, Y.f ou Y.d Nombres à virgule flottante (float ou double)

Valeur de retour

Renvoie l'angle en radian.

Le résultat est toujours compris entre - #PI et + #PI.

ATTENTION: Si X et Y sont égaux à zéro alors la commande renvoie zéro au lieu de lever une erreur de type 'division par zéro'.

Remarques

La valeur renvoyée peut être transformée en degré en utilisant la fonction Degree().

C'est la fonction réciproque de Tan()

L'intérêt de cette fonction et qu'elle prend en compte le signe des deux coordonnées x, y et place l'angle dans le bon quadrant. Ainsi, atan2(1, 1) = PI/4 et atan2(-1, -1) = -3 x PI/4 contrairement à ATan() qui renverrait PI/4 dans les deux cas.

C'est utile pour calculer des angles entre des lignes en 2D, ou pour transformer des coordonnées rectangulaires en coordonnées polaires.

Exemple

  Debug ATan2(0, 0)    ; Affiche 0.0 au lieu de lever une alerte division par zéro.
  Debug ATan2(1, 1)    ; Affiche #PI/4   (45 degrés)
  Debug ATan2(-1, 1)   ; Affiche 3#PI/4  (135 degrés)
  Debug ATan2(-1, -1)  ; Affiche -3#PI/4 (5#PI/4, 225 degrés) 
  Debug ATan2(1, -1)   ; Affiche -#PI/4  (7#PI/4 315 degrés)
  Debug ATan2(1, 0)    ; Affiche 0.0

Voir aussi

ATan(), Degree()

OS Supportés

Tous

<- ATan() - Math Index - ATanH() ->