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

  <refnamediv>
    <refname>jitter</refname>
    <refpurpose>
      Generates a segmented line whose segments are randomly generated.
      <indexterm id="IndexJitter"><primary>jitter</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      Generates a segmented line whose segments are randomly generated.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis>kout <command>jitter</command> kamp, kcpsMin, kcpsMax</synopsis>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>kamp</emphasis> -- Amplitude of jitter deviation
    </para>

    <para>
      <emphasis>kcpsMin</emphasis> -- Minimum speed of random frequency variations (expressed in cps)
    </para>

    <para>
      <emphasis>kcpsMax</emphasis> -- Maximum speed of random frequency variations (expressed in cps)
    </para>

    <para>
      <emphasis>jitter</emphasis> generates a segmented line whose segments are randomly generated inside the +kamp and -kamp interval. Duration of each segment is a random value generated according to kcpsmin and kcpsmax values.
    </para>

    <para>
      <emphasis>jitter</emphasis> can be used to make more natural and <quote>analog-sounding</quote> some static, dull sound. For best results, it is suggested to keep its amplitude moderate.
    </para>
  </refsect1>

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

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

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

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

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="jitter2"><citetitle>jitter2</citetitle></link>,
      <link linkend="vibr"><citetitle>vibr</citetitle></link>,
      <link linkend="vibrato"><citetitle>vibrato</citetitle></link>
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>Author: &namegabriel;</para>
    <para>Example written by &namekevin;.</para>
    <para>New in Version 4.15</para>
  </refsect1>
</refentry>
