PLAYWAVEwavefileflags
Plays a wave file.
The wavefile input is a filename of a WAVE file.
It may either be a word or a list of words.
If wavefile is the empty word or the empty list, then FMSLogo stops any wave files that it is currently playing.
If the file named by wavefile does not exist or is an invalid wave file, then the instruction does nothing.
The flags input is an integer that describes how the sound should be played.
The meaning is given by the following table:
| Flag | Behavior |
|---|---|
0 | Synchronous does not stop until completed. |
1 | Asynchronous returns immediately while sound is still playing. |
2 | Don't use the default sound if the specified one cannot be found. |
4 | In memory sound (not supported). |
8 | Continue to loop the sound until another PLAYWAVE instruction is run. |
16 | Don't stop an already playing sound. |
These flags can be combined by adding them together.
; loop the tada sound.
PLAYWAVE "c:\\windows\\tada.wav 1+8
; wait two seconds
WAIT 120
; stop the sound
PLAYWAVE [] 0