Pacchettofl.motion
Classepublic class Motion
EreditarietàMotion Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

La classe Motion memorizza una sequenza di animazione di fotogrammi chiave che può essere applicata a un oggetto visivo. I dati di animazione includono posizione, scala, rotazione, inclinazione, colore, filtri e andamento. La classe Motion presenta metodi che consentono di recuperare dati in precisi punti temporali e di interpolare automaticamente valori tra fotogrammi chiave.

Proprietà MXML predefinitakeyframesCompact

Vedere anche

Elementi XML di Motion


Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  duration: int
Controlla la durata dell'istanza Motion, misurata in fotogrammi.
Motion
  keyframes: Array
Un array di fotogrammi chiave che definiscono il comportamento di Motion nel tempo.
Motion
  keyframesCompact: Array
Un array di fotogrammi chiave compatto, in cui ogni posizione di indice è occupata da un fotogramma chiave.
Motion
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  source: Source
Un oggetto che memorizza informazioni sul contesto in cui è stato creato l'oggetto motion, ad esempio la frequenza di fotogrammi, le dimensioni, il punto di trasformazione e la posizione iniziale, la scala, la rotazione e l'inclinazione.
Motion
Metodi pubblici
 MetodoDefinito da
  
Motion(xml:XML = null)
Funzione di costruzione per le istanze Motion.
Motion
  
addKeyframe(newKeyframe:Keyframe):void
Aggiunge un oggetto keyframe all'istanza Motion.
Motion
  
[statico] Un metodo necessario per creare un'istanza Motion da una stringa XML.
Motion
  
Recupera un oggetto ColorTransform interpolato in corrispondenza di uno specifico indice temporale nell'istanza Motion.
Motion
  
getCurrentKeyframe(index:int, tweenableName:String = ""):Keyframe
Recupera il fotogramma chiave attualmente attivo in un fotogramma specifico nell'istanza Motion.
Motion
  
Recupera un array interpolato di filtri in corrispondenza di uno specifico indice temporale nell'istanza Motion.
Motion
  
getNextKeyframe(index:int, tweenableName:String = ""):Keyframe
Recupera il fotogramma chiave successivo dopo un fotogramma specifico nell'istanza Motion.
Motion
  
getValue(index:Number, tweenableName:String):Number
Recupera il valore di una proprietà di animazione in un determinato momento.
Motion
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
  
[statico] Fonde in modo fluido i filtri da un oggetto filter a un altro.
Motion
  
interpolateFilters(fromFilters:Array, toFilters:Array, progress:Number):Array
[statico] Fonde i filtri in modo fluido da un array di oggetti filter a un altro.
Motion
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
setValue(index:int, tweenableName:String, value:Number):void
Imposta il valore di una specifica proprietà interpolabile in corrispondenza di un determinato indice temporale nell'istanza Motion.
Motion
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà
durationproprietà
duration:int  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Controlla la durata dell'istanza Motion, misurata in fotogrammi. La durata non può essere inferiore al tempo occupato dai fotogrammi chiave dell'istanza Motion.

Il valore predefinito è 0.


Implementazione
    public function get duration():int
    public function set duration(value:int):void
keyframesproprietà 
public var keyframes:Array

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Un array di fotogrammi chiave che definiscono il comportamento di Motion nel tempo. Questa proprietà è un array sparso, dove un oggetto keyframe viene posizionato in corrispondenza di un indice nell'array corrispondente al proprio indice. Un oggetto motion con fotogrammi chiave nei fotogrammi 0 e 5 avrà un array di fotogrammi chiave con una lunghezza pari a 6. Ognuno degli indici 0 e 5 nell'array contiene un oggetto keyframe, mentre quelli da 1 a 4 presentano dei valori null.

keyframesCompactproprietà 
keyframesCompact:Array  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Un array di fotogrammi chiave compatto, in cui ogni posizione di indice è occupata da un fotogramma chiave. Al contrario, un array sparso presenta indici vuoti (come la proprietà keyframes). In un array compatto non vengono utilizzati valori null per occupare gli indici tra i fotogrammi chiave. Tuttavia, l'indice di un fotogramma chiave in keyframesCompact molto probabilmente non corrisponde al relativo indice nell'array keyframes.

Questa proprietà viene utilizzata principalmente per compatibilità con il compiler MXML di Flex, che genera un array compatto dall'XML di Motion.


Implementazione
    public function get keyframesCompact():Array
    public function set keyframesCompact(value:Array):void

Vedere anche

sourceproprietà 
public var source:Source

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Un oggetto che memorizza informazioni sul contesto in cui è stato creato l'oggetto motion, ad esempio la frequenza di fotogrammi, le dimensioni, il punto di trasformazione e la posizione iniziale, la scala, la rotazione e l'inclinazione.

Descrizione della funzione di costruzione
Motion()Funzione di costruzione
public function Motion(xml:XML = null)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Funzione di costruzione per le istanze Motion. Per impostazione predefinita, un fotogramma chiave iniziale viene creato automaticamente con proprietà di trasformazione predefinite.

Parametri
xml:XML (default = null) — Oggetto E4X XML opzionale che definisce un'istanza Motion.
Descrizione dei metodi
addKeyframe()metodo
public function addKeyframe(newKeyframe:Keyframe):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Aggiunge un oggetto keyframe all'istanza Motion.

Parametri

newKeyframe:Keyframe — Un oggetto keyframe con una proprietà index già impostata.

Vedere anche

fromXMLString()metodo 
public static function fromXMLString(xmlString:String):Motion

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Un metodo necessario per creare un'istanza Motion da una stringa XML.

