TweenLite中文帮助手册
为什么要用TWEENLITE而不用ADOBE官方的TWEEN?
用法:
TweenLite.to(target:Object, duration:Number, variables:Object);
Description:将target对象的属性从调用方法时的值缓动到variables中所指定的值
Parameters:
TweenLite.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设为truevisible: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的时候,这个缓动效果仍然可以被其他的缓动覆盖。默认值是falserenderOnStart:Boolean-在调用TweenLite.from()函数并且还有一个延时的时候,如果想要让指定的起始属性值在延时结束之后才展现出来的话,将renderOnStart设为true,相反,如果设为false,在延时开始之时就会立即展现指定的起始属性值。默认值是falseTweenLite.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:略.
示例:
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]});?function onFinishTween(parameter1_num:Number, parameter2_mc:MovieClip):void { //注意这里的参数,分别对应前面onCompleteParams数组中的类型,而不是Array型?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();v.addProps("x", 300, false, "y", 100, true); //with addProps(), you can add up to 15 dynamic properties at a time. addProp() adds one at a time.v.ease = Elastic.easeOut;v.onComplete = myFunction;?TweenLite.to(my_mc, 2, v);