Paquetefl.motion
Clasepublic class Animator
HerenciaAnimator Inheritance EventDispatcher Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

La clase Animator aplica la descripción XML de un movimiento de interpolación a un objeto de visualización. Las propiedades y métodos de la clase Animator controlan la reproducción del movimiento, y Flash Player difunde eventos como respuesta a los cambios detectados en el estado del movimiento. La clase Animator la utiliza fundamentalmente el comando "Copiar movimiento como ActionScript" en Flash CS3. Es posible editar el código ActionScript con la interfaz de programación de aplicaciones (API), o bien crear una animación personalizada propia.

Si tiene previsto llamar a métodos de la clase Animator en una función, declare la instancia de Animator fuera de dicha función de forma que el ámbito del objeto no se limite a ella. Si declara la instancia de Animator en la función, Flash Player la eliminará al final de la misma como parte de su rutina de "recogida de basura" de Flash Player y no se animará el objeto de destino.

Nota: si no se utiliza Flash CS3 para compilar el archivo SWF, las clases fl.motion deberán estar en la ruta de clases en el momento de la compilación para poder aplicar el movimiento al objeto de visualización.

Propiedad MXML predeterminadamotion

Véase también

Elementos Motion XML


Propiedades públicas
 PropiedadDefinido por
  autoRewind : Boolean = false
Define la animación para que se reinicie una vez finalizada.
Animator
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  isPlaying : Boolean
[read-only] Indica si la animación se está reproduciendo en ese momento.
Animator
  motion : Motion
Objeto que contiene las propiedades del movimiento de interpolación para la animación.
Animator
  orientToPath : Boolean = false
Define la posición del objeto de visualización en la ruta de movimiento.
Animator
  positionMatrix : Matrix
Objeto Matrix que aplica una transformación global en la ruta de movimiento.
Animator
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  repeatCount : int = 1
Número de veces que se repite la animación.
Animator
  target : DisplayObject
Objeto de visualización que se está animando.
Animator
  time : int
Entero basado en cero que indica y controla el tiempo de la animación en curso.
Animator
  transformationPoint : Point
Punto de referencia para girar o escalar un objeto de visualización.
Animator
Métodos públicos
 MétodoDefinido por
  
Animator(xml:XML = null, target:DisplayObject = null)
Crea un objeto Animator para aplicar la descripción del movimiento de interpolación basado en XML a un objeto de visualización.
Animator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.
EventDispatcher
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
  
end():void
Detiene la animación y Flash Player accede inmediatamente al último fotograma de la secuencia de animación.
Animator
  
fromXMLString(xmlString:String, target:DisplayObject = null):Animator
[static] Crea un objeto Animator a partir de una cadena de XML.
Animator
 Inherited
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.
EventDispatcher
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
  
Avanza Flash Player hasta el siguiente fotograma de la secuencia de animación.
Animator
  
Detiene temporalmente la animación hasta que se llama al método resume().
Animator
  
Inicia la animación.
Animator
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
  
Reanuda la animación tras haberse detenido temporalmente por la acción del método pause().
Animator
  
Establece a Flash Player en el primer fotograma de la animación.
Animator
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
Detiene la animación y Flash Player retrocede hasta el primer fotograma de la secuencia de animación.
Animator
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
 Inherited
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.
EventDispatcher
Eventos
 Evento Resumen Definido por
 Inherited Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo.EventDispatcher
 Inherited Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo.EventDispatcher
   Se distribuye cuando termina de reproducirse el movimiento, ya sea cuando llega al final o cuando se interrumpe por una llamada a los métodos stop() o end().Animator
   Se distribuye cuando comienza a reproducirse el movimiento.Animator
   Se distribuye cuando cambia el movimiento y se actualiza la pantalla.Animator
   Se distribuye cuando cambia el valor time de Animator, pero la pantalla no se ha actualizado aún (es decir, no se ha distribuido el evento motionUpdate).Animator