Parametri

xmlString:String — Una stringa di XML di Motion.

Restituisce
Motion — Una nuova istanza Motion.
getColorTransform()metodo 
public function getColorTransform(index:int):ColorTransform

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Recupera un oggetto ColorTransform interpolato in corrispondenza di uno specifico indice temporale nell'istanza Motion.

Parametri

index:int — L'indice temporale di un fotogramma nell'istanza Motion, sotto forma di un valore intero superiore o uguale a zero.

Restituisce
ColorTransform — L'oggetto ColorTransform interpolato.

Vedere anche

getCurrentKeyframe()metodo 
public function getCurrentKeyframe(index:int, tweenableName:String = ""):Keyframe

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Recupera il fotogramma chiave attualmente attivo in un fotogramma specifico nell'istanza Motion. Un fotogramma che non è un fotogramma chiave ottiene i valori dal fotogramma chiave che lo precede.

Questo metodo può anche applicare un filtro ai valori in base al nome di una specifica proprietà interpolabile. In questo modo è possibile trovare il fotogramma attualmente attivo per x, che potrebbe non essere lo stesso fotogramma attualmente attivo in generale.

Parametri

index:int — L'indice di un fotogramma nell'istanza Motion, sotto forma di un valore intero superiore o uguale a zero.
 
tweenableName:String (default = "") — Nome opzionale di una proprietà interpolabile, come "x" o "rotation".

Restituisce
Keyframe — Il fotogramma chiave più simile in corrispondenza o prima dell'indice di fotogramma specificato.

Vedere anche

getFilters()metodo 
public function getFilters(index:Number):Array

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Recupera un array interpolato di filtri in corrispondenza di uno specifico indice temporale nell'istanza Motion.

Parametri

index:Number — L'indice temporale di un fotogramma nell'oggetto Motion, sotto forma di un valore intero superiore o uguale a zero.

Restituisce
Array — L'array interpolato di filtri. Se non sono presenti dei filtri applicabili, restituisce un array vuoto.

Vedere anche

getNextKeyframe()metodo 
public function getNextKeyframe(index:int, tweenableName:String = ""):Keyframe

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Recupera il fotogramma chiave successivo dopo un fotogramma specifico nell'istanza Motion. Se un fotogramma non è un fotogramma chiave e si trova nel mezzo di un'interpolazione, questo metodo consente di ottenere i valori sia dal fotogramma che lo precede che dal fotogramma che lo segue.

Questo metodo può anche applicare un filtro in base al nome di una specifica proprietà interpolabile. In questo modo è possibile trovare il fotogramma successivo per x, che potrebbe non essere lo stesso fotogramma successivo in generale.

Parametri

index:int — L'indice di un fotogramma nell'istanza Motion, sotto forma di un valore intero superiore o uguale a zero.
 
tweenableName:String (default = "") — Nome opzionale di una proprietà interpolabile, come "x" o "rotation".

Restituisce
Keyframe — Il fotogramma chiave più simile dopo l'indice di fotogramma specificato.

Vedere anche

getValue()metodo 
public function getValue(index:Number, tweenableName:String):Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Recupera il valore di una proprietà di animazione in un determinato momento.

Parametri

index:Number — L'indice temporale di un fotogramma nell'istanza Motion, sotto forma di un valore intero superiore o uguale a zero.
 
tweenableName:String — Il nome di una proprietà interpolabile, come "x" o "rotation".

Restituisce
Number

Vedere anche

interpolateFilter()metodo 
public static function interpolateFilter(fromFilter:BitmapFilter, toFilter:BitmapFilter, progress:Number):BitmapFilter

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Fonde in modo fluido i filtri da un oggetto filter a un altro.

Parametri

fromFilter:BitmapFilter — L'oggetto filter iniziale.
 
toFilter:BitmapFilter — L'oggetto filter finale.
 
progress:Number — La percentuale della transizione sotto forma di valore decimale, dove 0 è l'inizio e 1 è la fine.

Restituisce
BitmapFilter — L'oggetto filter interpolato.

Vedere anche

interpolateFilters()metodo 
public static function interpolateFilters(fromFilters:Array, toFilters:Array, progress:Number):Array

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Fonde i filtri in modo fluido da un array di oggetti filter a un altro.

Parametri

fromFilters:Array — L'array iniziale di oggetti filter.
 
toFilters:Array — L'array finale di oggetti filter.
 
progress:Number — La percentuale della transizione sotto forma di valore decimale, dove 0 è l'inizio e 1 è la fine.

Restituisce
Array — L'array interpolato di oggetti filter.

Vedere anche

setValue()metodo 
public function setValue(index:int, tweenableName:String, value:Number):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Imposta il valore di una specifica proprietà interpolabile in corrispondenza di un determinato indice temporale nell'istanza Motion. Se un fotogramma chiave non esiste in corrispondenza dell'indice, viene creato automaticamente.

Parametri

index:int — L'indice temporale di un fotogramma nell'istanza Motion, sotto forma di un valore intero maggiore di zero. Se il valore dell'indice è zero, non viene apportata alcuna modifica. Dal momento che le proprietà di trasformazione sono relative alla trasformazione iniziale dell'oggetto target, i valori del primo fotogramma sono sempre quelli predefiniti e non devono essere modificati.
 
tweenableName:String — Il nome di una proprietà interpolabile, come "x" o "rotation".
 
value:Number — Il nuovo valore della proprietà interpolabile.

Vedere anche





 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/fl/motion/Motion.html