Package | mx.effects |
Classe | public class Tween |
Héritage | Tween EventDispatcher Object |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
A partir de Flex 4.0, Adobe vous recommande d’utiliser la classe spark.effects.animation.Animation comme alternative à cette classe. L’interpolation est la classe d’animation sous-jacente des effets dans Flex 3. Dans Flex 4, les effets Spark utilisent la classe spark.effects.animation.Animation pour fournir des fonctionnalités semblables. |
Cette classe définit une interpolation, une animation de propriété effectuée sur un objet cible pendant une période de temps. Cette animation peut être un changement de position, telle que effectué par l’effet Move ; une modification de la taille, tel qu’effectuée par les effets Resize et Zoom ; une modification de la visibilité, tel qu’effectué par les effets Fade ou Dissolve ; ou d’autres types d’animation.
Lorsque vous définissez des objets d’interpolation, vous créez généralement une instance de la classe Tween dans le cadre du remplacement de la méthode EffectInstance.play()
. Une instance Tween accepte les propriétés startValue
, endValue
et duration
, ainsi qu’une fonction d’accélération facultative pour définir l’animation.
L’objet interpolé invoque la fonction de rappel mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate()
dans un intervalle régulier sur l’instance d’effet de la durée de l’effet et transmet à la méthode onTweenUpdate()
une valeur interpolée située entre startValue
et endValue
. En règle générale, la fonction de rappel met à jour certaines propriétés de l’objet cible, pour qu’il soit animé pendant la durée de l’effet.
Lorsque l’effet s’arrête, les objets Tween invoquent la fonction de rappel mx.effects.effectClasses.TweenEffectInstance.onTweenEnd()
, si vous en avez définie.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
duration : Number = 3000
Durée de l’animation, en millisecondes. | Tween | ||
easingFunction : Function [écriture seule]
Définit la fonction d’accélération de l’animation. | Tween | ||
listener : Object
Objet averti à chaque intervalle de l’animation. | Tween |
Méthode | Défini par | ||
---|---|---|---|
Tween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1, updateFunction:Function = null, endFunction:Function = null)
Constructeur. | Tween | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Interrompez l’interpolation, accédez immédiatement à la fin de l’interpolation et appelez la fonction de rappel onTweenEnd. | Tween | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Interrompt momentanément l’effet jusqu’à un appel de la méthode resume(). | Tween | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Reprend l’effet après une interruption demandée par un appel de la méthode pause(). | Tween | ||
Exécute l’effet en sens inverse, à partir de sa position actuelle. | Tween | ||
Avance l’effet d’interpolation à la position spécifiée. | Tween | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Par défaut, la classe Tween invoque la fonction de rappel mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate() pendant un intervalle régulier sur l’instance d’effet de la durée de l’effet et la fonction de rappel facultative mx.effects.effectClasses.TweenEffectInstance.onTweenEnd() à la fin de la durée de l’effet. | Tween | ||
Arrête l’interpolation sans déclencher un événement ou en appelant les fonctions endFunction ou onTweenEnd() de l’effet Tween. | Tween | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher |
duration | propriété |
public var duration:Number = 3000
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Durée de l’animation, en millisecondes.
easingFunction | propriété |
easingFunction:Function
[écriture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Définit la fonction d’accélération de l’animation. La fonction d’accélération permet d’interpoler entre les valeurs startValue
et endValue
. Une fonction d’accélération banale effectue une interpolation linéaire, mais des fonctions d’accélération plus sophistiquées créent l’illusion d’accélération et de décélération qui rend l’animation plus naturelle.
Si aucune fonction d’accélération n’est spécifiée, une fonction d’accélération basée sur la méthode Math.sin()
est utilisée.
La fonction d’accélération suit la signature de fonction popularisée par Robert Penner. Cette fonction accepte quatre arguments. Le premier argument est l’« heure actuelle », où l’heure de début de l’animation est 0. Le second argument est la valeur initiale au début de l’animation (nombre). Le troisième argument est la valeur d’arrêt moins la valeur initiale. La quatrième argument est la durée de l’animation. La valeur renvoyée est le la valeur interpolée de l’heure actuelle (généralement, une valeur comprise entre la valeur de départ et la valeur d’arrivée).
Flex inclut un jeu de fonctions d’accélération dans le package mx.effects.easing.
Implémentation
public function set easingFunction(value:Function):void
listener | propriété |
public var listener:Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Objet averti à chaque intervalle de l’animation.
Tween | () | Constructeur |
public function Tween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1, updateFunction:Function = null, endFunction:Function = null)
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
Lorsque le constructeur est appelé, l’animation commence automatiquement.
Paramètreslistener:Object — Objet notifié à chaque intervalle de l’animation. En règle générale, vous transmettez le mot-clé this en tant que valeur. L’écouteur listener doit définir la méthode onTweenUpdate() et éventuellement la méthode onTweenEnd() . L’ancienne méthode est invoquée pour chaque intervalle de l’animation et cette dernière est invoquée à la fin de l’animation.
| |
startValue:Object — Valeur de départ de l’animation. Elle est soit un nombre ou un tableau de nombres. Si un nombre est transmis, la méthode Tween interpole entre ce nombre et le nombre transmis dans le paramètre endValue . Si un tableau de nombres est transmis, chaque nombre du tableau est interpolé.
| |
endValue:Object — Valeur d’arrivée de l’animation. Le type de cet argument doit correspondre au paramètre startValue .
| |
duration:Number (default = -1 ) — Durée de l’animation, exprimée en millisecondes.
| |
minFps:Number (default = -1 ) — Nombre minimal de fois que la méthode onTweenUpdate() doit être appelée chaque seconde. Le code d’interpolation tente d’appeler la méthode onTweenUpdate() autant de fois que possible (jusqu’à 100 fois par seconde). Toutefois, si la fréquence est inférieure à minFps , la durée de l’animation augmente automatiquement. Par conséquent, une animation qui se bloque temporairement (c’est-à-dire si elle n’obtient pas de cycles CPU) recommence à l’endroit où elle a été interrompue, au lieu de sauter à l’étape suivante.
| |
updateFunction:Function (default = null ) — Spécifie une autre fonction de rappel de mise à jour à utiliser au lieu de listener.OnTweenUpdate() .
| |
endFunction:Function (default = null ) — Spécifie une autre fonction de rappel de mise à jour à utiliser au lieu de listener.OnTweenEnd()
|
endTween | () | méthode |
public function endTween():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Interrompez l’interpolation, accédez immédiatement à la fin de l’interpolation et appelez la fonction de rappel onTweenEnd()
.
pause | () | méthode |
public function pause():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Interrompt momentanément l’effet jusqu’à un appel de la méthode resume()
.
resume | () | méthode |
public function resume():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Reprend l’effet après une interruption demandée par un appel de la méthode pause()
.
reverse | () | méthode |
public function reverse():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Exécute l’effet en sens inverse, à partir de sa position actuelle.
seek | () | méthode |
public function seek(playheadTime:Number):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Avance l’effet d’interpolation à la position spécifiée.
Paramètres
playheadTime:Number — Position, en millisecondes, comprise entre 0 et la valeur de la propriété duration .
|
setTweenHandlers | () | méthode |
public function setTweenHandlers(updateFunction:Function, endFunction:Function):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Par défaut, la classe Tween invoque la fonction de rappel mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate()
pendant un intervalle régulier sur l’instance d’effet de la durée de l’effet et la fonction de rappel facultative mx.effects.effectClasses.TweenEffectInstance.onTweenEnd()
à la fin de la durée de l’effet.
Cette méthode permet de spécifier différentes méthodes en tant que fonctions de rappel de mise à jour et de fin.
Paramètres
updateFunction:Function — Spécifie la fonction de rappel de mise à jour.
| |
endFunction:Function — Spécifie la fonction de rappel de mise à jour.
|
stop | () | méthode |
public function stop():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Arrête l’interpolation sans déclencher un événement ou en appelant les fonctions endFunction ou onTweenEnd()
de l’effet Tween.
Tue Jun 12 2018, 09:30 AM Z