CIGAL Reference Manual, Chapter 6 (RealTime): r_sound
r_sound -- Begin/end asynchronous sound playback
usage: r_sound opflg eflag ltime Flag SndName [duration]
R_SOUND is a REALTIME operator. It initiates transfer of sound data to the computer's speaker outputs. The sound data can be played either from a sound file, or from a sound resource. In either case the sound data is identified by name (file name or resource name) in the SNDNAME variable. If SndName is a string list variable the list pointer is incremented automatically by default, so that repeated calls to R_SOUND would play the successive sounds in the list.
The FLAG argument controls SOUND options:
1 - play sound from the named file; if a file with that name is not found it will attempt to play sound from a sound resource with that name (this is the default option) 2 - play sound from the named resource. This bypasses the attempt to find a file with the specified name and is thus more efficient if the sound is known to be a resource. 3 - record sound into the named file. The duration of the recording is a maximum of Duration seconds.
8 - do not increment the list pointer if SNDNAME is a string list. This allows the same sound to be played more than once. This flag can be combined with other options by addition.
When searching for files, if the filename does not pecify a file folder (directory) explicitly this command will look first in the current directory and then in the folder specified by the DATADIR string variable.
See Also:
CIGAL Home,
CIGAL Manual,
RealTime List,
Manual Help