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

    <refpurpose>
      Creates a held note.
      <indexterm id="IndexIhold"><primary>ihold</primary></indexterm>
    </refpurpose>
  </refnamediv>

  <refsect1>
    <title>Description</title>
    <para>
      Causes a finite-duration note to become a <quote>held</quote> note
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>ihold</command></synopsis>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>ihold</emphasis> -- this i-time statement causes a finite-duration note to become a <quote>held</quote> note. It thus has the same effect as a negative p3 ( see score <link linkend="i"><citetitle>i Statement</citetitle></link>), except that p3 here remains positive and the instrument reclassifies itself to being held indefinitely. The note can be turned off explicitly with <emphasis>turnoff</emphasis>, or its space taken over by another note of the same instrument number (i.e. it is tied into that note). Effective at i-time only; no-op during a <emphasis>reinit</emphasis> pass.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the ihold opcode. It uses the files <ulink url="examples/ihold.orc"><citetitle>ihold.orc</citetitle></ulink> and <ulink url="examples/ihold.sco"><citetitle>ihold.sco</citetitle></ulink>.

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

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

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

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="i"><citetitle>i Statement</citetitle></link>, <link linkend="turnoff"><citetitle>turnoff</citetitle></link>
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>Example written by &namekevin;.</para>
  </refsect1>
</refentry>
