MotionBase

Pacote	fl.motion
Classe	public class MotionBase
Herança	MotionBase Object
Subclasses	Motion

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

A classe MotionBase armazena uma sequência de animações de quadros-chave que você pode aplicar a um objeto visual. Os dados da animação incluem posição, escala, giro, inclinação, cor, filtros e atenuação. A classe MotionBase tem métodos para recuperar dados em pontos de quadro-chave específicos. Para interpolar valores entre quadros-chave, use a classe Motion.

Veja os exemplos

Elementos da API relacionados

Classe Motion
Elementos XML de movimento

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		duration : int Controla o espaço de tempo da ocorrência Motion, medido em quadros.	MotionBase
		is3D : Boolean Especifica se o movimento contém alterações na propriedade 3D.	MotionBase
		keyframes : Array Uma matriz de quadros-chave que define o comportamento do movimento com o passar do tempo.	MotionBase

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		MotionBase(xml:XML = null) Construtor para ocorrências de MotionBase.	MotionBase
		addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Modifica uma propriedade de filtro em todos os quadros-chave correspondentes de um objeto Motion.	MotionBase
		addKeyframe(newKeyframe:KeyframeBase):void Adiciona um objeto de quadro-chave à ocorrência Motion.	MotionBase
		addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Armazena uma matriz de valores em quadros-chave correspondentes de uma propriedade declarada da classe Motion.	MotionBase
		getColorTransform(index:int):flash.geom:ColorTransform Recupera um objeto ColorTransform interpolado em um índice de tempo específico na ocorrência Motion.	MotionBase
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase Recupera o quadro-chave que está atualmente ativo em um quadro específico na ocorrência Motion.	MotionBase
		getFilters(index:Number):Array Recupera uma matriz interpolada de filtros em um índice de tempo específico na ocorrência Motion.	MotionBase
		getMatrix(index:int):Matrix Retorna o objeto Matrix para a posição de índice especificada do quadro de animação.	MotionBase
		getMatrix3D(index:int):Object Retorna o objeto Matrix3D para a posição de índice especificada do quadro de animação.	MotionBase
		getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase Recupera o quadro-chave seguinte após um quadro específico na ocorrência Motion.	MotionBase
		getValue(index:Number, tweenableName:String):Number Recupera o valor de uma propriedade de animação em um ponto no tempo.	MotionBase
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void Inicializa a lista de filtros para o objeto de destino e a copia para todas as ocorrências de Keyframe do objeto Motion.	MotionBase
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void	MotionBase
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		setValue(index:int, tweenableName:String, value:Number):void Define o valor de uma propriedade de interpoláveis específica em um índice de tempo especificado na ocorrência Motion.	MotionBase
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna a representação de string do objeto especificado.	Object
		useRotationConcat(index:int):Boolean Gira o objeto de destino quando os dados do movimento são fornecidos pelo método addPropertyArray().	MotionBase
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object

Detalhes da propriedade

duration

propriedade

duration:int

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Controla o espaço de tempo da ocorrência Motion, medido em quadros. A duração não pode ser menor do que o tempo ocupado pelos quadros-chave da ocorrência Motion.

O valor padrão é 0.

Implementação
public function get duration():int
public function set duration(value:int):void

is3D

propriedade

is3D:Boolean

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 10, AIR 1.5, AIR 1.0

Especifica se o movimento contém alterações na propriedade 3D. Se true, o movimento contém alterações na propriedade 3D.

O valor padrão é false.

Implementação
public function get is3D():Boolean
public function set is3D(value:Boolean):void

keyframes

propriedade

public var keyframes:Array

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Uma matriz de quadros-chave que define o comportamento do movimento com o passar do tempo. Essa propriedade é uma matriz esparsa, onde um quadro-chave é colocado em um índice na matriz que corresponde a suas próprias regras. Um objeto de movimento com quadros-chave em 0 e 5 tem uma matriz de quadros-chave com um comprimento de 6. Os índices 0 e 5 na matriz contêm, cada um deles, um quadro-chave, e os índices de 1 a 4 têm valores nulos.

Detalhes do construtor

()

Construtor

public function MotionBase(xml:XML = null)

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Construtor para ocorrências de MotionBase. Por padrão, um quadro-chave inicial é criado automaticamente, com propriedades padrão de transformação.

Parâmetros

xml:XML (default = null) — Objeto XML E4X que define uma ocorrência Motion.

Detalhes do método

addFilterPropertyArray

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Modifica uma propriedade de filtro em todos os quadros-chave correspondentes de um objeto Motion. Chame initFilters() antes de usar esse método. A ordem dos valores na matriz determina a atribuição de cada um deles à propriedade de filtro em todos os quadros-chave. Para cada valor não nulo na matriz de values especificados, esse método localiza o quadro-chave correspondente à posição de índice do valor na matriz e armazena o par nome/valor do filtro no quadro-chave.

