MotionBase

Paquete	fl.motion
Clase	public class MotionBase
Herencia	MotionBase Object
Subclases	Motion

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

La clase MotionBase almacena una secuencia de animación de fotogramas clave que se puede aplicar a un objeto visual. La información de animación incluye datos sobre ubicación, escala, rotación, sesgado, color, filtros y aceleración. La clase MotionBase dispone de métodos para recuperar datos en puntos concretos de fotogramas clave. Para obtener valores interpolados entre fotogramas clave, utilice la clase Motion.

Ver los ejemplos

Elementos de API relacionados

Clase Motion
Elementos Motion XML

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		duration : int Controla la duración de la instancia de Motion, medida en fotogramas.	MotionBase
		is3D : Boolean Especifica si el movimiento contiene cambios de propiedades 3D.	MotionBase
		keyframes : Array Conjunto de fotogramas clave que define el comportamiento del movimiento a lo largo del tiempo.	MotionBase

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		MotionBase(xml:XML = null) Constructor para instancias de MotionBase.	MotionBase
		addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Modifica una propiedad filter en todos los fotogramas clave correspondientes de un objeto Motion.	MotionBase
		addKeyframe(newKeyframe:KeyframeBase):void Añade un objeto Keyframe a la instancia de Motion.	MotionBase
		addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Almacena un conjunto de valores en los fotogramas clave correspondientes de una propiedad declarada de la clase Motion.	MotionBase
		getColorTransform(index:int):flash.geom:ColorTransform Recupera un objeto ColorTransform interpolado en un índice de tiempo específico de la instancia de Motion.	MotionBase
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase Recupera el fotograma clave activo en ese momento en el fotograma concreto de la instancia de Motion.	MotionBase
		getFilters(index:Number):Array Recupera un conjunto interpolado de filtros en un índice de tiempo específico de la instancia de Motion.	MotionBase
		getMatrix(index:int):Matrix Devuelve el objeto Matrix para la posición del índice especificado en el fotograma de la animación.	MotionBase
		getMatrix3D(index:int):Object Devuelve el objeto Matrix3D para la posición del índice especificado en el fotograma de la animación.	MotionBase
		getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase Recupera el siguiente fotograma clave tras un fotograma concreto de la instancia de Motion.	MotionBase
		getValue(index:Number, tweenableName:String):Number Recupera el valor de una propiedad de animación en un punto del tiempo.	MotionBase
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void Inicializa la lista de filtros del objeto de destino y copia la lista de filtros en cada instancia de objeto Keyframe y Motion.	MotionBase
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void	MotionBase
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		setValue(index:int, tweenableName:String, value:Number):void Define el valor de una propiedad concreta de interpolación en un índice de tiempo determinado de la instancia de Motion.	MotionBase
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		useRotationConcat(index:int):Boolean Gira el objeto de destino cuando el método addPropertyArray() proporciona datos para el movimiento.	MotionBase
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object

Información sobre propiedades

duration

propiedad

duration:int

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Controla la duración de la instancia de Motion, medida en fotogramas. La duración no puede ser inferior al tiempo que ocupan los fotogramas clave de la instancia de Motion.

El valor predeterminado es 0.

Implementación
public function get duration():int
public function set duration(value:int):void

is3D

propiedad

is3D:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5, AIR 1.0

Especifica si el movimiento contiene cambios de propiedades 3D. Si es true, el movimiento contiene cambios de propiedades 3D.

El valor predeterminado es false.

Implementación
public function get is3D():Boolean
public function set is3D(value:Boolean):void

keyframes

propiedad

public var keyframes:Array

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Conjunto de fotogramas clave que define el comportamiento del movimiento a lo largo del tiempo. Esta propiedad es un conjunto disperso en la que un fotograma clave se coloca en un índice del conjunto que coincida con su propio índice. De este modo, un objeto de movimiento con fotogramas clave en los índices 0 y 5 tendrá un conjunto de fotogramas clave de longitud 6. Los índices 0 y 5 del conjunto contendrán cada uno un fotograma clave, y los índices del 1 al 4 tendrán valores null.

Información sobre constructores

()

Información sobre

public function MotionBase(xml:XML = null)

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Constructor para instancias de MotionBase. De forma predeterminada, se crea automáticamente un fotograma clave inicial con propiedades de transformación predeterminadas.

Parámetros

xml:XML (default = null) — Objeto XML E4X opcional que define una instancia de Motion.

Información sobre métodos

addFilterPropertyArray

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Modifica una propiedad filter en todos los fotogramas clave correspondientes de un objeto Motion. Llame a initFilters() antes de utilizar este método. El orden de los valores en el conjunto determina la asignación de cada valor a la propiedad filter de todos los fotogramas clave. Para cada valor no null del conjunto values especificada, este método busca el fotograma clave correspondiente a la posición del índice del valor en el conjunto y almacena el par nombre/valor de la propiedad para el filtro del fotograma clave.

