OSCBundle | SuperCollider 3.12.2 Help

// a synthdef that needs to be sent to the server, an operation that is asynchronous,
// i.e. we have to wait until it is finished.
x = SynthDef("test", { OffsetOut.ar(0, BPF.ar(Impulse.ar(4) * 10, Rand(9000, 1000), 0.1)) });
// this is why addPrepare is used.
a.addPrepare(["/d_recv", x.asBytes]);
// add is used with synchronous operations, like starting synths.
a.add(["/s_new", "test", -1]);

// the bundle has now the synchronous separated from the asynchronous bundles:
a.messages;
a.preparationMessages;

// this can be simply sent - the bundle takes care of the server client communication
// like waiting for the synthdef to be loaded. the synth is started when the preparation
// is finished.

s.boot; // boot the server
a.send(s);

s.freeAll; // free all nodes on the server

// scheduled sending: the synths are started on the next beat.

a.schedSend(s, TempoClock.default, 1);
a.schedSend(s, TempoClock.default, 1);
a.schedSend(s, TempoClock.default, 1);

s.freeAll; // free all nodes on the server

// the bundle can contain several preparation messages and messages at a time.
// the proparationMessages are sent first and only when they are all completed,
// the other bundles are sent.
// the bundle can also be reused, if there is no specific allocated buffers/node ids.

helpfile source: /usr/local/share/SuperCollider/HelpSource/Classes/OSCBundle.schelp
link::Classes/OSCBundle::

OSCBundle : Object

Description

Class Methods

Inherited class methods

Instance Methods

.add(msg)

.addAll(mgs)

.addPrepare(msg)

.send(server, time, timeOfRequest)

.schedSend(server, clock, quant)

Arguments:

Inherited instance methods

Undocumented instance methods

.addCancel(msg)

.cancel

.doPrepare(server, onComplete)

.messages

.preparationMessages

.sendAtTime(server, atTime, timeOfRequest)

Examples