tweenLite中文手册与参数说明

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++中文手册++++++++++++++++++++++++为什么要用TWEENLITE而不用ADOBE官方的TWEEN?1.效率(这也是作者所标榜的TWEENLITE2大优点之一，呵呵，“标榜”这个词用得可能有点过了，不过人家确实有那个实力)这里有2者运行效率对比的例子：tweening-speed-test2.onComplete,onStart,onUpdate等回调方法是TWEEN所没有的(TWEENLITE还可以往这些方法中传递任意个参数)3.智能的alpha(当alpha达到0时，TWEENLITE会自动将对象的visible设为false)4.在一次方法调用中就可以缓动多个属性5.可以设置每一次缓动的延时(对有先后顺序的缓动很有效)6.实现任何MovieClip/Sprite的变色效果非常简单7.可以缓动MovieClip的声音8.唯一的from()方法使你可以使用当前的属性值作为缓动的目标值9.使用相关联的值10.在一次方法调用中就可以缓动多个数组的值11.TWEENLITE默认会自动地覆盖同一个对象的缓动以免出现冲突(当然这个特性也是可以关闭的)12.强大的delayedCall()方法使你可以随意设置延时和延时过后所调用的变量，甚至传递任意个数的参数13.TWEENLITE有一个更加powerful的大哥”TweenFilterLite”，而TWEEN只在孤军奋战…当TWEENLITE有什么搞不定的时候，直接去找他大哥…用法：TweenLite.to(target:Object,duration:Number,variables:Object);Description：将target对象的属性从调用方法时的值缓动到variables中所指定的值Parameters：otarget:要缓动的对象(这里注意类型是Object,并不仅仅是MovieClip和Sprite)oduration:持续的时间(单位是秒)ovariables:一个Object,包含你想要缓动的所有属性(在TweenLite.from()方法中，这些变量表示的则是开始缓动时的值)，如果你给某个属性加引号，它将关联到当前的值。例如y:”xxx”,无论你引号里指定多少，它只会缓动到当前的值或者从当前的值开始缓动(在TweenLite.from()方法中)oTweenLite.to(mc,5,{x:10,y:20,ease:Elastic.easeOut});TweenLite.to(mc,5,{x:20,y:30,ease:Elastic.easeOut});//2者效果是一样的(通常情况下是不需要加引号的)特殊属性：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TweenLite.from(mc,5,{y:20,ease:Elastic.easeOut,delay:3,renderOnStart:false});//mc会在y=20处停留3秒，然后在5秒内缓动到当前位置TweenLite.from(mc,5,{y:20,ease:Elastic.easeOut,delay:3,renderOnStart:true});//mc会在当前位置置停留3秒，然后跳到y=20的位置开始缓动overwrite:Boolean-如果不想让这个缓动效果被应用在同一个对象上的其他缓动效果自动覆盖的话，请将这个值设为falseTweenLite.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:略.示例：123456789importgs.TweenLite;importgs.easing.Back;TweenLite.to(clip_mc,5,{alpha:0.5,x:120,ease:Back.easeOut,delay:2,onComplete:onFinishTween,onCompleteParams:[5,clip_mc]});functiononFinishTween(parameter1_num:Number,parameter2_mc:MovieClip):void{//注意这里的参数，分别对应前面onCompleteParams数组中的类型，而不是Array型trace(Thetweenhasfinished!parameters:+parameter1_num+,and+parameter2_mc);}源码包中也有2个很不错的例子~包含了大部分的用法在里面AboutTweenLiteVarsJackDoyle在7月15日的更新中加入了类TweenLiteVars，目的是为了让人们可以在FB，FD,FDT等编辑器中可以使用代码提示而不用去记众多的属性，并且能提供更加严谨的数据类型控制。TweenLiteVars类可以在TweenMax源码包中找到。TweenLiteVars的用法如下：123importgs.TweenLite;importgs.utils.tween.TweenLiteVars;importgs.easing.*;45678910varv:TweenLiteVars=newTweenLiteVars();v.addProps(x,300,false,y,100,true);//withaddProps(),youcanaddupto15dynamicpropertiesatatime.addProp()addsoneatatime.v.ease=Elastic.easeOut;v.onComplete=myFunction;TweenLite.to(my_mc,2,v);+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++参数说明+++++++++++++++++++++++++++++++++++++++++更新及更多文档请访问:(这里的链接指向AS3版)描述:缓动。我们都在做。我们很多人都知道除了Adobe'sTween类之外，还有很多更好的动画引擎，（比如Tweener）.每种引擎都有它们各自的优缺点。最近几年，为了得到一个更紧凑的，跑得更快，效率更高的引擎，我创建了TweenLite（我无法接受其它的一些引擎带来的文件尺寸上的负担）.它很快就融入到我的所有工作中。我告诉其它人，让大家能够从中获益，最终，我将它发布了出来。在过去的几年中，TweenLite越来越受欢迎，超乎了我的想像.基于此，我又添加了一些新的功能，并且尽量保持这个文件的尺寸，让它小于3K。TweenFilterLite扩充了TweenLite并且加入了滤镜缓动，包含了ColorMatrixFilter的一些效果，比如饱和、对比、增亮、色调，甚至是着色，但文件的尺寸始终没有超过3K。与TweenLite的做法相似，提供有AS2版和AS3版的类包下载。TweenMax比TweenFilterLite增加了更多的特性，包含bezier缓动，暂停/恢复，顺序执行等等。(见