object:play()

Overview

Play an animation sequence, starting at the current frame. This does not reset looping.

Note that object:setSequence() must be called before the sequence can be played. Play can also be called after object:pause().

Sprite Events

Sprite events are dispatched to the object's listener. These events tell what phase of the animation playback the sprite is in. These can have one of the following phases:

• "began" the sprite began playing
• "ended" the sprite finished playing
• "bounce" the sprite bounces from forward to backward while playing
• "loop" the sprite loops from the beginning of the sequence
• "next" the sprite plays a subsequent frame that's none of the above phases

See event.phase for more information.

Syntax

object:play()

Example

spriteObj:setSequence( "man" )
spriteObj:play()

-- add the event listener to the sprite object

local function spriteListener( event )
    print( "Sprite event: " .. event.phase )
end

-- Add sprite listener
spriteObj:addEventListener( "sprite", spriteListener )