<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="soundout">
  <refmeta>
    <refentrytitle>soundout</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>soundout</refname>
    <refpurpose>
      Writes audio output to a disk file.
      <indexterm id="IndexSoundout"><primary>soundout</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      Writes audio output to a disk file.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>soundout</command>  asig1, ifilcod [, iformat]</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>ifilcod</emphasis> -- integer or character-string denoting the destination soundfile name. An integer denotes the file soundin.filcod; a character-string (in double quotes, spaces permitted) gives the filename itself, optionally a full pathname. If not a full path, the named file is sought first in the current directory, then in that given by the environment variable SSDIR (if defined) then by SFDIR. See also <link linkend="GEN01"><citetitle>GEN01</citetitle></link>.
    </para>

    <para>
      <emphasis>iformat</emphasis> (optional, default=0) -- specifies the audio data file format:
      <itemizedlist>
        <listitem>
          <para>1 = 8-bit signed char (high-order 8 bits of a 16-bit integer)</para>
        </listitem>

        <listitem>
          <para>2 = 8-bit A-law bytes</para>
        </listitem>

        <listitem>
          <para>3 = 8-bit U-law bytes</para>
        </listitem>

        <listitem>
          <para>4 = 16-bit short integers</para>
        </listitem>

        <listitem>
          <para>5 = 32-bit long integers</para>
        </listitem>

        <listitem>
          <para>6 = 32-bit floats</para>
        </listitem>
      </itemizedlist>
    </para>

    <para>
      If <emphasis>iformat</emphasis> = 0 it is taken from the soundfile header, and if no header from the Csound <link linkend="FlagsMinusLowerO"><citetitle>-o</citetitle></link> command-line flag. The default value is 0.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>soundout</emphasis> writes audio output to a disk file.
    </para>
  </refsect1>
 
  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="out"><citetitle>out</citetitle></link>,
      <link linkend="outh"><citetitle>outh</citetitle></link>,
      <link linkend="outo"><citetitle>outo</citetitle></link>,
      <link linkend="outq"><citetitle>outq</citetitle></link>,
      <link linkend="outq1"><citetitle>outq1</citetitle></link>,
      <link linkend="outq2"><citetitle>outq2</citetitle></link>,
      <link linkend="outq3"><citetitle>outq3</citetitle></link>,
      <link linkend="outq4"><citetitle>outq4</citetitle></link>,
      <link linkend="outs"><citetitle>outs</citetitle></link>,
      <link linkend="outs1"><citetitle>outs1</citetitle></link>,
      <link linkend="outs2"><citetitle>outs2</citetitle></link>
    </para>
  </refsect1>
 
  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: &namebarry;, &namematt;/&namemike;</member>
        <member>MIT, Mills College</member>
        <member>1993-1997</member>
      </simplelist>
    </para>
  </refsect1>
</refentry>
