HelpSource/Classes/OSCBundle.schelp

   1 class:: OSCBundle
   2 summary:: network bundle object
   3 related:: Guides/OSC_communication
   4 categories:: OpenSoundControl
   5
   6 description::
   7 A bundle object that allows to add preparation messages for async processes. If this feature is not needed, a list object can be used instead.
   8
   9 InstanceMethods::
  10
  11 private::prSend
  12
  13 method::add
  14 Add an osc message to the bundle.
  15
  16 method::addAll
  17 Add an array of osc messages to the bundle.
  18
  19 method::addPrepare
  20 Add a preparation osc message, which is sent before the bundle is sent.
  21
  22 method::send
  23 Send the bundle to a server. If preparation messages are given, they are sent, the process waits for their reception abd then sends the bundle.
  24
  25 method::schedSend
  26 Like send, but the sending is synced to a given clock to the next beat.
  27
  28 argument::clock
  29 A link::Classes/TempoClock::.
  30
  31 argument::quant
  32 Can be a pair of values: [quant, offset].
  33
  34 Examples::
  35
  36 code::
  37 // create a new, empty instance
  38 a = OSCBundle.new;
  39
  40 // a synthdef that needs to be sent to the server, an operation that is asynchronous,
  41 // i.e. we have to wait until it is finished.
  42 x = SynthDef("test", { OffsetOut.ar(0, BPF.ar(Impulse.ar(4) * 10, Rand(9000, 1000), 0.1)) });
  43 // this is why addPrepare is used.
  44 a.addPrepare(["/d_recv", x.asBytes]);
  45 // add is used with synchronous operations, like starting synths.
  46 a.add(["/s_new", "test", -1]);
  47
  48 // the bundle has now the synchronous separated from the asynchronous bundles:
  49 a.messages;
  50 a.preparationMessages;
  51
  52 // this can be simply sent - the bundle takes care of the server client communication
  53 // like waiting for the synthdef to be loaded. the synth is started when the preparation
  54 // is finished.
  55
  56 s.boot; // boot the server
  57 a.send(s);
  58
  59 s.freeAll; // free all nodes on the server
  60
  61 // scheduled sending: the synths are started on the next beat.
  62
  63 a.schedSend(s, TempoClock.default, 1);
  64 a.schedSend(s, TempoClock.default, 1);
  65 a.schedSend(s, TempoClock.default, 1);
  66
  67 s.freeAll; // free all nodes on the server
  68
  69 // the bundle can contain several preparation messages and messages at a time.
  70 // the proparationMessages are sent first and only when they are all completed,
  71 // the other bundles are sent.
  72 // the bundle can also be reused, if there is no specific allocated buffers/node ids.
  73 ::