RegisterEventHandler

From The Official Visionaire Studio: Adventure Game Engine Wiki
Revision as of 19:31, 5 March 2013 by AFRLme (talk)

History: Available since v3.7

registerEventHandler is an event listener which lets you declare what should happen when specific events are registered!

Additional Info

Current events available:

mainLoop, mouseEvent, animationStarted, animationStopped, textStarted & textStopped


Syntax:

registerEventHandler('eventName', 'functionName', {integerValue or eventFlagName})


mainLoop

you should only include one instance of the "mainLoop" event per game/project!
currently there is no delay/pause method to control the speed of the loop!

Example 1: mainLoop (code inside of the loop event - not recommended!)

-- let's create the function for the mainLoop event!
function onMainLoop()
 -- if x equals less than 100 then + 1 should be added to value of x on each loop until x equals 100!
 if x < 100 then
  x = x + 1
 end
end

-- let's create the loop handler!
registerEventHandler("mainLoop", "onMainLoop")

Example 2: mainLoop (including functions inside of the loop event - recommended!)

-- let's create a function that we will include inside of the mainLoop event!
function checkValue()
 -- if x equals less than 100 then + 1 should be added to value of x on each loop until x equals 100!
 if x < 100 then
  x = x + 1
 end
end

 -- let's create the mainLoop event, where we will include functions for looping!
function onMainLoop()
 checkValue() -- calls checkVal function on each loop!
end

-- let's create the loop handler!
registerEventHandler("mainLoop", "onMainLoop")
end


Arguments

Flags: none

Return: