LeanTween Class
LeanTween is an efficient tweening engine for Unity3d
Index of All Methods | Optional Paramaters that can be passed
Optional Parameters are passed at the end of every method
Example:
LeanTween.moveX( gameObject, 1f, 1f).setEase( LeanTweenType.easeInQuad ).setDelay(1f);
You can pass the optional parameters in any order, and chain on as many as you wish!
You can also modify this tween later, just save the unique id of the tween.
Example:
int id = LeanTween.moveX(gameObject, 1f, 1f).id;LTDescr d = LeanTween.descr( id );
if(d!=null){ // if the tween has already finished it will return null
// change some parameters
d.setOnComplete( onCompleteFunc ).setEase( LeanTweenType.easeInOutBack );
}
Item Index
Methods
- LeanTween.addListener
- LeanTween.alpha
- LeanTween.alpha
- LeanTween.alpha (RectTransform)
- LeanTween.alpha (RectTransform)
- LeanTween.alphaCanvas
- LeanTween.alphaText
- LeanTween.alphaVertex
- LeanTween.cancel
- LeanTween.cancel
- LeanTween.cancelAll
- LeanTween.color
- LeanTween.colorText
- LeanTween.delayedCall
- LeanTween.descr
- LeanTween.descriptions
- LeanTween.dispatchEvent
- LeanTween.dispatchEvent
- LeanTween.init
- LeanTween.isTweening
- LeanTween.isTweening
- LeanTween.move
- LeanTween.move
- LeanTween.move
- LeanTween.move (GUI)
- LeanTween.move (RectTransform)
- LeanTween.moveLocal
- LeanTween.moveLocal
- LeanTween.moveSpline
- LeanTween.moveSpline
- LeanTween.moveSplineLocal
- LeanTween.moveX
- LeanTween.moveX (RectTransform)
- LeanTween.moveY
- LeanTween.moveY (RectTransform)
- LeanTween.moveZ
- LeanTween.moveZ (RectTransform)
- LeanTween.pause
- LeanTween.pause
- LeanTween.pauseAll
- LeanTween.play
- LeanTween.removeListener
- LeanTween.resume
- LeanTween.resume
- LeanTween.resumeAll
- LeanTween.rotate
- LeanTween.rotate
- LeanTween.rotate (RectTransform)
- LeanTween.rotateAround
- LeanTween.rotateAround (RectTransform)
- LeanTween.rotateAroundLocal
- LeanTween.rotateAroundLocal (RectTransform)
- LeanTween.rotateLocal
- LeanTween.rotateX
- LeanTween.rotateY
- LeanTween.rotateZ
- LeanTween.scale
- LeanTween.scale (GUI)
- LeanTween.scale (RectTransform)
- LeanTween.scaleX
- LeanTween.scaleY
- LeanTween.scaleZ
- LeanTween.sequence
- LeanTween.size (RectTransform)
- LeanTween.tweensRunning
- LeanTween.value (Color)
- LeanTween.value (Color)
- LeanTween.value (float)
- LeanTween.value (float)
- LeanTween.value (float)
- LeanTween.value (float,object)
- LeanTween.value (Vector2)
- LeanTween.value (Vector2)
- LeanTween.value (Vector3)
- LeanTween.value (Vector3)
Methods
LeanTween.addListener
-
caller:GameObject -
eventId:int -
callback:System.Action<LTEvent>
Add a listener method to be called when the appropriate LeanTween.dispatchEvent is called
Parameters:
-
caller:GameObjectGameObjectthe gameObject the listener is attached to
-
eventId:intInta unique int that describes the event (best to use an enum)
-
callback:System.Action<LTEvent>System.Actionthe method to call when the event has been dispatched
Example:
LeanTween.addListener(gameObject, (int)MyEvents.JUMP, jumpUp);
void jumpUp( LTEvent e ){ Debug.Log("jump!"); }
LeanTween.alpha
-
ltRect:LTRect -
to:float -
time:float
Fade a GUI Object
Parameters:
-
ltRect:LTRectLTRectLTRect that you wish to fade
-
to:floatFloatthe final alpha value (0-1)
-
time:floatFloatThe time with which to fade the object
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.alpha(ltRect, 1f, 1f) .setEase(LeanTweenType.easeInCirc);
LeanTween.alpha
-
gameObject:GameObject -
to:float -
time:float
Fade a gameobject's material to a certain alpha value. The material's shader needs to support alpha. Owl labs has some excellent efficient shaders.
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to fade
-
to:floatFloatthe final alpha value (0-1)
-
time:floatFloatThe time with which to fade the object
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.alpha(gameObject, 1f, 1f) .setDelay(1f);
LeanTween.alpha (RectTransform)
-
rectTrans:RectTransform -
to:float -
time:float
Alpha an Image Component attached to a RectTransform (used in Unity GUI in 4.6+, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
to:floatFloatThe final Vector3 with which to tween to (localScale)
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.alpha(gameObject.GetComponent<RectTransform>(), 0.5f, 1f).setDelay(1f);
LeanTween.alpha (RectTransform)
-
rectTrans:RectTransform -
to:float -
time:float
Change the Color of an Image Component attached to a RectTransform (used in Unity GUI in 4.6+, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
to:floatFloatThe final Vector3 with which to tween to (localScale)
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.color(gameObject.GetComponent<RectTransform>(), 0.5f, 1f).setDelay(1f);
LeanTween.alphaCanvas
-
rectTransform:RectTransform -
to:float -
time:float
Fade a Unity UI Canvas Group
Parameters:
-
rectTransform:RectTransformRectTransformRectTransform that the CanvasGroup is attached to
-
to:floatFloatthe final alpha value (0-1)
-
time:floatFloatThe time with which to fade the object
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.alphaCanvas(gameObject.GetComponent<RectTransform>(), 0f, 1f) .setLoopPingPong();
LeanTween.alphaText
-
rectTransform:RectTransform -
to:float -
time:float
Fade a Unity UI Object
Parameters:
-
rectTransform:RectTransformRectTransformRectTransform associated with the Text Component you wish to fade
-
to:floatFloatthe final alpha value (0-1)
-
time:floatFloatThe time with which to fade the object
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.alphaText(gameObject.GetComponent<RectTransform>(), 1f, 1f) .setEase(LeanTweenType.easeInCirc);
LeanTween.alphaVertex
-
gameObject:GameObject -
to:float -
time:float
This works by tweening the vertex colors directly.
Vertex-based coloring is useful because you avoid making a copy of your
object's material for each instance that needs a different color.
A shader that supports vertex colors is required for it to work
(for example the shaders in Mobile/Particles/)
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to alpha
-
to:floatFloatThe alpha value you wish to tween to
-
time:floatFloatThe time with which to delay before calling the function
Returns:
LTDescr an object that distinguishes the tween
LeanTween.cancel
-
id:int -
callOnComplete:int
Cancel a specific tween with the provided id
Parameters:
-
id:intIntunique id that represents that tween
-
callOnComplete:intBool(optional) whether to call the onComplete method before canceling
Example:
int id = LeanTween.move( gameObject, new Vector3(0f,1f,2f), 1f).id;
LeanTween.cancel( id );
LeanTween.cancel
-
gameObject:GameObject -
callOnComplete:bool
Cancel all tweens that are currently targeting the gameObject
Parameters:
-
gameObject:GameObjectGameObjectgameObject whose tweens you wish to cancel
-
callOnComplete:boolBool(optional) whether to call the onComplete method before canceling
Example:
LeanTween.move( gameObject, new Vector3(0f,1f,2f), 1f);
LeanTween.cancel( gameObject );
LeanTween.cancelAll
-
callComplete:bool
Cancels all tweens
Parameters:
-
callComplete:boolBool(optional) if true, then the all onCompletes will run before canceling
Example:
LeanTween.cancelAll(true);
LeanTween.color
-
gameObject:GameObject -
to:Color -
time:float
Change a gameobject's material to a certain color value. The material's shader needs to support color tinting. Owl labs has some excellent efficient shaders.
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to change the color
-
to:ColorColorthe final color value ex: Color.Red, new Color(1.0f,1.0f,0.0f,0.8f)
-
time:floatFloatThe time with which to fade the object
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.color(gameObject, Color.yellow, 1f) .setDelay(1f);
LeanTween.colorText
-
rectTransform:RectTransform -
to:Color -
time:float
Change the color a Unity UI Object
Parameters:
-
rectTransform:RectTransformRectTransformRectTransform attached to the Text Component whose color you want to change
-
to:ColorColorthe final alpha value ex: Color.Red, new Color(1.0f,1.0f,0.0f,0.8f)
-
time:floatFloatThe time with which to fade the object
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.colorText(gameObject.GetComponent<RectTransform>(), Color.yellow, 1f) .setDelay(1f);
LeanTween.delayedCall
-
gameObject:GameObject -
time:float
Call a method after a specified amount of time
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to associate with this delayed call
-
time:floatFloatdelay The time you wish to pass before the method is called
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.delayedCall(gameObject, 1f, ()=>{
Debug.Log("I am called one second later!");
}));
LeanTween.descr
-
id:int
Retrieve a tweens LTDescr object to modify
Parameters:
-
id:intIntunique id that represents that tween
Example:
int id = LeanTween.move( gameObject, new Vector3(0f,1f,2f), 1f).setOnComplete( oldMethod ).id;
if(descr!=null) // if the tween has already finished it will come back null
descr.setOnComplete( newMethod );
LeanTween.descriptions
-
id:GameObject
Retrieve a tweens LTDescr object(s) to modify
Parameters:
-
id:GameObjectGameObjectobject whose tween descriptions you want to retrieve
Example:
LeanTween.move( gameObject, new Vector3(0f,1f,2f), 1f).setOnComplete( oldMethod );
if(descr.Length>0) // make sure there is a valid description for this target
descr[0].setOnComplete( newMethod );// in this case we only ever expect there to be one tween on this object
LeanTween.dispatchEvent
-
eventId:int
Tell the added listeners that you are dispatching the event
Parameters:
-
eventId:intInta unique int that describes the event (best to use an enum)
Example:
LeanTween.dispatchEvent( (int)MyEvents.JUMP );
LeanTween.dispatchEvent
-
eventId:int -
data:object
Tell the added listeners that you are dispatching the event
Parameters:
-
eventId:intInta unique int that describes the event (best to use an enum)
-
data:objectObjectPass data to the listener, access it from the listener with *.data on the LTEvent object
Example:
LeanTween.dispatchEvent( (int)MyEvents.JUMP, transform );
void jumpUp( LTEvent e ){
Transform tran = (Transform)e.data;
}
LeanTween.init
-
maxSimultaneousTweens:int
This line is optional. Here you can specify the maximum number of tweens you will use (the default is 400). This must be called before any use of LeanTween is made for it to be effective.
Parameters:
-
maxSimultaneousTweens:intIntegerThe maximum number of tweens you will use, make sure you don't go over this limit, otherwise the code will throw an error
Example:
LeanTween.init( 800 );
LeanTween.isTweening
-
gameObject:GameObject
Test whether or not a tween is active on a GameObject
Parameters:
-
gameObject:GameObjectGameObjectGameObject that you want to test if it is tweening
LeanTween.isTweening
-
id:int
Test whether or not a tween is active or not
Parameters:
-
id:intGameObjectid of the tween that you want to test if it is tweening
Example:
int id = LeanTween.moveX(gameObject, 1f, 3f).id;
if(LeanTween.isTweening( id ))
Debug.Log("I am tweening!");
LeanTween.move
-
gameObject:GameObject -
destination:Transform -
time:float
Move a GameObject to another transform
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to move
-
destination:TransformTransformTransform whose position the tween will finally end on
-
time:floatFloattime The time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.move(gameObject, anotherTransform, 2.0f) .setEase( LeanTweenType.easeOutQuad );
LeanTween.move
-
gameObject:GameObject -
vec:Vector3 -
time:float
Move a GameObject to a certain location
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to move
-
vec:Vector3Vector3to The final positin with which to move to
-
time:floatFloattime The time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.move(gameObject, new Vector3(0f,-3f,5f), 2.0f) .setEase( LeanTweenType.easeOutQuad );
LeanTween.move
-
gameObject:GameObject -
path:Vector3[] -
time:float
Move a GameObject along a set of bezier curves
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to move
-
path:Vector3[]Vector3A set of points that define the curve(s) ex: Point1,Handle2,Handle1,Point2,...
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Javascript:
LeanTween.move(gameObject, [Vector3(0,0,0),Vector3(1,0,0),Vector3(1,0,0),Vector3(1,0,1)], 2.0) .setEase(LeanTweenType.easeOutQuad).setOrientToPath(true);
C#:
LeanTween.move(gameObject, new Vector3[]{new Vector3(0f,0f,0f),new Vector3(1f,0f,0f),new Vector3(1f,0f,0f),new Vector3(1f,0f,1f)}, 1.5f).setEase(LeanTweenType.easeOutQuad).setOrientToPath(true);;
LeanTween.move (GUI)
-
ltRect:LTRect -
vec:Vector2 -
time:float
Move a GUI Element to a certain location
Parameters:
-
ltRect:LTRectLTRectltRect LTRect object that you wish to move
-
vec:Vector2Vector2to The final position with which to move to (pixel coordinates)
-
time:floatFloattime The time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.move (RectTransform)
-
rectTrans:RectTransform -
to:Vector3 -
time:float
Move a RectTransform object (used in Unity GUI in 4.6+, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
to:Vector3Vector3The final Vector3 with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.move(gameObject.GetComponent<RectTransform>(), new Vector3(200f,-100f,0f), 1f).setDelay(1f);
LeanTween.moveLocal
-
gameObject:GameObject -
path:Vector3[] -
time:float
Move a GameObject along a set of bezier curves, in local space
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to move
-
path:Vector3[]Vector3A set of points that define the curve(s) ex: Point1,Handle1,Handle2,Point2,...
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Javascript:
LeanTween.moveLocal(gameObject, [Vector3(0,0,0),Vector3(1,0,0),Vector3(1,0,0),Vector3(1,0,1)], 2.0).setEase(LeanTweenType.easeOutQuad).setOrientToPath(true);
C#:
LeanTween.moveLocal(gameObject, new Vector3[]{Vector3(0f,0f,0f),Vector3(1f,0f,0f),Vector3(1f,0f,0f),Vector3(1f,0f,1f)}).setEase(LeanTweenType.easeOutQuad).setOrientToPath(true);
LeanTween.moveLocal
-
GameObject -
Vector3 -
float
Move a GameObject to a certain location relative to the parent transform.
Parameters:
-
GameObjectGameObjectgameObject Gameobject that you wish to rotate
-
Vector3Vector3to The final positin with which to move to
-
floatFloattime The time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.moveSpline
-
gameObject:GameObject -
spline:LTSpline -
time:float
Move a GameObject through a set of points
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to move
-
spline:LTSplineLTSplinepass a pre-existing LTSpline for the object to move along
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Javascript:
LeanTween.moveSpline(gameObject, ltSpline, 2.0) .setEase(LeanTweenType.easeOutQuad).setOrientToPath(true);
C#:
LeanTween.moveSpline(gameObject, ltSpline, 1.5f).setEase(LeanTweenType.easeOutQuad).setOrientToPath(true);
LeanTween.moveSpline
-
gameObject:GameObject -
path:Vector3[] -
time:float
Move a GameObject through a set of points
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to move
-
path:Vector3[]Vector3A set of points that define the curve(s) ex: ControlStart,Pt1,Pt2,Pt3,.. ..ControlEnd
Note: The first and last item just define the angle of the end points, they are not actually used in the spline path itself. If you do not care about the angle you can jus set the first two items and last two items as the same value. -
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Javascript:
LeanTween.moveSpline(gameObject, [Vector3(0,0,0),Vector3(1,0,0),Vector3(1,0,0),Vector3(1,0,1)], 2.0) .setEase(LeanTweenType.easeOutQuad).setOrientToPath(true);
C#:
LeanTween.moveSpline(gameObject, new Vector3[]{new Vector3(0f,0f,0f),new Vector3(1f,0f,0f),new Vector3(1f,0f,0f),new Vector3(1f,0f,1f)}, 1.5f).setEase(LeanTweenType.easeOutQuad).setOrientToPath(true);
LeanTween.moveSplineLocal
-
gameObject:GameObject -
path:Vector3[] -
time:float
Move a GameObject through a set of points, in local space
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to move
-
path:Vector3[]Vector3A set of points that define the curve(s) ex: ControlStart,Pt1,Pt2,Pt3,.. ..ControlEnd
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Javascript:
LeanTween.moveSpline(gameObject, [Vector3(0,0,0),Vector3(1,0,0),Vector3(1,0,0),Vector3(1,0,1)], 2.0) .setEase(LeanTweenType.easeOutQuad).setOrientToPath(true);
C#:
LeanTween.moveSpline(gameObject, new Vector3[]{new Vector3(0f,0f,0f),new Vector3(1f,0f,0f),new Vector3(1f,0f,0f),new Vector3(1f,0f,1f)}, 1.5f).setEase(LeanTweenType.easeOutQuad).setOrientToPath(true);
LeanTween.moveX
-
gameObject:GameObject -
to:float -
time:float
Move a GameObject along the x-axis
Parameters:
-
gameObject:GameObjectGameObjectgameObject Gameobject that you wish to move
-
to:floatFloatto The final position with which to move to
-
time:floatFloattime The time to complete the move in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.moveX (RectTransform)
-
rectTrans:RectTransform -
to:float -
time:float
Move a RectTransform object affecting x-axis only (used in Unity GUI in 4.6+, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
to:floatFloatThe final x location with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.moveX(gameObject.GetComponent<RectTransform>(), 200f, 1f).setDelay(1f);
LeanTween.moveY
-
GameObject -
float -
float
Move a GameObject along the y-axis
Parameters:
-
GameObjectGameObjectgameObject Gameobject that you wish to move
-
floatFloatto The final position with which to move to
-
floatFloattime The time to complete the move in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.moveY (RectTransform)
-
rectTrans:RectTransform -
to:float -
time:float
Move a RectTransform object affecting y-axis only (used in Unity GUI in 4.6+, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
to:floatFloatThe final y location with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.moveY(gameObject.GetComponent<RectTransform>(), 200f, 1f).setDelay(1f);
LeanTween.moveZ
-
GameObject -
float -
float
Move a GameObject along the z-axis
Parameters:
-
GameObjectGameObjectgameObject Gameobject that you wish to move
-
floatFloatto The final position with which to move to
-
floatFloattime The time to complete the move in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.moveZ (RectTransform)
-
rectTrans:RectTransform -
to:float -
time:float
Move a RectTransform object affecting z-axis only (used in Unity GUI in 4.6+, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
to:floatFloatThe final x location with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.moveZ(gameObject.GetComponent<RectTransform>(), 200f, 1f).setDelay(1f);
LeanTween.pause
-
gameObject:GameObject
Pause all tweens for a GameObject
Parameters:
-
gameObject:GameObjectGameObjectGameObject whose tweens you want to pause
LeanTween.pause
-
id:int
Pause all tweens for a GameObject
Parameters:
-
id:intIntId of the tween you want to pause
Example:
int id = LeanTween.moveX(gameObject, 5, 1.0).id
LeanTween.pause( id );
// Later....
LeanTween.resume( id );
LeanTween.pauseAll
()
Pause all active tweens
LeanTween.play
-
rectTransform:RectTransform -
sprites:Sprite[]
Play a sequence of images on a Unity UI Object
Parameters:
-
rectTransform:RectTransformRectTransformRectTransform that you want to play the sequence of sprites on
-
sprites:Sprite[]SpriteSequence of sprites to be played
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.play(gameObject.GetComponent
LeanTween.removeListener
-
caller:GameObject -
eventId:int -
callback:System.Action<LTEvent>
Remove an event listener you have added
Parameters:
-
caller:GameObjectGameObjectthe gameObject the listener is attached to
-
eventId:intInta unique int that describes the event (best to use an enum)
-
callback:System.Action<LTEvent>System.Actionthe method that was specified to call when the event has been dispatched
Example:
LeanTween.removeListener(gameObject, (int)MyEvents.JUMP, jumpUp);
void jumpUp( LTEvent e ){ }
LeanTween.resume
-
id:int
Resume a specific tween
Parameters:
-
id:intIntId of the tween you want to resume
Example:
int id = LeanTween.moveX(gameObject, 5, 1.0).id
LeanTween.pause( id );
// Later....
LeanTween.resume( id );
LeanTween.resume
-
gameObject:GameObject
Resume all the tweens on a GameObject
Parameters:
-
gameObject:GameObjectGameObjectGameObject whose tweens you want to resume
LeanTween.resumeAll
()
Resume all active tweens
LeanTween.rotate
-
GameObject -
Vector3 -
float
Rotate a GameObject, to values are in passed in degrees
Parameters:
-
GameObjectGameObjectgameObject Gameobject that you wish to rotate
-
Vector3Vector3to The final rotation with which to rotate to
-
floatFloattime The time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.rotate(cube, new Vector3(180f,30f,0f), 1.5f);
LeanTween.rotate
-
ltRect:LTRect -
to:float -
time:float -
optional:Array
Rotate a GUI element (using an LTRect object), to a value that is in degrees
Parameters:
-
ltRect:LTRectLTRectLTRect that you wish to rotate
-
to:floatFloatThe final rotation with which to rotate to
-
time:floatFloatThe time to complete the tween in
-
optional:ArrayArrayObject Array where you can pass optional items.
Returns:
LTDescr an object that distinguishes the tween
Example:
if(GUI.Button(buttonRect.rect, "Rotate"))
LeanTween.rotate( buttonRect4, 150.0f, 1.0f).setEase(LeanTweenType.easeOutElastic);
GUI.matrix = Matrix4x4.identity;
LeanTween.rotate (RectTransform)
-
rectTrans:RectTransform -
to:float -
time:float
Rotate a RectTransform object (used in Unity GUI in 4.6+, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
to:floatFloatThe degree with which to rotate the RectTransform
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.rotate(gameObject.GetComponent<RectTransform>(), 90f, 1f).setDelay(1f);
LeanTween.rotateAround
-
gameObject:GameObject -
vec:Vector3 -
degrees:float -
time:float
Rotate a GameObject around a certain Axis (the best method to use when you want to rotate beyond 180 degrees)
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to rotate
-
vec:Vector3Vector3axis in which to rotate around ex: Vector3.up
-
degrees:floatFloatthe degrees in which to rotate
-
time:floatFloattime The time to complete the rotation in
Returns:
LTDescr an object that distinguishes the tween
Example:
Example:
LeanTween.rotateAround ( gameObject, Vector3.left, 90f, 1f );
LeanTween.rotateAround (RectTransform)
-
rectTrans:RectTransform -
axis:Vector3 -
to:float -
time:float
Rotate a RectTransform object (used in Unity GUI in 4.6+, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
axis:Vector3Vector3The axis in which to rotate the RectTransform (Vector3.forward is most commonly used)
-
to:floatFloatThe degree with which to rotate the RectTransform
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.rotateAround(gameObject.GetComponent<RectTransform>(), Vector3.forward, 90f, 1f).setDelay(1f);
LeanTween.rotateAroundLocal
-
gameObject:GameObject -
vec:Vector3 -
degrees:float -
time:float
Rotate a GameObject around a certain Axis in Local Space (the best method to use when you want to rotate beyond 180 degrees)
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to rotate
-
vec:Vector3Vector3axis in which to rotate around ex: Vector3.up
-
degrees:floatFloatthe degrees in which to rotate
-
time:floatFloattime The time to complete the rotation in
Returns:
LTDescr an object that distinguishes the tween
Example:
Example:
LeanTween.rotateAround ( gameObject, Vector3.left, 90f, 1f );
LeanTween.rotateAroundLocal (RectTransform)
-
rectTrans:RectTransform -
axis:Vector3 -
to:float -
time:float
Rotate a RectTransform object around it's local axis (used in Unity GUI in 4.6+, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
axis:Vector3Vector3The local axis in which to rotate the RectTransform (Vector3.forward is most commonly used)
-
to:floatFloatThe degree with which to rotate the RectTransform
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.rotateAroundLocal(gameObject.GetComponent<RectTransform>(), Vector3.forward, 90f, 1f).setDelay(1f);
LeanTween.rotateLocal
-
gameObject:GameObject -
to:Vector3 -
time:float
Rotate a GameObject in the objects local space (on the transforms localEulerAngles object)
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to rotate
-
to:Vector3Vector3The final rotation with which to rotate to
-
time:floatFloatThe time to complete the rotation in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.rotateX
-
GameObject -
to:float -
time:float
Rotate a GameObject only on the X axis
Parameters:
-
GameObjectGameObjectGameobject that you wish to rotate
-
to:floatFloatThe final x-axis rotation with which to rotate
-
time:floatFloatThe time to complete the rotation in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.rotateY
-
GameObject -
to:float -
time:float
Rotate a GameObject only on the Y axis
Parameters:
-
GameObjectGameObjectGameobject that you wish to rotate
-
to:floatFloatThe final y-axis rotation with which to rotate
-
time:floatFloatThe time to complete the rotation in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.rotateZ
-
GameObject -
to:float -
time:float
Rotate a GameObject only on the Z axis
Parameters:
-
GameObjectGameObjectGameobject that you wish to rotate
-
to:floatFloatThe final z-axis rotation with which to rotate
-
time:floatFloatThe time to complete the rotation in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.scale
-
gameObject:GameObject -
vec:Vector3 -
time:float
Scale a GameObject to a certain size
Parameters:
-
gameObject:GameObjectGameObjectgameObject Gameobject that you wish to scale
-
vec:Vector3Vector3to The size with which to tween to
-
time:floatFloattime The time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.scale (GUI)
-
LTRect -
Vector2 -
float
Scale a GUI Element to a certain width and height
Parameters:
-
LTRectLTRectltRect LTRect object that you wish to move
-
Vector2Vector2to The final width and height to scale to (pixel based)
-
floatFloattime The time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Example Javascript:
var bRect:LTRect = new LTRect( 0, 0, 100, 50 );
LeanTween.scale( bRect, Vector2(bRect.rect.width, bRect.rect.height) * 1.3, 0.25 ).setEase(LeanTweenType.easeOutBounce);
function OnGUI(){
if(GUI.Button(bRect.rect, "Scale")){ }
}
Example C#:
LTRect bRect = new LTRect( 0f, 0f, 100f, 50f );
LeanTween.scale( bRect, new Vector2(150f,75f), 0.25f ).setEase(LeanTweenType.easeOutBounce);
void OnGUI(){
if(GUI.Button(bRect.rect, "Scale")){ }
}
LeanTween.scale (RectTransform)
-
rectTrans:RectTransform -
to:Vector3 -
time:float
Scale a RectTransform object (used in Unity GUI in 4.6+, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
to:Vector3Vector3The final Vector3 with which to tween to (localScale)
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.scale(gameObject.GetComponent<RectTransform>(), gameObject.GetComponent<RectTransform>().localScale*2f, 1f).setDelay(1f);
LeanTween.scaleX
-
gameObject:GameObject -
scaleTo:float -
time:float
Scale a GameObject to a certain size along the x-axis only
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to scale
-
scaleTo:floatFloatthe size with which to scale to
-
time:floatFloatthe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.scaleY
-
gameObject:GameObject -
scaleTo:float -
time:float
Scale a GameObject to a certain size along the y-axis only
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to scale
-
scaleTo:floatFloatthe size with which to scale to
-
time:floatFloatthe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.scaleZ
-
gameObject:GameObject -
scaleTo:float -
time:float
Scale a GameObject to a certain size along the z-axis only
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to scale
-
scaleTo:floatFloatthe size with which to scale to
-
time:floatFloatthe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.sequence
()
LTSeq
Retrieve a sequencer object where you can easily chain together tweens and methods one after another
Returns:
LTSeq an object that you can add tweens, methods and time on to
Example:
var seq = LeanTween.sequence();
seq.add(1f); // delay everything one second
seq.add( () => { // fire an event before start
Debug.Log("I have started");
});
seq.add( LeanTween.move(cube1, Vector3.one * 10f, 1f) ); // do a tween
seq.add( () => { // fire event after tween
Debug.Log("We are done now");
});;
LeanTween.size (RectTransform)
-
rectTrans:RectTransform -
to:Vector2 -
time:float
Change the sizeDelta of a RectTransform object (used in Unity Canvas, for Buttons, Panel, Scrollbar, etc...)
Parameters:
-
rectTrans:RectTransformRectTransformRectTransform that you wish to attach the tween to
-
to:Vector2Vector2The final Vector2 the tween will end at for sizeDelta property
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
LeanTween.size(gameObject.GetComponent<RectTransform>(), gameObject.GetComponent<RectTransform>().sizeDelta*2f, 1f).setDelay(1f);
LeanTween.tweensRunning
()
Find out how many tweens you have animating at a given time
Example:
Debug.Log("I have "+LeanTween.tweensRunning+" animating!");
LeanTween.value (Color)
-
gameObject:GameObject -
from:Color -
to:Color -
time:float
Tween any particular value (Color)
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to attach the tween to
-
from:ColorColorThe original value to start the tween from
-
to:ColorColorThe final Color with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Example Javascript:
LeanTween.value( gameObject, Color.red, Color.yellow, 5f).setOnUpdate( function( val:Color ){
Debug.Log("tweened val:"+val);
} );
Example C#:
LeanTween.value( gameObject, Color.red, Color.yellow, 5f).setOnUpdate( (Color val)=>{
Debug.Log("tweened val:"+val);
} );
LeanTween.value (Color)
-
GameObject -
callOnUpdate:Action<Color> -
Color -
Color -
Color
Tween from one color to another
Parameters:
-
GameObjectGameObjectgameObject GameObject with which to tie the tweening with. This is only used when you need to cancel this tween, it does not actually perform any operations on this gameObject
-
callOnUpdate:Action<Color>ActionThe function that is called on every Update frame, this function needs to accept a color value ex: function updateValue( Color val ){ }
-
ColorColorfrom The original value to start the tween from
-
ColorColorto The value to end the tween on
-
ColorColortime The time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Example Javascript:
LeanTween.value( gameObject, updateValueExampleCallback, Color.red, Color.green, 1f).setEase(LeanTweenType.easeOutElastic);
function updateValueExampleCallback( val:Color ){
Debug.Log("tweened color:"+val+" set this to whatever variable you are tweening...");
}
Example C#:
LeanTween.value( gameObject, updateValueExampleCallback, Color.red, Color.green, 1f).setEase(LeanTweenType.easeOutElastic);
void updateValueExampleCallback( Color val ){
Debug.Log("tweened color:"+val+" set this to whatever variable you are tweening...");
}
LeanTween.value (float)
-
GameObject -
callOnUpdate:Action<float> -
float -
float -
float
Tween any particular value, it does not need to be tied to any particular type or GameObject
Parameters:
-
GameObjectGameObjectgameObject GameObject with which to tie the tweening with. This is only used when you need to cancel this tween, it does not actually perform any operations on this gameObject
-
callOnUpdate:Action<float>ActionThe function that is called on every Update frame, this function needs to accept a float value ex: function updateValue( float val ){ }
-
floatFloatfrom The original value to start the tween from
-
floatFloatto The value to end the tween on
-
floatFloattime The time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Example Javascript:
LeanTween.value( gameObject, updateValueExampleCallback, 180f, 270f, 1f).setEase(LeanTweenType.easeOutElastic);
function updateValueExampleCallback( val:float ){
Debug.Log("tweened value:"+val+" set this to whatever variable you are tweening...");
}
Example C#:
LeanTween.value( gameObject, updateValueExampleCallback, 180f, 270f, 1f).setEase(LeanTweenType.easeOutElastic);
void updateValueExampleCallback( float val ){
Debug.Log("tweened value:"+val+" set this to whatever variable you are tweening...");
}
LeanTween.value (float)
-
GameObject -
callOnUpdateRatio:Action<float,float> -
float -
float -
float
Tweens any float value, it does not need to be tied to any particular type or GameObject
Parameters:
-
GameObjectGameObjectgameObject GameObject with which to tie the tweening with. This is only used when you need to cancel this tween, it does not actually perform any operations on this gameObject
-
callOnUpdateRatio:Action<float,float>ActionFunction that's called every Update frame. It must accept two float values ex: function updateValue( float val, float ratio){ }
-
floatFloatfrom The original value to start the tween from
-
floatFloatto The value to end the tween on
-
floatFloattime The time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Example Javascript:
LeanTween.value( gameObject, updateValueExampleCallback, 180f, 270f, 1f).setEase(LeanTweenType.easeOutElastic);
function updateValueExampleCallback( val:float, ratio:float ){
Debug.Log("tweened value:"+val+" percent complete:"+ratio100);
}
Example C#:
LeanTween.value( gameObject, updateValueExampleCallback, 180f, 270f, 1f).setEase(LeanTweenType.easeOutElastic);
void updateValueExampleCallback( float val, float ratio ){
Debug.Log("tweened value:"+val+" percent complete:"+ratio100);
}
LeanTween.value (float)
-
gameObject:GameObject -
from:float -
to:float -
time:float
Tween any particular value (float)
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to attach the tween to
-
from:floatFloatThe original value to start the tween from
-
to:floatVector3The final float with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Example Javascript:
LeanTween.value( gameObject, 1f, 5f, 5f).setOnUpdate( function( val:float ){
Debug.Log("tweened val:"+val);
} );
Example C#:
LeanTween.value( gameObject, 1f, 5f, 5f).setOnUpdate( (float val)=>{
Debug.Log("tweened val:"+val);
} );
LeanTween.value (float,object)
-
gameObject:GameObject -
callOnUpdate:Action<float,object> -
from:float -
to:float -
time:float
Tween any particular value (float)
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to attach the tween to
-
callOnUpdate:Action<float,object>ActionThe function that is called on every Update frame, this function needs to accept a float value ex: function updateValue( Vector3 val, object obj ){ }
-
from:floatFloatThe original value to start the tween from
-
to:floatVector3The final Vector3 with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.value (Vector2)
-
gameObject:GameObject -
from:Vector2 -
to:Vector2 -
time:float
Tween any particular value (Vector2)
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to attach the tween to
-
from:Vector2Vector2The original value to start the tween from
-
to:Vector2Vector3The final Vector2 with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Example Javascript:
LeanTween.value( gameObject, new Vector2(1f,0f), new Vector3(5f,0f), 5f).setOnUpdate( function( val:Vector2 ){
Debug.Log("tweened val:"+val);
} );
Example C#:
LeanTween.value( gameObject, new Vector3(1f,0f), new Vector3(5f,0f), 5f).setOnUpdate( (Vector2 val)=>{
Debug.Log("tweened val:"+val);
} );
LeanTween.value (Vector2)
-
gameObject:GameObject -
callOnUpdate:Action<Vector2> -
from:Vector2 -
to:Vector2 -
time:float
Tween any particular value (Vector2), this could be used to tween an arbitrary value like offset property
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to attach the tween to
-
callOnUpdate:Action<Vector2>ActionThe function that is called on every Update frame, this function needs to accept a float value ex: function updateValue( Vector3 val ){ }
-
from:Vector2FloatThe original value to start the tween from
-
to:Vector2Vector2The final Vector3 with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
LeanTween.value (Vector3)
-
gameObject:GameObject -
from:Vector3 -
to:Vector3 -
time:float
Tween any particular value (Vector3)
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to attach the tween to
-
from:Vector3Vector3The original value to start the tween from
-
to:Vector3Vector3The final Vector3 with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
Example:
Example Javascript:
LeanTween.value( gameObject, new Vector3(1f,0f,0f), new Vector3(5f,0f,0f), 5f).setOnUpdate( function( val:Vector3 ){
Debug.Log("tweened val:"+val);
} );
Example C#:
LeanTween.value( gameObject, new Vector3(1f,0f,0f), new Vector3(5f,0f,0f), 5f).setOnUpdate( (Vector3 val)=>{
Debug.Log("tweened val:"+val);
} );
LeanTween.value (Vector3)
-
gameObject:GameObject -
callOnUpdate:Action<Vector3> -
from:Vector3 -
to:Vector3 -
time:float
Tween any particular value (Vector3), this could be used to tween an arbitrary property that uses a Vector
Parameters:
-
gameObject:GameObjectGameObjectGameobject that you wish to attach the tween to
-
callOnUpdate:Action<Vector3>ActionThe function that is called on every Update frame, this function needs to accept a float value ex: function updateValue( Vector3 val ){ }
-
from:Vector3FloatThe original value to start the tween from
-
to:Vector3Vector3The final Vector3 with which to tween to
-
time:floatFloatThe time to complete the tween in
Returns:
LTDescr an object that distinguishes the tween
