Animator

Pacchetto	fl.motion
Classe	public class Animator
Ereditarietà	Animator AnimatorBase EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

La classe Animator applica una descrizione XML di un'interpolazione di movimento a un oggetto di visualizzazione. Le proprietà e i metodi della classe Animator controllano la riproduzione del movimento e Flash Player trasmette degli eventi in risposta alle modifiche allo stato del movimento. Se non è presente alcun contenuto tridimensionale, il comando Copia movimento come ActionScript in Flash CS4 usa la classe Animator. Per il contenuto tridimensionale viene invece utilizzata la classe Animator3D, che condivide la stessa base della classe Animator ma che è concepita specificamente per il contenuto tridimensionale. Potete modificare il codice ActionScript mediante l’API oppure creare un’animazione personalizzata.

Se intendete chiamare i metodi della classe Animator all'interno di una funzione, dichiarate l'istanza Animator al di fuori della funzione, affinché l'area di validità dell'oggetto non sia limitata alla funzione stessa. Se dichiarate l'istanza all'interno di una funzione, Flash Player eliminerà l'istanza Animator al termine della funzione durante la procedura di "garbage collection" di routine e l'oggetto target non verrà animato.

Nota: in Flash CS3, alcuni metodi e proprietà supportati da questa classe erano membri esclusivi di questa stessa classe. In Flash CS4 è stata introdotta una classe base, AnimatorBase, per tali metodi e proprietà di questa classe, che attualmente sono condivisi da altre classi tramite la catena di ereditarietà. Se avete utilizzato Flash CS3, potrete notare che questi metodi e proprietà sono ancora supportati dalla classe Animator, ma nelle versioni di Flash Professional successive a Flash CS3 sono membri della classe AnimatorBase. Come per tutte le altre classi in questo riferimento, selezionate Mostra metodi pubblici ereditati e Mostra proprietà pubbliche ereditate per visualizzare tutti i metodi e le proprietà supportati da questa classe.

Proprietà MXML predefinitamotion

Elementi API correlati

