Difference between revisions of "SetVolume"

From The Official Visionaire Studio: Adventure Game Engine Wiki
Line 1: Line 1:
<div class="toccolours mw-collapsible mw-collapsed" style="background: #f0f0f0; border: 1px dashed darkgrey" width="100%">
+
==setVolume==
<b>Command History</b>
 
<div class="mw-collapsible-content">
 
<div style="background:#ebebeb" width="100%">Available since <span style="color:orange">v3.7</span></div>
 
<div>MovieVolume & GlobalVolume added to <span style="color:orange">v3.8</span></div>
 
</div></div>
 
  
 +
<div class="command-min-version-info">Available since: <span class="command-min-version">v3.0</span></div>
  
Allows the user to set volume levels of: music, sound fx, speech, movies & global(master)
+
<div class="command-doc">Sets the general volume for background music, sound or speech output.</div>
<div class="toccolours mw-collapsible mw-collapsed" style="background: #f0f0f0; border: 1px dashed darkgrey" width="100%">
 
<b>Additional Info</b>
 
<div class="mw-collapsible-content">
 
<div>These are the numbers used inside of the setVolume(brackets) to set specific volume types! <br/>
 
<pre>eMusicVolume (0), eSoundVolume (1), eSpeechVolume (2), eMovieVolume (3) or eGlobalVolume (4)</pre></div>
 
</div></div>
 
  
 
+
Lua Syntax:
Syntax:
+
<pre class="command-syntax">setVolume(type, volume)</pre>
<syntaxhighlight>
+
===Arguments===
setVolume(type, volume)
+
====type====
</syntaxhighlight>
+
:'''int''' - The type of volume to set: eMusicVolume (0), eSoundVolume (1), eSpeechVolume (2), eMovieVolume (3) or eGlobalVolume (4).
 
+
====volume====
 
+
:'''int''' - New value for volume. Must be between 0 and 100.
Example:
+
===Flags===
 +
===Return Values===
 +
None.
 +
===Examples===
 +
Example 1: set speech volume to 50%
 
<syntaxhighlight>
 
<syntaxhighlight>
-- set music volume to 50%!
 
setVolume(eMusicVolume, 50)
 
 
-- set sound fx volume to 50%!
 
setVolume(eSoundVolume, 50)
 
 
-- set speech volume to 50%!
 
 
setVolume(eSpeechVolume, 50)
 
setVolume(eSpeechVolume, 50)
 
-- set movie volume to 50%!
 
setVolume(eMovieVolume, 50)
 
 
-- set global (master) volume to 50%!
 
setVolume(eGlobalVolume, 50)
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 
 
 
<b><u>Arguments</u></b>
 
 
<b>type</b>: integer (number) <br/>
 
The type of volume to set: eMusicVolume (0), eSoundVolume (1), eSpeechVolume (2), eMovieVolume (3) or eGlobalVolume (4)
 
 
<b>volume</b>: integer (number) <br/>
 
New value for volume. Must be a value between 0 and 100
 
 
 
<b><u>Flags</u></b>
 
 
none
 
 
 
<b><u>Return</u></b>
 
 
none
 
{{i18n|setVolume}} <br/>
 
{| style="background: #f0f0f0; border: 1px dashed darkgrey" width="100%"
 
|-
 
|<b>Relevant Pages</b>: [[GetVolume|getVolume]]
 
|}
 

Revision as of 23:33, 30 March 2013

setVolume

Available since: v3.0
Sets the general volume for background music, sound or speech output.

Lua Syntax:

setVolume(type, volume)

Arguments

type

int - The type of volume to set: eMusicVolume (0), eSoundVolume (1), eSpeechVolume (2), eMovieVolume (3) or eGlobalVolume (4).

volume

int - New value for volume. Must be between 0 and 100.

Flags

Return Values

None.

Examples

Example 1: set speech volume to 50%

setVolume(eSpeechVolume, 50)