MotionBase

Pacchetto	fl.motion
Classe	public class MotionBase
Ereditarietà	MotionBase Object
Sottoclassi	Motion

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

La classe MotionBase 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 MotionBase presenta metodi che consentono di recuperare dati in specifici punti dei fotogrammi chiave. Per ottenere valori interpolati tra fotogrammi chiave, utilizzate la classe Motion.

Vedere gli esempi

Elementi API correlati

Classe Motion
Elementi XML di Motion

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : 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.	MotionBase
		is3D : Boolean Specifica se il movimento contiene modifiche alla proprietà 3D.	MotionBase
		keyframes : Array Un array di fotogrammi chiave che definiscono il comportamento di Motion nel tempo.	MotionBase

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		MotionBase(xml:XML = null) Funzione di costruzione per le istanze MotionBase.	MotionBase
		addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Modifica una proprietà Filter in tutti i fotogrammi chiave corrispondenti per un oggetto Motion.	MotionBase
		addKeyframe(newKeyframe:KeyframeBase):void Aggiunge un oggetto keyframe all'istanza Motion.	MotionBase
		addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Memorizza un array di valori nei corrispondenti fotogrammi chiave per una proprietà dichiarata della classe Motion.	MotionBase
		getColorTransform(index:int):flash.geom:ColorTransform Recupera un oggetto ColorTransform interpolato in corrispondenza di uno specifico indice temporale nell'istanza Motion.	MotionBase
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase Recupera il fotogramma chiave attualmente attivo in un fotogramma specifico nell'istanza Motion.	MotionBase
		getFilters(index:Number):Array Recupera un array interpolato di filtri in corrispondenza di uno specifico indice temporale nell'istanza Motion.	MotionBase
		getMatrix(index:int):Matrix Restituisce l'oggetto Matrix per la posizione di indice specificata del fotogramma di animazione.	MotionBase
		getMatrix3D(index:int):Object Restituisce l'oggetto Matrix3D per la posizione di indice specificata del fotogramma di animazione.	MotionBase
		getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase Recupera il fotogramma chiave successivo dopo un fotogramma specifico nell'istanza Motion.	MotionBase
		getValue(index:Number, tweenableName:String):Number Recupera il valore di una proprietà di animazione in un determinato momento.	MotionBase
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void Inizializza l'elenco di filtri per l'oggetto target e copia l'elenco di filtri in ogni istanza Keyframe dell'oggetto Motion.	MotionBase
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void	MotionBase
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 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.	MotionBase
		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
		useRotationConcat(index:int):Boolean Ruota l'oggetto target quando i dati per il movimento vengono forniti dal metodo addPropertyArray().	MotionBase
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Descrizione delle proprietà

duration

proprietà

duration:int

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.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

is3D

proprietà

is3D:Boolean

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 10, AIR 1.5, AIR 1.0

Specifica se il movimento contiene modifiche alla proprietà 3D. Se è true, il movimento contiene modifiche alla proprietà 3D.

Il valore predefinito è false.

Implementazione
public function get is3D():Boolean
public function set is3D(value:Boolean):void

keyframes

proprietà

public var keyframes:Array

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.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.

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function MotionBase(xml:XML = null)

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Funzione di costruzione per le istanze MotionBase. 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

addFilterPropertyArray

()

metodo

 public function addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Modifica una proprietà Filter in tutti i fotogrammi chiave corrispondenti per un oggetto Motion. Chiamate initFilters() prima di utilizzare questo metodo. L'ordine dei valori nell'array determina l'assegnazione di ogni valore alla proprietà Filter per tutti i fotogrammi chiave. Per ogni valore non nullo nell'array di valori specificato, questo metodo trova il fotogramma chiave corrispondente alla posizione di indice dei valori nell'array e memorizza la coppia nome/valore della proprietà per il filtro nel fotogramma chiave.

Parametri

	`index:int` — La posizione dell'indice a base zero nell'array di filtri.

	`name:String` — Il nome della proprietà Filter da memorizzare in ogni fotogramma chiave.

	`values:Array` — L'array di valori per la proprietà specificata nel parametro `name`. Ogni valore non nullo viene assegnato al filtro in un fotogramma chiave che corrisponde all'indice dei valori nell'array.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

