Timer

From GiderosMobile
Revision as of 14:31, 13 July 2023 by Hgy29 (talk | contribs) (Text replacement - "<source" to "<syntaxhighlight")

Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2011.6
Inherits from: Object

Description

The Timer class is used to execute a code at specified intervals.

The listener functions are registered through Event.TIMER and Event.TIMER_COMPLETE events.

Example

Rotates a pixel 360° <syntaxhighlight lang="lua"> -- let's define a pixel and add it to the stage local mypixel = Pixel.new(0xff0000, 1, 64, 64) mypixel:setPosition(64, 64) stage:addChild(mypixel)

function onTimer(event)

  -- add 1 degree each time the function is called
  mypixel:setRotation(mypixel:getRotation() + 1)

end

-- create our timer and add an event listener -- 24 = delay in milliseconds -- (optional) 360 = number of repetitions (here the result is 360 degrees) local timer = Timer.new(24, 360) -- local timer = Timer.new(24) -- to run indefinitely timer:addEventListener(Event.TIMER, onTimer, timer) timer:start() </source>

Methods

Timer.delayedCall delay calls a function after a set amount of time
Timer.new creates a new Timer object
Timer.pauseAll pauses all timers
Timer.resumeAll resumes all timers
Timer.stopAll stops all timers

Timer:getCurrentCount returns the current trigger count of the timer
Timer:getDelay returns the time interval between timer events in milliseconds
Timer:getRepeatCount returns the number of repetitions the timer will make
Timer:isRunning returns the current running status of timer
Timer:pause pauses timer
Timer:reset stops the timer and sets the currentCount property to 0
Timer:setDelay sets the time interval between timer events in milliseconds
Timer:setRepeatCount sets the number of repetitions the timer will make
Timer:start starts the timer
Timer:stop stops the timer

Events

Event.TIMER
Event.TIMER_COMPLETE

Constants