Control ugen that can be set externally


Inherits from: Object : AbstractFunction : UGen : MultiOutUGen


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.


related subclasses are: TrigControl, LagControl.

For a more concise combination of name, default value and lag, see NamedControl 


The rate may be either .kr (continous control rate signal), .ar (audio rate) or .ir (a static value, set at the time the synth starts up, and subsequently unchangeable).


Control.ar(values)

Control.kr(values)

Control.ir(values)


*names(names) adds control names to the SynthDef.



(

SynthDef(\help_Control, { arg freq=200;

freq.inspect; // at the time of compiling the def


}).writeDefFile

);


What is passed into the ugenGraph function is an OutputProxy, and its source is a Control.



The main explicit use of Control is to allow Arrays to be sent to running Synths:


// 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);

}).send(s);

)


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);

}).send(s);

)


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);

}).send(s);

)


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))