diff options
Diffstat (limited to 'doc/manuel_utilisateur.txt')
| -rw-r--r-- | doc/manuel_utilisateur.txt | 56 |
1 files changed, 55 insertions, 1 deletions
diff --git a/doc/manuel_utilisateur.txt b/doc/manuel_utilisateur.txt index 9ce625c..255b705 100644 --- a/doc/manuel_utilisateur.txt +++ b/doc/manuel_utilisateur.txt @@ -454,7 +454,7 @@ 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) + - 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 @@ -495,6 +495,60 @@ $anim->start(); mrun; ________ MPath.pm : +MPath permet de réaliser une animation de déplacement suivant un chemin. Le +chemin est une suite de segments. + +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 +au long du trajet. Elle est déterminée par la durée de l'animation. Le premier +point du trajet correspond à l'endroit où se trouve l'objet au départ de +l'animation, il sert donc de point de référence. + +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 + - path : liste des points (x, y) par lesquels il faut passer + - 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". + +Les évènements émis sont : + - ANIMATION_END : Notifie la fin de l'annimation + - VALUE_CHANGED : Notifie un changement de position au cours de + l'animation + - ANIMATION_ABORD : Notifie un arrêt prématuré de l'animation + +Les évènements VALUE_CHANGED et ANIMATION_ABORD fournissent la valeur courante +de la position (x, y) et un vecteur qui donne la direction de déplacement de +l'objet (ce vecteur n'est pas proportionnel à la vitesse). La position est dans +le système de coordonnées définit par le path. + +Les fonctions applicables à un objet MPath sont : + - start : démarre l'animation + - stop: arrête l'animation + - isRunning : détermine si l'animation est en cours + +*** Au moment du "rebouclage" de l'animation, il y a parfois un +clignottement. Voir comment on peut régler ce problème + +Exemple d'utilisation : +use MTools; +use MTools::GUI::MRect; +use MTools::Anim::MPath; +new MTools (800, 600, "Exemple de animation path"); +my $rect = new MTools::GUI::MRect (1, 300, 100, 300, 50, -filled => 1); +my $anim = new MTools::Anim::MPath(targets => $rect, + loop => 1, + duration => 5); +$anim->mconfigure(path => [[0, 0], # point de référence + [100, 300], + [-300, 400], + [0, 0]]); # on retourne au point de départ +$anim->start(); +mrun; __________ MScalor.pm : ______________ |