blob: 676390f75f5a88ee0365367b0b3342360ee3b876 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
|
<chapter id="CommandTop">
<title>The Csound Command</title>
<para>
The command <emphasis>csound</emphasis> is a basic frontend to the system that can be used to generate a sound output from an <link linkend="OrchTop"><citetitle>orchestra</citetitle></link> file and a <link linkend="ScoreTop"><citetitle>score</citetitle></link> file (or a unified <link linkend="CommandUnifile"><citetitle>csd file</citetitle></link>). It is designed to be called from a terminal or DOS window. In addition to it, there are other <link linkend="OviewFrontEnds"><citetitle>front-ends</citetitle></link>, which might be simpler to use. The score file can be in one of many different formats, according to user preference. Translation, sorting, and formatting into orchestra-readable numeric text is handled by various preprocessors; all or part of the score is then sent on to the orchestra. Orchestra performance is influenced by <link linkend="CommandFlagsCategory"><citetitle>command flags</citetitle></link>, which set the level of displays and console reports, specify I/0 filenames and sample formats, and declare the nature of real-time sensing and control.
</para>
<section id="CommandOrder">
<title>Order of Precedence</title>
<para>
There are five places where options for Csound performance may be set. They are processed in the following order:
<orderedlist>
<listitem><para>Csound's own defaults</para></listitem>
<listitem><para>File defined by the CSOUND6RC <link linkend="CommandEnvironment"><citetitle>environment variable</citetitle></link>, or .csound6rc file in the HOME directory</para></listitem>
<listitem><para>A <link linkend="CommandUnifileParFile"><citetitle>.csound6rc</citetitle></link> file in the current directory</para></listitem>
<listitem><para><CsOptions> tag in a <link linkend="CommandUnifile"><citetitle>.csd file</citetitle></link></para></listitem>
<listitem><para>Passed on the Csound <link linkend="CommandDesc"><citetitle>command</citetitle></link> line</para></listitem>
</orderedlist>
</para>
<para>
The later options in the list will override any earlier ones.
As of version 5.01 of Csound, sample and control rate override flags
(<link linkend="FlagsMinusLowerR"><citetitle>-r</citetitle></link> and
<link linkend="FlagsMinusLowerK"><citetitle>-k</citetitle></link>)
specified anywhere override sr, kr, and ksmps defined in the orchestra header.
</para>
</section>
&commanddesc;
&commandflags;
&commandflagscategory;
&commandenvironment;
&commandunifile;
&commandpreproc;
</chapter>
|