<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="oscil1">
  <refmeta>
    <refentrytitle>oscil1</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>oscil1</refname>
    <refpurpose>
      Accesses table values by incremental sampling.
      <indexterm id="IndexOscil1"><primary>oscil1</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      Accesses table values by incremental sampling.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis>kr <command>oscil1</command> idel, kamp, idur, ifn</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>idel</emphasis> -- delay in seconds before <emphasis>oscil1</emphasis> incremental sampling begins.
    </para>

    <para>
      <emphasis>idur</emphasis> -- duration in seconds to sample through the <emphasis>oscil1</emphasis> table just once. A zero or negative value will cause all initialization to be skipped.
    </para>

    <para>
      <emphasis>ifn</emphasis> -- function table number. <emphasis>tablei, oscil1i</emphasis> require the extended guard point.
    </para>

  </refsect1>
 
  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>kamp</emphasis> -- amplitude factor.
    </para>

    <para>
      <emphasis>oscil1</emphasis> accesses values by sampling once through the function table at a rate determined by <emphasis>idur</emphasis>. For the first <emphasis>idel</emphasis> seconds, the point of scan will reside at the first location of the table; it will then begin moving through the table at a constant rate, reaching the end in another <emphasis>idur</emphasis> seconds; from that time on (i.e. after <emphasis>idel</emphasis> + <emphasis>idur</emphasis> seconds) it will remain pointing at the last location. Each value obtained from sampling is then multiplied by an amplitude factor <emphasis>kamp</emphasis> before being written into the result.
    </para>
  </refsect1>

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