| 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.
motion
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.
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
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
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.
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.
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
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
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
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.
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
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
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
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.
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
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
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
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.
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
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:
| Propiedad | Valor |
bubbles | false |
cancelable | false |
currentTarget | Objeto 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. |
target | Objeto 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. |
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:
| Propiedad | Valor |
bubbles | false |
cancelable | false |
currentTarget | Objeto 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. |
target | Objeto 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. |
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:
| Propiedad | Valor |
bubbles | false |
cancelable | false |
currentTarget | Objeto 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. |
target | Objeto 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. |
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:
| Propiedad | Valor |
bubbles | false |
cancelable | false |
currentTarget | Objeto 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. |
target | Objeto 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. |
© 2004-2007 Adobe Systems Incorporated. Todos los derechos reservados.
Fri Oct 12 2007, 2:30 AM GMT-07:00
Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/fl/motion/Animator.html