DESCRIPTION.

Définit, ou retourne, la motrice de transformation de la tortue graphique.

SYNTAXE.

turtle.shapetransform ( debut_1 , fin_1 , debut_2 , fin_2 )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

debut_1 ⇨ début de la première ligne [ optionnel ]

fin_1 ⇨ début de la première ligne [ optionnel ]

debut_2 ⇨ début de la deuxième ligne [ optionnel ]

fin_2 ⇨ début de la deuxième ligne [ optionnel ]

ou

TOR_Tortue.shapetransform ( debut_1 , fin_1 , debut_2 , fin_2 )

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

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

debut_1 ⇨ début de la première ligne [ optionnel ]

fin_1 ⇨ début de la première ligne [ optionnel ]

debut_2 ⇨ début de la deuxième ligne [ optionnel ]

fin_2 ⇨ début de la deuxième ligne [ optionnel ]

REMARQUES.

debut_1, fin_1, debut_2 et fin_2 doivent être des valeurs numériques, tel que des int ( ) ou des float ( ), quelconques mais valides. Ils définissent la matrice de transformation de la forme de la tortue graphique appelante. La première ligne de la matrice va de debut_1 à fin_1 et la deuxième ligne va de debut_2 à fin_2. 

Si au moins l'un de ses arguments est donné, les autres doivent l'être aussi.

Si tous les attributs sont donnés, l'appel de la méthode turtle.shapetransform ( ) modifiera le facteur d'étirement, le facteur de cisaillement et l'angle d'inclinaison de la tortue graphique appelante en fonction de la nouvelle matrice.

Dans tous les cas ( debut_1 x fin_2 ) - ( debut_2 x fin_1 ) doit être différent de 0 sinon Python lèvera une exception.

Si tous les attributs sont absents, l'appel de la méthode turtle.shapetransform ( ) retourne un tuple ( ) de 4 éléments, donnant les caractéristiques de la matrice de transformation actuellement en cour pour la tortue appelante.

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

EXEMPLE.

import turtle

turtle.Turtle ( )

print ( turtle.shapetransform ( ) )

turtle.shape ( "turtle" )

print ( turtle.shapetransform ( ) )

turtle.shapesize ( 6 , 5 )

print ( turtle.shapetransform ( ) )

turtle.shearfactor ( .75 )

print ( turtle.shapetransform ( ) )

turtle.shapetransform ( 2 , 2.5 , 1.5 , 3 )

print ( turtle.shapetransform ( ) )