PLAY (function)
Jump to navigation
Jump to search
The PLAY function returns the number of remaining notes/samples/seconds in the background music queue.
Syntax
- remaining& = PLAY (numericExpression&)
Parameters
- remaining& is the number of notes/samples/seconds left to play in the background music queue.
- numericExpression& can be any numeric expression.
- See also the important version dependent notes in the Availability section.
Description
- This function may be used to detect, if the background music queue is still playing.
- When there is nothing left to play, then this function returns zero.
Availability
v0.934
v3.1.0
yes
yes
yes
- In QB64 and early QB64-PE, this was just implemented as stub function which always returned zero.
- Since QB64-PE v3.1.0 the function is fully implemented, but unlike QuickBASIC, in QB64-PE this function does not return the number of notes left, but the number of audio samples.
- Since QB64-PE v3.8.0, if numericExpression& is a number other than zero, then the function will return the amount of time (seconds) left to play.
Examples
PLAY "mb l4cf.l8el4fag.l8fl4gl8agl4f.l8fl4a>cl2dl4dl4c.<l8al4afg.l8fl4gl8agl4f.l8dl4dcl2f>l4dc.<l8al4afg.l8fl4g>dc.<l8al4a>cl2dl4dc.<l8al4afg.l8fl4gl8agl4f.l8dl4dcl1f" PRINT "Playing tune..." DO smplLeft& = PLAY(0) timeLeft& = PLAY(1) LOCATE 3, 1: PRINT "Samples left to play ="; smplLeft&; " "; LOCATE 4, 1: PRINT "Seconds left to play ="; timeLeft&; " "; LOOP WHILE smplLeft& PRINT: PRINT: PRINT "And we are done!" END |
See also