{{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}}