Parâmetros

	`index:int` — A posição de índice com base em zero na matriz de filtros.

	`name:String` — O nome da propriedade de filtro a ser armazenada em cada quadro-chave.

	`values:Array` — A matriz de valores da propriedade especificada no parâmetro `name`. Cada valor não nulo é atribuído ao filtro em um quadro-chave correspondente ao índice do valor na matriz.

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

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

Elementos da API relacionados

initFilters()
flash.filters

addKeyframe

()

método

public function addKeyframe(newKeyframe:KeyframeBase):void

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Adiciona um objeto de quadro-chave à ocorrência Motion.

Parâmetros

newKeyframe:KeyframeBase — Um objeto de quadro-chave com uma propriedade de índice já definida.

Elementos da API relacionados

fl.motion.Keyframe

addPropertyArray

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Armazena uma matriz de valores em quadros-chave correspondentes de uma propriedade declarada da classe Motion. A ordem dos valores na matriz determina a atribuição de cada valor a um quadro-chave. Para cada valor não nulo na matriz de values especificados, esse método localiza o quadro-chave correspondente à posição de índice do valor na matriz, ou cria um novo quadro-chave para essa posição de índice e armazena o par nome/valor da propriedade no quadro-chave.

Parâmetros

	`name:String` — O nome da propriedade da classe Motion a ser armazenada em cada quadro-chave.

	`values:Array` — A matriz de valores da propriedade especificada no parâmetro `name`. Cada valor não nulo é atribuído a um quadro-chave correspondente à ordem do valor na matriz.

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

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

Elementos da API relacionados

fl.motion.Motion

getColorTransform

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Recupera um objeto ColorTransform interpolado em um índice de tempo específico na ocorrência Motion.

Parâmetros

index:int — O índice de tempo de um quadro na ocorrência Motion, como um número inteiro maior ou igual a zero.

Retorna

flash.geom:ColorTransform — O objeto ColorTransform interpolado.

Elementos da API relacionados

flash.geom.ColorTransform

getCurrentKeyframe

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Recupera o quadro-chave que está atualmente ativo em um quadro específico na ocorrência Motion. Um quadro que não é um quadro-chave deriva seus valores de um quadro-chave que o procede.

Esse método também pode filtrar valores pelo nome de uma propriedade de interpoláveis específica. Você pode localizar o quadro-chave atualmente ativo para x, que pode não ser o mesmo do quadro-chave geral atualmente ativo.

Parâmetros

	`index:int` — O índice de um quadro na ocorrência Motion, como um número inteiro maior ou igual a zero.

	`tweenableName:String` (default = "") — Nome opcional de uma propriedade de interpolável (como `"x"` ou `"rotation"`).

Retorna

KeyframeBase — Um quadro-chave correspondente mais próximo no índice de quadros fornecido ou antes dele.

Elementos da API relacionados

fl.motion.Tweenables

getFilters

()

método

public function getFilters(index:Number):Array

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Recupera uma matriz interpolada de filtros em um índice de tempo específico na ocorrência Motion.

Parâmetros

index:Number — O índice de tempo de um quadro na Motion, como um número inteiro maior ou igual a zero.

Retorna

Array — A matriz interpolada de filtros. Se não houver filtros aplicáveis, será retornada uma matriz vazia.

Elementos da API relacionados

flash.filters

getMatrix

()

método

public function getMatrix(index:int):Matrix

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 10, AIR 1.5, AIR 1.0

Retorna o objeto Matrix para a posição de índice especificada do quadro de animação.

Parâmetros

index:int — A posição de índice com base em zero do quadro de animação que contém a matriz

Retorna

Matrix — O objeto Matrix ou valor null. O método pode retornar um valor nulo mesmo que MotionBase.is3D seja false, porque você pode usar outras alterações feitas na propriedade de interpolável do movimento sem um objeto Matrix.

Elementos da API relacionados

flash.geom.Matrix

getMatrix3D

()

método

public function getMatrix3D(index:int):Object

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 10, AIR 1.5, AIR 1.0

Retorna o objeto Matrix3D para a posição de índice especificada do quadro de animação.

Parâmetros

index:int — A posição de índice com base em zero do quadro de animação que contém a matriz 3D.

Retorna

Object — O objeto Matrix3D ou valor null. O método pode retornar um valor null mesmo que MotionBase.is3D seja true, porque você pode usar outras alterações feitas na propriedade de interpolável do movimento 3D sem um objeto Matrix3D.

