Allows to scope signals on Bela's built-in Oscilloscope, which can be accessed from Bela's web interface. It is not needed to interact directly with this class, as UGens, Arrays, Busses, Functions and Servers can be scoped via their .belaScope() method.
Using BelaScope requires:
Once a Bela server is started with options.belaMaxScopeChannels > 0, it is possible to scope UGens and Busses using their .belaScope() methods. See examples below.
Send an array of UGen data to Bela's oscilloscope.
| channelOffset |
Bela's oscilloscope channel to start scoping on. This has to be a non-negative number, and can't be changed after scoping starts. |
| signals |
Array of UGens to scope |
the array of signals passed in as an argument. This allows for transparent usage of .belaScope() in processing chains
{ BelaScope.scope(0, SinOsc.ar) }.play;// same using UGen::belaScope() shortcut method:{ SinOsc.ar().belaScope(0) }.play// transparent usage in chains:// scoping LFNoise0 before and after .range, while still using it to modulate SinOsc{ SinOsc.ar(LFNoise0.kr(10).belaScope(0).range(20,100).belaScope(1)) }.playScope a Bus on Bela's oscilloscope
| channelOffset |
Bela's oscilloscope channel to start scoping on. This has to be a non-negative number, and can't be changed after scoping starts. |
| busindex |
Index of the audio bus to scope |
| numChannels |
Number of bus channels to scope |
| target |
Bela's SuperCollider server, or any node on that server. The bus is monitored after this target, or after this server's RootNode if a server is provided as target. |
| rate |
A symbol. The default is |
A Synth used to monitor the bus.
xxxxxxxxxx// scope 2 channels from audio bus 4 on Bela Oscilloscope's channel 3BelaScope.monitorBus(3, 4, 2, ~belaServer)// same using Server::belaScope() shortcut method:~belaServer.belaScope(3, 4, 2)// same using Bus::belaScope() shortcut methodBus(\audio, 4, 2, ~belaServer).belaScope(3)xxxxxxxxxx~belaServer = Server.remote(\Bela, NetAddr("192.168.6.2", 57110));// UGens: usage like .poll// scope the LFNoise0, and still use it to modulate a SinOsc{ var freq = LFNoise0.kr.range(20,2000); SinOsc.ar(freq.belaScope(0)) }.play(~belaServer)// scope an Array of UGens:{ var freq = LFNoise0.kr.range(20,2000) ! 4; SinOsc.ar(freq.belaScope(0)) }.play(~belaServer)// Bus: scope 3 channels from bus number 10 on Bela Oscilloscope's channel 4b = Bus(\audio, 10, 6, ~belaServer);{ SinOsc.ar }.play(~belaServer, outbus:b);b.belaScope(4);// Server: usage like .scope// scope busses 10 and 11 on Bela's Oscilloscope channel 2~belaServer.belaScope(2, 10, 2)// scope main output busses on Bela's Oscilloscope channel 0~belaServer.belaScope// Function: usage like .scope// play and scope a multi-output function; scope starting on BelaScope channel 4{ SinOsc.ar(LFNoise0.ar([1,2,3]).exprange(20,20000)) * LFNoise1.ar([1,2,3]).exprange(0.001, 0.1) }.belaScope(4, ~belaServer)