1
1
Fork 0
mirror of https://github.com/DualBrain/QB64.git synced 2023-11-19 13:10:13 +00:00
QB64-website/wiki/_SNDPLAYCOPY.md
2022-12-24 21:14:48 -06:00

1.1 KiB

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

Syntax

_SNDPLAYCOPY handle&[, volume!]

Parameter(s)

  • 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).

Description

  • Makes coding easier by doing all of the following automatically:
    • #Copies/duplicates the source handle (see _SNDCOPY).
    • #Changes the volume of the copy if volume is passed.
    • #Plays the copy.
    • #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(s)

Playing a previously opened sound at half volume.


_SNDPLAYCOPY applause&, 0.5 

Playing a song at random volumes.

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

See Also