Elementos da API relacionados

flash.geom.Matrix3D

getNextKeyframe

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Recupera o quadro-chave seguinte após um quadro específico na ocorrência Motion. Se um quadro não for um quadro-chave, e estiver no meio de uma interpolação, esse método derivará seus valores do quadro-chave precedente e do quadro-chave seguinte.

O método também permite filtrar pelo nome de uma propriedade de interpoláveis específica e encontrar o próximo quadro-chave de uma propriedade, que pode não ser a mesma do próximo quadro-chave geral.

Parâmetros

	`index:int` — O índice de um quadro na ocorrência Motion, como um número inteiro maior ou igual a zero.

	`tweenableName:String` (default = "") — Nome opcional de uma propriedade de interpolável (como `"x"` ou `"rotation"`).

Retorna

KeyframeBase — Um quadro-chave correspondente mais próximo após o índice de quadros fornecido.

Elementos da API relacionados

fl.motion.Tweenables

getValue

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Recupera o valor de uma propriedade de animação em um ponto no tempo.

Parâmetros

	`index:Number` — O índice de tempo de um quadro na ocorrência Motion, como um número inteiro maior ou igual a zero.

	`tweenableName:String` — O nome de uma propriedade de interpolável (como `"x"` ou `"rotation"`).

Retorna

Number — O valor de número da propriedade especificada no parâmetro tweenableName.

Elementos da API relacionados

fl.motion.Tweenables

initFilters

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Inicializa a lista de filtros para o objeto de destino e a copia para todas as ocorrências de Keyframe do objeto Motion.

Parâmetros

	`filterClasses:Array` — Uma matriz de classes. Cada item na matriz é o nome de classe totalmente qualificado (no formato String) do tipo de filtro que ocupa esse índice.

	`gradientSubarrayLengths:Array` — Uma matriz de números que contém um valor para cada filtro a ser usado na lista do movimento (todos os nomes de classe na matriz `filterClasses`). Um valor na matriz `gradientSubarrayLengths` só é usado caso a entrada de classe do filtro na mesma posição de índice na matriz `filterClasses` seja GradientGlowFilter ou GradientBevelFilter. O valor correspondente na matriz `gradientSubarrayLengths` é um número que determina o comprimento das matrizes que inicializam os parâmetros `colors`, `alphas` e `ratios` das funções de construtor GradientGlowFilter e GradientBevelFilter.

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

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

Elementos da API relacionados

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

overrideTargetTransform

()

método

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

Parâmetros

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

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

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

setValue

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Define o valor de uma propriedade de interpoláveis específica em um índice de tempo especificado na ocorrência Motion. Se não existir um quadro-chave no índice, será criado um automaticamente.

Parâmetros

	`index:int` — O índice de um quadro na ocorrência Motion, como um número inteiro maior que zero. Se o índice for zero, nenhuma alteração será feita. As propriedades de transformação são relativas aos valores de transformação iniciais do objeto de destino; os valores do primeiro quadro (valor de índice zero) sempre são valores padrão e não devem ser alterados.

	`tweenableName:String` — O nome de uma propriedade de interpolável como uma string (como `"x"` ou `"rotation"`).

	`value:Number` — O novo valor da propriedade interpolável.

Elementos da API relacionados

fl.motion.Tweenables

useRotationConcat

()

método

public function useRotationConcat(index:int):Boolean

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 10, AIR 1.5, AIR 1.0

Gira o objeto de destino quando os dados do movimento são fornecidos pelo método addPropertyArray().

Parâmetros

index:int — A posição do quadro da animação no índice.

Retorna

Boolean — Indica se o objeto de destino será girado usando a propriedade armazenada em KeyframeBase.rotationConcat.

Elementos da API relacionados

addPropertyArray()
fl.motion.KeyframeBase.rotationConcat

Exemplos Como usar este exemplo

MotionBaseExample.as

Este exemplo mostra como animar um sprite com o uso do MotionBase e classes AnimatorFactory. Um objeto de MotionBase é atribuído a matrizes de coordenadas de x e y e depois é usado para criar um objeto de AnimatorFactory. O AnimatorFactory é finalmente derecionado a um sprite, na forma de um retângulo preenchido.

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);
          }
     }    
}

Aspectos jurídicos | Política de privacidade on-line

MotionBase - AS3 Flash

Pacotesx

Elementos de linguagem

Apêndices

Pacote fl.motion

duration

is3D

keyframes

MotionBase

addFilterPropertyArray

addKeyframe

addPropertyArray

getColorTransform

getCurrentKeyframe

getFilters

getMatrix

getMatrix3D

getNextKeyframe

getValue

initFilters

overrideTargetTransform

setValue

useRotationConcat