_SNDPLAYCOPY - mkilgore/QB64pe GitHub Wiki

The _SNDPLAYCOPY statement copies a sound, plays it, and automatically closes the copy using a handle parameter passed from _SNDOPEN or _SNDCOPY

_SNDPLAYCOPY handle&[,]

• The LONG handle& value is returned by _SNDOPEN using a specific sound file.
• The volume! parameter can be any SINGLE value from 0 (no volume) to 1 (full volume).

• Makes coding easier by doing all of the following automatically:

1. Copies/duplicates the source handle (see _SNDCOPY).
2. Changes the volume of the copy if volume is passed.
3. Plays the copy.
4. Closes the copy.

• This statement is a better choice than _SNDPLAYFILE if the sound will be played often, reducing the burden on the computer.

Example 1: Playing a previously opened sound at half volume.

 '' ''
_SNDPLAYCOPY applause&, 0.5 '' ''

Example 2: Playing a song at random volumes.

 '' '' 
chomp& = _SNDOPEN("chomp.wav") 
_SNDPLAYCOPY chomp&, 0.5 + RND * 0.49

• _SNDOPEN
• _SNDCOPY
• _SNDPLAYFILE