<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="fin">
  <refmeta>
    <refentrytitle>fin</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>fin</refname>
    <refpurpose>
      Read signals from a file at a-rate.
      <indexterm id="IndexFin"><primary>fin</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      Read signals from a file at a-rate.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>fin</command> ifilename, iskipframes, iformat, ain1 [, ain2] [, ain3] [,...]</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>ifilename</emphasis> -- input file name (can be a string or a handle number generated by fiopen)
    </para>

    <para>
      <emphasis>iskipframes</emphasis> -- number of frames to skip at the start (every frame contains a sample of each channel)
    </para>

    <para>
      <emphasis>iformat</emphasis> -- a number specifying the input file format.
      <itemizedlist>
        <listitem>
          <para>0 -  32 bit floating points without header</para>
        </listitem>

        <listitem>
          <para>1 - 16 bit integers without header</para>
        </listitem>
      </itemizedlist>
    </para>
  </refsect1>
 
  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>fin</emphasis> (file input) is the complement of <link linkend="fout"><citetitle>fout</citetitle></link>: it reads a multichannel file to generate audio rate signals. At the present time no header is supported for the file format. The user must be sure that the number of channels of the input file is the same as the number of <emphasis>ainX</emphasis> arguments.
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="fini"><citetitle>fini</citetitle></link>,
      <link linkend="fink"><citetitle>fink</citetitle></link>
    </para>
  </refsect1>
 
  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: &namegabriel;</member>
        <member>Italy</member>
        <member>1999</member>
      </simplelist>
    </para>

    <para>New in Csound version 3.56</para>
  </refsect1>
</refentry>
