| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
La classe Tween vous permet, à l'aide d'ActionScript, de déplacer et de redimensionner les clips sur la scène et d'en réaliser un fondu, en définissant une propriété du clip cible afin qu'il soit animé sur un certain nombre d'images ou de secondes.
Cette classe vous permet également de spécifier de nombreuses méthodes d'accélération. Ce terme fait ici référence à une accélération ou une décélération progressive survenant pendant l'animation et destinée à améliorer son réalisme. Le package fl.transitions.easing fournit de nombreuses méthodes contenant des équations correspondant à cette accélération et à cette décélération, qui modifient l'animation d'accélération en conséquence.
Pour utiliser les méthodes et les propriétés de la classe Tween, vous utilisez l'opérateur new avec la fonction constructeur pour créer une occurrence de la classe et vous spécifiez une méthode d'accélération sous forme de paramètre. Exemple :
import fl.transitions.Tween;
import fl.transitions.easing.*;
var myTween:Tween = new Tween(myObject, "x", Elastic.easeOut, 0, 300, 3, true);
public var begin:Number = NaN
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Valeur initiale de la propriété désignée de l'objet cible avant le démarrage de l'interpolation.
duration:Number [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
La durée de l'animation interpolée en images ou en secondes. Cette propriété est définie comme un paramètre lors de la création d'une occurrence Tween ou de l'appel à la méthode Tween.yoyo().
Implémentation
public function get duration():Number
public function set duration(value:Number):void
finish:Number [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Nombre indiquant la valeur de fin de la propriété de l'objet cible à interpoler. Cette propriété est définie sous forme de paramètre lors de la création d'une occurrence Tween ou de l'appel à la méthode Tween.yoyo().
Implémentation
public function get finish():Number
public function set finish(value:Number):void
Voir aussi
FPS:Number [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Nombre d'images par seconde calculé dans l'animation interpolée. Par défaut, la fréquence d'images actuelle de la scène est utilisée pour calculer l'animation interpolée. Définir cette propriété permet de recalculer le nombre d'incréments dans la propriété animée, qui est affichée à chaque seconde sur la propriété Tween.FPS plutôt que sur la fréquence d'images actuelle de la scène. La définition de la propriété Tween.FPS ne modifie pas la fréquence d'images effective de la scène.
Remarque :La propriété Tween.FPS renvoie undefined, à moins que vous ne l'ayez déjà définie de façon explicite.
Implémentation
public function get FPS():Number
public function set FPS(value:Number):void
public var func:Function
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Fonction d'accélération utilisée avec l'interpolation.
public var isPlaying:Boolean = false
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique si l'animation interpolée est en cours de lecture.
public var looping:Boolean = false
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique si l'interpolation doit être exécutée en boucle. Si la valeur est true, l'interpolation redémarre indéfiniment chaque fois qu'elle se termine. Si la valeur est false, l'interpolation n'est lue qu'une fois.
public var obj:Object = null
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Objet cible auquel est appliquée l'interpolation.
position:Number [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Valeur actuelle de la propriété de l'objet cible en cours d'interpolation. Cette valeur est mise à jour avec chaque image dessinée de l'animation interpolée.
Implémentation
public function get position():Number
public function set position(value:Number):void
public var prop:String = ""
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Nom de la propriété affectée par l'interpolation de l'objet cible.
time:Number [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
L'heure actuelle dans la durée de l'animation.
Implémentation
public function get time():Number
public function set time(value:Number):void
public var useSeconds:Boolean = false
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique si la durée de l'interpolation est définie en images ou en secondes. La valeur true entraîne l'animation de l'interpolation pendant un nombre de secondes spécifié dans la propriété duration. La valeur false entraîne l'animation de l'interpolation pendant un nombre d'images.
public function Tween(obj:Object, prop:String, func:Function, begin:Number, finish:Number, duration:Number, useSeconds:Boolean = false)
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Crée une occurrence de la classe Tween. Utilisez la fonction constructeur avec l'opérateur new : var myTween:Tween = new Tween().
Paramètres
| obj:Object — Objet cible de l'interpolation.
|
| |
| prop:String — Nom de la propriété (valeur de paramètre obj) qui sera affectée.
|
| |
| func:Function — Nom de la fonction d'accélération à utiliser.
|
| |
| begin:Number — Valeur de départ du paramètre prop.
|
| |
| finish:Number — Nombre indiquant la valeur de fin du paramètre prop (propriété de l'objet cible à interpoler).
|
| |
| duration:Number — Durée du mouvement ; défini sur infinity si négatif ou omis.
|
| |
| useSeconds:Boolean (default = false) — Indicateur spécifiant l'utilisation de secondes au lieu d'images. La fonction utilise des secondes si la valeur est true ou des images selon la valeur spécifiée dans le paramètre duration si la valeur est false.
|
Voir aussi
public function continueTo(finish:Number, duration:Number):void
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique à l'animation interpolée de poursuivre l'interpolation de son point d'animation actuel à un nouveau point de durée et de fin.
Paramètres
| finish:Number — Nombre indiquant la valeur de fin de la propriété de l'objet cible à interpoler.
|
| |
| duration:Number — Nombre indiquant la durée ou le nombre d'images pour le mouvement d'interpolation ; la durée est mesurée en secondes si le paramètre Tween.start() useSeconds est défini sur true ou en images s'il est défini sur false.
|
Voir aussi
public function fforward():void
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Transmet l'animation interpolée directement à la valeur finale de l'animation interpolée.
public function nextFrame():void
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Transmet l'animation interpolée à la prochaine image d'une animation arrêtée. Utilisez cette méthode pour transmettre une image à la fois d'une animation interpolée après avoir utilisé la méthode Tween.stop() pour l'arrêter.
Remarque : N'utilisez cette méthode que pour les interpolations à base d'images. Une interpolation est définie à base d'images lors de sa création en définissant le paramètre useSeconds sur false.
public function prevFrame():void
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Lit l'image précédente de l'animation interpolée depuis le point d'arrêt actuel d'une animation qui a été arrêtée. Utilisez cette méthode pour lire une animation interpolée en arrière d'une image à la fois après l'avoir arrêtée à l'aide de la méthode Tween.stop().
Remarque : N'utilisez cette méthode que pour les interpolations à base d'images. Une interpolation est définie à base d'images lors de sa création en définissant le paramètre Tween.start() useSeconds sur false.
Voir aussi
public function resume():void
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Reprend la lecture d'une animation interpolée arrêtée. Utilisez cette méthode pour poursuivre une animation interpolée après son arrêt à l'aide de la méthode Tween.stop().
Remarque : N'utilisez cette méthode que pour les interpolations à base d'images. Une interpolation est définie à base d'images lors de sa création en définissant le paramètre useSeconds sur false.
public function rewind(t:Number = 0):void
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Recule la lecture d'une animation interpolée jusqu'à sa valeur de début. Si la méthode Tween.rewind() est appelée pendant la lecture de l'animation interpolée, l'animation est rembobinée jusqu'à sa valeur de début et poursuit la lecture. Si la méthode Tween.rewind() est appelée alors que l'animation interpolée est arrêtée ou a terminé son animation, l'animation interpolée est rembobinée jusqu'à sa valeur de début, et reste arrêtée. Utilisez cette méthode pour rembobiner une animation interpolée à son point de départ une fois que vous l'avez arrêtée en utilisant la méthode Tween.stop() ou pour rembobiner une animation interpolée pendant sa lecture.
Paramètres
| t:Number (default = 0) — Valeur de début.
|
public function start():void
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Démarre la lecture d'une animation interpolée depuis son point de départ. Cette méthode permet de redémarrer une interpolation depuis le début de son animation après son arrêt ou la fin de son animation.
public function stop():void
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Arrête la lecture d'une animation interpolée à sa valeur actuelle.
public function yoyo():void
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique à l'animation interpolée d'effectuer la lecture à l'envers en partant de la dernière direction des incréments de propriété interpolés. Si cette méthode est appelée avant la fin de l'animation d'un objet Tween, l'animation passe directement à la fin de sa lecture, puis lit dans la direction inverse à partir de ce point. Si vous appelez la méthode Tween.yoyo() dans un gestionnaire d'événements TweenEvent.MOTION_FINISH, vous pouvez obtenir un effet d'animation qui termine sa lecture, puis inverse toute sa lecture. Cette procédure garantit que l'effet inverse de la méthode Tween.yoyo() ne commence pas tant que l'actuelle animation interpolée n'est pas terminée.
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_CHANGE
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique que l'interpolation a changé et que l'écran a été actualisé.
Les propriétés de l'objet de l'événement sont les valeurs suivantes :
| Propriété | Valeur |
bubbles | false |
cancelable | false |
currentTarget | Objet qui définit l'écouteur qui gère cet événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d'événement, myButton a la même valeur que la propriété currentTarget. |
target | Objet qui a diffusé l'événement (ce n'est pas toujours celui qui écoute l'événement). Pour accéder systématiquement à l'objet qui écoute l'événement, utilisez la propriété currentTarget. |
time | Durée de l'interpolation au moment de l'événement. |
position | Valeur de la propriété contrôlée par l'interpolation, au moment de l'événement. |
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_FINISH
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique que l'interpolation a atteint sa fin et a terminé.
Les propriétés de l'objet de l'événement sont les valeurs suivantes :
| Propriété | Valeur |
bubbles | false |
cancelable | false |
currentTarget | Objet qui définit l'écouteur qui gère cet événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d'événement, myButton a la même valeur que la propriété currentTarget. |
target | Objet qui a diffusé l'événement (ce n'est pas toujours celui qui écoute l'événement). Pour accéder systématiquement à l'objet qui écoute l'événement, utilisez la propriété currentTarget. |
time | Durée de l'interpolation au moment de l'événement. |
position | Valeur de la propriété contrôlée par l'interpolation, au moment de l'événement. |
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_LOOP
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique que la lecture de l'interpolation a repris depuis le début en mode boucle.
Les propriétés de l'objet de l'événement sont les valeurs suivantes :
| Propriété | Valeur |
bubbles | false |
cancelable | false |
currentTarget | Objet qui définit l'écouteur qui gère cet événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d'événement, myButton a la même valeur que la propriété currentTarget. |
target | Objet qui a diffusé l'événement (ce n'est pas toujours celui qui écoute l'événement). Pour accéder systématiquement à l'objet qui écoute l'événement, utilisez la propriété currentTarget. |
time | Durée de l'interpolation au moment de l'événement. |
position | Valeur de la propriété contrôlée par l'interpolation, au moment de l'événement. |
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_RESUME
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique que la lecture de l'interpolation a repris après une pause.
Les propriétés de l'objet de l'événement sont les valeurs suivantes :
| Propriété | Valeur |
bubbles | false |
cancelable | false |
currentTarget | Objet qui définit l'écouteur qui gère cet événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d'événement, myButton a la même valeur que la propriété currentTarget. |
target | Objet qui a diffusé l'événement (ce n'est pas toujours celui qui écoute l'événement). Pour accéder systématiquement à l'objet qui écoute l'événement, utilisez la propriété currentTarget. |
time | Durée de l'interpolation au moment de l'événement. |
position | Valeur de la propriété contrôlée par l'interpolation, au moment de l'événement. |
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_START
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique que la lecture du mouvement a commencé.
Les propriétés de l'objet de l'événement sont les valeurs suivantes :
| Propriété | Valeur |
bubbles | false |
cancelable | false |
currentTarget | Objet qui définit l'écouteur qui gère cet événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d'événement, myButton a la même valeur que la propriété currentTarget. |
target | Objet qui a diffusé l'événement (ce n'est pas toujours celui qui écoute l'événement). Pour accéder systématiquement à l'objet qui écoute l'événement, utilisez la propriété currentTarget. |
time | Durée de l'interpolation au moment de l'événement. |
position | Valeur de la propriété contrôlée par l'interpolation, au moment de l'événement. |
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_STOP
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Indique que l'interpolation a été interrompue par un appel explicite de
Tween.stop().
Les propriétés de l'objet de l'événement sont les valeurs suivantes :
| Propriété | Valeur |
bubbles | false |
cancelable | false |
currentTarget | Objet qui définit l'écouteur qui gère cet événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d'événement, myButton a la même valeur que la propriété currentTarget. |
target | Objet qui a diffusé l'événement (ce n'est pas toujours celui qui écoute l'événement). Pour accéder systématiquement à l'objet qui écoute l'événement, utilisez la propriété currentTarget. |
time | Durée de l'interpolation au moment de l'événement. |
position | Valeur de la propriété contrôlée par l'interpolation, au moment de l'événement. |
© 2004-2007 Adobe Systems Incorporated. Tous droits réservés.
Fri Oct 12 2007, 2:53 AM GMT-07:00
Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/fl/transitions/Tween.html