NamedControl : Object

Description

A NamedControl directly combines a ControlName and a Control UGen conveniently. Also this makes it safe even if several identical controls exist (see example below).

There are syntax shortcuts that generate NamedControls from the name:\name.ar(values, lags, spec) \name.kr(values, lags, fixedLag, spec) \name.ir(values, lags, spec) \name.tr(values, lags, spec)

Class Methods

NamedControl.ar(name, values, lags, spec)

NamedControl.kr(name, values, lags, fixedLag: false, spec)

NamedControl.ir(name, values, lags, spec)

NamedControl.tr(name, values, lags, spec)

NamedControl.new(name, values, rate, lags, fixedLag: false, spec)

Inherited class methods

Undocumented class methods

NamedControl.initDict

Instance Methods

Inherited instance methods

Undocumented instance methods

.control

.fixedLag

.lags

.name

.rate

.spec

.spec = spec

.values

Examples

Multiple usage of the same name

Identical controls can not make use of different defaults and lag values. They can be saved to a variable to avoid duplicate code.// multiple usage of the same name: a = { SinOsc.ar(\freq.kr(440, 1.0)) + Saw.ar(\freq.kr(440, 1.0) * 0.5) * 0.1 }.play; a.set(\freq, 1220); a.set(\freq, 120); // with different lag values: a = { SinOsc.ar(\freq.kr(440).lag(3.5)) + Saw.ar(\freq.kr(440).lag(0.05) * 0.5) * 0.1 }.play; a.set(\freq, 1220); a.set(\freq, 120); // control saved to a variable: ( a = { var freq = \freq.kr(440); SinOsc.ar(freq.lag(3.5)) + Saw.ar(freq.lag(0.05) * 0.5) * 0.1; }.play; ) a.set(\freq, 1220); a.set(\freq, 120);

Comparison with direct use of Controls

In the situation when functions are used to combine UGens to more complex SynthDefs, it may not be known which ControlNames are already taken by others. NamedControl allows to reuse existing control names.// compare this: ( a = { var x, y; x = NamedControl.kr(\freq, 440).lag(3.5); y = NamedControl.kr(\freq, 440).lag(1); SinOsc.ar([x, y] * [2, 1.2]) * 0.1 }.play; ) a.set(\freq, 1220); a.set(\freq, 120); // to this: ( a = { var x, y; x = Control.names([\freq]).kr(440).lag(3.5); y = Control.names([\freq]).kr(440).lag(1); // this hangs when set SinOsc.ar([x, y] * [2, 1.2]) * 0.1 }.play; ) a.set(\freq, 1220); a.set(\freq, 120);

Using dictionary with functions to build SynthDefs

Here is a basic example using a dictionary with functions that can be combined to build SynthDefs.( q = (); q.makeEnv = { |q, env, doneAction = 0| EnvGen.kr(env, NamedControl.kr(\gate, 1), doneAction: doneAction) }; q.chooseNoise = { [ {PinkNoise.ar}, {WhiteNoise.ar}, {LFNoise2.ar(Rand(100, 1000))}].choose.value}; q.filterInput = { |q, in| [ { BPF.ar(in * 15, NamedControl.kr(\freq, 800), 0.2) }, { RHPF.ar(in, NamedControl.kr(\freq, 800, 0.2), 0.2) } ].choose.value }; ) // test the envelope: a = { SinOsc.ar(440) * q.makeEnv(Env.asr, 2) * 0.1 }.play; a.set(\gate, -3); // release in 3 seconds // single channel: a = { q.chooseNoise * q.makeEnv(Env.asr, 2) }.play; a.set(\gate, -3); // release in 3 seconds a = { q.filterInput(q.chooseNoise) * q.makeEnv(Env.asr, 2) }.play; a.set(\freq, 1000); // set filter frequency a.set(\gate, -3); // release in 3 seconds ( a = { var channels = Array.fill(8, { q.filterInput(q.chooseNoise) * q.makeEnv(Env.asr, 2) }); Splay.ar(channels); }.play; ) a.set(\freq, 6000); // set filter frequency a.set(\gate, -3); // release in 3 seconds