Información sobre propiedades
autoRewindpropiedad
public var autoRewind:Boolean = false

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Define la animación para que se reinicie una vez finalizada.

isPlayingpropiedad 
isPlaying:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Indica si la animación se está reproduciendo en ese momento.


Implementación
    public function get isPlaying():Boolean
motionpropiedad 
motion:Motion  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Objeto que contiene las propiedades del movimiento de interpolación para la animación.


Implementación
    public function get motion():Motion
    public function set motion(value:Motion):void
orientToPathpropiedad 
public var orientToPath:Boolean = false

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Define la posición del objeto de visualización en la ruta de movimiento. Si se define como true, la línea base del objeto de visualización se orienta en la ruta de movimiento; en caso contrario, el punto de registro se orienta en la ruta de movimiento.

positionMatrixpropiedad 
public var positionMatrix:Matrix

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Objeto Matrix que aplica una transformación global en la ruta de movimiento. Esta matriz permite cambiar, escalar, sesgar o girar la ruta sin que cambie el aspecto del objeto de visualización.

repeatCountpropiedad 
public var repeatCount:int = 1

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Número de veces que se repite la animación. Los valores posibles son cualquier número entero mayor o igual que 0. Un valor de 1 significa que la animación se reproduce una vez. Un valor de 0 significa que la animación se reproduce indefinidamente hasta que se detiene de forma explícita (mediante una llamada al método end(), por ejemplo).

El valor predeterminado es 1.

Véase también

targetpropiedad 
target:DisplayObject  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Objeto de visualización que se está animando. Se puede utilizar cualquier subclase de flash.display.DisplayObject, por ejemplo, MovieClip, Sprite o Bitmap.


Implementación
    public function get target():DisplayObject
    public function set target(value:DisplayObject):void

Véase también

timepropiedad 
time:int  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Entero basado en cero que indica y controla el tiempo de la animación en curso. En el primer fotograma de la animación, el valor de time es 0. Si la animación tiene una duración de 10 fotogramas, en el último fotograma el valor de time será 9.


Implementación
    public function get time():int
    public function set time(value:int):void
transformationPointpropiedad 
public var transformationPoint:Point

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Punto de referencia para girar o escalar un objeto de visualización. El punto de transformación es relativo al cuadro delimitador del objeto de visualización. Las coordenadas del punto deben escalarse hasta un cuadro de 1 x 1 píxeles, donde (1, 1) es la esquina inferior derecha del objeto y (0, 0) representa la esquina superior izquierda.

Información sobre constructores
Animator()constructor
public function Animator(xml:XML = null, target:DisplayObject = null)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Crea un objeto Animator para aplicar la descripción del movimiento de interpolación basado en XML a un objeto de visualización.

Parámetros
xml:XML (default = null) — Objeto E4X que contiene una descripción de movimiento de interpolación basado en XML.
 
target:DisplayObject (default = null) — Objeto de visualización que utiliza el movimiento de interpolación.

Véase también

Información sobre métodos
end()método
public function end():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Detiene la animación y Flash Player accede inmediatamente al último fotograma de la secuencia de animación. Si la propiedad autoRewind se define como true, Flash Player accede al primer fotograma de la secuencia de animación.

Véase también

fromXMLString()método 
public static function fromXMLString(xmlString:String, target:DisplayObject = null):Animator

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Crea un objeto Animator a partir de una cadena de XML. Este método es una alternativa al constructor Animator, que acepta un objeto E4X en su lugar.

Parámetros

xmlString:String — Cadena de XML que describe el movimiento de interpolación.
 
target:DisplayObject (default = null) — Objeto de visualización que utiliza el movimiento de interpolación.

Valor devuelto
Animator — Instancia de Animator que aplica la cadena xmlString concreta al objeto target especificado.

Véase también

nextFrame()método 
public function nextFrame():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Avanza Flash Player hasta el siguiente fotograma de la secuencia de animación.

pause()método 
public function pause():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Detiene temporalmente la animación hasta que se llama al método resume().

