| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
La clase Tween permite utilizar ActionScript para mover, cambiar el tamaño y desvanecer clips de película especificando una propiedad del clip de película de destino para animar durante un número de fotogramas o segundos.
La clase Tween también permite especificar diversos métodos de suavizado. "Suavizado" hace referencia a la aceleración o desaceleración gradual durante una animación, que da un aspecto más realista a las animaciones. El paquete fl.transitions.easing ofrece numerosos métodos de suavizado que contienen ecuaciones para esta aceleración y desaceleración, lo que cambia la animación de suavizado en consonancia.
Para utilizar los métodos y las propiedades de la clase Tween, use el operador new con la función constructora para crear una instancia de la clase y especifique un método de aceleración como parámetro. Por ejemplo:
import fl.transitions.Tween;
import fl.transitions.easing.*;
var myTween:Tween = new Tween(myObject, "x", Elastic.easeOut, 0, 300, 3, true);
public var begin:Number = NaN
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Valor inicial de la propiedad designada del objeto de destino antes del comienzo de la interpolación.
duration:Number [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Duración de la animación interpolada en fotogramas o segundos. Esta propiedad se establece como un parámetro cuando se crea una nueva instancia de Tween o cuando se llama al método Tween.yoyo().
Implementación
public function get duration():Number
public function set duration(value:Number):void
finish:Number [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Número que indica el valor final de la propiedad de objeto de destino que se va a interpolar. Esta propiedad se establece como un parámetro cuando se crea una nueva instancia de Tween o cuando se llama al método Tween.yoyo().
Implementación
public function get finish():Number
public function set finish(value:Number):void
Véase también
FPS:Number [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Número de fotogramas por segundo calculado en la animación interpolada. De manera predeterminada, la velocidad de fotogramas actual del escenario se utiliza para calcular la animación interpolada. Al establecer esta propiedad se recalcula el número de incrementos en la propiedad animada que se muestra cada segundo como el valor de la propiedad Tween.FPS en lugar de la velocidad de fotogramas actual del escenario. Al establecer el valor de la propiedad Tween.FPS, la velocidad de fotogramas real del escenario no cambia.
Nota: la propiedad Tween.FPS devuelve undefined a menos que primero se establezca explícitamente.
Implementación
public function get FPS():Number
public function set FPS(value:Number):void
public var func:Function
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Función de aceleración utilizada con la interpolación.
public var isPlaying:Boolean = false
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica si la interpolación se está reproduciendo en ese momento.
public var looping:Boolean = false
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica si la interpolación ejecutará un bucle. Si el valor es true, la interpolación se reiniciará indefinidamente cada que se complete la interpolación. Si el valor es false, la interpolación se reproducirá una sola vez.
public var obj:Object = null
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Objeto de destino que se está interpolando.
position:Number [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Valor actual de la propiedad del objeto de destino que se está interpolando. Este valor se actualiza con cada fotograma dibujado de la animación interpolada.
Implementación
public function get position():Number
public function set position(value:Number):void
public var prop:String = ""
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Nombre de la propiedad afectada por la interpolación del objeto de destino.
time:Number [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Tiempo transcurrido de la duración de la animación.
Implementación
public function get time():Number
public function set time(value:Number):void
public var useSeconds:Boolean = false
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica si la interpolación se reproduce durante un período de fotogramas o segundos. El valor true hará que la interpolación se anime durante un período de segundos especificado mediante la propiedad duration. false hará que se anime durante un período de fotogramas.
public function Tween(obj:Object, prop:String, func:Function, begin:Number, finish:Number, duration:Number, useSeconds:Boolean = false)
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Crea una instancia de la clase Tween. Utilice la función constructora con el operador new: var myTween:Tween = new Tween().
Parámetros
| obj:Object — Objeto de destino de la clase Tween.
|
| |
| prop:String — Nombre de la propiedad (valor de parámetro obj) que se verá afectado.
|
| |
| func:Function — Nombre de la función de suavizado que se utiliza.
|
| |
| begin:Number — Valor inicial del parámetro prop.
|
| |
| finish:Number — Número que indica el valor final del parámetro prop (la propiedad del objeto de destino que se va a interpolar).
|
| |
| duration:Number — Longitud del tiempo del movimiento; se establece como infinity si es negativo o se omite.
|
| |
| useSeconds:Boolean (default = false) — Indicador que especifica el uso de segundos en lugar de fotogramas. La función utiliza segundos si es true, o fotogramas en relación con el valor especificado en el parámetro duration si es false.
|
Véase también
public function continueTo(finish:Number, duration:Number):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica a la animación interpolada que continúe la interpolación desde el punto de animación actual hasta un nuevo punto final y de duración.
Parámetros
| finish:Number — Número que indica el valor final de la propiedad de objeto de destino que se va a interpolar.
|
| |
| duration:Number — Número que indica la longitud de tiempo o el número de fotogramas del movimiento de interpolación; la duración se mide en longitud de tiempo si el parámetro Tween.start() useSeconds se establece como true, o en fotogramas si se establece como false.
|
Véase también
public function fforward():void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lleva la animación interpolada directamente a su valor final.
public function nextFrame():void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lleva la animación interpolada hasta el fotograma siguiente de una animación detenida. Utilice este método para avanzar un fotograma en un tiempo de una animación interpolada tras utilizar el método Tween.stop() para detenerla.
Nota: utilice este método sólo en animaciones basadas en fotogramas. Para especificar que una interpolación se base en fotogramas, debe establecer el parámetro useSeconds como false.
public function prevFrame():void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Reproduce el fotograma anterior de la animación interpolada desde el punto en el que se ha detenido en una animación detenida. Utilice este método para retroceder la animación interpolada un fotograma hasta un momento después de haberla detenido mediante el método Tween.stop().
Nota: utilice este método sólo en animaciones basadas en fotogramas. Para especificar que una interpolación se base en fotogramas, debe establecer el parámetro Tween.start() useSeconds como false.
Véase también
public function resume():void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Reanuda la reproducción de una animación interpolada detenida. Utilice este método para continuar una animación interpolada tras haberlo detenido mediante el método Tween.stop().
Nota: utilice este método sólo en animaciones basadas en fotogramas. Para especificar que una interpolación se basa en fotogramas, debe establecer el valor false en el parámetro useSeconds.
public function rewind(t:Number = 0):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Desplaza la reproducción de una animación interpolada hasta su valor inicial. Si se llama a Tween.rewind() mientras se está reproduciendo la animación interpolada, la animación se rebobina hasta su valor inicial y continúa reproduciéndose. Si se llama a Tween.rewind() mientras la animación interpolada está detenida o ha finalizado, la animación interpolada se rebobina hasta su valor inicial y permanece detenida. Utilice este método para rebobinar una animación interpolada hasta su punto inicial después de haberla detenido mediante el método Tween.stop() o para rebobinar una animación interpolada mientras se reproduce.
Parámetros
| t:Number (default = 0) — Valor inicial.
|
public function start():void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Inicia la reproducción de una animación interpolada desde su punto inicial. Este método se utiliza para reiniciar una instancia de Tween desde el principio de su animación después de que se haya detenido o completado su animación.
public function stop():void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Detiene la reproducción de una animación interpolada en su punto actual.
public function yoyo():void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Ordena a la animación interpolada que se reproduzca a la inversa desde el último sentido de incrementos de la propiedad de interpolación. Si se llama a este método antes de que se complete la animación del objeto Tween, la animación salta bruscamente al final de la reproducción en dirección inversa desde ese punto. Puede conseguir el efecto de una animación completando toda su reproducción y, a continuación, invirtiéndola llamando al método Tween.yoyo() dentro de un controlador de eventos TweenEvent.MOTION_FINISH. Este proceso garantiza que el efecto inverso del método Tween.yoyo() no comienza hasta que no se complete la animación interpolada actual.
Tipo de objeto de evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_CHANGE
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica que la interpolación ha cambiado y que la pantalla se ha actualizado.
Las propiedades del objeto de evento tiene los valores siguientes:
| 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 es el valor de la propiedad currentTarget. |
target | El objeto que distribuye el evento no es siempre el que lo detecta. Utilice la propiedad currentTarget para acceder siempre al objeto que detecta el evento. |
time | Hora de la interpolación en la que ocurrió el evento. |
position | Valor de la propiedad controlada por la interpolación, cuando el evento ocurrió. |
Tipo de objeto de evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_FINISH
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica que la interpolación ha alcanzado el final y ha terminado.
Las propiedades del objeto de evento tiene los valores siguientes:
| 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 es el valor de la propiedad currentTarget. |
target | El objeto que distribuye el evento no es siempre el que lo detecta. Utilice la propiedad currentTarget para acceder siempre al objeto que detecta el evento. |
time | Hora de la interpolación en la que ocurrió el evento. |
position | Valor de la propiedad controlada por la interpolación, cuando el evento ocurrió. |
Tipo de objeto de evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_LOOP
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica el reinicio de la reproducción de la interpolación desde el principio en modo de bucle.
Las propiedades del objeto de evento tiene los valores siguientes:
| 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 es el valor de la propiedad currentTarget. |
target | El objeto que distribuye el evento no es siempre el que lo detecta. Utilice la propiedad currentTarget para acceder siempre al objeto que detecta el evento. |
time | Hora de la interpolación en la que ocurrió el evento. |
position | Valor de la propiedad controlada por la interpolación, cuando el evento ocurrió. |
Tipo de objeto de evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_RESUME
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica la reanudación de la reproducción de la interpolación tras una pausa.
Las propiedades del objeto de evento tiene los valores siguientes:
| 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 es el valor de la propiedad currentTarget. |
target | El objeto que distribuye el evento no es siempre el que lo detecta. Utilice la propiedad currentTarget para acceder siempre al objeto que detecta el evento. |
time | Hora de la interpolación en la que ocurrió el evento. |
position | Valor de la propiedad controlada por la interpolación, cuando el evento ocurrió. |
Tipo de objeto de evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_START
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica que ha comenzado la reproducción del movimiento.
Las propiedades del objeto de evento tiene los valores siguientes:
| 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 es el valor de la propiedad currentTarget. |
target | El objeto que distribuye el evento no es siempre el que lo detecta. Utilice la propiedad currentTarget para acceder siempre al objeto que detecta el evento. |
time | Hora de la interpolación en la que ocurrió el evento. |
position | Valor de la propiedad controlada por la interpolación, cuando el evento ocurrió. |
Tipo de objeto de evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_STOP
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica que la interpolación se ha detenido con una llamada explícita a
Tween.stop().
Las propiedades del objeto de evento tiene los valores siguientes:
| 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 es el valor de la propiedad currentTarget. |
target | El objeto que distribuye el evento no es siempre el que lo detecta. Utilice la propiedad currentTarget para acceder siempre al objeto que detecta el evento. |
time | Hora de la interpolación en la que ocurrió el evento. |
position | Valor de la propiedad controlada por la interpolación, cuando el evento ocurrió. |
© 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/transitions/Tween.html