Parámetros

	`index:int` — La posición del índice basado en cero en el conjunto de filtros.

	`name:String` — Nombre de la propiedad filter que se almacena en cada fotograma clave.

	`values:Array` — Conjunto de valores de la propiedad especificada en el parámetro `name`. Cada valor no null se asigna al filtro de un fotograma clave que corresponde al índice del valor en el conjunto.

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

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

Elementos de API relacionados

initFilters()
flash.filters

addKeyframe

()

método

public function addKeyframe(newKeyframe:KeyframeBase):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Añade un objeto Keyframe a la instancia de Motion.

Parámetros

newKeyframe:KeyframeBase — Objeto Keyframe con una propiedad index ya definida.

Elementos de API relacionados

fl.motion.Keyframe

addPropertyArray

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Almacena un conjunto de valores en los fotogramas clave correspondientes de una propiedad declarada de la clase Motion. El orden de los valores en el conjunto determina la asignación de cada valor a un fotograma clave. Para cada valor no null del conjunto values, este método busca el fotograma clave correspondiente a la posición del índice del valor en el conjunto, o bien crea un fotograma clave nuevo para dicha posición del índice y guarda el par nombre/valor de la propiedad en el fotograma clave.

Parámetros

	`name:String` — Nombre de la propiedad de la clase Motion que se almacena en cada fotograma clave.

	`values:Array` — Conjunto de valores de la propiedad especificada en el parámetro `name`. Cada valor no null se asigna a un fotograma clave que corresponde al orden del valor en el conjunto.

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

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

Elementos de API relacionados

fl.motion.Motion

getColorTransform

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Recupera un objeto ColorTransform interpolado en un índice de tiempo específico de la instancia de Motion.

Parámetros

index:int — Índice de tiempo de un fotograma de la instancia de Motion, como un número entero mayor o igual que cero.

Valor devuelto

flash.geom:ColorTransform — Objeto ColorTransform interpolado.

Elementos de API relacionados

flash.geom.ColorTransform

getCurrentKeyframe

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Recupera el fotograma clave activo en ese momento en el fotograma concreto de la instancia de Motion. Un fotograma que no sea clave obtiene sus valores desde el fotograma clave que lo precede.

Este método también puede filtrar valores por el nombre de una propiedad concreta de interpolación. Esto permite encontrar el fotograma clave activo en ese momento para x, que puede no coincidir con el fotograma clave activo en general.

Parámetros

	`index:int` — Índice de un fotograma de la instancia de Motion, como un número entero mayor o igual que cero.

	`tweenableName:String` (default = "") — Nombre opcional de una propiedad de interpolación (como `"x"` o `"rotation"`).

Valor devuelto

KeyframeBase — Fotograma clave con mayor grado de coincidencia en el índice del fotograma suministrado o en una posición anterior.

Elementos de API relacionados

fl.motion.Tweenables

getFilters

()

método

public function getFilters(index:Number):Array

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Recupera un conjunto interpolado de filtros en un índice de tiempo específico de la instancia de Motion.

Parámetros

index:Number — Índice de tiempo de un fotograma del objeto Motion, como un número entero mayor o igual que cero.

Valor devuelto

Array — Conjunto interpolado de filtros. Si no hay ningún filtro pertinente, se devuelve un conjunto vacío.

Elementos de API relacionados

flash.filters

getMatrix

()

método

public function getMatrix(index:int):Matrix

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5, AIR 1.0

Devuelve el objeto Matrix para la posición del índice especificado en el fotograma de la animación.

Parámetros

index:int — Posición del índice basada en cero en el fotograma de la animación que contiene la matriz

Valor devuelto

Matrix — El objeto Matrix o un valor null. Este método puede devolver un valor null incluso si MotionBase.is3D es false, ya que se pueden utilizar otros cambios de la propiedad de interpolación de movimiento sin necesidad de un objeto Matrix.

Elementos de API relacionados

flash.geom.Matrix

getMatrix3D

()

método

public function getMatrix3D(index:int):Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5, AIR 1.0

Devuelve el objeto Matrix3D para la posición del índice especificado en el fotograma de la animación.

Parámetros

index:int — Posición del índice basada en cero en el fotograma de la animación que contiene la matriz 3D.

Valor devuelto

Object — El objeto Matrix3D o un valor null. Este método puede devolver un valor null incluso si MotionBase.is3D es true, ya que se pueden utilizar otros cambios de la propiedad de interpolación de movimiento 3D sin necesidad de un objeto Matrix3D.

