| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
La classe AnimatorBase applique la description XML d'une interpolation de mouvement à un objet d'affichage. Les propriétés et les méthodes de la classe AnimatorBase contrôlent la lecture du mouvement, tandis que Flash Player diffuse des événements en réponse aux modifications survenues dans l'état du mouvement. La classe AnimatorBase est essentiellement utilisée par le biais de la commande de copie du mouvement en code ActionScript dans Flash CS4. Vous pouvez ensuite modifier le code ActionScript au moyen de l'API (Application Programming Interface), ou construire votre propre animation personnalisée. La classe AnimatorBase ne doit pas être utilisée seule. Utilisez à la place ses sous-classes Animator ou Animator3D.
Si vous envisagez d'appeler des méthodes de la classe AnimatorBase dans une fonction, déclarez l'occurrence d'AnimatorBase hors de la fonction de sorte que le domaine de l'objet ne soit pas limité à la fonction elle-même. Si vous déclarez l'occurrence dans une fonction, Flash Player la supprime à la fin de la fonction au court de sa routine de nettoyage de la mémoire et l'objet cible ne sera pas animé.
motion
public var autoRewind:Boolean = false| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Règle l'animation pour qu'elle redémarre une fois terminée.
frameEvent:String [lecture-écriture]
Implémentation public function get frameEvent():String public function set frameEvent(value:String):voidinitialPosition:Array [lecture seule]
Implémentation public function set initialPosition(value:Array):voidisPlaying:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Indique si l'animation est en cours de lecture.
Implémentation public function get isPlaying():Booleanmotion:MotionBase [lecture-écriture]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Objet contenant les propriétés d'interpolation de mouvement pour l'animation.
Implémentation public function get motion():MotionBase public function set motion(value:MotionBase):voidpublic var orientToPath:Boolean = false| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Définit la position de l'objet d'affichage sur la trajectoire de mouvement. Si elle est définie sur true la ligne de base de l'objet d'affichage s'oriente par rapport à la trajectoire de mouvement ; sinon c'est le point d'alignement qui s'oriente par rapport à cette trajectoire.
public var positionMatrix:Matrix| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Objet Matrix appliquant une transformation globale à la trajectoire de mouvement. Cette matrice permet à la trajectoire d'être déplacée, redimensionnée, inclinée ou pivotée sans modifier l'apparence de l'objet d'affichage.
public var repeatCount:int = 1| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Nombre de fois que l'animation doit être répétée. Les valeurs possibles sont tout entier supérieur ou égal à 0. La valeur 1 signifie que l'animation doit être lue une fois. La valeur 0 indique que l'animation est jouée en continu jusqu'à ce qu'elle soit explicitement arrêtée (par un appel à la méthode end(), par exemple).
La valeur par défaut est 1.
Voir aussi
sceneName:String [lecture-écriture]
Implémentation public function get sceneName():String public function set sceneName(value:String):voidspanEnd:int [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Renvoie l'image du parent de la cible sur laquelle se termine l'animation de la cible. Cette valeur est déterminée à l'aide de spanStart et de la propriété duration du mouvement.
Implémentation public function get spanEnd():intspanStart:int [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Renvoie l'image du parent de la cible sur laquelle commence l'animation de la cible.
Implémentation public function get spanStart():inttarget:DisplayObject [lecture-écriture]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Objet d'affichage actuellement animé. Toute sous-classe de flash.display.DisplayObject est utilisable, telle que MovieClip, Sprite ou Bitmap.
Implémentation public function get target():DisplayObject public function set target(value:DisplayObject):voidVoir aussi
targetName:String [lecture-écriture]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Nom de l'objet cible tel que le voit le DisplayObjectContainer parent. Peut être utilisé en combinaison avec targetParent pour récupérer l'objet cible après sa suppression, puis remplacé sur le scénario.
Implémentation public function get targetName():String public function set targetName(value:String):voidtargetParent:DisplayObjectContainer [lecture-écriture]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
DisplayObjectContainer parent cible animé, qui peut être utilisé en combinaison avec targetName pour récupérer l'objet cible après sa suppression, puis remplacé sur le scénario.
Implémentation public function get targetParent():DisplayObjectContainer public function set targetParent(value:DisplayObjectContainer):voidtargetState3D:Array [lecture-écriture]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Orientation initiale de l'objet cible. Toute rotation 3D est absolue pour les données du mouvement. Si vous ciblez un autre objet dont l'orientation 3D de début est différente 3D, son état de cible est d'abord réinitialisé.
Implémentation public function get targetState3D():Array public function set targetState3D(value:Array):voidtime:int [lecture-écriture]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Entier (commençant à zéro) qui indique et contrôle le temps dans l'animation en cours. A la première image de l'animation, la valeur de time est 0. Si la durée de l'animation est de 10 images, à la dernière image la valeur de time est 9.
Implémentation public function get time():int public function set time(value:int):voidpublic var transformationPoint:Point| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Point de référence pour la rotation ou le redimensionnement d'un objet d'affichage. Dans le cas d'un mouvement 2D, le point de transformation varie en fonction du cadre de délimitation de l'objet d'affichage. Les coordonnées du point doivent être redimensionnées sur une zone de 1 px x 1 px, sachant que (1, 1) représente le coin inférieur droit de l'objet et (0, 0), le coin supérieur gauche. Dans le cas d'un mouvement 3D (lorsque l'occurrence AnimatorBase est un Animator3D), les x et y du transformationPoint plus transformationPointZ sont des valeurs absolues dans l'espace de coordonnées du parent cible.
public var transformationPointZ:intusingCurrentFrame:Boolean [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Indique si la propriété currentFrame est vérifiée à chaque entrée d'une nouvelle image et si l'animation de la cible est synchronisée sur les images du scénario de son parent, ou progresse toujours quelle que soit l'image en cours du parent.
Implémentation public function get usingCurrentFrame():Booleanpublic function AnimatorBase(xml:XML = null, target:DisplayObject = null)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Crée un objet AnimatorBase pour appliquer la description XML d'une interpolation de mouvement à un objet d'affichage. Si XML est null (valeur par défaut), vous pouvez fournir XML directement à une occurrence Motion ou définir les tableaux des valeurs de propriété dans l'occurrence Motion.
Paramètres | xml:XML (default = null) — Objet E4X contenant une description XML d'interpolation de mouvement. |
| |
| target:DisplayObject (default = null) — Objet d'affichage utilisant l'interpolation de mouvement. |
Voir aussi
public function end(reset:Boolean = false, stopEnterFrame:Boolean = true):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Arrête l'animation tandis que Flash Player passe immédiatement à la dernière image de la séquence d'animation. Si la propriété autoRewind est définie sur true, Flash Player passe à la première image dans la séquence d'animation.
Paramètres
| reset:Boolean (default = false) —
Indique si les valeurs d'origine de _lastRenderedTime et _target doivent être réinitialisées. _target n'est réinitialisé que si les propriétés targetParent et targetName ont été fournies.
|
| |
| stopEnterFrame:Boolean (default = true) |
Voir aussi
public function nextFrame():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Avance Flash Player à l'image suivante dans la séquence d'animation.
public function pause():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Interrompt momentanément l'animation jusqu'à un appel de la méthode resume().
Voir aussi
public function play(startTime:int = -1, startEnterFrame:Boolean = true):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Commence l'animation. Appelez la méthode end() avant d'appeler la méthode play() pour vous assurer que toute précédente occurrence de l'animation est terminée avant d'en commencer une nouvelle.
Paramètres
| startTime:int (default = -1) — Indique une autre heure de début (image relative) à utiliser. Si elle n'est pas spécifiée, l'heure de début par défaut 0 est utilisée. |
| |
| startEnterFrame:Boolean (default = true) —
Indique si l'écouteur d'événement doit être ajouté au parent pour capturer les événements d'image. La valeur peut être false si le parent a été enregistré sur son occurrence AnimatorBase via registerParentFrameHandler().
|
Voir aussi
public static function processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void Paramètres
public static function registerButtonState(targetParentBtn:SimpleButton, anim:AnimatorBase, stateFrame:int):void Paramètres
public static function registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Enregistre le MovieClip donné et une occurrence AnimatorBase pour un enfant de ce MovieClip. Les événements FRAME_CONSTRUCTED du MovieClip parent sont traités, et son currentFrame et les propriétés spanStart de AnimatorBase sont utilisés pour déterminer l'image relative en cours de l'animation qui doit être lue.
L'appel à cette fonction définit automatiquement la propriété useCurrentFrame de AnimatorBase sur true, et sa propriété spanStart utilisant le paramètre du même nom.
Paramètres
| parent:MovieClip — MovieClip parent de l'occurrence AnimatorBase. |
| |
| anim:AnimatorBase — Occurrence AnimatorBase associée au MovieClip parent. |
| |
| spanStart:int — Image de début de l'animation en termes de scénario du MovieClip parent. |
| |
| repeatCount:int (default = 0) — Nombre de lectures de l'animation. La valeur par défaut est 0, ce qui signifie que l'animation est lue en boucle. |
| |
| useCurrentFrame:Boolean (default = false) — Indique si la propriété useCurrentFrame est vérifiée à chaque entrée d'une nouvelle image. |
public function resume():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Reprend l'animation après une interruption demandée par la méthode pause().
Voir aussi
public function rewind():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Positionne Flash Player sur la première image de l'animation. Si l'animation était en cours de lecture, elle est poursuivie à partir de la première image. Si l'animation était arrêtée, elle est maintenue à l'arrêt sur la première image.
public function startFrameEvents():void public function stop():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Arrête l'animation tandis que Flash Player revient à la première image dans la séquence d'animation.
Voir aussi
public function useCurrentFrame(enable:Boolean, spanStart:int):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Définit la propriété currentFrame chaque fois qu'une nouvelle image est entrée et indique si l'animation de la cible est synchronisée sur les images du scénario de son MovieClip parent. spanStart est l'image de début de l'animation en termes de scénario du parent. Si enable est défini sur true, dans tout événement d'entrée d'image donné dans la plage de l'animation, la propriété time est définie sur un nombre d'images par rapport à l'image spanStart.
Par exemple, si une animation de 4 images commence à l'image 5 (spanStart=5), et que l'image 5 contient un script qui utilise la propriété gotoAndPlay pour atteindre et lire l'image 8, à l'entrée de l'image 8, la propriété time est définie sur 3 (en ignorant time = 1 et time = 2 ).
Paramètres
| enable:Boolean — Valeur true ou false qui détermine si la propriété currentFrame est vérifiée. |
| |
| spanStart:int — Image de début de l'animation en termes de scénario du MovieClip parent. |
Type d'objet événement: fl.motion.MotionEventpropriété MotionEvent.type = fl.motion.MotionEvent.MOTION_END| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Distribué lorsque le mouvement s'arrête, soit parce qu'il est arrivé à son terme, soit parce qu'il est interrompu par un appel aux méthodes stop() ou end().
Indique que le mouvement s'est arrêté, soit par un appel explicite à
Animator.stop() ou
Animator.end(), soit parce qu'il est arrivé à son terme.
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 currentTarget.
|
target
|
Objet qui a distribué 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.
|
Type d'objet événement: fl.motion.MotionEventpropriété MotionEvent.type = fl.motion.MotionEvent.MOTION_START| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Distribué lorsque le mouvement commence.
Indique que la lecture de l'occurrence de Motion 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 currentTarget.
|
target
|
Objet qui a distribué 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.
|
Type d'objet événement: fl.motion.MotionEventpropriété MotionEvent.type = fl.motion.MotionEvent.MOTION_UPDATE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Distribué lorsque le mouvement a changé et que l'écran a été actualisé.
Indique que l'occurrence de Motion 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 currentTarget.
|
target
|
Objet qui a distribué 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.
|
Type d'objet événement: fl.motion.MotionEventpropriété MotionEvent.type = fl.motion.MotionEvent.TIME_CHANGE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9.0.28.0 |
Distribué lorsque la valeur time d'Animator a changé, mais que l'écran n'a pas encore été actualisé (événement motionUpdate).
Indique que la valeur
time de l'occurrence d'Animator a changé, mais que l'écran n'a pas encore été actualisé (Flash Player n'a pas distribué l'événement
motionUpdate).
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 currentTarget.
|
target
|
Objet qui a distribué 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.
|
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 03:00 AM -08:00