TweenLite说明

• 效率(这也是作者所标榜的TWEENLITE2大优点之一，呵呵，“标榜”这个词用得可能有点过了，不过人家确实有那个实力)这里有2者运行效率对比的例子：tweening-speed-test
• onComplete, onStart, onUpdate 等回调方法是TWEEN所没有的(TWEENLITE还可以往这些方法中传递任意个参数)
• 智能的alpha(当alpha达到0时，TWEENLITE会自动将对象的visible设为false)
• 在一次方法调用中就可以缓动多个属性
• 可以设置每一次缓动的延时(对有先后顺序的缓动很有效)
• 实现任何MovieClip/Sprite的变色效果非常简单
• 可以缓动MovieClip的声音
• 唯一的from()方法使你可以使用当前的属性值作为缓动的目标值
• 使用相关联的值
• 在一次方法调用中就可以缓动多个数组的值
• TWEENLITE默认会自动地覆盖同一个对象的缓动以免出现冲突(当然这个特性也是可以关闭的)
• 强大的delayedCall()方法使你可以随意设置延时和延时过后所调用的变量，甚至传递任意个数的参数
• TWEENLITE有一个更加powerful的大哥”TweenFilterLite”，而TWEEN只在孤军奋战…当TWEENLITE有什么搞不定的时候，直接去找他大哥.

用法：
TweenLite.to(target:Object, duration:Number, variables:Object);
Description：将target对象的属性从调用方法时的值缓动到variables中所指定的值
Parameters：

• target:要缓动的对象(这里注意类型是Object,并不仅仅是MovieClip和Sprite)
• duration:持续的时间(单位是秒)
• variables: 一个Object,包含你想要缓动的所有属性(在TweenLite.from()方法中，这些变量表示的则是开始缓动时的值)，如果你给某个属性加引 号，它将关联到当前的值。例如y:”xxx”,无论你引号里指定多少，它只会缓动到当前的值或者从当前的值开始缓动(在 TweenLite.from()方法中)

//2者效果是一样的(通常情况下是不需要加引号的
TweenLite.to(mc, 5, {x:"10", y:"20", ease:Elastic.easeOut});
TweenLite.to(mc, 5, {x:"20", y:"30", ease:Elastic.easeOut});

特殊属性：

• delay:Number-延时几秒后开始缓动，这在有先后顺序的缓动效果中很有用
• ease:Function-应用在variables上的缓动函数，比如gs.easing.Elastic.easeOut。默认值是Regular.easeOut.当然你也可以应用CustomEase来定义自己的缓动函数(CustomEase属于收费内容)
• easeParam:Array-给缓动函数提供额外参数的数组。这在使用Elastic缓动函数时控制其他参数比图振幅和周期会非常有用(ADOBE官 方文档中，Elastic.easeXX()方法是可以有6个参数的，但是在TweenLite中只提供4个参数，那么另外2个参数：周期和振幅就可以在 这个数组中给定)。大部分的缓动函数是只有4个参数的，所以通常情况下是不需要传入easeParams参数的。
• autoAlpha:Number-效果和改变”alpha”值一样，但是多了一个特性：如果alpha最终变为0，则自动将visible设为false。同样如果autoAlpha的值大于0，则在开始缓动前会自动将visible设为true
• visible:Boolean-缓动效果结束时DisplayObject对象的visible属性
• volume:Number-缓动对象的SoundTransform属性(例如MovieClip/SoundChannel/NetStream等)
• tint:uint-改变DisplayObject对象的色调，设置一个要缓动到的16进制的颜色值(在from()函数中表示起始值)
• removeTint:Boolean-表示是否要取消一个应用在DisplayObject对象的tint属性
• frame:int-缓动MovieClip到指定的帧(在from()函数中表示起始帧)
• onStart:Function-在缓动开始时触发此方法
• onStartParams:Array-数组，装有传递给onStart方法的参数
• onUpdate:Function-当属性值发生改变时(缓动进行中的每一帧，每一秒)触发此方法
• onUpdateParams:Array-数组，装有传递给OnUpdate方法的参数
• onComplete:Function-在缓动效果结束时触发此方法
• onCompleteParams:Array-数组，装有传递给onComplete方法的参数
• persist:Boolean-如果设为true,在缓动效果结束时，TweenLite实例将不会被垃圾回收器自动回收。当然，persist为true的时候，这个缓动效果仍然可以被其他的缓动覆盖。默认值是false
• renderOnStart:Boolean-在调用TweenLite.from()函数并且还有一个延时的时候，如果想要让指定的起始属性值在延时结 束之后才展现出来的话，将renderOnStart设为true,相反，如果设为false,在延时开始之时就会立即展现指定的起始属性值。默认值是 false

  //mc会在y=20处停留3秒，然后在5秒内缓动到当前位置
  TweenLite.from(mc, 5, { y:20, ease:Elastic.easeOut, delay:3, renderOnStart:false } );
  //mc会在当前位置置停留3秒，然后跳到y=20的位置开始缓动
  TweenLite.from(mc, 5, { y:20, ease:Elastic.easeOut, delay:3, renderOnStart:true } );

