DESCRIPTION.

Fais dessiner un cercle, ou un polygone régulier, à la tortue graphique.

SYNTAXE.

turtle.circle ( rayon , arc , cotes )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

rayon ⇨ rayon du cercle conscrit [ OBLIGATOIRE ]

arc ⇨ portion de la circonférence à tracer [ optionnel ]

cotes ⇨ nombre de côtés du polygone régulier [ optionnel ]

ou

TOR_Tortue.circle ( rayon , arc , cote )

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

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

rayon ⇨  rayon du cercle conscrit [ OBLIGATOIRE ]

arc ⇨ portion de la circonférence à tracer [ optionnel ]

cotes ⇨ nombre de côtés du polygone régulier [ optionnel ]

REMARQUES.

rayon doit être une valeur numérique, int ( ) ou float ( ), quelconque mais valide, exprimé en pas, c'est-à-dire le plus souvent en pixels. Si rayon et positif le cercle sera dessiné dans le sens antihoraire. Le centre du cercle tracé se trouve à rayon pas à gauche de la position de départ tortue graphique.

arc doit être une valeur numérique, int ( ) ou float ( ), compris entre -360  et 360 si le système d'unité est en degrés ; ou entre -2*pi et 2*pi si le système d'unité est en radians. arc  est la portion de la circonférence de la figure qui sera tracé. Si arc est omis toute la circonférence sera tracée par la tortue graphique.

cotes doit être int ( ). cotes indique le nombre de cotés du polygone régulier. Si cotes est omis la tortue graphique dessinera un cercle, sinon si cotes vaut :

- 0, Python lèvera une exception ;

- 1, la tortue graphique ne se déplace pas ;

- 2, la tortue graphique trace un segment de droite (aller-retour) ;

- 3, la tortue graphique trace un triangle équilatérale ;

- 4, la tortue graphique trace un carré ;

- 5, la tortue graphique trace un pentagone ;

- ...

Si cotes est présent alors arc doit une valeur. Si tous les côtés du polygone régulier doivent être tracés, c'est-à-dire visibles, la valeur de arc doit être None.

Notez que : l'orientation, c'est-à-dire la direction, de la tortue graphique est modifiée pour suivre le sens du tracé quel doit effectuer pour dessiner le cercle, ou le polygone régulier.

Si le crayon de la tortue graphique est baissé, turtle.pendown ( ), la bordure de la figure sera visible et aura la couleur définie par le dernier appel de la méthode turtle.pencolor ( ) ou de la méthode turtle.color ( ), sinon, si le crayon a été levé avec turtle.penup ( ), la bordure de la figure ne sera pas visible. 

Pour obtenir un cercle, ou un polygone régulier, dont la surface intérieure est coloriée, l'appel de la méthode turtle.circle ( ) doit être inséré dans une séquence turtle.begin_fill ( ) /  turtle.end_fill ( ).

Pour obtenir des polygone irréguliers, il faut utiliser la séquence : 

- turtle.begin_fill ( ) /  turtle.end_fill ( ). pour des polygones coloriés ;

- turtle.begin_poly ( ) /  turtle.end_poly ( ). pour des polygones vides.

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

EXEMPLE.

import turtle

def FNC_Depart ( ) :

turtle.penup ( )

turtle.goto ( 0 , -200 )

turtle.setheading ( 0 )

turtle.pendown ( )

turtle.pensize ( 5 )

turtle.color ( "blue" )

turtle.fillcolor ( "aqua" )

FNC_Depart ( )

turtle.circle ( 200 )

FNC_Depart ( )

turtle.begin_fill ( )

turtle.circle ( 150 , 270 )

turtle.end_fill ( )

FNC_Depart ( )

turtle.begin_fill ( )

turtle.fillcolor ( "yellow" )

turtle.circle ( 100 , None , 6 )

turtle.end_fill ( )

FNC_Depart ( )

turtle.pencolor ( "orange" )

turtle.circle ( 50 , -240 , 9 )

FNC_Depart ( )

turtle.clear ( )

turtle.begin_fill ( )

turtle.fillcolor ( "blue" )

turtle.circle ( 200 )

turtle.end_fill ( )

turtle.begin_fill ( )

turtle.fillcolor ( "yellow" )

turtle.circle ( 150 )

turtle.end_fill ( )

turtle.begin_fill ( )

turtle.fillcolor ( "red" )

turtle.circle ( 100 )

turtle.end_fill ( )

turtle.begin_fill ( )

turtle.fillcolor ( "magenta" )

turtle.circle ( 50 )

turtle.end_fill ( )