DESCRIPTION.

Modifie le cap, axe de rotation, donnant la direction de la tortue graphique.

SYNTAXE.

Valeur = turtle.setheading ( angle )

Valeur = ⇨ variable qui recevra la valeur [ optionnel ]

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

angle ⇨ valeur angulaire de la rotation [ OBLIGATOIRE ]

ou

Valeur = TOR_Tortue.setheading ( angle )

Valeur = ⇨ variable qui recevra la valeur [ optionnel ]

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

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

angle ⇨ valeur angulaire de la rotation [ OBLIGATOIRE ]

REMARQUES.

angle doit être une valeur numérique, int ( ) ou float ( ), quelconque mais valide. Si angle est négatif, le cap est modifier dans le sens inverse. Si angle est supérieur à la valeur d'une résolution complète d'un cercle, il est ramené à une valeur équivalente dans une résolution simple.

Par défaut, la valeur de angle s'exprime en degrés angulaires, mais il est possible de choisir une valeur en radians si l'on utilise au préalable la méthode turtle.radians ( ).

Le cap, c'est-à-dire l'orientation, de la tortue graphique est relatif au mode des axes dans lequel elle é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.

La méthode turtle.left ( ) modifie la cap de la tortue graphique vers la gauche. 

La méthode turtle.right ( ) modifie la cap de la tortue graphique vers la droite. 

La méthode turtle.heading ( ) retourne le cap actuel de la tortue graphique.

Les méthodes turtle.setheading ( ) et turtle.seth ( ) sont des synonymes qui peuvent être employés indifféremment.

La méthode turtle.setheading ( ) 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 )." )