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

  <refnamediv>
    <refname>ftmorf</refname>
    <refpurpose>
       Morphs between multiple ftables as specified in a list.
      <indexterm id="IndexFtmorf"><primary>ftmorf</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      Uses an index into a table of ftable numbers to morph between adjacent tables in the list.This morphed function is written into the table referenced by <emphasis>iresfn</emphasis> on every k-cycle.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>ftmorf</command> kftndx, iftfn, iresfn</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>iftfn</emphasis> -- The ftable function. The list of values are expected to be pre-existing ftable numbers.
    </para>

    <para>
      <emphasis>iresfn</emphasis> -- Table number of the morphed function
    </para>

    <para>
      The length of all the tables in <emphasis>iftfn</emphasis> must equal the length of <emphasis>iresfn</emphasis>.
    </para>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>kftndx</emphasis> -- the index into the <emphasis>iftfn</emphasis> table.
    </para>

    <para>
      If <emphasis>iftfn</emphasis> contains (6, 4, 6, 8, 7, 4):

      <itemizedlist>
        <listitem>
          <para>
            <emphasis>kftndx=4</emphasis> will write the contents of f7 into <emphasis>iresfn</emphasis>.
          </para>
        </listitem>

        <listitem>
          <para>
            <emphasis>kftndx=4.5</emphasis> will write the average of the contents of f7 and f4 into <emphasis>iresfn</emphasis>.
          </para>
        </listitem>
      </itemizedlist>
    </para>
  </refsect1>

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

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

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

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

  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: William <quote>Pete</quote> Moss</member>
        <member>University of Texas at Austin</member>
        <member>Austin, Texas USA</member>
        <member>Jan. 2002</member>
      </simplelist>
    </para>

    <para>New in version 4.18</para>
  </refsect1>
</refentry>
