CtkScore | SuperCollider 3.13.0 Help

Description

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

CtkScore enables rendering Scores with CTK objects. Examples below show how to populate an instance of CtkScore. The CtkScore can then be rendered in non-real-time (NRT), played or saved as a file. See also Non-Realtime Synthesis (NRT).

Class Methods

.new

Crete new instance of a CtkScore. Any number of initial events may be passed in at creation time.

Arguments:

... events

Events are instances of CtkNote, CtkGroup, CtkBuffer, CtkEvent, CtkControl or another CtkScore.

Instance Methods

.add

Add events to the score. Any number of events may be added.

Arguments:

... events

Events are instances of CtkNote, CtkGroup, CtkBuffer, CtkEvent, CtkControl or another CtkScore.

.write

Renders the CtkScore in non-real-time (NRT) mode

Arguments:

path	The output file path.
duration	The duration of the score. This defaults to 'nil' which will render the entire CtkScore.
sampleRate	The sample rate of the output file.
headerFormat	See SoundFile: -headerFormat
sampleFormat	See SoundFile: -sampleFormat
options	An instance of ServerOptions. This is useful e.g. for specifying number of channels in the output file: `ServerOptions.new.numOutputBusChannels_(2)`
action	A function to be evaluated once the NRT server has finished rendering its score.
inputFilePath	An optional path for an input soundfile.
oscFilePath	An optional path to which the binary OSC file will be written.

.play

Plays this instance of CtkScore in real-time (RT) on the server.

NOTE: When CtkScore.play is called, the CtkScore is rendered fully before performance starts which may cause a delay. Events that are instances of CtkBuffer are also allocated to the Server before performance starts to ensure they are ready for use. This, too, may cause a delay.

Arguments:

server	The sever on which to play the score.
clock	An optional clock and quant to be used as a tempo base.
quant
startPoint
endPoint

.score

Returns:

the Score that is created as part of CtkScore.

.copy

Make a copy of this score

Returns:

a copy of this score

.offset

Set an offset for this score, useful whem mergin multiple scores

Arguments:

duration

Offset in seconds

.saveToFile

Saves the Score associated with this instance of CtkScore.

Arguments:

path	'path' to save to

.items

Returns:

An array of all events in the CtkScore.

Examples

s.boot;
(
var scpn, score, grainfun, gliss;
scpn = CtkProtoNotes(
    SynthDef(\control, {arg outbus, rate, low, hi;
        Out.kr(outbus, LFNoise2.kr(rate).range(low, hi))
    }),
    SynthDef(\test, {arg freq, amp, dur;
        var env, envgen, src;
        env = Env([0, 1, 0], [0.5, 0.5], \sin);
        envgen = EnvGen.kr(env, timeScale: dur);
        src = BPF.ar(WhiteNoise.ar(amp), freq, 0.01, amp * envgen);
        Out.ar(0, Pan2.ar(src, Rand(-1.0, 1.0)));
    })
);

score = CtkScore.new;

//creates a granular gesture of duration. Each grain is 0.1 seconds long, new grain every 0.02 seconds
grainfun = {arg starttime, duration, ampenv, lowfreq, hifreq;
    var now, note, thisgroup;
    now = 0;
    ampenv.times = ampenv.times.normalizeSum * duration; // scale the Env's time to the gestures
    thisgroup = CtkGroup.new(starttime, duration + 2).addTo(score);
    while({
        // create a note... add it to the CtkScore
        note = scpn[\test].note(starttime + now, 0.1, target: thisgroup)
        .freq_(lowfreq.rrand(hifreq))
        .amp_(ampenv[now])
        .dur_(0.1).addTo(score);
        now = now + 0.02;
        now < duration;
    });
};

gliss = {arg starttime, duration, rate, lowfreq, hifreq;
    var cbus, control, note;
    cbus = CtkControl.new;
    control = scpn[\control].note(starttime, duration)
    .outbus_(cbus.bus)
    .rate_(rate)
    .low_(lowfreq)
    .hi_(hifreq)
    .addTo(score);
    note = scpn[\test].note(starttime, duration, \tail, 1)
    .freq_(cbus)
    .amp_(2)
    .dur_(duration)
    .addTo(score);
};

grainfun.value(1, 10, Env([0, 1, 0], [0.5, 0.5], [3, -5]), 440, 880);
grainfun.value(4, 4, Env([0, 1, 0], [0.5, 0.5], [3, -5]), 4400, 8800);
grainfun.value(6, 12, Env([0, 1, 0], [0.5, 0.5], [3, -5]), 300, 400);
grainfun.value(3, 10, Env([0, 1, 0], [0.5, 0.5], [3, -5]), 200, 200);
grainfun.value(1.5, 20, Env([0, 1, 0], [0.5, 0.5], [3, -5]), 7000, 7100);

5.do({arg i;
    var j;
    j = i + 1;
    gliss.value(3 + (i + 4), 10.rrand(7), j.reciprocal, 440 * j, 880 * j);
});

// uncomment to play the CtkScore you have created
score.play(s);

// uncomment to write (render) the score to a soundfile
// score.write("~/Desktop/test.aiff".standardizePath, 22, options: ServerOptions.new.numOutputBusChannels_(2).blockSize_(1));

// uncomment to save the CtkScore as a file
// score.saveToFile("~/Desktop/test.sc".standardizePath);
)

