<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="prealloc">
  <refmeta>
    <refentrytitle>prealloc</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>prealloc</refname>

    <refpurpose>
      Creates space for instruments but does not run them.
      <indexterm id="IndexPrealloc"><primary>prealloc</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      Creates space for instruments but does not run them.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>prealloc</command> insnum, icount</synopsis>
    <synopsis><command>prealloc</command> &quot;insname&quot;, icount</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>insnum</emphasis> -- instrument number
    </para>

    <para>
      <emphasis>icount</emphasis> -- number of instrument allocations
    </para>

    <para>
      <emphasis><quote>insname</quote></emphasis> -- A string (in double-quotes) representing a named instrument.
    </para>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      All instances of <emphasis>prealloc</emphasis> must be defined in the header section, not in the instrument body.
    </para>
  </refsect1>

  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the prealloc opcode. It uses the files <ulink url="examples/prealloc.orc"><citetitle>prealloc.orc</citetitle></ulink> and <ulink url="examples/prealloc.sco"><citetitle>prealloc.sco</citetitle></ulink>.

      <example>
        <title>Example of the prealloc opcode.</title>

        <programlisting>
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="examples/prealloc.orc" format="linespecific">
            </imageobject>
          </inlinemediaobject>
        </programlisting>

        <programlisting>
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="examples/prealloc.sco" format="linespecific">
            </imageobject>
          </inlinemediaobject>
        </programlisting>
      </example>
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="cpuprc"><citetitle>cpuprc</citetitle></link>, <link linkend="maxalloc"><citetitle>maxalloc</citetitle></link>
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: &namegabriel;</member>
        <member>Italy</member>
        <member>July 1999</member>
      </simplelist>
    </para>
    <para>Example written by &namekevin;.</para>

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