Documentation de l'animation de transformation homotétique.

1 files changed, 49 insertions, 1 deletions

diff --git a/doc/manuel_utilisateur.txt b/doc/manuel_utilisateur.txt
index 1db8e8a..aa14e85 100644
--- a/doc/manuel_utilisateur.txt
+++ b/doc/manuel_utilisateur.txt
@@ -496,7 +496,8 @@ mrun;
 ________
 MPath.pm :
 MPath permet de réaliser une animation de déplacement suivant un chemin. Le
-chemin est une suite de segments.
+chemin est une suite de segments. L'animation peut porter sur un objet ou un
+tableau d'objets.
 
 La description du chemin est une liste de points (x, y). L'objet se déplace en
 ligne droite d'un point à l'autre. La vitesse de déplacement est régulière tout
@@ -548,6 +549,53 @@ $anim->start();
 mrun;
 __________
 MScalor.pm :
+MScalor permet de realiser une animation de scale (changement de taille).
+
+L'animation de changement de taille permet de réaliser une animation
+homotétique, appliquée à un objet ou à un tableau d'objets. L'homotétie peut
+utiliser des coefficients différents horizontalement et verticalement. Le
+changement de taille peut être pour agrandir ou pour diminuer la taille.
+
+La fonction de création ne nécessite aucun argument. Elle permet de configurer
+toutes les propriétés comme mconfigure.
+
+Les valeurs modifiables par mconfigure sont :
+	- -visible : permet d'activer ou stopper l'animation
+ 	- duration : durée de l'animation (défaut : 1s)
+	- loop : indique le caractère répétitif de l'animation (défaut : faux)
+	- targets : objet ou tableau d'objets cible de cette animation. Ces
+	objets doivent disposer d'une fonction "translate".
+	- center_x, center_y : coordonnées du centre de l'homotétie (coordonnées
+	relatives à la fenêtre)
+	- from_x, to_x : valeurs sans dimension pour définir l'homotétie
+	horizontale
+	- from_y, to_y : valeurs sans dimension pour définir l'homotétie
+	verticale
+
+Les valeurs qui définissent l'homotétie (from et to) n'ont pas d'unité. Par
+exemple pour doubler la taille, on peut mettre comme valeur 1 et 2, tout comme
+on peut mettre 100 et 200. L'utilisation de valeurs de signe opposé a pour effet
+de retourner l'objet.
+
+*** Il y a un problème d'affichage du texte lorsqu'il est retourné
+    horizontalement (il est retourné verticalement à tord).
+
+Les évènements émis sont :
+	- ANIMATION_END : Notifie la fin de l'annimation
+	- SCALED : Notifie un changement de taille au cours de l'animation
+	- ANIMATION_ABORD : Notifie un arrêt prématuré de l'animation
+
+L'évènement ANIMATION_ABORD fournit la valeur courante du facteur d'homotétie en
+x et du facteur en y (compris respectivement dans les intervales [from_x, to_x]
+et [from_y, to_y]).
+L'évènement VALUE_CHANGED fournit les coefficients d'homotétie comme
+ANIMATION_ABORD et fournit en plus les coordonnées du centre d'homotétie.
+
+Les fonctions applicables à un objet MScalor sont :
+	- start : démarre l'animation
+	- stop: arrête l'animation
+	- isRunning : détermine si l'animation est en cours
+
 ______________
 MTranslator.pm :