Elementos de API relacionados

flash.geom.Matrix3D

getNextKeyframe

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Recupera el siguiente fotograma clave tras un fotograma concreto de la instancia de Motion. Si un fotograma no es clave y se encuentra en medio de una interpolación, este método obtiene sus valores tanto desde el fotograma clave que lo precede como desde el que le sigue.

Este método también permite filtrar por nombre una propiedad de interpolación concreta para encontrar el siguiente fotograma clave de una propiedad (que puede coincidir o no con el siguiente fotograma clave).

Parámetros

	`index:int` — Índice de un fotograma de la instancia de Motion, como un número entero mayor o igual que cero.

	`tweenableName:String` (default = "") — Nombre opcional de una propiedad de interpolación (como `"x"` o `"rotation"`).

Valor devuelto

KeyframeBase — Fotograma clave con mayor grado de coincidencia después del índice del fotograma suministrado.

Elementos de API relacionados

fl.motion.Tweenables

getValue

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Recupera el valor de una propiedad de animación en un punto del tiempo.

Parámetros

	`index:Number` — Índice de tiempo de un fotograma de la instancia de Motion, como un número entero mayor o igual que cero.

	`tweenableName:String` — Nombre de una propiedad de interpolación (como `"x"` o `"rotation"`).

Valor devuelto

Number — El valor numérico de la propiedad especificada en el parámetro tweenableName.

Elementos de API relacionados

fl.motion.Tweenables

initFilters

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Inicializa la lista de filtros del objeto de destino y copia la lista de filtros en cada instancia de objeto Keyframe y Motion.

Parámetros

	`filterClasses:Array` — Un conjunto de clases de filtro. Cada elemento del conjunto es el nombre completo de clase cualificada (en forma de cadena) para el tipo de filtro que ocupa dicho índice.

	`gradientSubarrayLengths:Array` — Un conjunto de números que contiene un valor para cada filtro de la lista de filtros del movimiento (cada nombre de clase del conjunto `filterClasses`). Un valor del conjunto `gradientSubarrayLengths` sólo se utiliza si la entrada de la clase de filtro en la misma posición de índice del conjunto `filterClasses` es GradientGlowFilter o GradientBevelFilter. El valor correspondiente en el conjunto `gradientSubarrayLengths` es un número que determina la longitud de los conjuntos que inicializan los parámetros `color`, `alpha` y `ratio` de las funciones constructoras GradientGlowFilter y GradientBevelFilter.

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

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

Elementos de 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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Define el valor de una propiedad concreta de interpolación en un índice de tiempo determinado de la instancia de Motion. Si no hay ningún fotograma clave en el índice, se crea uno automáticamente.

Parámetros

	`index:int` — Índice de tiempo de un fotograma de la instancia de Motion, como un número entero mayor que cero. Si el índice es cero, no se produce ningún cambio. Las propiedades de transformación son relativas a los valores iniciales de transformación del objeto de destino; los valores del primer fotograma (valor de índice cero) siempre son valores predeterminados y no deben modificarse.

	`tweenableName:String` — El nombre de una propiedad de interpolación como una cadena (como `"x"` o `"rotation"`).

	`value:Number` — Nuevo valor de la propiedad de interpolación.

Elementos de API relacionados

fl.motion.Tweenables

useRotationConcat

()

método

public function useRotationConcat(index:int):Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5, AIR 1.0

Gira el objeto de destino cuando el método addPropertyArray() proporciona datos para el movimiento.

Parámetros

index:int — Posición del índice del fotograma de animación.

Valor devuelto

Boolean — Indica si el objeto de destino se gira utilizando la propiedad almacenada en KeyframeBase.rotationConcat.

Elementos de API relacionados

addPropertyArray()
fl.motion.KeyframeBase.rotationConcat

Ejemplos Cómo utilizar este ejemplo

MotionBaseExample.as

Este ejemplo muestra cómo animar un objeto sprite utilizando las clases MotionBase y AnimatorFactory. A un objeto MotionBase se le asginan conjuntos de coordenadas x e y. Seguidamente, se utiliza para crear un objeto AnimatorFactory. Finalmente AnimatorFactory se destina a un objeto sprite en forma de un rectángulo con relleno.

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

Avisos legales | Política de privacidad en línea

MotionBase - AS3 Flash

Paquetesx

Elementos del lenguaje

Apéndices

Paquete fl.motion

duration

is3D

keyframes

MotionBase

addFilterPropertyArray

addKeyframe

addPropertyArray

getColorTransform

getCurrentKeyframe

getFilters

getMatrix

getMatrix3D

getNextKeyframe

getValue

initFilters

overrideTargetTransform

setValue

useRotationConcat