Altri esempi

Aggiunta di filtri

Elementi API correlati

initFilters()
flash.filters

addKeyframe

()

metodo

public function addKeyframe(newKeyframe:KeyframeBase):void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Aggiunge un oggetto keyframe all'istanza Motion.

Parametri

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

Elementi API correlati

fl.motion.Keyframe

addPropertyArray

()

metodo

public function addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Memorizza un array di valori nei corrispondenti fotogrammi chiave per una proprietà dichiarata della classe Motion. L'ordine dei valori nell'array determina l'assegnazione di ogni valore a un fotogramma chiave. Per ogni valore non nullo nell'array di valori specificato, questo metodo trova il fotogramma chiave corrispondente alla posizione di indice dei valori nell'array oppure crea un nuovo fotogramma chiave per tale posizione di indice e memorizza la coppia nome/valore della proprietà nel fotogramma chiave.

Parametri

	`name:String` — Il nome della proprietà della classe Motion da memorizzare in ogni fotogramma chiave.

	`values:Array` — L'array di valori per la proprietà specificata nel parametro `name`. Ogni valore non nullo viene assegnato a un fotogramma chiave che corrisponde all'ordine dei valori nell'array.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

Altri esempi

Descrizione dell'animazione

Elementi API correlati

fl.motion.Motion

getColorTransform

()

metodo

public function getColorTransform(index:int):flash.geom:ColorTransform

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.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

flash.geom:ColorTransform — L'oggetto ColorTransform interpolato.

Elementi API correlati

flash.geom.ColorTransform

getCurrentKeyframe

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.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 potete 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

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

Elementi API correlati

fl.motion.Tweenables

getFilters

()

metodo

public function getFilters(index:Number):Array

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.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.

Elementi API correlati

flash.filters

getMatrix

()

metodo

public function getMatrix(index:int):Matrix

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 10, AIR 1.5, AIR 1.0

Restituisce l'oggetto Matrix per la posizione di indice specificata del fotogramma di animazione.

Parametri

index:int — La posizione dell'indice a base zero del fotogramma di animazione contenente la matrice.

Restituisce

Matrix — L'oggetto Matrix o un valore null. Questo metodo può restituire un valore null anche se MotionBase.is3D è false, poiché possono essere utilizzate altre modifiche della proprietà dell'interpolazione di movimento senza un oggetto Matrix.

Elementi API correlati

flash.geom.Matrix

getMatrix3D

()

metodo

public function getMatrix3D(index:int):Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 10, AIR 1.5, AIR 1.0

Restituisce l'oggetto Matrix3D per la posizione di indice specificata del fotogramma di animazione.

Parametri

index:int — La posizione dell'indice a base zero del fotogramma di animazione contenente la matrice 3D.

Restituisce

Object — L'oggetto Matrix3D o un valore null. Questo metodo può restituire un valore null anche se MotionBase.is3D è true, poiché possono essere utilizzate altre modifiche della proprietà dell'interpolazione di movimento 3D senza un oggetto Matrix3D.

Elementi API correlati

flash.geom.Matrix3D

getNextKeyframe

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.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 consente anche di applicare un filtro in base al nome di una specifica proprietà interpolabile per trovare il fotogramma chiave successivo per una proprietà, che potrebbe non essere lo stesso del 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

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

Elementi API correlati

fl.motion.Tweenables

getValue

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.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 — Il valore numerico per la proprietà specificata nel parametro tweenableName.

Elementi API correlati

fl.motion.Tweenables

initFilters

()

metodo

 public function initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Inizializza l'elenco di filtri per l'oggetto target e copia l'elenco di filtri in ogni istanza Keyframe dell'oggetto Motion.

