<section id="CommandFlags">
  <title>Command-line Flags</title>

  <para>
    Many flags are generic Csound command-line flags. Various platform implementations may not react the same way to different flags!
  </para>

  <para>
    The format of a command is either:
    <cmdsynopsis>
      <command>csound</command>
      <arg><option>-flags</option></arg>
      <arg><replaceable>orchname</replaceable></arg>
      <arg><replaceable>scorename</replaceable></arg>
    </cmdsynopsis>

    or

    <cmdsynopsis>
      <command>csound</command>
      <arg><option>-flags</option></arg>
      <arg><replaceable>csdfilename</replaceable></arg>
    </cmdsynopsis>
  </para>

  <para>
    where the arguments are of 2 types: <emphasis>flags</emphasis> arguments (beginning with a <quote>-</quote>), and <emphasis>name</emphasis> arguments (such as filenames). Certain flag arguments take a following name or
numeric argument.
  </para>

  <variablelist>
    <title>Command-line Flags</title>
    
    <varlistentry id="FlagsMinusAt">
      <term>-&commat; FILE<indexterm id="IndexMinusAt"><primary>-&commat;</primary></indexterm></term>
      <listitem>
        <para>
          Provide an extended command-line in file <quote>FILE</quote>
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinus3">
      <term>-3<indexterm id="IndexMinus3"><primary>-3</primary></indexterm>, --format=24bit<indexterm id="IndexMinusFormat24bit"><primary>--format=24bit</primary></indexterm></term>
      <listitem>
        <para>
          Use 24-bit audio samples.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinus8">
      <term>-8<indexterm id="IndexMinus8"><primary>-8</primary></indexterm>, --format=uchar<indexterm id="IndexMinusFormatUchar"><primary>--format=uchar</primary></indexterm></term>
      <listitem>
        <para>
          Use 8-bit unsigned character audio samples.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperA">
      <term>-A<indexterm id="IndexMinusUpperA"><primary>-A</primary></indexterm>, --aiff<indexterm id="IndexMinusAiff"><primary>--aiff</primary></indexterm></term>
      <listitem>
        <para>
          Write an AIFF format soundfile. Use with the <link linkend="FlagsMinusLowerC"><citetitle>-c</citetitle></link>, <link linkend="FlagsMinusLowerS"><citetitle>-s</citetitle></link>, <link linkend="FlagsMinusLowerL"><citetitle>-l</citetitle></link>, or <link linkend="FlagsMinusLowerF"><citetitle>-f</citetitle></link> flags.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerA">
      <term>-a<indexterm id="IndexMinusLowerA"><primary>-a</primary></indexterm>, --format=alaw<indexterm id="IndexMinusFormatAlaw"><primary>--format=alaw</primary></indexterm></term>
      <listitem>
        <para>
          Use a-law audio samples.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperB">
      <term>-B NUM<indexterm id="IndexMinusUpperB"><primary>-B</primary></indexterm>, --hardwarebufsamps=NUM<indexterm id="IndexMinusHardwarebufsamps"><primary>--hardwarebufsamps</primary></indexterm></term>
      <listitem>
        <para>
          Number of audio sample-frames held in the DAC <emphasis>hardware</emphasis> buffer. This is a threshold on which <emphasis>software</emphasis> audio I/O (above) will wait before returning. A small number reduces audio I/O delay; but the value is often hardware limited, and small values will risk data lates. The default is 1024.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerB">
      <term>-b NUM<indexterm id="IndexMinusLowerB"><primary>-b</primary></indexterm>, --iobufsamps=NUM<indexterm id="IndexMinusIobufsamps"><primary>--iobugsamps</primary></indexterm></term>
      <listitem>
        <para>
          Number of audio sample-frames per sound i/o <emphasis>software</emphasis> buffer. Large is efficient, but small will reduce audio I/O delay. The default is 1024. In real-time performance, Csound waits on audio I/O on <emphasis>NUM</emphasis> boundaries. It also processes audio (and polls for other input like MIDI) on orchestra <emphasis>ksmps</emphasis> boundaries. The two can be made synchronous. For convenience, if NUM = -NUM (is negative) the effective value is <emphasis>ksmps * NUM</emphasis> (audio synchronous with k-period boundaries). With NUM small (e.g. 1) polling is then frequent and also locked to fixed DAC sample boundaries.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperC">
      <term>-C<indexterm id="IndexMinusUpperC"><primary>-C</primary></indexterm>, --cscore<indexterm id="IndexMinusCscore"><primary>--cscore</primary></indexterm></term>
      <listitem>
        <para>
          Use Cscore processing of the scorefile.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerC">
      <term>-c<indexterm id="IndexMinusLowerC"><primary>-c</primary></indexterm>, --format=schar<indexterm id="IndexMinusFormatSchar"><primary>--format=schar</primary></indexterm></term>
      <listitem>
        <para>
          Use 8-bit signed character audio samples.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperD">
      <term>-D<indexterm id="IndexMinusUpperD"><primary>-D</primary></indexterm>, --defer-gen1<indexterm id="IndexMinusDefergen1"><primary>--defer-gen1</primary></indexterm></term>
      <listitem>
        <para>
          Defer GEN01 soundfile loads until performance time.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerD">
      <term>-d<indexterm id="IndexMinusLowerD"><primary>-d</primary></indexterm>, --nodisplays<indexterm id="IndexMinusNodisplays"><primary>--nodisplays</primary></indexterm></term>
      <listitem>
        <para>
          Suppress all displays.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperE">
      <term>-E NUM<indexterm id="IndexMinusUpperE"><primary>-E</primary></indexterm>, --graphs=NUM<indexterm id="IndexMinusGraphs"><primary>--graphs</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Mac only.</emphasis> Number of tables in graphics window. <emphasis>(was -G)</emphasis>
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerE">
      <term>-e<indexterm id="IndexMinusLowerE"><primary>-e</primary></indexterm>, --format=rescale<indexterm id="IndexMinusFormatRescale"><primary>--format=rescale</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Mac only.</emphasis> Rescale floats as shorts to max amplitude.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperF">
      <term>-F FILE<indexterm id="IndexMinusUpperF"><primary>-F</primary></indexterm>, --midifile=FILE<indexterm id="IndexMinusMidifile"><primary>--midifile</primary></indexterm></term>
      <listitem>
        <para>
          Read MIDI events from MIDI file <emphasis>FILE</emphasis>.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerF">
      <term>-f<indexterm id="IndexMinusLowerF"><primary>-f</primary></indexterm>, --format=float<indexterm id="IndexMinusFormatFloat"><primary>--format=float</primary></indexterm></term>
      <listitem>
        <para>
          Use single-precision float audio samples (not playable, but can be read by <link linkend="FlagsMinusLowerI"><citetitle>-i</citetitle></link>, <link linkend="soundin"><citetitle>soundin</citetitle></link> and <link linkend="GEN01"><citetitle>GEN01</citetitle></link>
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperG">
      <term>-G<indexterm id="IndexMinusUpperG"><primary>-G</primary></indexterm>, --postscriptdisplay<indexterm id="IndexMinusPostscriptdisplay"><primary>--postscriptdisplay</primary></indexterm></term>
      <listitem>
        <para>
          Suppress graphics, use PostScript displays instead.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerG">
      <term>-g<indexterm id="IndexMinusLowerG"><primary>-g</primary></indexterm>, --asciidisplay<indexterm id="IndexMinusAsciidisplay"><primary>--asciidisplay</primary></indexterm></term>
      <listitem>
        <para>
          Suppress graphics, use ASCII displays instead.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperH">
      <term>-H#<indexterm id="IndexMinusUpperH"><primary>-H</primary></indexterm>, --heartbeat=NUM<indexterm id="IndexMinusHeartbeat"><primary>--heartbeat</primary></indexterm></term>
      <listitem>
        <para>
          Print a heartbeat after each soundfile buffer write:
          <itemizedlist>
            <listitem><para>no NUM, a rotating bar.</para></listitem>
            <listitem><para>NUM = 1, a rotating bar.</para></listitem>
            <listitem><para>NUM = 2, a dot (.)</para></listitem>
            <listitem><para>NUM = 3, filesize in seconds.</para></listitem>
            <listitem><para>NUM = 4, sound a bell.</para></listitem>
          </itemizedlist>
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerH">
      <term>-h<indexterm id="IndexMinusLowerH"><primary>-h</primary></indexterm>, --noheader<indexterm id="IndexMinusNoheader"><primary>--noheader</primary></indexterm></term>
      <listitem>
        <para>
          No header on output soundfile. Don't write a file header, just binary samples.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry id="FlagsMinusHelp">
      <term>--help<indexterm id="IndexMinusHelp"><primary>--help</primary></indexterm></term>
      <listitem>
        <para>
          Display on-line help message.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperI">
      <term>-I<indexterm id="IndexMinusUpperI"><primary>-I</primary></indexterm>, --i-only<indexterm id="IndexMinusIonly"><primary>--i-only</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>i-time only.</emphasis> Allocate and initialize all instruments as per the score, but skip all p-time processing (no k-signals or a-signals, and thus no amplitudes and no sound). Provides a fast validity check of the score pfields and orchestra i-variables.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerI">
      <term>-i FILE<indexterm id="IndexMinusLowerI"><primary>-i</primary></indexterm>, --input=FILE<indexterm id="IndexMinusInput"><primary>--input</primary></indexterm></term>
      <listitem>
        <para>
          Input soundfile name. If not a full pathname, the file will be sought first in the current directory, then in that given by the environment variable SSDIR (if defined), then by SFDIR. The name <emphasis>stdin</emphasis> will cause audio to be read from standard input. If RTAUDIO is enabled, the name <emphasis>devaudio</emphasis> will request sound from the host audio input device.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperJ">
      <term>-J<indexterm id="IndexMinusUpperJ"><primary>-J</primary></indexterm>, --ircam<indexterm id="IndexMinusIrcam"><primary>--ircam</primary></indexterm></term>
      <listitem>
        <para>
          Write an IRCAM format soundfile.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerJ">
      <term>-j FILE<indexterm id="IndexMinusLowerJ"><primary>-j</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Currently disabled.</emphasis> Use database <emphasis>FILE</emphasis> for messages to print to console during performance.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperK">
      <term>-K<indexterm id="IndexMinusUpperK"><primary>-K</primary></indexterm>, --nopeaks<indexterm id="IndexMinusNopeaks"><primary>--nopeaks</primary></indexterm></term>
      <listitem>
        <para>
          Do not generate any PEAK chunks.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerK">
      <term>-k NUM<indexterm id="IndexMinusLowerK"><primary>-k</primary></indexterm>, --control-rate=NUM<indexterm id="IndexMinusControlrate"><primary>--control-rate</primary></indexterm></term>
      <listitem>
        <para>
          Override the control rate (<link linkend="kr"><citetitle>KR</citetitle></link>) supplied by the orchestra.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperL">
      <term>-L DEVICE<indexterm id="IndexMinusUpperL"><primary>-L</primary></indexterm>, --score-in=DEVICE<indexterm id="IndexMinusScorein"><primary>--score-in</primary></indexterm></term>
      <listitem>
        <para>
          Read line-oriented real-time score events from device <emphasis>DEVICE</emphasis>. The name <emphasis>stdin</emphasis> will permit score events to be typed at your terminal, or piped from another process. Each line-event is terminated by a carriage-return. Events are coded just like those in a <emphasis>standard numeric score</emphasis>, except that an event with p2=0 will be performed immediately, and an event with p2=T will be performed T seconds after arrival. Events can arrive at any time, and in any order. The score <emphasis>carry</emphasis> feature is legal here, as are held notes (p3 negative) and string arguments, but ramps and <emphasis>pp</emphasis> or <emphasis>np</emphasis> references are not.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerL">
      <term>-l<indexterm id="IndexMinusLowerL"><primary>-l</primary></indexterm>, --format=long<indexterm id="IndexMinusFormatLong"><primary>--format=long</primary></indexterm></term>
      <listitem>
        <para>
          Use long integer audio samples.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperM">
      <term>-M DEVICE<indexterm id="IndexMinusUpperM"><primary>-M</primary></indexterm>, --midi-device=DEVICE<indexterm id="IndexMinusMididevice"><primary>--midi-device</primary></indexterm></term>
      <listitem>
        <para>
          Read MIDI events from device <emphasis>DEVICE</emphasis>.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerM">
      <term>-m NUM<indexterm id="IndexMinusLowerM"><primary>-m</primary></indexterm>, --messagelevel=NUM<indexterm id="IndexMinusMessagelevel"><primary>--messagelevel</primary></indexterm></term>
      <listitem>
        <para>
          Message level for standard (terminal) output. Takes the <emphasis>sum</emphasis> of 3 print control flags, turned on by the following values:
          <itemizedlist>
            <listitem><para>1 = note amplitude messages</para></listitem>
            <listitem><para>2 = samples out of range message</para></listitem>
            <listitem><para>4 = warning messages</para></listitem>
          </itemizedlist>
        </para>

        <para>
          The default value is <emphasis>m7</emphasis> (all messages on).
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperN">
      <term>-N<indexterm id="IndexMinusUpperN"><primary>-N</primary></indexterm>, --notify<indexterm id="IndexMinusNotify"><primary>--notify</primary></indexterm></term>
      <listitem>
        <para>
          Notify (ring the bell) when score or MIDI track is done.
        </para>
      </listitem>
    </varlistentry>
     
    <varlistentry id="FlagsMinusLowerN">
      <term>-n<indexterm id="IndexMinusLowerN"><primary>-n</primary></indexterm>, --nosound<indexterm id="IndexMinusNosound"><primary>--nosound</primary></indexterm></term>
      <listitem>
        <para>
          No sound. Do all processing, but bypass writing of sound to disk. This flag does not change the execution in any other way.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperO">
      <term>-O FILE<indexterm id="IndexMinusUpperO"><primary>-O</primary></indexterm>, --logfile=FILE<indexterm id="IndexMinusLogfile"><primary>--logfile</primary></indexterm></term>
      <listitem>
        <para>
          Log output to file <emphasis>FILE</emphasis>.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerO">
      <term>-o FILE<indexterm id="IndexMinusLowerO"><primary>-o</primary></indexterm>, --output=FILE<indexterm id="IndexMinusOutput"><primary>--output</primary></indexterm></term>
      <listitem>
        <para>
          Output soundfile name. If not a full pathname, the soundfile will be placed in the directory given by the environment variable SFDIR (if defined), else in the current directory. The name <emphasis>stdout</emphasis> will cause audio to be written to standard output. If no name is given, the default name will be <emphasis>test</emphasis>. If RTAUDIO is enabled, the name <emphasis>devaudio</emphasis> will send to the host audio output device.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperP">
      <term>-P NUM<indexterm id="IndexMinusUpperP"><primary>-P</primary></indexterm>, --pollrate=NUM<indexterm id="IndexMinusPollrate"><primary>--pollrate</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Mac only.</emphasis> Poll events every NUM buffer writes.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerP">
      <term>-p<indexterm id="IndexMinusLowerP"><primary>-p</primary></indexterm>, --play-on-end<indexterm id="IndexMinusPlayonend"><primary>--playonend</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Mac only.</emphasis> Play after rendering.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperQ">
      <term>-Q DEVICE, -Q DIRECTORY<indexterm id="IndexMinusUpperQ"><primary>-Q</primary></indexterm>, --analysis-directory=DIRECTORY<indexterm id="IndexMinusAnalysisdirectory"><primary>--analysis-directory</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Beos and Linux only.</emphasis> Enables MIDI OUT operations and optionally chooses device id <emphasis>DEVICE</emphasis> (if the DEVICE argument is present). This flag allows parallel MIDI OUT and DAC performance. Unfortunately the real-time timing implemented in Csound is completely managed by DAC buffer sample flow. So MIDI OUT operations can present some time irregularities. These irregularities can be fully eliminated when suppressing DAC operations themselves (see <link linkend="FlagsMinusUpperY"><citetitle>-Y</citetitle></link> flag).
        </para>
        <para>
          <emphasis>Mac only.</emphasis> Define the analysis (SADIR) directory.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerQ">
      <term>-q DIRECTORY<indexterm id="IndexMinusLowerQ"><primary>-q</primary></indexterm>, --sample-directory=DIRECTORY<indexterm id="IndexMinusSampledirectory"><primary>--sample-directory</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Mac only.</emphasis> Define the sound sample-in (SSDIR) directory.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperR">
      <term>-R<indexterm id="IndexMinusUpperR"><primary>-R</primary></indexterm>, --rewrite<indexterm id="IndexMinusRewrite"><primary>--rewrite</primary></indexterm></term>
      <listitem>
        <para>
          Continually rewrite the header while writing the soundfile (WAV/AIFF).
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerR">
      <term>-r NUM<indexterm id="IndexMinusLowerR"><primary>-r</primary></indexterm>, --sample-rate=NUM<indexterm id="IndexMinusSamplerate"><primary>--sample-rate</primary></indexterm></term>
      <listitem>
        <para>
          Override the sampling rate (<link linkend="sr"><citetitle>SR</citetitle></link>) supplied by the orchestra.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerS">
      <term>-s<indexterm id="IndexMinusLowerS"><primary>-s</primary></indexterm>, --format=short<indexterm id="IndexMinusFormatShort"><primary>--format=short</primary></indexterm></term>
      <listitem>
        <para>
          Use short integer audio samples.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry id="FlagsMinusSched">
      <term>--sched<indexterm id="IndexMinusSched"><primary>--sched</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Linux only.</emphasis> Use real-time scheduling and lock memory. (Also requires <link linkend="FlagsMinusLowerD"><citetitle>-d</citetitle></link> and either <link linkend="FlagsMinusLowerO"><citetitle>-o dac</citetitle></link> or <link linkend="FlagsMinusLowerO"><citetitle>-o devaudio</citetitle></link>).
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperT">
      <term>-T<indexterm id="IndexMinusUpperT"><primary>-T</primary></indexterm>, --terminate-on-midi<indexterm id="IndexMinusTerminateonmidi"><primary>--terminate-on-midi</primary></indexterm></term>
      <listitem>
        <para>
          Terminate the performance when MIDI track is done.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerT0">
      <term>-t0<indexterm id="IndexMinusLowerT0"><primary>-t0</primary></indexterm>, --keep-sorted-score<indexterm id="IndexMinusKeepsortedscore"><primary>--keep-sorted-score</primary></indexterm></term>
      <listitem>
        <para>
          Prevents Csound from deleting the sorted score file, score.srt, upon exit.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerT">
      <term>-t NUM<indexterm id="IndexMinusLowerT"><primary>-t</primary></indexterm>, --tempo=NUM<indexterm id="IndexMinusTempo"><primary>--tempo=NUM</primary></indexterm></term>
      <listitem>
        <para>
          Use the uninterpreted beats of <emphasis>score.srt</emphasis> for this performance, and set the initial tempo at <emphasis>NUM</emphasis> beats per minute. When this flag is set, the tempo of score performance is also controllable from within the orchestra.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry id="FlagsMinusUpperU">
      <term>-U UTILITY<indexterm id="IndexMinusUpperU"><primary>-U</primary></indexterm>, --utility=UTILITY<indexterm id="IndexMinusUtility"><primary>--utility</primary></indexterm></term>
      <listitem>
        <para>
          Invoke the utility program <emphasis>UTILITY</emphasis>.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerU">
      <term>-u<indexterm id="IndexMinusLowerU"><primary>-u</primary></indexterm>, --format=ulaw<indexterm id="IndexMinusFormatUlaw"><primary>--format=ulaw</primary></indexterm></term>
      <listitem>
        <para>
          Use u-law audio samples.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperV">
      <term>-V NUM<indexterm id="IndexMinusUpperV"><primary>-V</primary></indexterm>, --screen-buffer=NUM<indexterm id="IndexMinusScreenbuffer"><primary>--screen-buffer</primary></indexterm>, --volume=NUM<indexterm id="IndexMinusVolume"><primary>--volume</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Linux only.</emphasis> Set real-time audio output volume to NUM (1 to 100).
        </para>
        <para>
        <emphasis>Mac only.</emphasis> Number of chars in the screen buffer for the output window.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerV">
      <term>-v<indexterm id="IndexMinusLowerV"><primary>-v</primary></indexterm>, --verbose<indexterm id="IndexMinusVerbose"><primary>--verbose</primary></indexterm></term>
      <listitem>
        <para>
          Verbose translate and run. Prints details of orch translation and performance, enabling errors to be more clearly located.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperW">
      <term>-W<indexterm id="IndexMinusUpperW"><primary>-W</primary></indexterm>, --wave<indexterm id="IndexMinusWave"><primary>--wave</primary></indexterm></term>
      <listitem>
        <para>
          Write a WAV format soundfile.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerW">
      <term>-w<indexterm id="IndexMinusLowerW"><primary>-w</primary></indexterm>, --save-midi<indexterm id="IndexMinusSaveMidi"><primary>--save-midi</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Mac only.</emphasis> Record and save MIDI input to a file.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperX">
      <term>-X DIRECTORY<indexterm id="IndexMinusUpperX"><primary>-X</primary></indexterm>, --sound-directory=DIRECTORY<indexterm id="IndexMinusSounddirectory"><primary>--sound-directory</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Mac only.</emphasis> Define the sound file (SFDIR) directory.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerX">
      <term>-x FILE<indexterm id="IndexMinusLowerX"><primary>-x</primary></indexterm>, --extract-score=FILE<indexterm id="IndexMinusExtractscore"><primary>--extract-score</primary></indexterm></term>
      <listitem>
        <para>
          Extract a portion of the sorted score, score.srt, using the extract file <emphasis>FILE</emphasis> (see <link linkend="commandpreextract"><citetitle>Extract</citetitle></link>).
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperY">
      <term>-Y NUM<indexterm id="IndexMinusUpperY"><primary>-Y</primary></indexterm>, --progress-rate=NUM<indexterm id="IndexMinusProgressRate"><primary>--progress-rate</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Currently disabled. Mac only.</emphasis> Enables progress display at rate NUM in seconds, or for negative NUM, at -NUM kperiods.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerY">
      <term>-y NUM<indexterm id="IndexMinusLowerY"><primary>-y</primary></indexterm>, --profile-rate=NUM<indexterm id="IndexMinusProfileRate"><primary>--profile-rate</primary></indexterm></term>
      <listitem>
        <para>
          <emphasis>Currently disabled. Mac only.</emphasis> Enables profile display at rate NUM in seconds, or for negative NUM, at -NUM kperiods.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusUpperZ">
      <term>-Z<indexterm id="IndexMinusUpperZ"><primary>-Z</primary></indexterm>, --dither<indexterm id="IndexMinusDither"><primary>--dither</primary></indexterm></term>
      <listitem>
        <para>
          Switch on dithering of audio conversion from internal floating point to 32, 16 and 8-bit formats.
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="FlagsMinusLowerZ">
      <term>-z NUM<indexterm id="IndexMinusLowerZ"><primary>-z</primary></indexterm>, --list-opcodesNUM<indexterm id="IndexMinusListopcodes"><primary>--list-opcodesNUM</primary></indexterm></term>
      <listitem>
        <para>
          List opcodes in this version:
          <itemizedlist>
            <listitem><para>no NUM, just show names</para></listitem>
            <listitem><para>NUM = 0, just show names</para></listitem>
            <listitem><para>NUM = 1, show arguments to each opcode using the format &lt;opname&gt; &lt;inargs&gt; &lt;outargs&gt;</para></listitem>
          </itemizedlist>
        </para>
      </listitem>
    </varlistentry>
  </variablelist>
</section>
