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>
getVolume()
+
registerEventHandler('eventName', 'functionName', {integerValue or eventFlagName})
 
</syntaxhighlight>
 
</syntaxhighlight>
  

Revision as of 19: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