Véase también

play()método 
public function play():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Inicia la animación. Llama al método end() antes de llamar al método play() para garantizar que todas las instancias previas de la animación han concluido antes de iniciar una nueva.

Véase también

resume()método 
public function resume():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Reanuda la animación tras haberse detenido temporalmente por la acción del método pause().

Véase también

rewind()método 
public function rewind():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Establece a Flash Player en el primer fotograma de la animación. Si la animación se estaba reproduciendo, la reproducción continúa desde el primer fotograma. Si la animación estaba detenida, permanece detenida en el primer fotograma.

stop()método 
public function stop():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Detiene la animación y Flash Player retrocede hasta el primer fotograma de la secuencia de animación.

Véase también

Información sobre eventos
motionEnd Evento
Tipo de objeto de evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_END

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye cuando termina de reproducirse el movimiento, ya sea cuando llega al final o cuando se interrumpe por una llamada a los métodos stop() o end().

Indica que el movimiento se ha detenido, bien por una llamada explícita a Animator.stop() o Animator.end(), o bien por haber llegado al final de la instancia de Motion.

Las propiedades del objeto de evento tienen los siguientes valores:

PropiedadValor
bubblesfalse
cancelablefalse
currentTargetObjeto que define el detector de eventos que gestiona el evento. Por ejemplo, si utiliza myButton.addEventListener() para registrar un detector de eventos, myButton será el valor de currentTarget.
targetObjeto que distribuyó el evento; no siempre se trata del objeto que detecta el evento. Utilice la propiedad currentTarget para acceder siempre al objeto que detecta el evento.
motionStart Evento  
Tipo de objeto de evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_START

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye cuando comienza a reproducirse el movimiento.

Indica que la instancia de Motion ha comenzado a reproducirse.

Las propiedades del objeto de evento tienen los siguientes valores:

PropiedadValor
bubblesfalse
cancelablefalse
currentTargetObjeto que define el detector de eventos que gestiona el evento. Por ejemplo, si utiliza myButton.addEventListener() para registrar un detector de eventos, myButton será el valor de currentTarget.
targetObjeto que distribuyó el evento; no siempre se trata del objeto que detecta el evento. Utilice la propiedad currentTarget para acceder siempre al objeto que detecta el evento.
motionUpdate Evento  
Tipo de objeto de evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_UPDATE

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye cuando cambia el movimiento y se actualiza la pantalla.

Indica que la instancia de Motion ha cambiado y que se ha actualizado la pantalla.

Las propiedades del objeto de evento tienen los siguientes valores:

PropiedadValor
bubblesfalse
cancelablefalse
currentTargetObjeto que define el detector de eventos que gestiona el evento. Por ejemplo, si utiliza myButton.addEventListener() para registrar un detector de eventos, myButton será el valor de currentTarget.
targetObjeto que distribuyó el evento; no siempre se trata del objeto que detecta el evento. Utilice la propiedad currentTarget para acceder siempre al objeto que detecta el evento.
timeChange Evento  
Tipo de objeto de evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.TIME_CHANGE

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Se distribuye cuando cambia el valor time de Animator, pero la pantalla no se ha actualizado aún (es decir, no se ha distribuido el evento motionUpdate).

Indica que el valor time de la instancia de Animator ha cambiado, pero que la pantalla no se ha actualizado aún (Flash Player no ha distribuido el evento motionUpdate).

Las propiedades del objeto de evento tienen los siguientes valores:

PropiedadValor
bubblesfalse
cancelablefalse
currentTargetObjeto que define el detector de eventos que gestiona el evento. Por ejemplo, si utiliza myButton.addEventListener() para registrar un detector de eventos, myButton será el valor de currentTarget.
targetObjeto que distribuyó el evento; no siempre se trata del objeto que detecta el evento. Utilice la propiedad currentTarget para acceder siempre al objeto que detecta el evento.




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/fl/motion/Animator.html