CtkAudio : CtkBus : CtkObj : Object

Extension

Description

Part of the Composer's Tool Kit (CTK) system. See CTK for more details.

CtkAudio is a wrapper for an audio Bus suitable for use with CTK objects. CtkAudio object can be passed in straight to a CtkNotes arg. The bus id will be extracted for you.

Class Methods

CtkAudio.new(numChans: 1, bus, server)

CtkAudio.play(numChans: 1, bus, server)

Inherited class methods

Instance Methods

.bus

.free

Inherited instance methods

Examples

CtkScore

Examples that populate an instance of CtkScore. The CtkScore can then be rendered in NRT, played or saved as a file. See CtkScore for more examples.( var pnotes, group, noisesynth, noisebus, filtbus, ampsynth, ampbus, task, env; var score, now; score = CtkScore.new; pnotes = CtkProtoNotes( SynthDef(\noise, {arg outbus; Out.ar(outbus, WhiteNoise.ar(1)); }), SynthDef(\filts, {arg outbus, inbus, dur, freq, amp; var env, envgen, src; env = Control.names([\env]).kr(Env.newClear(8)); envgen = EnvGen.kr(env, timeScale: dur, doneAction: 2); src = BPF.ar(In.ar(inbus), freq, 0.01); Out.ar(outbus, Pan2.ar(src * envgen * amp, Rand(-1.0, 1.0))); }), SynthDef(\dels, {arg inbus, deltime, dur, amp; var env, envgen, src; env = Control.names([\env]).kr(Env.newClear(8)); envgen = EnvGen.kr(env, timeScale: dur, doneAction: 2); src = CombN.ar(In.ar(inbus, 2), deltime, [deltime, Rand.new(0.01, deltime)]); Out.ar(0, src * envgen * amp); }), SynthDef(\controlenv, {arg gate = 1, outbus; var env; env = Control.names([\env]).kr(Env.newClear(8)); Out.kr(outbus, EnvGen.kr(env, gate)); }).load(s) ); env = Env([0, 1, 0], [1, 4], [3, -4], 1); group = CtkGroup.new.addTo(score); noisebus = CtkAudio.new; // allocate an audio bus to route noise filtbus = CtkAudio.new(2); // sends stereo ampbus = CtkControl.new; // for global amp control noisesynth = pnotes[\noise].note(0.1, addAction: \head, target: group) .outbus_(noisebus) // a CtkAudio! No need to call .bus .addTo(score); ampsynth = pnotes[\controlenv].note(1.0, 10, addAction: \head, target: group) .outbus_(ampbus.bus) // a CtkControl... need to call .bus! .env_(env) .release(10 - env.releaseTime) .addTo(score); now = 0.0; while({ // place the filter notes after the noisesynth pnotes[\filts].note(1.0 + now, addAction: \after, target: noisesynth) .dur_(1) .outbus_(filtbus) // route output for the delays .inbus_(noisebus) // read in the noisebus .env_(Env([0, 1, 0], [0.5, 0.5], \sin)) .freq_(1200.rrand(2400)) .amp_(ampbus) .addTo(score); pnotes[\dels].note(1.0 + now, addAction: \tail, target: group) .inbus_(filtbus) // read in the filtered noise .deltime_(0.01.rrand(0.03)) .dur_(1.5) .env_(Env([0, 1, 0], [0.5, 0.5], \sin)) .amp_(ampbus) // don't call .bus here... it will map the arg for you .addTo(score); now = now + 0.5; now < 10; }); // uncomment to play the CtkScore you have created score.play(s); // uncomment to write the score to a soundfile // score.write("~/Desktop/test.aiff".standardizePath, options: ServerOptions.new.numOutputBusChannels_(2)); // uncomment to save the CtkScore as a file // score.saveToFile("~/Desktop/test.sc".standardizePath); )

Using CtkAudio to set output bus

CtkAudio can be passed directly to set an argument specifying the output bus, but this will not work if that bus number is subject to any operation (e.g. addition).s.boot; // This works as expected - CtkAudio's bus number is extracted and used ( ~sd = CtkSynthDef(\mapTest0, {|out = 1| out.poll(1, \outNoAddition); Out.ar(out, DC.ar(0)); }) ) ~bus = CtkAudio().play; // create a private bus ~bus.bus; // check bus index ~note = ~sd.note.play; // play the note and observe post window ~note.out_(~bus); // the bus index is extracted and properly used as the bus number ~note.free; ~bus.free; // free everything // However, this doesn't work as expected // Instead of using CtkAudio bus number, value from the bus is mapped to the bus number ( ~sd = CtkSynthDef(\mapTest1, {|out = 1| out.poll(1, \outBeforeAddition); Out.ar(out + 1, DC.ar(0)); // note that we add an offset to the bus number here }) ) ~bus = CtkAudio().play; // create a private bus ~bus.bus; // check bus index ~note = ~sd.note.play; // play the note and observe post window ~note.out_(~bus); // the value of out is mapped to CtkAudio, i.e. it reads values from the bus instead of using bus index ~note.out_(~bus.bus); // in that case we need to pass the bus value explicitly ~note.out_(~bus.index); // this is a synonymous method ~note.free; ~bus.free; // free everything