• overwrite:Boolean-如果不想让这个缓动效果被应用在同一个对象上的其他缓动效果自动覆盖的话，请将这个值设为false

TweenLite.from(target:Object, duration:Number, variables:Object);
基本上同TweenLite.to()方法一样，唯一不同的是所指定的缓动的属性是起始值

TweenLite.delayedCall(delay:Number, onComplete:Function, onCompleteParams:Array);
提 供一个简单的方法来实现在指定的秒数之后调用指定的方法(其作用相当于setTimeout()方法，如果单为了实现setTimeout的功能而给你的 代码增加3K的重量，实在不值，但是如果项目中已经引入了TweenLite,使用这个方法是个不错的主意)，可以传递任意个数的参数
Parameters:略…

TweenLite.killTweensOf(target:Object, complete:Boolean);
提供一个简单的方法来移除应用在对象上的所有缓动效果，可以指定是否立即强制结束
Parameters:
target:目标对象
complete: 如果设为true,目标对象的缓动效果将会立即结束(缓动的属性直接变为缓动效果结束时的值，同时调用onComplete方法如果定义了的话)，若设为 false,同样会立即结束缓动效果 ，但是属性值将停留在当前缓动到的位置，onComplete函数也不会执行

TweenLite.killDelayedCallsTo(function:Function);
提供一个简单的方法来移除TweenLite.delayedCall方法中设置了的方法(其作用相当于clearTimeout)
Parameters:略..

TweenLite.removeTween(tween:TweenLite):void
回收指定的TweenLite的实例
Parameters:略.

示例：

import gs.TweenLite;
import gs.easing.Back;
 
TweenLite.to(clip_mc, 5, { alpha:0.5, x:120, ease:Back.easeOut, delay:2, onComplete:onFinishTween, onCompleteParams:[5, clip_mc] } );
 
//注意这里的参数，分别对应前面onCompleteParams数组中的类型，而不是Array型
function onFinishTween(parameter1_num:Number, parameter2_mc:MovieClip):void
{
 trace("The tween has finished! parameters: " + parameter1_num + ", and " + parameter2_mc);
}

源码包中也有2个很不错的例子~包含了大部分的用法在里面

About TweenLiteVars
Jack Doyle在7月15日的更新中加入了类TweenLiteVars，目的是为了让人们可以在FB，FD,FDT等编辑器中可以使用代码提示而不用去记众多的属性，并且能提供更加严谨的数据类型控制。TweenLiteVars类可以在TweenMax源码包中找到。
TweenLiteVars的用法如下：

import gs.TweenLite;
import gs.utils.tween.TweenLiteVars;
import gs.easing.*;
 
var v:TweenLiteVars = new TweenLiteVars();
 
//with addProps(), you can add up to 15 dynamic properties at a time. addProp() adds one at a time.
v.addProps("x", 300, false, "y", 100, true);
v.ease = Elastic.easeOut;
v.onComplete = myFunction;
TweenLite.to(my_mc, 2, v);

静态属性

TweenLite.defaultEase

设置默认的缓动函数

 

静态方法

TweenLite.to( target:Object, duration:Number, vars:Object):TweenLite

功能：用来创建动画

参数：target:要创建动画的影片剪辑

        duration:动画持续的时间，以秒为单位（如果整个动画模式是基于帧的话则以帧为单位）

        vars：要参与动画的属性，以对象形式来写，比如{x:100,y:100,…},这些属性是动画完成的目标

