PRESENTATION DU MODULE TURTLE.

Le module turtle simule le déplacement d'une tortue virtuelle, dont la trace crée des figures et des graphismes.

turtle est un module de la bibliothèque standard de Python 3. Il est donc toujours disponible.

UTILISATION DU MODULE TURTLE. 

Si vous utilisez la tortue anonyme (turtle.), vous pouvez appelez les méthodes des classes turtle.Screen ( ) et turtle.RawTurtle ( ) directement. Par exemple :

- turtle.forward ( 100 ), pour faire avancer la tortue de 100 pas ;

- turtle.title ( "Mon titre" ), pour modifier le titre de la fenêtre.

Si vous souhaitez utiliser plusieurs tortues pour réaliser des figures indépendantes (TOR_MaTortueA = turtle.Turtle ( )), vous pouvez appelez les méthodes : 

- de la classe turtle.RawTurtle ( ) directement (ex.: TOR_MaTortueA.forward ( 100 )) ;

- de la classe turtle.Screen ( ) indirectement par la méthode turtle.screen ( ) (ex.: TOR_MaTortueA.screen.title ( "Mon titre" )).

Aller à tutoriel du module turtle.

LISTE DES METHODES DE LA CLASSE TURTLE. 

back ( ) : similaire à backward ( ).

backward ( ) : fait reculer la tortue du nombre de pas indiqués.

begin_fill ( ) : débute la création d'un polygone qu'il faudra colorier.

begin_poly ( ) : débute la création d'un polygone.

bk ( ) : similaire à backward ( ).

circle ( ) : trace un cercle ou un polygone régulier.

clear ( ) : efface les dessins réalisés par la tortue appelante.

clearstamp ( ) : efface de la toile et supprime une empreinte de la tortue.

clearstamps ( ) : efface plusieurs empreintes de l'aspect de la tortue.

clone ( ) : crée une nouvelle tortue en copiant une tortue existante.

color ( ) : définit ou retourne la couleur du bord et de remplissage des figures.

degrees ( ) : définit la quantité de sections composant d'un cercle complet.

distance ( ) : retourne le nombre de pas entre un point et la tortue.

dot ( ) : dessine un point aux coordonnées de la tortue.

down ( ) : similaire à pendown ( ).

end_fill ( ) : termine et ferme un polygone puis colorie l'intérieur.

end_poly ( ) : termine et ferme un polygone sans colorier l'intérieur.

fd ( ) : similaire à forward ( ).

fillcolor ( ) : définit la couleur de remplissage des figures.

filling ( ) : teste si la tortue dessine un polygone à colorier.

forward ( ) : fait avancer la tortue du nombre de pas indiqués.

get_poly ( ) : retourne les sommets du dernier polygone dessiné par la tortue.

get_shapepoly ( ) : retourne les sommets du polygone dessinant la tortue.

getpen ( ) : similaire à getturtle ( ).

getscreen ( ) : retourne l'identification de la zone de dessin de la tortue.

getturtle ( ) : retourne l'identification de la tortue.

goto ( ) : déplace la tortue aux coordonnées indiquées.

heading ( ) : retourne le cap angulaire actuel de la tortue.

hideturtle ( ) : cache la tortue.

home ( ) : replace la tortue au point d'origine et dans l'axe par défaut.

ht ( ) : similaire à hideturtle ( ).

isdown ( ) : teste si le crayon de la tortue est baisser.

isvisible ( ) : teste si la tortue est visible.

left ( ) : fait pivoter la tortue vers la gauche.

lt ( ) : similaire à left ( ).

onclick ( ) : associe l'exécution d'une fonction à un clique de souris sur la tortue.

ondrag ( ) : associe l'exécution d'une fonction au cliquer-glisser de souris sur la tortue.

onrelease ( ) : associe l'exécution d'une fonction au relechement d'un bouton de souris.

pd ( ) : similaire à pendown ( ).

pen ( ) : définit ou retourne les caractéristiques du crayon de la tortue.

pencolor ( ) : définit ou retourne la couleur du crayon de la tortue.

pendown ( ) : baisse le crayon de la tortue pour dessiner.

pensize ( ) : définit ou retourne l'épaisseur du crayon.

penup ( ) : relève le crayon de la tortue et arrête de dessiner.

pos ( ) : similaire à position ( ).

position ( ) : retourne les coordonnées de la tortue.

pu ( ) : similaire à penup ( ).

radians ( ) : passe la mesure des angles en radians.

reset ( ) : réinitialise la tortue et son crayon aux valeurs par défaut.

resizemode ( ) : définit ou retourne le mode de redimensionnement de la tortue.

right ( ) : fait pivoter la tortue vers la droite.

