BBCutProc:
Filter:
BBCut/Classes (extension) | Libraries > BBCut > Cut procedures

BBCutProc
ExtensionExtension

Base class for cutting procedures in BBCut2

Description

An essential base class for the BBCut library. derive from this respecting the interface to create your own cut procedures. The library assumes an abstraction for cuts as a hierachy with three components - from largest to smallest in duration, phrases, blocks and repeats.

A phrase is a sequence of blocks, perhaps lasting a few measures of 4/4. A block works from a single cut source in the audio, say a particular offset in a sample, though the block can be composed of a number of repeats, into which its assigned duration is split. A special type of block might be a roll or stutter, say a one beat block cut into a 0.125 beat source repeated eight times in total. The cut procedure does its own accounting for phrases (and may not care about phrases, or can add its own extra layers of hierachy that it tracks itself) but must work with the blocks/repeats paradigm.

The critical instance method is chooseblock, during which the instance variable cuts must be set with an array of cuts, and the blocklength parameter with the length of this next block to render. The aspiring class writer is advised to thoroughly check out an existing cut procedure so they know what is expected of them to maintain accurate accounting. The phrase/block/repeat paradigm is matched by the bbcutsynth, which can update effects parameters based on knowledge of the whereabouts of the cutting. The default behaviour is to make blocks of one repeat that make up each phrase.

Class Methods

.new

Arguments:

bpsd

beats per sub division. Passed to the BBCutSynth object for offset calculations. Defaults to 0.5 beats (that is, cutting in eighth notes or quavers).

phraselength

value called on this to choose the next phraselength at the start of a new phrase.

Instance Methods

.chooseblock

Calculate the next block.

.phraseover

A method required by the MultiProc class to test for a completed phrase so as to know when to allow a switch of method. Derived classes can ignore this base method unless they know a better implementation.

.endBlockAccounting

Method provided to help avoid repeated code for updating statistics of the base class.

.newPhraseAccounting

Method provided to help avoid repeated code for updating statistics of the base class.

Examples

see the derived classes of this super class