例：TweenLite.to(mc, 1, {x:100});

   var myTween:TweenLite = new TweenLite(mc, 1, {x:100});  //以第一个代码效果相同

   var myTween:TweenLite = TweenLite.to(mc, 1, {x:100});   //以第一个代码效果相同

TweenLite.from( target:Object, duration:Number, vars:Object):TweenLite

功能：用来创建动画,与TweenLite.to不同的是，这个函数动画的属性目标是影片剪辑的现有属性，初始属性是vars设定的属性

参数：target:要创建动画的影片剪辑

        duration:动画持续的时间，以秒为单位（如果整个动画模式是基于帧的话则以帧为单位）

        vars：要参与动画的属性，以对象形式来写，比如{x:100,y:100,…},这些属性是动画的初始属性

例：TweenLite.from(mc, 1, {x:100});

 

TweenLite.delayedCall( delay:Number,onComplete:Function,onCompleteParams:Array = null, useFrames:Boolean = false):TweenLite

功能：用于在一定时间或一定帧数后自动执行一个函数，相当于一个延迟器吧

参数：delay:要延迟执行函数的时间（或是帧数）

        onComplete:要延迟执行的函数

        onCompleteParams：要延迟执行的函数的参数，以数组形式传入

        useFrames:指明是用时间还是帧数来记时

例：TweenLite.delayedCall(1, myFunction, ["param1", 2]);

TweenLite.killTweensOf( target:Object, complete:Boolean = false, vars:Object = null):void

功能：用来消除动画

参数：target:要消除动画的影片剪辑

        complete:如果为真则会在消除动画的同时把动画属性设为完成时的值，如果为假则不会

        vars：要消除动画的属性，以对象形式来写，比如{x:true,y:true,…},这些属性将不再参与动画

例：TweenLite.killTweensOf(mc, false, {alpha:true, x:true});

动画属性对象vars：

{

delay:Number   在开始动画前要等待的时间,单位为秒（或帧数） 

useFrames:Boolean   如果设为true则动画模式是基于帧的，否则是基于时间的（指的是动画函数中要指定时间的地方）

ease:Function  缓动函数，默认为Quad.easeOut

easeParams:Array 缓动函数的参数，以数组形式传入，注意只是有些缓动函数才需要需要参数的

immediateRender:Boolean 当值为false时，

overwrite:int  用来控制同一个对象上有多个动画时的覆盖之类的情况,tweenlite只有1和2这两种情况可选,具体请见OverwriteManager

onInit:Function 当动画开始渲染（或是说开始运行时）前要执行的函数

onInitParams:Array onInit函数的参数，以数组形式传入

onStart:Function 当动画开始渲染时要执行的函数，有可能会被执行多次，因为动画时可以重复开始的

onStartParams:Array onStart函数的参数，以数组形式传入

onUpdate:Function 当每一次动画属性值发生变化时调用的函数

onUpdateParams:Array  onUpdate函数的参数，以数组形式传入

onComplete:Function 当动画执行完毕后要调用的函数

onCompleteParams:Array  onComplete函数的参数，以数组形式传入

onReverseComplete:Function  当一个动画被反转后又回到了原点时调用的函数

onReverseComplete:Array  onReverseComplete函数的参数，以数组形式传入

}

OverwriteManager

NONE(0)  同一个物体上的动画之间不会被覆盖

ALL_IMMEDIATE(1) 会立即覆盖之前的所有动画（包括运行的和没运行的），也是也tweenlite的默认模式，被覆盖的动画会保持覆盖那一刻的现状

AUTO(2) 当动画开始运行时（即不包括延迟或暂停之类的）覆盖，且只会覆盖同一物体上的正在运行的动画中的有重叠的动画属性。是TweenMax、TimelineLite、TimelineMax的默认覆盖模式

CONCURRENT(3) 当动画开始运行时覆盖，会覆盖同一物体上正在运行的所有动画

ALL_ONSTART(4)  当动画开始运行时覆盖，会覆盖同一物体上的所有动画（包括运行的和没运行的）

PREEXISTING(5)  当动画开始运行时覆盖，会覆盖同一物体上在本动画之前创建的所有动画（包括运行的和没运行的）

可以使用OverwriteManager.init(OverwriteManager.AUTO);来给所有动画定义覆盖方式，如果想给不同动画定义不同覆盖方式，则在具体的vars对象中定义

2、3、4、5类型都需要导入OverwriteManager类