Animator

Package	fl.motion
Classe	public class Animator
Héritage	Animator AnimatorBase EventDispatcher Object

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

La classe Animator applique la description XML d’une interpolation de mouvement à un objet d’affichage. Les propriétés et les méthodes de la classe Animator 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. S’il n’y a pas de contenu tridimensionnel, la copie de mouvement en tant que commande ActionScript dans Flash CS4 utilise la classe Animator. Le contenu tridimensionnel utilise à la place la classe Animator3D, qui partage la même classe de base que la classe Animator mais qui est spécifique au contenu 3D. Vous pouvez ensuite modifier le code ActionScript au moyen de l’API (Application Programming Interface), ou construire votre propre animation personnalisée.

Si vous envisagez d’appeler des méthodes de la classe Animator dans une fonction, déclarez l’occurrence d’Animator 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 Animator 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é.

Remarque : dans Flash CS3, certaines propriétés et méthodes prises en charge par cette classe appartenaient exclusivement à cette classe. Flash CS4 introduit une classe de base, AnimatorBase, pour les propriétés et méthodes de cette classe ; ces dernières sont à présent partagées par d’autres classes à travers la chaîne d’héritage. Si vous avez utilisé Flash CS3, notez que ces propriétés et méthodes sont toujours prises en charge par la classe Animator, mais appartiennent à la classe AnimatorBase dans les versions de Flash Professional ultérieures à Flash CS3. Comme pour toute autre classe dans cette référence, sélectionnez Afficher les propriétés publiques héritées et Afficher les méthodes publiques héritées pour afficher toutes les propriétés et méthodes prises en charge par cette classe.

Propriété MXML par défautmotion

Eléments de l’API associés

