-
Notifications
You must be signed in to change notification settings - Fork 7
/
Copy pathUser Guide.txt
152 lines (120 loc) · 6.39 KB
/
User Guide.txt
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
Live Coding Toolkit for Pure Data - User Guide
A suite of Pure Data abstractions (predefined functions) for musical live coding
By Andrew R. Brown, 2021
Abstractions:
tempo : BPM metronome
- arguments (beats per minute, beat subdivision)
- inlets [start/stop toggle, BPM, Sub-division]
- outlets [pulse bang, pulse count, pulse dur (ms), (re)start bang]
cycle : phrase looper
- arguments (pitch, velocity, duration)
- inlets [trigger bangs or counter, pitch list, velocity list, duration list (ints >= 1), restart count]
- outlets [next pitch, next velocity, next duration, beat count, pulse count]
periodic : stepped simple harmonic motion
- arguments (numb of steps, centre value, range)
- inlets [step, numb of steps, centre value, range]
- outlet [next value, glide to next value]
euclid : euclidean rhythm generator
- arguments (seq length, hits per seq, rotation)
- inlets [bang or step, seq length, hits per seq, rotation]
- outlet [bang, step number]
randchord : generate and store a randomised chord
- arguments (numb of notes, central pitch, max pitch deviation, pitch-class vals)
- inlets [bang to generate new chord, numb of notes, central pitch, max pitch deviation, scale pitch-class list, bang to send chord]
- outlet [list of chord data]
randseq : generate and store and randomised number sequence
- arguments (numb of steps, random range, offset, multiply)
- inlets [bang to generate seq, numb of steps, random range, offset, multiply, bang to send seq]
- outlet [list of seq data]
defer : schedule an event into the future by a number of beats
- arguments (bpm, number of beats to wait)
- inlets [data, bpm, number of beats to wait]
- outlet [delayed data]
stairs : stepped transition between two values
- arguments (numb of steps, start value, end value, curve)
- inlets [step, numb of steps, start value, end value, curve, reset]
- outlet [next value, bang on last step]
ramp : smooth transition to a new value
- arguments (end value, duration)
- inlets [end value, duration]
- outlet [value]
rand : linear, gaussian and random walk
- arguments (centre, deviation, upper limit, lower limit)
- inlets [trigger bang, centre/start value, deviation value, lower limit, upper limit]
- outlets [linear distribution, gaussian distribution, random walk]
modrand : make a random selection at each modulo cycle
- arguments (modulo value, maximum random value from 1 to 4)
- inlets [step number, modulo value, maximum random value]
- outlets [bang from up to four outlets]
direct : pass input values to a specified outlet
- arguments (outlet number from 0 to 3)
- inlets [value, outlet number from 0 to 3]
- outlet [outlet 0, outlet 1, outlet 2, outlet 3]
quant : pitch class quanitze
- arguments (list of up to 11 MIDI pitch numbers ranged from 0-11)
- inlets [MIDI pitch to quantize, pitch class list]
- outlet [quantised MIDI pitch]
trans : transpose a number of list of numbers
- arguments (transpose amount, allowable pitch classes with values from 0-11)
- inlets [value (number or list), transpose amount, pitch class list (scale)]
- outlet [transposed value (number or list)]
midi : MIDI note send and note and control change receive
- arguments (MIDI send velocity, send duration in ms, MIDI send channel from 1 to 16, receive control change number)
- inlets [MIDI pitch, MIDI velocity, duration in ms, MIDI channel from 1 to 16, set cc number to receive]
- outlets [received pitch, received velocity, received cc val (0-127), scaled received cc value (0-1)]
map : scales data from one range to another
- arguments (input min, input max, output min, output max)
- inlets [value to be scaled, input min, input max, output min, output max]
- outlet [scaled value]
gate : probabilistically let data through or not
- arguments (prob value 0-1)
- inlets [data in, prob value (0-1)]
- outlet [data out]
synth~ : simple mono subtractive synth
- arguments (filter cutoff, attack in ms, release in ms, glide in ms)
- inlets [MIDI pitch, MIDI velocity, filter cutoff, attack in ms, release in ms, glide in ms]
- outlet [mono audio signal, amplitude envelope level]
polysynth~ : 8 voice version of synth
- arguments (cutoff, attack in ms, release in ms)
- inlets [pitch, velocity, cutoff, attack, release]
- outlet [audio out left, audio out right]
fm~ : simple 2-operator frequency modulation synth
- arguments (mod index, C:M ratio, attack in ms, release in ms, glide in ms)
- inlets [MIDI pitch, MIDI velocity, modulation index, carrier:modulator ratio, attack in ms, release in ms, glide in ms]
- outlet [mono audio signal]
polyfm~ : 8 voice version of fm
- arguments (mod index, C:M ratio, attack in ms, release in ms)
- inlets [pitch, velocity, mod index, C:M ratio, attack in ms, release in ms]
- outlet [audio out left, audio out right]
drums~ : simple synthesized drum kit
- arguments (none)
- inlets [kick trigger, snare trigger, hats trigger, kick level (0-1), snare level, hats level]
- outlet [mono audio signal]
sample~ : load and playback a mono or stereo audio file
- arguments (filename, including path relative to abstraction)
- inlets [trigger (pitch or bang), velocity, filename, playback speed (0-11 or 12-127), start position (0-1), end position (0-1), scrub pos (0-1)]
- outlet [audio out left, audio out right, voice end]
polysample~ : load and playback 8 voices of a mono or stereo audio file
- arguments (filename, including path relative to abstraction)
- inlets [trigger (pitch, pitch list or bang), velocity, filename, playback speed (0-11 or 12-127), start position (0-1), end position (0-1)]
- outlet [audio out left, audio out right, voice end]
echo~ : stereo audio feedback delay
- arguments delay-time, delay-level, feedback
- inlets [audio input left, audio input right, delay-time, delay-level, feedback]
- outlets [audio out left, audio out right]
gate~ : probabilistically let audio through or not
- arguments (prob value 0-1)
- inlets [audio signal in, trigger prob calc, prob value (0-1)]
- outlet [audio signal out]
gain~ : stereo audio gain control with mute
- arguments (level 0-1)
- inlets [laudio input left, audio input right], level 0-1, mute 0 or 1]
- outlet [audio out left, audio out right]
panner~ : stereo audio panner
- arguments (pan position 0-1)
- inlets [audio signal, pan position from 0.0 - 1.0]
- outlets [audio out left, audio out right]
out~ : stereo audio output with reverb
- arguments (volume 0-1, reverb level 0-100)
- inlets (audio input left, audio input right, volume level from 0.0 to 1.0, reverb amount from 0 to 100)
- outlets [none]