Documentar a Família inteira em português vai exigir alguns dias, quem sabe semanas de trabalho, mas como eu não me enxergo mais trabalhando sem essa classe, acho muito importante evangelizar seu uso.

Confira no flash abaixo (reduzido para caber) vários exemplos de como a classe funciona. Basta selecionar entre as diferentes opções e clicar em Tween para ver o resultado.

A Classe TweenLite

Método estático to
TweenLite.to(target:Object, duration:Number, variables:Object):TweenLite
Onde:
- target:Object é o alvo da interpolação, um movieclip, um botão, um objeto sound, um objeto papervision3d.
- duration:Number é o tempo em segundos que dura a interpolação.
- variables:Object é um conjunto de variáveis contiadas em um objeto, incluindo as propriedades de cada objeto e variáveis da classe, com valores finais e funções a serem executadas.

Exemplo:
Vamos executar uma tween de um objeto chamado “bola” em 1 segundo, movendo-o de sua posição atual para o centro do palco, alterando seu alpha para 50% e sua escala total para 80%, ao final da tween, vamos executar um trace com a palavra “Fim”.

TweenLite.to(bola, 1, {x:stage.stageWidth/2,y:stage.stageHeight/2, alpha:.5, scaleX:.8, scaleY:.8, onComplete:traceIt});
function traceIt():void
{
trace(“Fim”);
}

Método estático from

Exemplo:
Vamos fazer com que a bola, que está – supomos – no canto superior esquerdo, ao inicar o filme, caminhar do centro para este local, mudar seu alpha de 50%

para 100% e sua escala de 80% para 100%, ou seja, ela vai iniciar transformada e terminar como está no palco, desta forma:

TweenLite.from(bola, 1, {x:stage.stageWidth/2,y:stage.stageHeight/2, alpha:.5, scaleX:.8, scaleY:.8, onComplete:traceIt});

Então, ao executar o filme esses valores inseridos como parâmetros serão tomados como inciais, ou seja, vamos fazer o processo inverso do método to.

• delay:Number: Número em segundos de espera para inciar uma tween.

• ease:Function: Você pode especificar uma função de easing, por exemplo ease:Strong.easeOut.

• easeParams:Array: Um array de parâmetros para você modificar e custmizar sua função de easing.

• autoAlpha:Number: Funciona como a propriedade “alpha”, mas com esse parâmetro a propriedade “visible” de um objeto também é alterada para “false” quando o objeto se torna 100% transparente, e alterada para “true” quando seu alpha é maior que 0.

• visible:Boolean: Altera a propriedade “visible” do objeto no fim da interpolação.

• volume:Number: Modifica o volume de um objeto(MovieClip, SoundChannel, NetStream) utilizando a propriedade soundTransform.

• tint:uint: Para mudar a cor de um objeto, utilizando valores não inteiros como ex: 0xffffff (para colorir com branco)

• removeTint:Boolean: Remove a propriedade tint aplicada a um objeto.

• frame:int: Use para animar um MovieClip para um determinado frame.

• onStart:Function: Para chamar uma função no início da interpolação.

• onStartParams:Array Um array contendo parâmetros a serem enviados para a função chamada no evento onStart, ex: onStartParams:["lorem", 1, 0xffcc00].

• onUpdate:Function: Para chamar uma função sempre e enquanto uma propriedade do objeto for alterada.

• onUpdateParams:Array: Um array com parâmetros para a função durante a interpolação.

• onComplete:Function: Para chamar uma função no final da interpolação.

• onCompleteParams:Array: Um array com parâmetros para essa função no fim da interpolação.

• persist:Boolean: Quando ativada, essa opção NÃO permite que a tween seja enviada para a “garbage collection”, permitindo que ela possa ser alterada ou atualizada. Por padrão essa opção é false.

• renderOnStart:Boolean: Utilizado quando você ativa o parâmetro “runBackwards” ou quando utilizando o método from com delayCall. Irei explicar quando explicar esses métodos (delayedcall).

• runBackwards:Boolean: Troca os valores final e inicial da tween, o método from faz isto automaticamente.

• overwrite:int: Controla como duas tweens sobre um mesmo objeto simultaneamente se comportam.
  overwrite: 0 (nenhum) – As tweens não se sobrescrevem, mas deve-se tomar cuidado ao aplicar duas tweens diferentes sobre a mesma propriedade de um mesmo objeto.
  overwrite: 1 (todos) – Valor padrão quando NÃO utilizada a classe OverwriteManager e invocado o método OverwriteManager.init(), dessa forma, uma segunda tween sobrescreve completamente uma primeira, sobrescrevendo todas as suas propriedades.
  overwrite: 2 (auto) – Valor padrão quando iniciado o método init() do OverwriteManager, faz com que apenas as propriedades chamadas em ambas as tweens sejam sobrescritas pela nova tween.
  overwrite: 3 (concorrente) – Sobrescreve todas as propriedades do mesmo objeto quando inciada a nova tween.

Método estático delayedCall
TweenLite.delayedCall(delay:Number, onComplete:Function, onCompleteParams:Array)
Serve para definir um intervalo de tempo para executar uma função, uma espécie de time.
Onde:
delay: Tempo em segundos
onComplete: É a função que você vai chamar ao fim do tempo
onCompleteParams: Um array com parâmetros para esta função

Método estático killTweensOf
TweenLite.killTweensOf(target:Object, complete:Boolean)
Serve para forçar o término de todas as tweens de um objeto, você pode inclusive forçar o objeto a terminar a tween (imadiatamente) chamando a função – caso exista – definida no parâmetro onComplete
Onde:
target: O Objeto que as tweens serão finalizadas
complete: Se “true”, finaliza as tweens levando o objeto aos valores finais imediatamente e sem interpolação

Método estático killDelayedCallTo
TweenLite.killDelayedCallsTo(function:Function)
Serve para matar o evento criando pelo método TweenLite.delayedCAll()
Onde:
function: É a função que terá as chamadas finalizadas

import gs.TweenLite;
import gs.plugins.GlowFilterPlugin;
import gs.TweenPlugin;
TweenPlugin.activate([GlowFilterPlugin]);

TweenLite.to(obj, 1, {glowFilter:{color:0xffffff, alpha:1, blurX:30, blurY:30}});