mirror of
https://github.com/QB64-Phoenix-Edition/QB64pe.git
synced 2024-07-06 02:20:25 +00:00
45 lines
2.1 KiB
Plaintext
45 lines
2.1 KiB
Plaintext
{{DISPLAYTITLE:_SNDSETPOS}}
|
|
The [[_SNDSETPOS]] statement changes the current/starting playing position of a sound in seconds.
|
|
|
|
|
|
{{PageSyntax}}
|
|
::: [[_SNDSETPOS]] {{Parameter|handle&}}''',''' {{Parameter|position!}}
|
|
|
|
|
|
{{PageDescription}}
|
|
*Changes the current/starting playing position of a sound in seconds(a [[SINGLE]] value).
|
|
*If the seconds position is past the length of the sound the sound will stop playing.
|
|
*Function cannot be called while a looping ([[_SNDLOOP]]) sound is being played.
|
|
*Opened '''MP3''' files must have the "SETPOS" capability to use this statement. Not all do!
|
|
{{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:''To check MP3 files for the SETPOS capability, use [[_SNDPLAY]] with [[_SNDGETPOS]] printed in a loop
|
|
{{CodeStart}} '' ''
|
|
SoundFile& = {{Cl|_SNDOPEN}}("YourSoundFile.mp3", "VOL,SETPOS,PAUSE") '<<< your MP3 sound file here!
|
|
{{Cl|_SNDSETPOS}} SoundFile&, 5.5 'set to play sound 5 1/2 seconds into music
|
|
{{Cl|_SNDPLAY}} SoundFile& 'play sound
|
|
Do: {{Cl|_LIMIT}} 60
|
|
LOCATE 5, 2: PRINT "Current play position> "; {{Cl|_SNDGETPOS}}(SoundFile&)
|
|
LOOP UNTIL {{Cl|_KEYDOWN}}(27) OR {{Cl|NOT}} {{Cl|_SNDPLAYING}}(SoundFile&) 'ESC or end of sound exit
|
|
{{CodeEnd}}
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[_SNDGETPOS]], [[_SNDLEN]]
|
|
* [[_SNDOPEN]], [[_SNDLIMIT]]
|
|
|
|
|
|
{{PageNavigation}} |