BelaScope | SuperCollider 3.12.2 Help

Description

NOTE: This UGen only works on Bela

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.

Setup

Using BelaScope requires:

an instance of Server running on a Bela (either locally or remotely).
ServerOptions.belaMaxScopeChannels should be set > 0 for Bela's server. It represents the maximum number of channels that is possible to scope on that server, and affects resources allocation. If set <= 0, the server won't instantiate any Scope object, and any attempt to instantiate a BelaScope from sclang will throw an error.

Usage

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.

Class Methods

BelaScope.scope(channelOffset, signals)

Send an array of UGen data to Bela's oscilloscope.

Arguments:

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

Returns:

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)) }.play

BelaScope.monitorBus(channelOffset, busindex, numChannels, target, rate: 'audio')

Scope a Bus on Bela's oscilloscope

Arguments:

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.

Returns:

A Synth used to monitor the bus.// scope 2 channels from audio bus 4 on Bela Oscilloscope's channel 3 BelaScope.monitorBus(3, 4, 2, ~belaServer) // same using Server::belaScope() shortcut method: ~belaServer.belaScope(3, 4, 2) // same using Bus::belaScope() shortcut method Bus(\audio, 4, 2, ~belaServer).belaScope(3)