Paquetefl.transitions
Clasepublic class Tween
HerenciaTween Inheritance EventDispatcher Inheritance Object

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

Véase también

fl.transitions.TransitionManager
fl.transitions.easing
Tween()


Propiedades públicas
 PropiedadDefinido por
  begin : Number = NaN
Valor inicial de la propiedad designada del objeto de destino antes del comienzo de la interpolación.
Tween
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  duration : Number
Duración de la animación interpolada en fotogramas o segundos.
Tween
  finish : Number
Número que indica el valor final de la propiedad de objeto de destino que se va a interpolar.
Tween
  FPS : Number
Número de fotogramas por segundo calculado en la animación interpolada.
Tween
  func : Function
Función de aceleración utilizada con la interpolación.
Tween
  isPlaying : Boolean = false
Indica si la interpolación se está reproduciendo en ese momento.
Tween
  looping : Boolean = false
Indica si la interpolación ejecutará un bucle.
Tween
  obj : Object = null
Objeto de destino que se está interpolando.
Tween
  position : Number
Valor actual de la propiedad del objeto de destino que se está interpolando.
Tween
  prop : String = ""
Nombre de la propiedad afectada por la interpolación del objeto de destino.
Tween
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  time : Number
Tiempo transcurrido de la duración de la animación.
Tween
  useSeconds : Boolean = false
Indica si la interpolación se reproduce durante un período de fotogramas o segundos.
Tween
Métodos públicos
 MétodoDefinido por
  
Tween(obj:Object, prop:String, func:Function, begin:Number, finish:Number, duration:Number, useSeconds:Boolean = false)
Crea una instancia de la clase Tween.
Tween
 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
  
continueTo(finish:Number, duration:Number):void
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.
Tween
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
  
Lleva la animación interpolada directamente a su valor final.
Tween
 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
  
Lleva la animación interpolada hasta el fotograma siguiente de una animación detenida.
Tween
  
Reproduce el fotograma anterior de la animación interpolada desde el punto en el que se ha detenido en una animación detenida.
Tween
 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 reproducción de una animación interpolada detenida.
Tween
  
rewind(t:Number = 0):void
Desplaza la reproducción de una animación interpolada hasta su valor inicial.
Tween
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
Inicia la reproducción de una animación interpolada desde su punto inicial.
Tween
  
Detiene la reproducción de una animación interpolada en su punto actual.
Tween
 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
  
Ordena a la animación interpolada que se reproduzca a la inversa desde el último sentido de incrementos de la propiedad de interpolación.
Tween
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
   Indica que la interpolación ha cambiado y que la pantalla se ha actualizado.Tween
   Indica que la interpolación ha alcanzado el final y ha terminado.Tween
   Indica el reinicio de la reproducción de la interpolación desde el principio en modo de bucle.Tween
   Indica la reanudación de la reproducción de la interpolación tras una pausa.Tween
   Indica que ha comenzado la reproducción del movimiento.Tween
   Indica que la interpolación se ha detenido con una llamada explícita a Tween.stop().Tween
Información sobre propiedades
beginpropiedad
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.

durationpropiedad 
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
finishpropiedad 
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

FPSpropiedad 
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
funcpropiedad 
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.

isPlayingpropiedad 
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.

loopingpropiedad 
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.

objpropiedad 
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.

positionpropiedad 
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
proppropiedad 
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.

timepropiedad 
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
useSecondspropiedad 
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.

Información sobre constructores
Tween()constructor
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

Información sobre métodos
continueTo()método
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

fforward()método 
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.

nextFrame()método 
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.

prevFrame()método 
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

resume()método 
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.

rewind()método 
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.

start()método 
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.

stop()método 
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.

yoyo()método 
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.

Información sobre eventos
motionChange Evento
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:

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 es el valor de la propiedad currentTarget.
targetEl 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.
timeHora de la interpolación en la que ocurrió el evento.
positionValor de la propiedad controlada por la interpolación, cuando el evento ocurrió.
motionFinish Evento  
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:

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 es el valor de la propiedad currentTarget.
targetEl 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.
timeHora de la interpolación en la que ocurrió el evento.
positionValor de la propiedad controlada por la interpolación, cuando el evento ocurrió.
motionLoop Evento  
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:

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 es el valor de la propiedad currentTarget.
targetEl 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.
timeHora de la interpolación en la que ocurrió el evento.
positionValor de la propiedad controlada por la interpolación, cuando el evento ocurrió.
motionResume Evento  
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:

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 es el valor de la propiedad currentTarget.
targetEl 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.
timeHora de la interpolación en la que ocurrió el evento.
positionValor de la propiedad controlada por la interpolación, cuando el evento ocurrió.
motionStart Evento  
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:

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 es el valor de la propiedad currentTarget.
targetEl 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.
timeHora de la interpolación en la que ocurrió el evento.
positionValor de la propiedad controlada por la interpolación, cuando el evento ocurrió.
motionStop Evento  
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:

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 es el valor de la propiedad currentTarget.
targetEl 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.
timeHora de la interpolación en la que ocurrió el evento.
positionValor de la propiedad controlada por la interpolación, cuando el evento ocurrió.




 

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/transitions/Tween.html