Parametri

	`filterClasses:Array` — Un array di classi di filtri. Ogni elemento nell'array è il nome di classe completo (in formato stringa) per il tipo di filtro che occupa quell'indice.

	`gradientSubarrayLengths:Array` — Un array di numeri contenente un valore per ogni filtro presente nell'elenco dei filtri per il movimento (ogni nome di classe nell'array `filterClasses`). Viene utilizzato un valore nell'array `gradientSubarrayLengths` solo se la voce relativa alla classe dei filtri nella stessa posizione di indice nell'array `filterClasses` è GradientGlowFilter o GradientBevelFilter. Il valore corrispondente nell'array `gradientSubarrayLengths` è un numero che determina la lunghezza per gli array che inizializzano i parametri `colors`, `alphas` e `ratios` per le funzioni di costruzione GradientGlowFilter e GradientBevelFilter.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

Altri esempi

Aggiunta di filtri

Elementi API correlati

flash.filters
flash.filters.GradientGlowFilter
flash.filters.GradientBevelFilter

overrideTargetTransform

()

metodo

public function overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void

Parametri

	`scale:Boolean` (default = `true`)

	`skew:Boolean` (default = `true`)

	`rotate:Boolean` (default = `true`)

setValue

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.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. Poiché le proprietà di trasformazione sono relative ai valori di trasformazione iniziali dell'oggetto target, i valori del primo fotogramma (valori di indice a base zero) sono sempre quelli predefiniti e non devono essere modificati.

	`tweenableName:String` — Il nome di una proprietà interpolabile sotto forma di stringa (come `"x"` o `"rotation"`).

	`value:Number` — Il nuovo valore della proprietà interpolabile.

Elementi API correlati

fl.motion.Tweenables

useRotationConcat

()

metodo

public function useRotationConcat(index:int):Boolean

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 10, AIR 1.5, AIR 1.0

Ruota l'oggetto target quando i dati per il movimento vengono forniti dal metodo addPropertyArray().

Parametri

index:int — La posizione di indice del fotogramma di animazione.

Restituisce

Boolean — Indica se l'oggetto target ruoterà utilizzando la proprietà memorizzata da KeyframeBase.rotationConcat.

Elementi API correlati

addPropertyArray()
fl.motion.KeyframeBase.rotationConcat

Esempi Come utilizzare questo esempio

MotionBaseExample.as

In questo esempio viene illustrato come animare uno sprite utilizzando le classi MotionBase e AnimatorFactory. A un oggetto MotionBase vengono assegnati array di coordinate x e y, quindi viene utilizzato per creare un oggetto AnimatorFactory. AnimatorFactory viene infine indirizzata a uno sprite, sotto forma di rettangolo riempito.

package 
{
     import flash.display.MovieClip;
     import flash.display.Sprite;
     import fl.motion.AnimatorFactory;
     import fl.motion.MotionBase;
     import flash.geom.Point;
    
     public class  MotionBaseExample extends MovieClip
     {
          private var motionBase:MotionBase;
          private var animFactory:AnimatorFactory;
          private var size:uint    = 100;
          private var bgColor:uint = 0xFFCC00;

          public function MotionBaseExample():void
          {
               var boxObj:sprite = new Sprite();
               boxObj.graphics.beginFill(bgColor);
               boxObj.graphics.drawRect(0, 0, size, size);
               boxObj.graphics.endFill();
               addChild(boxObj);

               motionBase = new MotionBase();
               motionBase.duration = 20;
               motionBase.addPropertyArray("x",[0,50,95,134,169,199,225,247,265,280]);
               motionBase.addPropertyArray("y",[0,1,0,4,12,21,32,44,52,38]);
               animFactory = new AnimatorFactory(motionBase);
               animFactory.transformationPoint = new Point(2, 2);
               animFactory.addTarget(boxObj, 0);
          }
     }    
}

Note legali | Informativa sulla privacy online

MotionBase - AS3 Flash

Pacchettix

Elementi del linguaggio

Appendici

Pacchetto fl.motion

duration

is3D

keyframes

MotionBase

addFilterPropertyArray

addKeyframe

addPropertyArray

getColorTransform

getCurrentKeyframe

getFilters

getMatrix

getMatrix3D

getNextKeyframe

getValue

initFilters

overrideTargetTransform

setValue

useRotationConcat