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

  <refnamediv>
    <refname>subinstrinit</refname>
    <refpurpose>
      Creates and runs a numbered instrument instance at init-time.
      <indexterm id="IndexSubinstrinit"><primary>subinstrinit</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      Same as <link linkend="subinstr"><citetitle>subinstr</citetitle></link>, but init-time only and has no output arguments.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>subinstrinit</command> instrnum [, p4] [, p5] [...]</synopsis>
    <synopsis><command>subinstrinit</command> &quot;insname&quot; [, p4] [, p5] [...]</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>instrnum</emphasis> -- Number of the instrument to be called.
    </para>

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

    <para>
      For more information about specifying input and output interfaces, see <link linkend="InstrSubinstrument"><citetitle>Calling an Instrument within an Instrument</citetitle></link>.
    </para>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>p4, p5, ...</emphasis> -- Additional input values the are mapped to the called instrument p-fields, starting with p4.
    </para>

    <para>
      The called instrument's p2 and p3 values will be identical to the host instrument's values. While the host instrument can <link linkend="ControlDurctl"><citetitle>control its own duration</citetitle></link>, any such attempts inside the called instrument will most likely have no effect.
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="InstrSubinstrument"><citetitle>Calling an Instrument within an Instrument</citetitle></link>,
      <link linkend="event"><citetitle>event</citetitle></link>,
      <link linkend="schedule"><citetitle>schedule</citetitle></link>,
      <link linkend="subinstr"><citetitle>subinstr</citetitle></link>
     </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>New in version 4.23</para>
  </refsect1>
</refentry>
