<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="table3">
  <refmeta>
    <refentrytitle>table3</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>table3</refname>
    <refpurpose>
      Accesses table values by direct indexing with cubic interpolation.
      <indexterm id="IndexTable3"><primary>table3</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      Accesses table values by direct indexing with cubic interpolation.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis>ar <command>table3</command> andx, ifn [, ixmode] [, ixoff] [, iwrap]</synopsis>

    <synopsis>ir <command>table3</command> indx, ifn [, ixmode] [, ixoff] [, iwrap]</synopsis>

    <synopsis>kr <command>table3</command> kndx, ifn [, ixmode] [, ixoff] [, iwrap]</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>ifn</emphasis> -- function table number.
    </para>

    <para>
      <emphasis>ixmode</emphasis> (optional) -- index data mode. The default value is 0.
      <itemizedlist>
        <listitem><para>0 = raw index</para></listitem>
        <listitem><para>1 = normalized (0 to 1)</para></listitem>
      </itemizedlist>
    </para>

    <para>
      <emphasis>ixoff</emphasis> (optional) -- amount by which index is to be offset. For a table with origin at center, use tablesize/2 (raw) or .5 (normalized). The default value is 0.
    </para>

    <para>
      <emphasis>iwrap</emphasis> (optional) -- wraparound index flag. The default value is 0.
      <itemizedlist>
        <listitem>
          <para>0 = nowrap (index &lt; 0 treated as index=0; index tablesize sticks at index=size)</para>
        </listitem>

        <listitem>
          <para>1 = wraparound.</para>
        </listitem>
      </itemizedlist>
    </para>
  </refsect1>
 
  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>table3</emphasis> is experimental, and is identical to <link linkend="tablei"><citetitle>tablei</citetitle></link>, except that it uses cubic interpolation. (New in Csound version 3.50.)
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="table"><citetitle>table</citetitle></link>,
      <link linkend="tablei"><citetitle>tablei</citetitle></link>,
      <link linkend="oscil1"><citetitle>oscil1</citetitle></link>,
      <link linkend="oscil1i"><citetitle>oscil1i</citetitle></link>,
      <link linkend="osciln"><citetitle>osciln</citetitle></link>
    </para>
  </refsect1>
</refentry>
