Package | spark.effects.animation |
Classe | public final class Animation |
Héritage | Animation Object |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Cette classe définit la durée et les valeurs de l’animation. D’autres séquences de code, définies dans le code des effets ou de l’application, associent l’animation à des objets et des propriétés cible. Les valeurs d’animation produites par la classe Animation peuvent ainsi être appliquées à des objets et propriétés cible pour permettre l’animation de ces objets.
Pour définir des effets d’animation, la procédure normale consiste à créer une instance de la classe Animate ou une sous-classe d’Animate. Ainsi, vous créez une instance Animation dans la méthode play()
. L’instance Animation accepte des valeurs de début, de fin, de durée, ainsi que des paramètres facultatifs, par exemple des objets d’accélération et d’interpolation.
L’objet Animation appelle des écouteurs d’événement au début et à la fin de l’animation, lorsque l’animation est répétée, mais aussi à intervalle régulier tout au long de l’animation. Ces appels transmettent des valeurs calculées par l’instance Animation à partir des valeurs de début et de fin et des objets d’accélération et d’interpolation. Ces valeurs peuvent ensuite être utilisées pour définir les valeurs des propriétés sur les objets cible.
Propriété MXML par défautmotionPaths
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
animationTarget : spark.effects.animation:IAnimationTarget
Objet IAnimationTarget devant recevoir une notification pour tous les événements de début, de fin, de répétition et de mise à jour de cette animation. | Animation | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
currentValue : Object
Objet contenant les valeurs calculées correspondant à l’image en cours de l’animation. | Animation | ||
cycleFraction : Number [lecture seule]
La fraction en cours écoulée dans l’animation, après que l’accélération a été appliquée. | Animation | ||
cycleTime : Number [lecture seule]
La position en millisecondes actuelle dans le cycle d’animation en cours. | Animation | ||
duration : Number = 500
Durée de l’animation, en millisecondes, sans compter les répétitions définies par la propriété repeatCount. | Animation | ||
easer : IEaser
Comportement d’accélération de cet effet. | Animation | ||
interpolator : IInterpolator = null
Interpolateur utilisé par l’instance Animation pour calculer les valeurs situées entre les valeurs de début et de fin de la propriété. | Animation | ||
isPlaying : Boolean [lecture seule]
Si la valeur est true, l’animation est en cours de lecture. | Animation | ||
motionPaths : Vector.<MotionPath>
Jeu d’objets MotionPath définissant les propriétés et valeurs qui font l’objet d’une animation. | Animation | ||
playheadTime : Number
Temps écoulé depuis le début de l’animation, en incluant le délai d’attente et les répétitions. | Animation | ||
playReversed : Boolean
Si la valeur est true, l’animation est lue à l’envers. | Animation | ||
repeatBehavior : String
Définit le comportement d’une animation répétée. | Animation | ||
repeatCount : int
Nombre de répétitions de cette animation. | Animation | ||
repeatDelay : Number
Délai d’attente, en millisecondes, avant le début de chaque cycle de répétition. | Animation | ||
startDelay : Number
Délai d’attente avant le début de l’animation. | Animation |
Méthode | Défini par | ||
---|---|---|---|
Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)
Constructeur. | Animation | ||
Interrompt l’animation, atteint immédiatement la fin de l’animation, et appelle la fonction animationEnd() sur la cible animationTarget. | Animation | ||
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 | ||
Suspend l’effet jusqu’à ce que la méthode resume() soit appelée. | Animation | ||
Démarre l’animation. | Animation | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Reprend l’effet après une interruption demandée par un appel de la méthode pause(). | Animation | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Arrête l’animation et la termine sans appeler la méthode end(). | Animation | ||
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 |
animationTarget | propriété |
animationTarget:spark.effects.animation:IAnimationTarget
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Objet IAnimationTarget devant recevoir une notification pour tous les événements de début, de fin, de répétition et de mise à jour de cette animation. La valeur null
indique qu’il n’y a pas de cible à notifier.
La valeur par défaut est null.
Implémentation
public function get animationTarget():spark.effects.animation:IAnimationTarget
public function set animationTarget(value:spark.effects.animation:IAnimationTarget):void
currentValue | propriété |
public var currentValue:Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Objet contenant les valeurs calculées correspondant à l’image en cours de l’animation. Les valeurs sont stockées sous forme de valeurs de mappage, en utilisant comme clé les noms de propriété.
cycleFraction | propriété |
cycleFraction:Number
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
La fraction en cours écoulée dans l’animation, après que l’accélération a été appliquée. Cette valeur est comprise entre 0 et 1. Un « cycle » d’animation est défini comme une seule répétition de l’animation, où la propriété repeatCount
définit le nombre de cycles qui seront exécutés.
Implémentation
public function get cycleFraction():Number
cycleTime | propriété |
cycleTime:Number
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
La position en millisecondes actuelle dans le cycle d’animation en cours. Cette valeur est comprise entre 0 et duration
. Un « cycle » d’animation est défini comme une seule répétition de l’animation, où la propriété repeatCount
définit le nombre de cycles qui seront exécutés. Utilisez la méthode seek()
pour modifier la position de l’animation.
Implémentation
public function get cycleTime():Number
duration | propriété |
public var duration:Number = 500
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Durée de l’animation, en millisecondes, sans compter les répétitions définies par la propriété repeatCount
.
La valeur par défaut est 500.
easer | propriété |
easer:IEaser
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Comportement d’accélération de cet effet. Cet objet IEaser est utilisé pour convertir la partie écoulée de l’animation en partie accélérée, qui est ensuite utilisée pour calculer la valeur au niveau de cette fraction écoulée accélérée.
La valeur null
signifie qu’aucune accélération n’est mise en œuvre, ce qui revient à utiliser une accélération Linear ou animation.easer = Linear.getInstance();
.
La valeur par défaut est Sine(.5).
Implémentation
public function get easer():IEaser
public function set easer(value:IEaser):void
interpolator | propriété |
public var interpolator:IInterpolator = null
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Interpolateur utilisé par l’instance Animation pour calculer les valeurs situées entre les valeurs de début et de fin de la propriété. Par défaut, la classe utilise la classe NumberInterpolator ou, dans les cas où les valeurs de début et de fin sont des tableaux ou des vecteurs, par la classe MultiValueInterpolator. L’interpolation d’autres types de données ou de valeurs Number devant être interpolées de façon différente, par exemple des valeurs uint
contenant des informations de canal de couleur, peut être traitée en spécifiant un autre interpolateur.
Eléments de l’API associés
isPlaying | propriété |
isPlaying:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Si la valeur est true
, l’animation est en cours de lecture. La valeur est false
, sauf si l’animation a été lancée et n’a pas encore été arrêtée (soit par programmation, soit automatiquement) ni suspendue.
La valeur par défaut est false.
Implémentation
public function get isPlaying():Boolean
motionPaths | propriété |
public var motionPaths:Vector.<MotionPath>
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Jeu d’objets MotionPath définissant les propriétés et valeurs qui font l’objet d’une animation.
Eléments de l’API associés
playheadTime | propriété |
playheadTime:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Temps écoulé depuis le début de l’animation, en incluant le délai d’attente et les répétitions. Pendant le premier cycle d’une animation, cette valeur est égale à celle de cycleTime
.
Implémentation
public function get playheadTime():Number
public function set playheadTime(value:Number):void
playReversed | propriété |
playReversed:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Si la valeur est true
, l’animation est lue à l’envers. Si l’animation est en cours de lecture dans la direction opposée à la valeur playReversed
spécifiée, l’animation change de direction de manière dynamique.
La valeur par défaut est false.
Implémentation
public function get playReversed():Boolean
public function set playReversed(value:Boolean):void
repeatBehavior | propriété |
repeatBehavior:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Définit le comportement d’une animation répétée. La propriété repeatCount
d’une animation répétée est définie sur 0 ou sur une valeur supérieure à 1. Cette valeur doit être soit RepeatBehavior.LOOP
, auquel cas l’animation est répétée systématiquement dans le même sens, soit RepeatBehavior.REVERSE
, auquel cas l’animation est inversée à chaque répétition.
La valeur par défaut est RepeatBehavior.LOOP.
Implémentation
public function get repeatBehavior():String
public function set repeatBehavior(value:String):void
Eléments de l’API associés
repeatCount | propriété |
repeatCount:int
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Nombre de répétitions de cette animation. La valeur 0 signifie qu’elle se répète indéfiniment.
La valeur par défaut est 1.
Implémentation
public function get repeatCount():int
public function set repeatCount(value:int):void
repeatDelay | propriété |
repeatDelay:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Délai d’attente, en millisecondes, avant le début de chaque cycle de répétition. Si cette valeur n’est pas nulle, le cycle d’animation précédent s’arrête exactement au niveau de la valeur de fin. Cependant, les répétitions non retardées peuvent ignorer totalement cette valeur, lorsque l’animation passe progressivement d’un point situé peu avant la fin d’un cycle à un point situé peu après le début du cycle suivant. La valeur de cette propriété doit être supérieure ou égale à 0.
Cette propriété est utilisée pour la première répétition après le premier cycle de l’animation. Pour retarder le premier cycle de l’animation, utilisez la propriété startDelay
.
La valeur par défaut est 0.
Implémentation
public function get repeatDelay():Number
public function set repeatDelay(value:Number):void
Eléments de l’API associés
startDelay | propriété |
startDelay:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Délai d’attente avant le début de l’animation. La valeur de cette propriété doit être supérieure ou égale à 0.
La valeur par défaut est 0.
Implémentation
public function get startDelay():Number
public function set startDelay(value:Number):void
Animation | () | Constructeur |
public function Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur. Les paramètres facultatifs property
, startValue
et endValue
définissent une animation simple utilisant un seul objet MotionPath et deux images-clés KeyFrame. Si une des valeurs n’est pas null, la valeur startValue
devient la valeur value
de la première image-clé, à la position temporelle 0, et la valeur endValue
devient la valeur value
de la deuxième image-clé, à la fin de l’animation.
duration:Number (default = 500 ) — Durée de l’animation, en millisecondes.
| |
property:String (default = null ) — Propriété devant faire l’objet d’une animation.
| |
startValue:Object (default = null ) — Valeur initiale de la propriété.
| |
endValue:Object (default = null ) — Valeur finale de la propriété.
|
end | () | méthode |
public function end():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Interrompt l’animation, atteint immédiatement la fin de l’animation, et appelle la fonction animationEnd() sur la cible animationTarget
.
pause | () | méthode |
public function pause():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Suspend l’effet jusqu’à ce que la méthode resume()
soit appelée. Si la méthode stop()
est appelée avant la méthode resume()
, il est impossible de reprendre l’animation.
play | () | méthode |
public function play():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Démarre l’animation. Si l’animation est déjà en cours, elle est arrêtée puis relancée.
resume | () | méthode |
public function resume():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Reprend l’effet après une interruption demandée par un appel de la méthode pause()
.
stop | () | méthode |
public function stop():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Arrête l’animation et la termine sans appeler la méthode end()
. La fonction animationStop() sur la cible animationTarget
sera appelée.
Tue Jun 12 2018, 09:30 AM Z