DESCRIPTION.

Précise que les déplacements de la tortue graphique suivants formeront les bords d'un polygone.

SYNTAXE.

turtle.begin_poly ( )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

ou

TOR_Tortue.begin_poly ( )

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

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

REMARQUES.

La construction d'une figure géométrique commence avec l'appel de la méthode turtle.begin_poly ( ), et se termine avec l'appel de la méthode turtle.end_poly ( ). Entre ces 2 appels, tous les déplacements de la tortue graphique seront pris en compte pour délimiter la figure géométrique.

Si besoin un segment reliant la première position de la tortue graphique et sa dernière position sera ajouté afin de fermer la figure, mais, dans ce cas il ne sera pas visible, comme si le crayon de la tortue graphique était levé.

Si un nouvel appel de la méthode turtle.begin_poly ( ) est rencontrer dans le script, avant un appel de la méthode turtle.end_poly ( ), l'appel précédent de la méthode turtle.begin_fill ( ) est annulé, et aucun polygone ne sera créé pour ce premier appel de la méthode, mais aucune exception ne sera levée par Python.

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 polygone dont la surface intérieure sera coloriée, il faut utiliser la séquence turtle.begin_fill ( ) / turtle.end_fill ( ). Pour obtenir un cercle, ou un polygone régulier, il faut utiliser la méthode turtle.circle ( ).

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

for krotation in range ( 4 ) :

turtle.forward ( 40 )

turtle.right ( 72 )

turtle.end_poly ( )

turtle.penup ( )

turtle.home ( )

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

turtle.begin_poly ( )

for krotation in range ( 5 ) :

turtle.forward ( 40 )

turtle.left ( 60 )

turtle.end_poly ( )

turtle.penup ( )

turtle.goto ( 75 , 75 )

turtle.pendown ( )

turtle.begin_poly ( )

for krotation in range ( 4 ) :

turtle.forward ( 50 )

turtle.left ( 90 )

turtle.end_poly ( )