DESCRIPTION.

Définit une nouvelle forme, aspect, pour les tortues graphiques et l'ajoute aux catalogue des formes disponibles.

SYNTAXE.

turtle.addshape ( identifiant , definition )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

identifiant ⇨ nom de la nouvelle forme [ OBLIGATOIRE ]

definition ⇨ sommets du polygone de la nouvelle forme [ OBLIGATOIRE ]

ou

TOR_Tortue.screen.addshape ( identifiant , definition )

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

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

identifiant ⇨ nom de la nouvelle forme [ OBLIGATOIRE ]

definition ⇨ sommets du polygone de la nouvelle forme [ OBLIGATOIRE ]

REMARQUES.

identifiant doit être un str ( ) : 

- quelconque mais valide, qui sera utilisée pour nommer la nouvelle forme ;

- un fichier image de type .gif existant.

definition peut être : 

- None ;

- un objet e type turlte.sharpe ( ) ;

- un tuple ( ) composée de tuple ( ), de deux éléments de la forme ( abscisse , ordonnee ), désignant les sommets d'un polygone.

La méthode turtle.addshape ( identifiant , definition ) peut être appelée de trois façons différentes.

turtle.addshape ( "monfichier.gif" , None ). La nouvelle forme sera affectée aux tortues graphiques par la valeur "monfichier.gif". La forme sera celle du fichier image "monfichier.gif". Le nom du fichier peut être relatif, s'il est dans le même répertoire que le programme, ou absolu, s'il se trouve dans un autre répertoire ou dans un sous répertoire contenant le programme. Comme la méthode attend, obligatoirement, un objet séquence en second paramètre, il faut lui donner la valeur None pour indiquer que celui-la est vide. Ce type de forme reste statique, il ne sera pas tournée pour indiqué la direction de de la tortue graphique.

turtle.addshape ( nom_de_la_forme , tuple ( ) ). La nouvelle forme sera affectée aux tortues graphiques par la valeur nom_de_la_forme. tuple ( ) aura autant d'éléments que le polygone dessinant la nouvelle forme à de sommet. Chacun de ces élément aura la forme ( abscisse , ordonnee ) où abscisse et ordonnee sont des valeurs numériques valide.

turtle.addshape ( nom_de_la_forme , forme ). La nouvelle forme sera affectée aux tortues graphiques par la valeur nom_de_la_forme. forme doit être un objet obtenu avec l'appel de la méthode turlte.sharpe ( ) retournant la définition d'un polygone valide.

Voir la méthode turtle.getshapes ( ) de la classe turtle.TurtleScreen ( ) pour consulter la liste des formes présentent dans le catalogue pour l'aspect de la tortue graphique.

Les méthodes turtle.addshape ( ) et turtle.register_shape ( ) sont des synonymes qui peuvent être employés indifféremment.

La tortue graphique anonyme ne doit pas préfixer cette méthode (turtle.addshape ( )).

Les tortues graphiques nommées devront la préfixer avec .screen (TOR_Tortue.screen.addshape ( )).

Les tortues graphiques indépendantes ne doivent pas utiliser cette méthode.