Difference between revisions of "RegisterEventHandler"
From The Official Visionaire Studio: Adventure Game Engine Wiki
(Created page with "<b>History</b>: Available since <span style="color:green">v3.7</span> <br/> MovieVolume & GlobalVolume added to <span style="color:green">v3.8</span> Allows the user to check...") |
|||
Line 13: | Line 13: | ||
Syntax: | Syntax: | ||
<syntaxhighlight> | <syntaxhighlight> | ||
− | + | registerEventHandler('eventName', 'functionName', {integerValue or eventFlagName}) | |
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 18:42, 5 March 2013
History: Available since v3.7
MovieVolume & GlobalVolume added to v3.8
Allows the user to check current volume levels of: music, sound fx, speech, movies & global(master)
Additional Info |
---|
These are the numbers used inside of the getVolume(brackets) to check specific volume types! eMusicVolume (0), eSoundVolume (1), eSpeechVolume (2), eMovieVolume (3) or eGlobalVolume (4) |
Syntax:
registerEventHandler('eventName', 'functionName', {integerValue or eventFlagName})
Example:
-- is music volume over 50%?
if getVolume(0) > 50 then
-- do some action!
end
-- is sound fx volume less than 25%?
if getVolume(1) < 25 then
-- do some action!
end
-- is speech volume more than or equal to 80%?
if getVolume(2) >= 80 then
-- do some action!
end
-- is movie volume at 50%?
if getVolume(3) == 50 then
-- do some action!
end
-- is global (master) volume not equal to 50%?
if getVolume(4) ~= 50 then
-- do some action!
end
Arguments
type: integer
The type of volume to return: eMusicVolume (0), eSoundVolume (1), eSpeechVolume (2), eMovieVolume (3) or eGlobalVolume (4)
Flags: none
Return: volume
The queried volume