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

    <refpurpose>
      Defines and initializes numeric arrays at orchestra load time.
      <indexterm id="IndexPset"><primary>pset</primary></indexterm>
    </refpurpose>
  </refnamediv>

  <refsect1>
    <title>Description</title>
    <para>
      Defines and initializes numeric arrays at orchestra load time.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>pset</command> icon1 [, icon2] [...]</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>icon1, icon2, ...</emphasis> -- preset values for a MIDI instrument
    </para>

    <para>
      <emphasis>pset</emphasis> (optional) defines and initializes numeric arrays at orchestra load time. It may be used as an orchestra header statement (i.e. instrument 0) or within an instrument. When defined within an instrument, it is not part of its i-time or performance operation, and only one statement is allowed per instrument. These values are available as i-time defaults. When an instrument is triggered from MIDI it only gets p1 and p2 from the event, and p3, p4, etc. will receive the actual preset values.
    </para>
  </refsect1>

  <refsect1>
    <title>Examples</title>
    <para>
      The example below illustrates <emphasis>pset</emphasis> as used within an instrument.

      <informalexample>
        <programlisting>
<command>instr</command> 1
  <emphasis>pset</emphasis> 0,0,3,4,5,6  ; pfield substitutes
  a1 <emphasis>oscil</emphasis> 10000, 440, p6
        </programlisting>
      </informalexample>
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="strset"><citetitle>strset</citetitle></link>
    </para>
  </refsect1>
</refentry> 
