cs

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:

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.

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.