// working with a 'parent' score - manipulating CtkScore objects
(
s.boot;
o = ServerOptions.new.numOutputBusChannels_(1);

// the 'parent' score
a = CtkScore.new;

b = CtkScore.new;

z = CtkSynthDef(\test, {arg freq, dur;
    Out.ar(0, SinOsc.ar(freq, 0, XLine.kr(0.1, 0.0001, dur)))
});

t = 0.0;

while({
    b.add(z.note(t, 0.1).freq_(440).dur_(0.1));
    t = t + 0.1;
    t < 5.0;
});

a.add(b);
a.saveToFile("~/Desktop/test.sc".standardizePath)
a.write("~/Desktop/test.aiff".standardizePath, options: o);
)

// p = Player.new("~/Desktop/test.aiff".standardizePath).gui; //seems not working currently
p = Buffer.read(s, "~/Desktop/test.aiff".standardizePath);
q = p.play; //play the rendered score
q.free; p.free; //free the buffer

(
var scpn, score, grainfun, gliss;
scpn = CtkProtoNotes(
    SynthDef(\control, {arg outbus, rate, low, hi;
        Out.kr(outbus, LFNoise2.kr(rate).range(low, hi))
        }),
    SynthDef(\test, {arg freq, amp, dur;
        var env, envgen, src;
        env = Env([0, 1, 0], [0.5, 0.5], \sin);
        envgen = EnvGen.kr(env, timeScale: dur);
        src = BPF.ar(WhiteNoise.ar(amp), freq, 0.01, amp * envgen);
        Out.ar(0, Pan2.ar(src, Rand(-1.0, 1.0)));
        })
    );

score = CtkScore.new;

//creates a granular gesture of duration. Each grain is 0.1 seconds long, new grain every 0.02 seconds
grainfun = {arg starttime, duration, ampenv, lowfreq, hifreq;
    var now, note, thisgroup;
    now = 0;
    ampenv.times = ampenv.times.normalizeSum * duration; // scale the Env's time to the gestures
    thisgroup = CtkGroup.new(starttime, duration + 2).addTo(score);
    while({
        // create a note... add it to the CtkScore
        note = scpn[\test].note(starttime + now, 0.1, target: thisgroup)
            .freq_(lowfreq.rrand(hifreq))
            .amp_(ampenv[now])
            .dur_(0.1).addTo(score);
        now = now + 0.02;
        now < duration;
        });
    };

gliss = {arg starttime, duration, rate, lowfreq, hifreq;
    var cbus, control, note;
    cbus = CtkControl.new;
    control = scpn[\control].note(starttime, duration)
        .outbus_(cbus.bus)
        .rate_(rate)
        .low_(lowfreq)
        .hi_(hifreq)
        .addTo(score);
    note = scpn[\test].note(starttime, duration, \tail, 1)
        .freq_(cbus)
        .amp_(2)
        .dur_(duration)
        .addTo(score);
    };

5.do({arg i;
    var j;
    j = i + 1;
    gliss.value(3 + (i + 4), 10.rrand(7), j.reciprocal, 440 * j, 880 * j);
    });

// 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, 22, options: ServerOptions.new.numOutputBusChannels_(2).blockSize_(1));

// uncomment to save the CtkScore as a file
// score.saveToFile("~/Desktop/test.sc".standardizePath);
)

