aboutsummaryrefslogtreecommitdiff
path: root/doc/manuel_utilisateur.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/manuel_utilisateur.txt')
-rw-r--r--doc/manuel_utilisateur.txt50
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 :