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

  <refnamediv>
    <refname>jitter2</refname>
    <refpurpose>
      Generates a segmented line with user-controllable random segments.
      <indexterm id="IndexJitter2"><primary>jitter2</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      Generates a segmented line with user-controllable random segments.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis>kout <command>jitter2</command> ktotamp, kamp1, kcps1, kamp2, kcps2, kamp3, kcps3</synopsis>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>ktotamp</emphasis> -- Resulting amplitude of jitter2
    </para>

    <para>
      <emphasis>kamp1</emphasis> -- Amplitude of the first jitter component
    </para>

    <para>
      <emphasis>kcps1</emphasis> -- Speed of random variation of the first jitter component (expressed in cps)
    </para>

    <para>
      <emphasis>kamp2</emphasis> -- Amplitude of the second jitter component
    </para>

    <para>
      <emphasis>kcps2</emphasis> -- Speed of random variation of the second jitter component (expressed in cps)
    </para>

    <para>
      <emphasis>kamp3</emphasis> -- Amplitude of the third jitter component
    </para>

    <para>
      <emphasis>kcps3</emphasis> -- Speed of random variation of the third jitter component (expressed in cps)
    </para>

    <para>
      <emphasis>jitter2</emphasis> also generates a segmented line such as <link linkend="jitter"><citetitle>jitter</citetitle></link>, but in this case the result is similar to the sum of three <emphasis>randi</emphasis> opcodes, each one with a different amplitude and frequency value (see <link linkend="randi"><citetitle>randi</citetitle></link> for more details), that can be varied at k-rate. Different effects can be obtained by varying the input arguments.
    </para>

    <para>
      <emphasis>jitter2</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 jitter2 opcode. It uses the files <ulink url="examples/jitter2.orc"><citetitle>jitter2.orc</citetitle></ulink> and <ulink url="examples/jitter2.sco"><citetitle>jitter2.sco</citetitle></ulink>.

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

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

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

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="jitter"><citetitle>jitter</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>