Eléments XML de mouvement

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		autoRewind : Boolean = false Règle l’animation pour qu’elle redémarre une fois terminée.	AnimatorBase
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		frameEvent : String Nom de l’objet d’événement créé par l’événement Event.ENTER_FRAME.	AnimatorBase
		initialPosition : Array [écriture seule] Tableau de coordonnées définissant l’emplacement de départ de l’animation.	AnimatorBase
		instanceFactoryClass : Class Lors de la création d’occurrences avec ActionScript, il s’agit de la classe qui crée l’occurrence.	AnimatorBase
		isPlaying : Boolean [lecture seule] Indique si l’animation est en cours de lecture.	AnimatorBase
		motion : MotionBase Objet contenant les propriétés d’interpolation de mouvement pour l’animation.	AnimatorBase
		motionArray : Array Tableau d’objets contenant les propriétés d’interpolation de mouvement pour l’animation.	AnimatorBase
		orientToPath : Boolean = false Définit la position de l’objet d’affichage sur la trajectoire de mouvement.	AnimatorBase
		placeholderName : String Lors de la création d’occurrences avec ActionScript, il s’agit de l’occurrence qui s’affiche sur la scène que nous allons remplacer.	AnimatorBase
		positionMatrix : Matrix Objet Matrix appliquant une transformation globale à la trajectoire de mouvement.	AnimatorBase
		repeatCount : int = 1 Nombre de fois que l’animation doit être répétée.	AnimatorBase
		sceneName : String Référence pour les séquences exportées (pour le mouvement en 3D) afin que la séquence puisse être chargée dans un scénario parent.	AnimatorBase
		spanEnd : int [lecture seule] Renvoie l’image du parent de la cible sur laquelle se termine l’animation de la cible.	AnimatorBase
		spanStart : int [lecture seule] Renvoie l’image du parent de la cible sur laquelle commence l’animation de la cible.	AnimatorBase
		target : DisplayObject Objet d’affichage actuellement animé.	AnimatorBase
		targetName : String Nom de l’objet cible tel que le voit le DisplayObjectContainer parent.	AnimatorBase
		targetParent : DisplayObjectContainer 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.	AnimatorBase
		targetParentButton : SimpleButton	AnimatorBase
		targetState3D : Array Orientation initiale de l’objet cible.	AnimatorBase
		time : int Entier (commençant à zéro) qui indique et contrôle le temps dans l’animation en cours.	AnimatorBase
		transformationPoint : Point Point de référence pour la rotation ou le redimensionnement d’un objet d’affichage.	AnimatorBase
		transformationPointZ : int Point de référence de la coordonnée z pour la rotation ou le redimensionnement d’un objet d’affichage.	AnimatorBase
		usingCurrentFrame : Boolean [lecture seule] 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.	AnimatorBase

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		Animator(xml:XML = null, target:DisplayObject = null) Crée un objet Animator pour appliquer la description XML d’une interpolation de mouvement à un objet d’affichage.	Animator
		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
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		end(reset:Boolean = false, stopEnterFrame:Boolean = true, pastLastFrame:Boolean = false):void Arrête l’animation tandis que Flash Player passe immédiatement à la dernière image de la séquence d’animation.	AnimatorBase
		fromXMLString(xmlString:String, target:DisplayObject = null):Animator [statique] Crée un objet Animator à partir d’une chaîne XML.	Animator
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean 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
		matricesEqual(a:Matrix, b:Matrix):Boolean [statique] Compare deux matrices spécifiées en tant que paramètres et renvoie true si elles sont égales.	Animator
		nextFrame(reset:Boolean = false, stopEnterFrame:Boolean = true):void Avance Flash Player à l'image suivante dans la séquence d'animation.	AnimatorBase
		pause():void Interrompt momentanément l’animation jusqu’à ce que la méthode resume() soit appelée.	AnimatorBase
		play(startTime:int = -1, startEnterFrame:Boolean = true):void Commence l’animation.	AnimatorBase
		processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void [statique]	AnimatorBase
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void [statique] Enregistre le MovieClip donné et une occurrence AnimatorBase pour un enfant de ce MovieClip.	AnimatorBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		resume():void Reprend l’animation après une interruption demandée par la méthode pause().	AnimatorBase
		rewind():void Positionne Flash Player sur la première image de l’animation.	AnimatorBase
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		startFrameEvents():void Lance des événements d’image.	AnimatorBase
		stop():void Arrête l’animation tandis que Flash Player revient à la première image dans la séquence d’animation.	AnimatorBase
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		useCurrentFrame(enable:Boolean, spanStart:int):void 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.	AnimatorBase
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean 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

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
motionEnd	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().	AnimatorBase
motionStart	Distribué lorsque le mouvement commence.	AnimatorBase
motionUpdate	Distribué lorsque le mouvement a changé et que l'écran a été actualisé.	AnimatorBase
timeChange	Distribué lorsque la valeur time d’Animator a changé, mais que l’écran n’a pas encore été actualisé (événement motionUpdate).	AnimatorBase

Détails du constructeur

()

Constructeur

public function Animator(xml:XML = null, target:DisplayObject = null)

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Crée un objet Animator pour appliquer la description XML d’une interpolation de mouvement à un objet d’affichage.

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.

Eléments de l’API associés

Eléments XML de mouvement

Détails de la méthode

fromXMLString

()

méthode

public static function fromXMLString(xmlString:String, target:DisplayObject = null):Animator

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Crée un objet Animator à partir d’une chaîne XML. Cette méthode se présente comme une alternative à l’utilisation du constructeur Animator qui accepte un objet E4X à la place.

Paramètres

	`xmlString:String` — Chaîne de code XML décrivant l’interpolation de mouvement.

	`target:DisplayObject` (default = `null`) — Objet d’affichage utilisant l’interpolation de mouvement.

Valeur renvoyée

Animator — Occurrence Animator appliquant le paramètre xmlString spécifié au paramètre target indiqué.

Eléments de l’API associés

Eléments XML de mouvement

matricesEqual

()

méthode

public static function matricesEqual(a:Matrix, b:Matrix):Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2

Compare deux matrices spécifiées en tant que paramètres et renvoie true si elles sont égales.

Paramètres

	`a:Matrix` — La première occurrence de l’objet Matrix en vue de la comparaison.

	`b:Matrix` — La deuxième occurrence de l’objet Matrix en vue de la comparaison.

Valeur renvoyée

Boolean — Valeur booléenne ; true si les deux matrices sont égales, false dans le cas contraire.

Informations juridiques | Politique de confidentialité en ligne

Animator - AS3 Flash

Classes x

Animator

fromXMLString

matricesEqual