transition.scaleTo()

Type Function
Library transition.*
Return value Table
Revision Release 2022.3683
Keywords easing, animation, transition, tween, interpolation

Overview

Scales an object to the specified xScale and yScale amounts over a specified time.

Syntax

transition.scaleTo( target, params )
target (required)

Table. Any object that behaves like a table, for example display objects.

params (required)

Table. A table that specifies the properties of the transition — see the next section for details.

Parameter Reference

xScale (optional)

Number. The xScale value to scale to.

yScale (optional)

Number. The yScale value to scale to.

time (optional)

Number. The time of the action.

tag (optional)

String. Specifies the transition tag. The transition library can pause, resume, or cancel transitions sharing the same tag.

transition (optional)

Function. Specifies the easing interpolation method. Default is linear.

delay (optional)

Number. Specifies the delay, in milliseconds, before the transition begins. Default is 0.

onStart (optional)

Listener. Listener function to be called before the transition begins. This function will receive a reference to the associated object as its sole argument.

onComplete (optional)

Listener. Listener function to be called after the transition completes. This function will receive a reference to the associated object as its sole argument.

onPause (optional)

Listener. Listener function to be called when the transition is paused. This function will receive a reference to the associated object as its sole argument.

onResume (optional)

Listener. Listener function to be called when the transition is resumed. This function will receive a reference to the associated object as its sole argument.

onCancel (optional)

Listener. Listener function to be called when the transition is cancelled. This function will receive a reference to the associated object as its sole argument.

Examples

local square = display.newRect( 0, 0, 100, 100 )

transition.scaleTo( square, { xScale=2.0, yScale=1.5, time=2000 } )