DESCRIPTION.

Définit, ou retourne, le fichier image qui sera placé comme fond sur la zone sur laquelle se trouve la tortue graphique.

SYNTAXE.

turtle.bgpic ( fichier )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

fichier ⇨ nom du fichier image [ optionnel ]

ou

TOR_Tortue.screen.bgpic ( fichier )

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

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

fichier ⇨ nom du fichier image [ optionnel ]

REMARQUES.

fichier peut être : 

- un str ( ) précisant le nom d'un fichier image qui sera placé comme fond de la zone où évolue la tortue graphique ;

- "nopic" pour supprimer l'image de la toile ;

- None ( ), ou absent, pour retourné le nom du fichier actuellement en fond de zone ;

Le fichier image désigné par l'appel de la méthode turtle.bgpic ( ) doit être le nom, absolu ou relatif, d'un fichier fournir des données d'image polychrome. Le format de fichier doit être l'un de ceux pour lesquels il existe un gestionnaire de format de fichier image capable de lire ces données.

Il est recommandé d'utiliser la méthode turtle.update ( ), qui force la mise à jour de la zone, après l'appel de la de la méthode turtle.bgpic ( ).

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

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

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