NAME
cs - Starts Csound with a set of options that can be controlled by
environment variables, and input and output files determined by the
specified filename stem. .
DESCRIPTION
Starts Csound with a set of options that can be controlled by
environment variables, and input and output files determined by the
specified filename stem.
SYNTAX
cs [-OPTIONS] <name> [CSOUND OPTIONS ... ]
INITIALIZATION
Flags:
· - OPTIONS = OPTIONS is a sequence of alphabetic characters that can
be used for selecting the Csound executable to be run, as well as
the command line flags (see below). There is a default for the
option ´r´ (selects real-time output), but it can be overridden.
· <name> = this is the filename stem for selecting input files; it
may contain a path. Files that have .csd, .orc, or .sco extension
are searched, and either a CSD or an orc/sco pair that matches
<name> the best are selected. MIDI files with a .mid extension are
also searched, and if one that matches <name> at least as close as
the CSD or orc/sco pair, it is used with the -F flag.
NOTE
The MIDI file is not used if any -M or -F flag is specified by
the user - new in version 4.24.0) Unless there is any option
(-n or -o) related to audio output, an output file name with
the appropriate extension is automatically generated (based on
the name of selected input files and format options). The
output file is always written to the current directory.
NOTE
file name extensions are not case sensitive.
· [CSOUND OPTIONS ... ] = any number of additional options for
Csound that are simply copied to the final command line to be
executed.
The command line that is executed is generated from four parts:
1. Csound executable (possibly with options). This is exactly one of
the following (the last one has the highest precedence):
· a built-in default
· the value of the CSOUND environment variable
· environment variables with a name in the format of CSOUND_x
where x is an uppercase letter selected by characters of the
-OPTIONS string. Thus, if the -dcba option is used, and the
environment variables CSOUND_B and CSOUND_C are defined, the
value of CSOUND_B will take effect.
2. Any number of option lists, added in the following order:
· either some built-in defaults, or the value of the CSFLAGS
environment variable if it is defined.
· environment variables with a name in the format of
CSFLAGS_x where x is an uppercase letter selected by
characters of the -OPTIONS string. Thus, if the -dcba
option is used, and the environment variables CSFLAGS_A and
CSFLAGS_C are defined as ´-M 1 -o dac´ and ´-m231 -H0´,
respectively, the string ´-m231 -H0 -M 1 -o dac´ will be
added.
3. The explicit options of [CSOUND OPTIONS ... ].
4. Any options and file names generated from <name>.
NOTE
Quoted options that contain spaces are allowed.
EXAMPLES
Assuming the following environment variables:
CSOUND = csoundfltk.exe -W
CSOUND_D = csound64.exe -J
CSOUND_R = csoundfltk.exe -h
CSFLAGS = -d -m135 -H1 -s
CSFLAGS_D = -f
CSFLAGS_R = -m0 -H0 -o dac1 -M "MIDI Yoke NT: 1" -b 200 -B 6000
And a directory that contains:
foo.orc piano.csd
foo.sco piano.mid
im.csd piano2.mid
ImproSculpt2_share.csd foobar.csd
The following commands will execute as shown:
cs foo => csoundfltk.exe -W -d -m135 -H1 -s -o foo.wav \
foo.orc foo.sco
cs foob => csoundfltk.exe -W -d -m135 -H1 -s \
-o foobar.wav foobar.csd
cs -r imp -i adc => csoundfltk.exe -h -d -m135 -H1 -s -m0 -H0 \
-o dac1 -M "MIDI Yoke NT: 1" \
-b 200 -B 6000 -i adc \
ImproSculpt2_share.csd
cs -d im => csound64.exe -J -d -m135 -H1 -s -f -o im.sf \
im.csd
cs piano => csoundfltk.exe -W -d -m135 -H1 -s \
-F piano.mid -o piano.wav \
piano.csd
cs piano2 => csoundfltk.exe -W -d -m135 -H1 -s \
-F piano2.mid -o piano2.wav \
piano.csd
CREDITS
Author: Istvan Varga
Jan 2003
AUTHORS
Barry Vercoe
MIT Media Lab
Author.
Dan Ellis
MIT Media Lab,
Cambridge
Massachussetts
Author.
COPYRIGHT