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

  <refnamediv>
    <refname>scanhammer</refname>
    <refpurpose>
      Copies from one table to another with a gain control.
      <indexterm id="IndexScanhammer"><primary>scanhammer</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      This is is a variant of <link linkend="tablecopy"><citetitle>tablecopy</citetitle></link>, copying from one table to another, starting at <emphasis>ipos</emphasis>, and with a gain control. The number of points copied is determined by the length of the source. Other points are not changed. This opcode can be used to <quote>hit</quote> a string in the scanned synthesis code.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>scanhammer</command> isrc, idst, ipos, imult</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>isrc</emphasis> -- source function table.
    </para>

    <para>
      <emphasis>idst</emphasis> -- destination function table.
    </para>

    <para>
      <emphasis>ipos</emphasis> -- starting position (in points).
    </para>

    <para>
      <emphasis>imult</emphasis> -- gain multiplier. A value of 0 will leave values unchanged.
    </para>
  </refsect1>

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

  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: Matt Gilliard</member>
        <member>April 2002</member>
      </simplelist>
    </para>

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