## Introduction
csound-bitbitch provides opcodes for sample level alterations, glitches and other mishaps


## Requirements
 - Csound libraries
 - Cmake >= 2.8.12


## Building
Create a build directory at the top of the source tree, execute *cmake ..*, *make* and optionally *make install* as root. If the latter is not used/possible then the resulting module can be used with the *--opcode-lib* flag in Csound. eg:
	
	cd csound-bitbitch
	mkdir build && cd build
	cmake ..
	make && sudo make install


## Opcode overview
### bitchrandom
* aout bitchrandom kamp, kdensity, krepeattrig, kbufread, kbufmode [, ibufsize]

Create a stochastic data stream

 - aout : audio output

 - kdensity : 


### bitchglitch
* aout bitchglitch ain, kread, ksizeratio

Perform a basic buffered retrigger read on the input

 - aout : audio output

 - ain : audio input
 - kread : 0 = write, 1 = read
 - ksizeratio : size ratio of total buffer for the retriggered read


### bitchwreck
* aout bitchwreck ain, ibuffersize, kwrite

Aleatoric buffer reading

 - aout : audio output

 - ain : audio input
 - ibuffersize : buffer size in seconds
 - kwrite : 0 = read, 1 = write


### bitchpan
* aL, aR bitchpan ain, ibuffersize, kpansamples

Harsh sample level binary panning

 - aL : left audio output
 - aR : right audio output

 - ain : audio input
 - kpansamples : number of samples to alternate between channels


### bitchbuffer1
* aout bitchbuffer1 ain, ibuffersize, 

Harsh sample level binary panning

 - aL : left audio output
 - aR : right audio output

 - ain : audio input
 - kpansamples : number of samples to alternate between channels


### bitchaverage
* aout bitchaverage ain, [kbufferratio = 1, ibuffersize = ksmps]

Buffered sample averaging

 - aout : audio output

 - ain : audio input
 - kbufferratio : ratio of buffer size to read and write
 - ibuffersize : buffer size in samples



### bitchpeaker
* aout bitchpeaker ain [kbufferratio = 1, kconsiderationratio = 0.3, ibufferdecimation = 64, ibuffersize = ksmps]

Experimental peak resculpture

 - aout : audio output

 - ain : audio input
 - kbufferratio : ratio of buffer size to read and write
 - kconsiderationratio : ratio of buffer to consider in resculpture
 - ibufferdecimation : buffer decimation divisor
 - ibuffersize : buffer size in samples