/usr/share/SuperCollider/HelpSource/Classes/Control.schelp is in supercollider-common 1:3.8.0~repack-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 153 154 155 156 157 158 159 160 161 162 | class:: Control
summary:: Bring signals and floats into the ugenGraph function of a SynthDef.
related:: Classes/NamedControl, Classes/LagControl, Classes/TrigControl
categories:: UGens>Synth control
Description::
A Control is a UGen that can be set and routed externally to interact with a running Synth.
Typically, Controls are created from the arguments of a SynthDef function.
Generally you do not create Controls yourself. (See Arrays example
below).
The rate may be either .kr (continuous control rate signal) or .ir (a
static value, set at the time the synth starts up, and subsequently
unchangeable). For .ar, see link::Classes/AudioControl::
SynthDef creates these when compiling the ugenGraph function. They are
created for you, you use them, and you don't really need to worry about
them if you don't want to.
For a more concise combination of name, default value and lag, see link::Classes/NamedControl::
classmethods::
method::kr, ir
argument::values
default values.
method::names
argument::names
adds control names to the SynthDef.
Examples::
code::
(
SynthDef(\help_Control, { | freq = 200 |
freq.inspect; // at the time of compiling the def
}).add
);
// synonym:
(
SynthDef(\help_Control, {
\freq.kr(200).inspect; // at the time of compiling the def
}).add
);
::
What is passed into the ugenGraph function is an link::Classes/OutputProxy::, and its source is a Control.
The main explicit use of Control is to allow Arrays to be sent to running Synths:
code::
// a synth def that has 4 partials
(
SynthDef(\help_Control, { arg out=0, i_freq;
var klank, harm, amp, ring;
// harmonics
harm = Control.names([\harm]).ir(Array.series(4, 1, 1).postln);
// amplitudes
amp = Control.names([\amp]).ir(Array.fill(4, 0.05));
// ring times
ring = Control.names([\ring]).ir(Array.fill(4, 1));
klank = Klank.ar(`[harm, amp, ring], { ClipNoise.ar(0.01) }.dup, i_freq);
Out.ar(out, klank);
}).add;
)
a = Synth(\help_Control, [\i_freq, 300, \harm, [1, 3.3, 4.5, 7.8]]);
a.free;
a = Synth(\help_Control, [\i_freq, 300, \harm, [2, 3, 4, 5]]);
a.free;
(
SynthDef(\help_Control_Sines, { arg out=0;
var sines, control, numsines;
numsines = 20;
control = Control.names(\array).kr(Array.rand(numsines, 400.0, 1000.0));
sines = Mix(SinOsc.ar(control, 0, numsines.reciprocal)) ;
Out.ar(out, sines ! 2);
}).add
)
b = Synth(\help_Control_Sines);
b.setn(\array, Array.rand(20, 200, 1600));
b.setn(\array, Array.rand(20, 200, 1600));
(
SynthDef(\help_Control_DynKlank, { arg out=0, freq = 440;
var klank, harm, amp, ring;
// harmonics
harm = Control.names(\harm).kr(Array.series(4, 1, 1));
// amplitudes
amp = Control.names(\amp).kr(Array.fill(4, 0.05));
// ring times
ring = Control.names(\ring).kr(Array.fill(4, 1));
klank = DynKlank.ar(`[harm, amp, ring], {ClipNoise.ar(0.003)}.dup, freq);
Out.ar(out, klank);
}).add
)
a = Synth(\help_Control_DynKlank, [\freq, 300]);
b = Synth(\help_Control_DynKlank, [\freq, 400]);
a.setn(\harm, Array.rand(4, 1.0, 4.7))
a.setn(\amp, Array.rand(4, 0.005, 0.1))
a.setn(\ring, Array.rand(4, 0.005, 1.0))
b.setn(\harm, Array.rand(4, 1.0, 4.7))
b.setn(\amp, Array.rand(4, 0.005, 0.1))
b.setn(\ring, Array.rand(4, 0.005, 1.0))
::
subsection:: Symbols
Inside SynthDefs and UGen functions, symbols can be used to conveniently specify control inputs of different rates and with lags (see: link::Classes/NamedControl::, and link::Classes/Symbol::)
definitionlist::
## code:: \name.kr(val, lag) ::
|| Return a control rate link::Classes/NamedControl:: input with a default value (val), and if supplied, with a lag. If val is an array, the control will be multichannel.
code::
a = { SinOsc.ar(\freq.kr(440, 1.2)) }.play;
a.set(\freq, 330);
a.release;
a = { SinOsc.ar(\freq.kr([440, 460], 1.2)) }.play;
a.setn(\freq, [330, 367]);
a.release;
::
## code:: \name.ar(val, lag) ::
|| Return an audio rate link::Classes/NamedControl:: input with a default value (val), and if supplied, with a lag. If val is an array, the control will be multichannel.
## code:: \name.ir(val) ::
|| Return an initialization rate link::Classes/NamedControl:: input with a default value (val). If val is an array, the control will be multichannel.
## code:: \name.tr(val) ::
|| Return a link::Classes/TrigControl:: input with a default value (val). If val is an array, the control will be multichannel.
code::
a = { Ringz.ar(T2A.ar(\trig.tr), \freq.kr(500, 1), 0.8) }.play;
a.set(\freq, 330, \trig, 1);
a.set(\freq, 830, \trig, 1);
a.release;
::
::
|