DESCRIPTION.

Retourne le cap de la tortue graphique.

SYNTAXE.

Valeur = turtle.heading ( )

Valeur = ⇨ variable qui recevra la valeur [ optionnel ]

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

.heading ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

ou

Valeur = TOR_Tortue.heading ( )

Valeur = ⇨ variable qui recevra la valeur [ optionnel ]

TOR_Tortue ⇨ instance de la classe turtle.RawTurtle ( ) [ OBLIGATOIRE ]

.heading ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

REMARQUES.

La méthode turtle.heading ( ) retourne un float ( ) exprimant en degrés le cap, c'est-à-dire l'orientation, actuel de la tortue graphique. Ce cap est relatif au mode des axes dans lequel la tortue graphique évolue, définie avec la méthode turtle.Screen.mode ( ). Le cap vaut 0 degré dans le mode : 

- "standard", dans la direction des abscisses positive, vers la droite / l'est, et augment vers la gauche, antihoraire ;

- "logo", dans la direction des ordonnées positif, vers le haut / le nord, et augment vers la droite, horaire ;

- "world", la direction et le sens de l'augmentation sont définis par l'utilisateur, le programme.

Dans le mode "standard", turtle.left ( ) augmente la valeur du cap et turtle.right ( ) la diminue. 

Dans le mode "logo", turtle.left ( ) diminue la valeur du cap et turtle.right ( ) l'augmente.

Voir la méthode turtle.setheading ( ) pour modifier précisément le cap de la tortue graphique.

La méthode turtle.heading ( ) est une méthode commune du module turtle et n'a pas besoin d'être préfixée.

EXEMPLE.

import turtle

turtle.shape ( "turtle" )

turtle.speed ( 1 )

turtle.home ( )

turtle.forward ( 100 )

print ( "Direction 1 :" ,  turtle.heading ( ) , "à la création de la tortue." )

turtle.setheading ( 90 )

turtle.forward ( 80 )

print ( "Direction 2 :" ,  turtle.heading ( ) , "avec setheading ( 90 )." )

turtle.left ( 45 )

turtle.forward ( 30 )

print ( "Direction 3 :" ,  turtle.heading ( ) , "avec left ( 45 )." )

turtle.right ( 30 )

turtle.forward ( 60 )

print ( "Direction 4 :" ,  turtle.heading ( ) , "avec right ( 30 )." )

turtle.setheading ( 234 )

turtle.forward ( 120 )

print ( "Direction 5 :" ,  turtle.heading ( ) , "avec setheading ( 234 )." )