// working with a 'parent' score - manipulating CtkScore objects

(
s.boot;
o = ServerOptions.new.numOutputBusChannels_(1);

// the 'parent' score
a = CtkScore.new;

b = CtkScore.new;

z = CtkSynthDef(\test, {arg freq, dur;
    Out.ar(0, SinOsc.ar(freq, 0, XLine.kr(0.1, 0.0001, dur)))
});

t = 0.0;

while({
    b.add(z.note(t, 0.1).freq_(440).dur_(0.1));
    t = t + 0.1;
    t < 5.0;
});

a.add(b);
a.saveToFile("~/Desktop/test.sc".standardizePath);
a.write("~/Desktop/test.aiff".standardizePath, options: o);

)
// p = Player.new("~/Desktop/test.aiff".standardizePath).gui;
p = Buffer.read(s, "~/Desktop/test.aiff".standardizePath);
q = p.play; //play the rendered score
q.free; p.free; //free the buffer

(
// make a copy of b with an offset of 2.05 seconds
c = b.copy;
c.offset(2.05);
// alter the freq , durations and the dur parameter of c's notes
c.notes.do({arg me;
    me.setDuration(0.11).dur_(0.11).freq_(me.freq * 2)
});

// add it to the score
a.add(c);

a.write("~/Desktop/test.aiff".standardizePath, options: o);
)

// p = Player.new("~/Desktop/test.aiff".standardizePath).gui;
p = Buffer.read(s, "~/Desktop/test.aiff".standardizePath);
q = p.play; //play the rendered score
q.free; p.free; //free the buffer

(
// let's alter the score 'c'...
c.notes.do({arg me;
    me.freq_(me.freq * (1 + 0.25.rand2));
});

// offset it another 0.123 seconds
c = c.offset(0.123);

a.write("~/Desktop/test.aiff".standardizePath, options: o);
)

// p = Player.new("~/Desktop/test.aiff".standardizePath).gui;
p = Buffer.read(s, "~/Desktop/test.aiff".standardizePath);
q = p.play; //play the rendered score
q.free; p.free; //free the buffer

// add it to the score
a.add(c);

a.write("~/Desktop/test.aiff".standardizePath, options: o);
)

// p = Player.new("~/Desktop/test.aiff".standardizePath).gui;
p = Buffer.read(s, "~/Desktop/test.aiff".standardizePath);
q = p.play; //play the rendered score
q.free; p.free; //free the buffer

// let's alter the score 'c'...
(
c.notes.do({arg me;
    me.freq_(me.freq * (1 + 0.25.rand2));
});

// offset it another 0.123 seconds
c = c.offset(0.123);

a.write("~/Desktop/test.aiff".standardizePath, options: o);
)

// p = Player.new("~/Desktop/test.aiff".standardizePath).gui;
p = Buffer.read(s, "~/Desktop/test.aiff".standardizePath);
q = p.play; //play the rendered score
q.free; p.free; //free the buffer

helpfile source: HelpSource/Classes/CtkScore.schelp
link::Ctk/Classes/CtkScore::

CtkScoreExtension

Description

Class Methods

.new

Arguments:

Instance Methods

.add

Arguments:

.write

Arguments:

.play

Arguments:

.score

Returns:

.copy

Returns:

.offset

Arguments:

.saveToFile

Arguments:

.items

Returns:

Examples

CtkScore
Extension