|
|
| (8 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | <div class="toccolours mw-collapsible mw-collapsed tbl-ds">
| + | #REDIRECT [[Global Command: registerEventHandler]] |
| − | <span>Command History</span>
| |
| − | <div class="mw-collapsible-content">
| |
| − | <div class="alt-bg">Available since v3.6</div>
| |
| − | <div>animationStarted, animationStopped, textStarted & textStopped event listener LUA commands added to v3.6</div>
| |
| − | <div class="alt-bg">mouseEvent listener added to v3.7</div>
| |
| − | </div></div>
| |
| − | | |
| − | | |
| − | registerEventHandler is an event listener which lets you declare what should happen when specific events are registered!
| |
| − | <div class="toccolours mw-collapsible mw-collapsed tbl-ds">
| |
| − | <span class="bold">Additional Info</span>
| |
| − | <div class="mw-collapsible-content">
| |
| − | <div>Current events available:
| |
| − | <pre>mainLoop, mouseEvent, animationStarted, animationStopped, textStarted & textStopped</pre></div>
| |
| − | </div></div>
| |
| − | | |
| − | | |
| − | Syntax:
| |
| − | <syntaxhighlight>
| |
| − | registerEventHandler("eventName", "functionName", {integerValue or eventFlagName})
| |
| − | </syntaxhighlight>
| |
| − | | |
| − | | |
| − | <span class="medium bold underline">mainLoop</span>
| |
| − | | |
| − | you should only include one instance of the "mainLoop" event per game/project! <br/>
| |
| − | 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!)
| |
| − | <syntaxhighlight>
| |
| − | -- 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")
| |
| − | </syntaxhighlight>
| |
| − | | |
| − | Example 2: mainLoop (including functions inside of the loop event - recommended!)
| |
| − | <syntaxhighlight>
| |
| − | -- 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
| |
| − | </syntaxhighlight>
| |
| − | | |
| − | | |
| − | <span class="medium bold underline">mouseEvent</span>
| |
| − | | |
| − | you should only include one instance of the "mouseEvent" listener per game/project!
| |
| − | <div class="toccolours mw-collapsible mw-collapsed tbl-ds">
| |
| − | <span class="bold">Additional Info</span>
| |
| − | <div class="mw-collapsible-content">
| |
| − | <div>Current mouseEvent eventFlags available: (if no mouseEvent flags are included then all mouse events will be registered!)
| |
| − | <syntaxhighlight>eEvtMouseMove(1), eEvtMouseLeftButtonDoubleClick(2), eEvtMouseLeftButtonDown(3), eEvtMouseLeftButtonUp(4), eEvtMouseLeftButtonHold(5), eEvtMouseLeftButtonHolding(6), eEvtMouseRightButtonDoubleClick(7), eEvtMouseRightButtonDown(8), eEvtMouseRightButtonUp(9), eEvtMouseMiddleButtonDown(10), eEvtMouseMiddleButtonUp(11), eEvtMouseWheelUp(12) & eEvtMouseWheelDown(13)</syntaxhighlight></div>
| |
| − | </div></div>
| |
| − | | |
| − | | |
| − | Example: mouseEvent
| |
| − | <syntaxhighlight enclose="div">
| |
| − | --[[
| |
| − | Like the mainLoop event you can create what each registered event should do inside of the mouseEvent function or you can add functions which could be called based on certain conditions or not!
| |
| − | --]]
| |
| − | | |
| − | -- let's create the function for the mouseEvent listener!
| |
| − | function onMouseEvent(eventType, mousePosition)
| |
| − | -- bleh!
| |
| − | end
| |
| − | | |
| − | -- let's create the mouseEvent listener!
| |
| − | registerEventHandler("mouseEvent", "onMouseEvent", {eEvtMouseMove, eEvtMouseLeftButtonDoubleClick, eEvtMouseLeftButtonDown, eEvtMouseLeftButtonUp, eEvtMouseLeftButtonHold, eEvtMouseLeftButtonHolding, eEvtMouseRightButtonDoubleClick, eEvtMouseRightButtonDown, eEvtMouseRightButtonUp, eEvtMouseMiddleButtonDown, eEvtMouseMiddleButtonUp, eEvtMouseWheelUp, eEvtMouseWheelDown}) | |
| − | | |
| − | --[[
| |
| − | registerEventHandler("mouseEvent", "onMouseEvent", {1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13})
| |
| − | would also work & saves time on having to type out all the string versions of the mouseEvents!
| |
| − | note: you don't need to add all of the mouseEvents; only add the ones you need for your game!
| |
| − | --]]
| |
| − | </syntaxhighlight>
| |
| − | | |
| − | | |
| − | <span class="medium bold underline">animationStarted & animationStopped</span>
| |
| − | | |
| − | you should only include one instance of the "animationStarted" & "animationStopped" listener per game/project!
| |
| − | | |
| − | example: animationStarted & animationStopped
| |
| − | <syntaxhighlight>
| |
| − | -- let's create the function which will perform the included functions or code provided; when an animation has been started!
| |
| − | function onAnimStarted()
| |
| − | -- let's set a variable state to declare that an animation is playing!
| |
| − | var_state = 1
| |
| − | print("an animation has been started!")
| |
| − | end
| |
| − | | |
| − | -- let's create the function which will perform the included functions or code provided; when an animation has been stopped!
| |
| − | function onAnimStopped()
| |
| − | -- let's set a variable state to declare that an animation has stopped playing!
| |
| − | var_state = 0
| |
| − | print("an animation has been stopped!")
| |
| − | end
| |
| − | | |
| − | -- let's create the event listener for checking when an animation has been started!
| |
| − | registerEventHandler("animationStarted", "onAnimStarted")
| |
| − | | |
| − | -- let's create the event listener for checking when an animation has finished!
| |
| − | registerEventHandler("animationStopped","onAnimStopped")
| |
| − | </syntaxhighlight>
| |
| − | | |
| − | | |
| − | <span class="medium bold underline">textStarted & textStopped</span>
| |
| − | | |
| − | | |
| − | | |
| − | <span class="bold underline">Arguments</span>
| |
| − | | |
| − | will add later!
| |
| − | | |
| − | | |
| − | <span class="bold underline">Flags</span>
| |
| − | | |
| − | n/a (will add later)
| |
| − | | |
| − | | |
| − | <span class="bold underline">Return</span>
| |
| − | | |
| − | none
| |
| − | {{i18n|RegisterEventHandler}}
| |
