| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.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. La classe Animator viene utilizzata principalmente dal comando "Copia movimento come ActionScript" in Flash CS3. È possibile modificare il codice ActionScript mediante l'API oppure creare un'animazione personalizzata.
Se si intende chiamare i metodi della classe Animator all'interno di una funzione, è necessario dichiarare l'istanza Animator al di fuori della funzione, affinché l'area di validità dell'oggetto non sia limitata alla funzione stessa. Se si dichiara 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: se non si utilizza Flash CS3 per compilare il file SWF, sono necessarie le classi fl.motion nel percorso di classe in fase di compilazione per applicare il movimento all'oggetto di visualizzazione.
motion
public var autoRewind:Boolean = false
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Imposta l'animazione in modo che riprenda da capo dopo che è terminata.
isPlaying:Boolean [sola lettura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Indica se l'animazione è in corso di riproduzione.
Implementazione
public function get isPlaying():Boolean
motion:Motion [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
L'oggetto che contiene le proprietà dell'interpolazione di movimento dell'animazione.
Implementazione
public function get motion():Motion
public function set motion(value:Motion):void
public var orientToPath:Boolean = false
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Imposta la posizione dell'oggetto di visualizzazione lungo il tracciato del movimento. Se è true, la linea di base dell'oggetto di visualizzazione si orienta verso il tracciato del movimento; in caso contrario, è il punto di registrazione a orientarsi verso il tracciato del movimento.
public var positionMatrix:Matrix
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
L'oggetto Matrix che applica una trasformazione globale al tracciato di movimento. Questa matrice consente di spostare, modificare in scala, inclinare e ruotare il tracciato senza modificare l'aspetto dell'oggetto di visualizzazione.
public var repeatCount:int = 1
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Numero di ripetizioni dell'animazione. I valori possibili sono tutti i numeri interi superiori o uguali a 0. Un valore pari a 1 indica che l'animazione viene riprodotta una sola volta. Il valore 0 indica che l'animazione viene riprodotta indefinitamente fino a quando viene esplicitamente interrotta (ad esempio, mediante una chiamata al metodo end()).
Il valore predefinito è 1.
Vedere anche
target:DisplayObject [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
L'oggetto di visualizzazione in corso di animazione. È possibile utilizzare qualunque sottoclasse di flash.display.DisplayObject, ad esempio MovieClip, Sprite o Bitmap.
Implementazione
public function get target():DisplayObject
public function set target(value:DisplayObject):void
Vedere anche
time:int [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Un numero intero a base zero che indica e controlla la posizione temporale dell'animazione corrente. In corrispondenza del primo fotogramma dell'animazione il valore di time è 0. Se l'animazione ha una durata di 10 fotogrammi, il valore di time nell'ultimo fotogramma è 9.
Implementazione
public function get time():int
public function set time(value:int):void
public var transformationPoint:Point
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Il punto di riferimento per la rotazione o la modifica in scala di un oggetto di visualizzazione. Il punto di trasformazione è relativo al riquadro di delimitazione dell'oggetto di visualizzazione. Le coordinate del punto devono essere modificate in scala fino a ottenere una casella di 1 x 1 pixel, dove (1, 1) è l'angolo inferiore destro dell'oggetto e (0, 0) è l'angolo superiore sinistro.
public function Animator(xml:XML = null, target:DisplayObject = null)
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.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.
|
Vedere anche
public function end():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Interrompe l'animazione e Flash Player passa immediatamente all'ultimo fotogramma nella sequenza di animazione. Se la proprietà autoRewind è impostata su true, Flash Player passa al primo fotogramma nella sequenza di animazione.
Vedere anche
public static function fromXMLString(xmlString:String, target:DisplayObject = null):Animator
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.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.
|
Vedere anche
public function nextFrame():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Fa avanzare Flash Player al fotogramma successivo nella sequenza di animazione.
public function pause():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Mette in pausa l'animazione fino a quando viene chiamato il metodo resume().
Vedere anche
public function play():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Inizia l'animazione. Chiamare il metodo end() prima di play() per assicurarsi che tutte le eventuali istanze precedenti dell'animazione siano terminate prima di iniziarne una nuova.
Vedere anche
public function resume():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Riprende l'animazione dopo che è stata messa in pausa dal metodo pause().
Vedere anche
public function rewind():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Imposta Flash Player sul primo fotogramma dell'animazione. Se l'animazione è in corso di riproduzione, la riproduzione continua dal primo fotogramma. Se l'animazione è stata interrotta, la riproduzione rimane ferma al primo fotogramma.
public function stop():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Interrompe l'animazione e Flash Player torna al primo fotogramma nella sequenza di animazione.
Vedere anche
Tipo di oggetto evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_END
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
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().
Indica che il movimento è stato interrotto mediante una chiamata esplicita a
Animator.stop() o
Animator.end() oppure perché è stata raggiunta la fine dell'istanza Motion.
Le proprietà degli oggetti evento hanno i seguenti valori:
| Proprietà | Valore |
bubbles | false |
cancelable | false |
currentTarget | L'oggetto che definisce il listener di eventi che gestisce l'evento. Ad esempio, se si utilizza myButton.addEventListener() per registrare un listener di eventi, myButton è il valore di currentTarget. |
target | L'oggetto che ha inviato l'evento; non si tratta sempre dell'oggetto che ascolta l'evento. Utilizzare la proprietà currentTarget per accedere sempre all'oggetto che ascolta l'evento. |
Tipo di oggetto evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_START
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Inviato all'inizio della riproduzione del movimento.
Indica che è iniziata la riproduzione dell'istanza Motion.
Le proprietà degli oggetti evento hanno i seguenti valori:
| Proprietà | Valore |
bubbles | false |
cancelable | false |
currentTarget | L'oggetto che definisce il listener di eventi che gestisce l'evento. Ad esempio, se si utilizza myButton.addEventListener() per registrare un listener di eventi, myButton è il valore di currentTarget. |
target | L'oggetto che ha inviato l'evento; non si tratta sempre dell'oggetto che ascolta l'evento. Utilizzare la proprietà currentTarget per accedere sempre all'oggetto che ascolta l'evento. |
Tipo di oggetto evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_UPDATE
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Inviato quando il movimento è stato modificato e lo schermo è stato aggiornato.
Inviato quando l'istanza Motion è cambiata e lo schermo è stato aggiornato.
Le proprietà degli oggetti evento hanno i seguenti valori:
| Proprietà | Valore |
bubbles | false |
cancelable | false |
currentTarget | L'oggetto che definisce il listener di eventi che gestisce l'evento. Ad esempio, se si utilizza myButton.addEventListener() per registrare un listener di eventi, myButton è il valore di currentTarget. |
target | L'oggetto che ha inviato l'evento; non si tratta sempre dell'oggetto che ascolta l'evento. Utilizzare la proprietà currentTarget per accedere sempre all'oggetto che ascolta l'evento. |
Tipo di oggetto evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.TIME_CHANGE
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Inviato quando il valore time dell'oggetto Animator è cambiato ma lo schermo non è ancora stato aggiornato (ovvero, l'evento motionUpdate).
Indica che il valore
time dell'istanza Animator è cambiato ma lo schermo non è ancora stato aggiornato (ovvero, Flash Player non ha inviato l'evento
motionUpdate).
Le proprietà degli oggetti evento hanno i seguenti valori:
| Proprietà | Valore |
bubbles | false |
cancelable | false |
currentTarget | L'oggetto che definisce il listener di eventi che gestisce l'evento. Ad esempio, se si utilizza myButton.addEventListener() per registrare un listener di eventi, myButton è il valore di currentTarget. |
target | L'oggetto che ha inviato l'evento; non si tratta sempre dell'oggetto che ascolta l'evento. Utilizzare la proprietà currentTarget per accedere sempre all'oggetto che ascolta l'evento. |
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Oct 12 2007, 3:14 AM GMT-07:00
Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/fl/motion/Animator.html