<!-- Converted to DocBook/SGML by Kevin Conder -->
<chapter id="CscoreTop">
  <title>Cscore</title>

  <para>
    <indexterm id="IndexCscore"><primary>Cscore</primary></indexterm>
    <emphasis>Cscore</emphasis> is a program for generating and manipulating numeric score files. It comprises a number of function subprograms, called into operation by a user-written control program, and can be invoked either as a standalone score preprocessor, or as part of the Csound run-time system:
  </para>

  <para>
    <cmdsynopsis>
      <command>Cscore</command>
      <arg><replaceable>scorefilein</replaceable></arg>
      <arg><replaceable>scorefileout</replaceable></arg>
    </cmdsynopsis>
  </para>

  <para>or</para>

  <para>
    <cmdsynopsis>
      <command>CSound</command>
      <arg><replaceable>-C</replaceable></arg>
      <arg><option>otherflags</option></arg>
      <arg><replaceable>orchname</replaceable></arg>
      <arg><replaceable>scorename</replaceable></arg>
    </cmdsynopsis>
  </para>

  <para>
    The available function programs augment the C language library functions; they can read either standard or pre-sorted score files, can massage and expand the data in various ways, then make it available for performance by a Csound orchestra.
  </para>

  <para>
    The user-written control program is also in C, and is compiled and linked to the function programs (or the entire Csound) by the user. It is not essential to know the C language well to write this program, since the function calls have a simple syntax, and are powerful enough to do most of the complicated work. Additional power can come from C later as the need arises.
  </para>

&cscoreevents;
&cscoremain;
&cscoreadvancd;
&cscorecompile;

</chapter>
