aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: d3576eceb2bce20060d6cae43d3d352291b416b8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

   

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