User Tools

Site Tools


jvs:cigal:manual:chapter6:r_sound

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

jvs/cigal/manual/chapter6/r_sound.txt · Last modified: 2023/02/23 18:43 (external edit)