1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-07-05 21:40:25 +00:00
QB64-PE/internal/help/_SNDVOL.txt
2016-03-18 08:36:04 -03:00

39 lines
1.4 KiB
Plaintext

{{DISPLAYTITLE:_SNDVOL}}
The [[_SNDVOL]] statement sets the volume of a sound using a handle from the [[_SNDOPEN]] Function.
{{PageSyntax}}
::: '''_SNDVOL ('''{{Parameter|handle&}}, {{Parameter|volume!}}''')'''
{{PageDescription}}
*Volume is a value from 0 (silence) to 1 (full volume).
*An opened sound file must have the "VOL" capability to use this function.
{{TextStart}} QB64 supports the following sound file formats ('''Bold is a guaranteed capability'''):
WAV = "'''VOL,SYNC,LEN''',PAUSE" [http://www.rarewares.org/ogg-oggdropxpd.php Free WAV to OGG GUI converter]
OGG = "VOL,SYNC,LEN,PAUSE" [http://www.rarewares.org/ogg-oggenc.php Free WAV to OGG converter]
AIF = "VOL,SYNC,LEN,PAUSE"
RIF = "VOL,SYNC,LEN,PAUSE"
VOC = "VOL,SYNC,LEN,PAUSE"
MID = "'''VOL'''"
MOD = "VOL,PAUSE"
MP3 = "'''VOL''',PAUSE,SETPOS" [http://www.freemp3wmaconverter.com/index.html Free WMA, MP3 and OGG converter]
''Note:'' {{Cb|_SNDBAL}} only affects MP3 volume. Sound will reside in main channel.
{{TextEnd}}
''Example:''
{{CodeStart}} '' ''
h& = {{Cl|_SNDOPEN}}("bell.wav", "SYNC,VOL")
{{Cl|_SNDVOL}} h&, 0.5
{{Cl|_SNDPLAY}} h& '' ''
{{CodeEnd}}
{{PageSeeAlso}}
*{{KW|_SNDOPEN}}, {{KW|_SNDBAL}}
{{PageNavigation}}