DESCRIPTION.

Définie, ou retourne, la couleur de la trace réalisée par les déplacements la tortue graphique.

SYNTAXE.

turtle.pencolor ( couleur )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

couleur ⇨ couleur du trait [ optionnel ]

ou

TOR_Tortue.pencolor ( couleur )

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

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

couleur ⇨ couleur du trait [ optionnel ]

REMARQUES.

couleur peut être :

- un str ( ), représentant le nom normalisé d'une couleur (ex. "black", "red", "green") ;

- un str ( ), où chaque couleur primaire est exprimées de 00 à ff en hexadécimale ("#rrvvbb") (ex. "#94bde0") ;

- un tuple ( ), où chaque couleur primaire est exprimée par un int ( ) de 0 à 255 (rouge, vert, bleu) ( ex.  ( 128 , 35 , 15 ) ).

Quand les composants de couleur sont exprimées avec des valeurs numériques, entre 0 et 255, il faut au préalable avoir utilisé la méthode turtle.colormode ( 255 ), héritée de la classe turtle.Screen ( ).

La couleur du crayon de la tortue graphique peut aussi être modifiée avec la méthode turtle.color ( ) et la méthode turtle.pen ( ). 

Utilisé sans argument, l'appel de la méthode turtle.pencolor ( ) retourne les valeurs actuelles de couleur. 

Rappel : Lors d'un déplacement de la tortue graphique, son crayon doit être baissé, turtle.pendown ( ), pour dessiner un trait de la couleur du crayon sur la toile, si le crayon a été levé avec turtle.penup ( ), elle ne laisse aucune trace sur la toile quelque soit sa position d'arrivée. 

La méthode turtle.pencolor ( ), de la classe turtle.RawTurtle ( ), est une méthode commune du module turtle et n'a pas besoin d'être préfixée.

EXEMPLE.

import turtle

turtle.speed ( 1 )

turtle.pensize ( 5 )

turtle.pencolor ( "blue" )

turtle.fillcolor ( "aqua" )

turtle.begin_fill ( )

for krotation in range ( 4 ) :

turtle.forward ( 40 )

turtle.right ( 72 )

turtle.end_fill ( )

turtle.penup ( )

turtle.home ( )

turtle.color ( "red" , "pink")

turtle.begin_fill ( )

for krotation in range ( 5 ) :

turtle.forward ( 40 )

turtle.left ( 60 )

turtle.end_fill ( )

turtle.penup ( )

turtle.goto ( 75 , 75 )

turtle.pendown ( )

turtle.begin_fill ( )

for krotation in range ( 4 ) :

turtle.forward ( 150 )

turtle.right ( 90 )

turtle.end_fill ( )