Elementi XML di Motion

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		autoRewind : Boolean = false Imposta l'animazione in modo che riprenda da capo dopo che è terminata.	AnimatorBase
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		frameEvent : String Il nome dell'oggetto evento creato dall'evento Event.ENTER_FRAME.	AnimatorBase
		initialPosition : Array [sola scrittura] Un array di coordinate che definiscono la posizione iniziale dell'animazione.	AnimatorBase
		instanceFactoryClass : Class Quando si creano istanze con ActionScript, questa è la classe che consente di creare l'istanza.	AnimatorBase
		isPlaying : Boolean [sola lettura] Indica se l'animazione è in corso di riproduzione.	AnimatorBase
		motion : MotionBase L'oggetto che contiene le proprietà dell'interpolazione di movimento dell'animazione.	AnimatorBase
		motionArray : Array L'array di oggetti che contiene le proprietà dell'interpolazione di movimento dell'animazione.	AnimatorBase
		orientToPath : Boolean = false Imposta la posizione dell'oggetto di visualizzazione lungo il tracciato del movimento.	AnimatorBase
		placeholderName : String Quando si creano istanze con ActionScript, questa è l'istanza visualizzata sullo stage che verrà sostituita.	AnimatorBase
		positionMatrix : Matrix L'oggetto Matrix che applica una trasformazione globale al tracciato di movimento.	AnimatorBase
		repeatCount : int = 1 Numero di ripetizioni dell'animazione.	AnimatorBase
		sceneName : String Un riferimento per le scene esportate, per il movimento 3D, affinché la scena possa essere caricata in una linea temporale principale.	AnimatorBase
		spanEnd : int [sola lettura] Restituisce il fotogramma dell'elemento principale del target in corrispondenza del quale termina l'animazione del target.	AnimatorBase
		spanStart : int [sola lettura] Restituisce il fotogramma dell'elemento principale del target in corrispondenza del quale inizia l'animazione del target.	AnimatorBase
		target : DisplayObject L'oggetto di visualizzazione in corso di animazione.	AnimatorBase
		targetName : String Il nome dell'oggetto target rilevato dall'oggetto DisplayObjectContainer principale.	AnimatorBase
		targetParent : DisplayObjectContainer L'oggetto DisplayObjectContainer principale di destinazione in fase di animazione, che può essere usato insieme a targetName per recuperare l'oggetto target dopo che è stato rimosso e sostituito sulla linea temporale.	AnimatorBase
		targetParentButton : SimpleButton	AnimatorBase
		targetState3D : Array L'orientamento iniziale dell'oggetto target.	AnimatorBase
		time : int Un numero intero a base zero che indica e controlla la posizione temporale dell'animazione corrente.	AnimatorBase
		transformationPoint : Point Il punto di riferimento per la rotazione o la modifica in scala di un oggetto di visualizzazione.	AnimatorBase
		transformationPointZ : int Il punto di riferimento di una coordinata z per la rotazione o la modifica in scala di un oggetto di visualizzazione.	AnimatorBase
		usingCurrentFrame : Boolean [sola lettura] Indica se viene controllata la proprietà currentFrame ogni volta che inserite un nuovo fotogramma e se l'animazione di destinazione è sincronizzata con i fotogrammi nella relativa linea temporale dell'oggetto principale oppure se avanza continuamente, indipendentemente dal fotogramma corrente dell'oggetto principale.	AnimatorBase

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		Animator(xml:XML = null, target:DisplayObject = null) Crea un oggetto Animator per applicare la descrizione XML di un'interpolazione di movimento a un oggetto di visualizzazione.	Animator
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		end(reset:Boolean = false, stopEnterFrame:Boolean = true, pastLastFrame:Boolean = false):void Interrompe l'animazione e Flash Player passa immediatamente all'ultimo fotogramma nella sequenza di animazione.	AnimatorBase
		fromXMLString(xmlString:String, target:DisplayObject = null):Animator [statico] Crea un oggetto Animator da una stringa XML.	Animator
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		matricesEqual(a:Matrix, b:Matrix):Boolean [statico] Confronta due matrici specificate come parametri e restituisce true se sono uguali tra loro.	Animator
		nextFrame(reset:Boolean = false, stopEnterFrame:Boolean = true):void Fa avanzare Flash Player al fotogramma successivo nella sequenza di animazione.	AnimatorBase
		pause():void Mette in pausa l'animazione fino a quando viene chiamato il metodo resume().	AnimatorBase
		play(startTime:int = -1, startEnterFrame:Boolean = true):void Inizia l'animazione.	AnimatorBase
		processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void [statico]	AnimatorBase
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void [statico] Registra l'oggetto MovieClip dato e un'istanza AnimatorBase per un elemento secondario di tale MovieClip.	AnimatorBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		resume():void Riprende l'animazione dopo che è stata messa in pausa dal metodo pause().	AnimatorBase
		rewind():void Imposta Flash Player sul primo fotogramma dell'animazione.	AnimatorBase
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		startFrameEvents():void Avvia gli eventi fotogramma.	AnimatorBase
		stop():void Interrompe l'animazione e Flash Player torna al primo fotogramma nella sequenza di animazione.	AnimatorBase
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		useCurrentFrame(enable:Boolean, spanStart:int):void Imposta la proprietà currentFrame ogni volta che inserite un nuovo fotogramma e specifica se l'animazione di destinazione è sincronizzata con i fotogrammi nella relativa linea temporale dell'oggetto MovieClip principale.	AnimatorBase
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher
motionEnd	Inviato quando termina la riproduzione del movimento, ovvero quando viene raggiunta la fine oppure quando la riproduzione viene interrotta da una chiamata al metodo stop() o end().	AnimatorBase
motionStart	Inviato all'inizio della riproduzione del movimento.	AnimatorBase
motionUpdate	Inviato quando il movimento è stato modificato e lo schermo è stato aggiornato.	AnimatorBase
timeChange	Inviato quando il valore temporale dell'oggetto Animator è cambiato ma lo schermo non è ancora stato aggiornato (ovvero, l'evento motionUpdate).	AnimatorBase

Descrizione della funzione di costruzione

()

Funzione di costruzione

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Crea un oggetto Animator per applicare la descrizione XML di un'interpolazione di movimento a un oggetto di visualizzazione.

Parametri

	`xml:XML` (default = `null`) — Un oggetto E4X che contiene la descrizione dell'interpolazione di movimento basata su XML.

	`target:DisplayObject` (default = `null`) — L'oggetto di visualizzazione che utilizza l'interpolazione di movimento.

Elementi API correlati

Elementi XML di Motion

Descrizione dei metodi

fromXMLString

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Crea un oggetto Animator da una stringa XML. Questo metodo è un'alternativa all'utilizzo della funzione di costruzione Animator, che accetta invece un oggetto E4X.

Parametri

	`xmlString:String` — Una stringa XML che specifica il tipo di interpolazione di movimento.

	`target:DisplayObject` (default = `null`) — L'oggetto di visualizzazione che utilizza l'interpolazione di movimento.

Restituisce

Animator — Un'istanza Animator che applica l'oggetto xmlString specificato all'oggetto target specificato.

Elementi API correlati

Elementi XML di Motion

matricesEqual

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS5

Versioni runtime:

Flash Player 10.1, AIR 2

Confronta due matrici specificate come parametri e restituisce true se sono uguali tra loro.

Parametri

	`a:Matrix` — La prima istanza di oggetto Matrix per il confronto.

	`b:Matrix` — La seconda istanza di oggetto Matrix per il confronto.

Restituisce

Boolean — Un valore booleano; true se le due matrici sono uguali tra loro, altrimenti false.

Note legali | Informativa sulla privacy online

Animator - AS3 Flash

Classi x

Animator

fromXMLString

matricesEqual