Difference between revisions of "SNDGETPOS"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
m
imported>Flukiluke
(Created page with "{{DISPLAYTITLE:_SNDGETPOS}} The _SNDGETPOS function returns the current playing position in seconds using a handle from _SNDOPEN. {{PageSyntax}} :{{Parameter|positio...")
Line 8: Line 8:


{{PageDescription}}
{{PageDescription}}
*Returns the currently playing position in seconds from '''MP3''' sound files with the SETPOS capability.
*Returns the currently playing position in seconds.
*If a sound isn't playing, it returns 0.
*If a sound isn't playing, it returns 0.
*If a sound is paused, it returns the paused position.
*If a sound is paused, it returns the paused position.
*For a looping sound, the value returned continues to increment and does not reset to 0 when the sound loops.
*For a looping sound, the value returns to 0 when the sound restarts.
{{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}}
{{PageSeeAlso}}

Revision as of 11:28, 12 August 2017

The _SNDGETPOS function returns the current playing position in seconds using a handle from _SNDOPEN.


Syntax

position = _SNDGETPOS(handle&)


Description

  • Returns the currently playing position in seconds.
  • If a sound isn't playing, it returns 0.
  • If a sound is paused, it returns the paused position.
  • For a looping sound, the value returns to 0 when the sound restarts.

See also



Navigation:
Keyword Reference - Alphabetical
Keyword Reference - By Usage
Main Wiki Page