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

  <refnamediv>
    <refname>bbcuts</refname>
    <refpurpose>
      Generates breakbeat-style cut-ups of a stereo audio stream.
      <indexterm id="IndexBbcuts"><primary>bbcuts</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      The BreakBeat Cutter automatically generates cut-ups of a source audio stream in the style of drum and bass/jungle breakbeat manipulations.  There are two versions, for mono (<emphasis>bbcutm</emphasis>) or stereo (<emphasis>bbcuts</emphasis>) sources.  Whilst originally based on breakbeat cutting, the opcode can be applied to any type of source audio.
    </para>

    <para>
      The prototypical cut sequence favoured over one bar with eighth note subdivisions would be

      <literallayout>
3+ 3R + 2
      </literallayout>
 
      where we take a 3 unit block from the source's start, repeat it, then 2 units from the 7th and 8th eighth notes of the source.
    </para>

    <para>
      We talk of rendering phrases (a sequence of cuts before reaching a new phrase at the beginning of a bar) and units (as subdivision th notes).
    </para>

    <para>
      The opcode comes most alive when multiple synchronised versions are used simultaneously.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis>a1,a2 <command>bbcuts</command> asource1, asource2, ibps, isubdiv, ibarlength, iphrasebars, inumrepeats [, istutterspeed] [, istutterchance] [, ienvchoice]</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>ibps</emphasis> -- Tempo to cut at, in beats per second.
    </para>

    <para>
      <emphasis>isubdiv</emphasis> -- Subdivisions unit, for a bar. So 8 is eighth notes (of a 4/4 bar).
    </para>

    <para>
      <emphasis>ibarlength</emphasis> -- How many beats per bar. Set to 4 for default 4/4 bar behaviour.
    </para>

    <para>
      <emphasis>iphrasebars</emphasis> -- The output cuts are generated in phrases, each phrase is up to iphrasebars long
    </para>

    <para>
      <emphasis>inumrepeats</emphasis> --  In normal use the algorithm would allow up to one additional repeat of a given cut at a time. This parameter allows that to be changed. Value 1 is normal- up to one extra repeat. 0 would avoid repeating, and you would always get back the original source except for enveloping and stuttering.
    </para>

    <para>
      <emphasis>istutterspeed</emphasis> -- (optional, default=1) The stutter can be an integer multiple of the subdivision speed. For instance, if subdiv is 8 (quavers) and stutterspeed is 2, then the stutter is in semiquavers (sixteenth notes= subdiv 16). The default is 1.
    </para>

    <para>
      <emphasis>istutterchance</emphasis> -- (optional, default=0) The tail of a phrase has this chance of becoming a single repeating one unit cell stutter (0.0 to 1.0). The default is 0.
    </para>

    <para>
      <emphasis>ienvchoice</emphasis> -- (optional, default=1) choose 1 for on (exponential envelope for cut grains) or 0 for off. Off will cause clicking, but may give good noisy results, especially for percussive sources. The default is 1, on.
    </para>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>asource</emphasis> -- The audio signal to be cut up. This version runs in real-time without knowledge of future audio.
    </para>
  </refsect1>

  <refsect1>
    <title>Examples</title>
    <para>
      See the advanced examples for the <link linkend="bbcutm"><citetitle>bbcutm</citetitle></link> opcode.
    </para>
  </refsect1>

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

  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: Nick Collins</member>
        <member>London</member>
        <member>August 2001</member>
      </simplelist>
    </para>

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