rt ( ) : similaire à right ( ).

seth ( ) : similaire à setheading ( ).

setheading ( ) : modifie le cap (axe de rotation) de la représentation de la tortue.

setpos ( ) : similaire à goto ( ).

setposition ( ) : similaire à goto ( ).

settiltangle ( ) : obsolète. Fait pivoter la représentation de la tortue sans modifier son cap.

setundobuffer ( ) : autorise l'annulation des actions de la tortue.

setx ( ) : modifie l'abscisse de la tortue.

sety ( ) : modifie l'ordonnée de la tortue.

shape ( ) : modifie ou retourne l'aspect visuel de la tortue.

shapesize ( ) : définit les facteurs d'étirement personnalisés de la tortue.

shapetransform ( ) : modifie le quadrilatère contenant la forme de la tortue.

shearfactor ( ) : modifie l'axe médian du quadrilatère contenant la forme de la tortue.

showturtle ( ) : affiche la tortue.

speed ( ) : modifie la vitesse des mouvements de la tortue.

st ( ) : similaire à showturtle ( ).

stamp ( ) : dessine une empreinte de l'aspect de la tortue aux coordonnées courantes.

tilt ( ) : augmente l'angle de rotation de la représentation de la tortue.

tiltangle ( ) : définie l'angle de rotation de la représentation de la tortue.

towards ( ) : retourne l'angle entre l'axe d'origine et un vecteur précisé partant de la tortue.

turtlesize ( ) : similaire à shapesize ( ).

undo ( ) : annule l'action précédente de la tortue.

undobufferentries ( ) : retourne le nombre actions présentes dans la pile d'annulation.

up ( ) : similaire à penup ( ).

width ( ) : similaire à pensize ( ).

write ( ) : insère un texte depuis les coordonnées de la tortue.

xcor ( ) : retourne l'abscisse de la tortue.

ycor ( ) : retourne l'ordonnée de la tortue.

LISTE DES METHODES DE LA CLASSE SCREEN. 

addshape ( ) : définie et ajoute de nouvelles formes pour les tortue.

bgcolor ( ) : définie, ou retourne, la couleur de fond de la zone de dessin.

bgpic ( ) : définie, ou retourne, l'image de fond de la zone de dessin.

bye ( ) : ferme la zone de dessin et détruit les tortues actives.

clear ( ) : similaire à clearscreen ( ) pour les tortues nommées.

clearscreen ( ) : efface toutes les traces de la zone de dessin.

colormode ( ) : définie la valeur maximale des teintes rouge, vert et bleu à 1.0 ou 255.

delay ( ) : définie l’intervalle entre deux mise à jour du dessin.

done ( ) : similaire à mainloop ( ).

exitonclick ( ) : appel la méthode bye ( ) si l'utilisateur clique sur la zone de dessin.

getcanvas ( ) : retourne l'identifiant de la zone de dessin.

getshapes ( ) : retourne la liste des formes de tortues disponibles.

listen ( ) : donne le focus à la zone de dessin de tortue graphique.

mainloop ( ) : lance le gestionnaire d'événements de la zone de dessin.

mode ( ) : définit le mode d'évolution des tortues.

numinput ( ) : affiche une boite de dialogue attendant une saisie numérique.

onclick ( ) : similaire à onscreenclick ( ) pour les tortue nommées.

onkey ( ) : associe une fonction au relachement d'une touche du clavier par l'utilisateur.

onkeypress ( ) : associe  une fonction à l'appui d'une touche du clavier par l'utilisateur.

onkeyrelease ( ) : similaire à onkey ( ).

onscreenclick ( ) : associe une fonction à un clique de souris sur la toile.

ontimer ( ) : exécute une fonction après un certain temps.

register_shape ( ) : similaire à addshape ( ).

reset ( ) : similaire à resetscreen ( ) pour les tortues nommées.

resetscreen ( ) : réinitialise toutes les tortues aux valeurs de création.

screensize ( ) : étend les dimensions et modifie la couleur de la zone de dessin.

setup ( ) : modifie les dimensions de la fenêtre et déplace les axes des coordonnées.

setworldcoordinates ( ) : définie le système de coordonnées personnalisée de la zone de dessin.

textinput ( ) : Affiche une boite de dialogue attendant une saisie de l'utilisateur.

title ( ) : définie le titre de la fenêtre.

tracer ( ) : définie le nombres de mises à jour consécutives ignorées.

turtles ( ) : retourne la liste des tortues associées à la zone de dessin.

update ( ) : force la mise à jour de la toile.

window_height ( ) : retourne la hauteur de la fenêtre accueillant la zone de dessin.

window_width ( ) : retourne la largeur de la fenêtre accueillant la zone de dessin.