DESCRIPTION.

Définit les caractéristiques du crayon et du comportement de la tortue graphique.

SYNTAXE.

turtle.pen ( attribut1 = valeur , ... , attributn = valeur )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

attribut = valeur ⇨ attribut à modifier avec sa nouvelle valeur [ optionnel ]

ou

TOR_Tortue.pen ( attribut1 = valeur , ... , attributn = valeur )

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

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

attribut = valeur ⇨ attribut à modifier avec sa nouvelle valeur [ optionnel ]

REMARQUES.

Les attributs doivent toujours être nommés mais peuvent être placés dans n'importe quel ordre. Ils peuvent être :

fillcolor = couleur, définit la couleur de remplissage des figures (équivaut à la méthode turtle.fillcolor ( )).

couleur peut être :

- un str ( ), représentant le nom normalisé d'une couleur ;

- un str ( ), où chaque couleur primaire est exprimées de 00 à ff en hexadécimale ;

- un tuple ( ), où chaque couleur primaire est exprimée par un int ( ) de 0 à 255.

outline = bordure, définit l'épaisseur du contour de la tortue (équivaut à turtle.shapesize ( outline = bordure )).

bordure doit être une valeur numérique, tel qu'un int ( ), quelconque mais valide.

pencolor = couleur, définit la couleur du trait (équivaut à la méthode turtle.pencolor ( )).

couleur peut être :

- un str ( ), représentant le nom normalisé d'une couleur ;

- un str ( ), où chaque couleur primaire est exprimées de 00 à ff en hexadécimale ;

- un tuple ( ), où chaque couleur primaire est exprimée par un int ( ) de 0 à 255.

pendown = status, définit la position du crayon de la tortue.

status doit être un bool ( ), quand :

- pendown = True, le crayon de la tortue est baissé (équivaut à la méthode turtle.pendown ( )); 

- pendown = False,le crayon de la tortue est levé (équivaut à la méthode turtle.penup ( )).

pensize = epaisseur, définit l'épaisseur du trait du crayon (équivaut à la méthode turtle.pensize ( )).

epaisseur doit être une valeur numérique, tel qu'un int ( ), quelconque mais valide.

resizemode = mode, définit le mode de redimensionnement de la tortue (équivaut à la méthode turtle.resizemode ( )).

mode doit être un str ( ), quand :

- resizemode = "auto", la tortue est redimensionnée automatiquement ;

- resizemode = "noresize", la tortue ne sera pas redimensionnée ;

- resizemode = "user", il sera en fonction de l'attribut stretchfactor ou définit avec turtle.shapesize ( ).

shown = visible, définit si la tortue est visible ou non.

visible doit être un bool ( ), quand :

- shown = True, la forme de la tortue est visible sur la toile (équivaut à la méthode turtle.showturtle ( )) ;

- shown = False, la tortue est cachée (équivaut à la méthode turtle.hideturtle ( )).

speed = vitesse, définit la rapidité des déplacements de la tortue (équivaut à la méthode turtle.speed ( )).

vitesse peut être l'un str ( ), suivant, ou son homologue numérique représenté par un int ( ) entre 0 et 10 :

- speed = "slowest", ou speed = 1, pour des déplacements très lent ;

- speed = "slow", ou speed = 3, pour des déplacements lent ;

- speed = "normal", ou speed = 6, pour des déplacements standard ;

- speed = "fast", ou speed = 10, pour des déplacements rapide ;

- speed = "fastest", ou speed = 0, pour des déplacements très rapide.

stretchfactor = facteurs, définit les facteurs d'étirements lors de son redimensionnement.

facteurs doit être l'un tuple ( ) de deux  int ( ) positifs et ayant la forme ( largueur , hauteur ) où :

 - largueur, est le facteur d'étirement de la tortue en largeur (équivaut turtle.shapesize ( stretch_wid = largueur )

 - hauteur, est le facteur d'étirement de la tortue en largeur (équivaut turtle.shapesize ( stretch_len = hauteur )

tilt = angle, définit la rotation d'aspect de la tortue sans modification de son cap (équivaut à la méthode turtle.tilt ( )).

facteurs doit être une valeur numérique, tel qu'un int ( ), quelconque mais valide.

Comme indiqué dans leur description, la valeur de chacun de ces attributs peut être modifiée, ou retournée, avec des méthodes spécifiques qui leur sont dédiées.

Il est aussi possible de donner un dict ( ) comme unique argument, ou certains attributs suivi d'un dict ( ) pour certains autres, mais les paires attribut:valeur contenues dans le dict ( ) doivent toutes être valide pour la méthode turtle.pen ( ).

Utilisé sans aucune paire attribut = valeur, l'appel de la méthode turtle.pen ( ) retourne un dict ( ) avec toutes les paires attribut:valeur.

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

EXEMPLE.

import turtle

DCT_Crayon = { "pensize" : 4 , "speed" : 8 , "pencolor" : "blue" , "fillcolor" : "pink" }

turtle.home ( )

turtle.pen ( pensize = 10 , speed = 3 , pencolor = "red" , fillcolor = "yellow" )

turtle.begin_fill ( )

turtle.circle ( 150 , 360 , 8 )

turtle.end_fill ( )

print ( turtle.pen ( ) )

turtle.pen ( DCT_Crayon )

turtle.begin_fill ( )

turtle.circle ( 75 , 360 , 6 )

turtle.end_fill ( )

print ( turtle.pen ( ) )