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.txt62
1 files changed, 62 insertions, 0 deletions
diff --git a/doc/manuel_utilisateur.txt b/doc/manuel_utilisateur.txt
index 1316625..9ce625c 100644
--- a/doc/manuel_utilisateur.txt
+++ b/doc/manuel_utilisateur.txt
@@ -437,6 +437,68 @@ sub moved {
2.5 Les animations
------------------
+Une animation est une évolution progressive d'un paramètre d'un objet
+graphique. Les animations proposées sont :
+- changement de transparence
+- changement de position (translation ou parcours complexe)
+- changement de taille
+___________
+MOpacity.pm :
+MOpacity permet de réaliser une animation sur la transparence d'un ou plusieurs
+groupes ou autres objets ayant une propriété nommée "-alpha".
+
+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
+ - from_opacity : valeur initiale de l'opacité au départ de l'animation
+ - to_opacity : valeur de l'opacité à la fin de 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 propriété "-alpha" (c'est le cas des
+ MGroup)
+
+Les valeurs d'opacité vont de 0 (transparent) à 100 (opaque).
+
+Les évènements émis sont :
+ - ANIMATION_END : Notifie la fin de l'annimation
+ - OPACITY_CHANGED : Notifie un changement de valeur de l'opacite au
+ cours de l'animation
+ - ANIMATION_ABORD : Notifie un arrêt prématuré de l'animation
+
+Les évènements OPACITY_CHANGED et ANIMATION_ABORD fournissent la valeur courante
+de l'opacité.
+
+Les fonctions applicables à un objet MOpacity sont :
+ - start : démarre l'animation
+ - stop: arrête l'animation
+ - isRunning : détermine si l'animation est en cours
+
+Exemple d'utilisation :
+use MTools;
+use MTools::GUI::MRect;
+use MTools::GUI::MGroup;
+use MTools::Anim::MOpacity;
+new MTools (800, 600, "Exemple de animation opacity");
+new MTools::GUI::MRect(1, 400, 200, 100, 300, -filled => 1, -fillcolor => red);
+my $group = new MTools::GUI::MGroup (1);
+new MTools::GUI::MRect ($group, 300, 300, 300, 100, -filled => 1);
+my $anim = new MTools::Anim::MOpacity(targets => $group,
+ loop => 1,
+ from_opacity => 0,
+ to_opacity => 100,
+ duration => 1
+ );
+$anim->start();
+mrun;
+________
+MPath.pm :
+__________
+MScalor.pm :
+______________
+MTranslator.pm :
2.6 Les comportements
---------------------