SensorSonificator | SuperCollider 3.13.0 Help

Description

SensorSonificator allows you to sonify realtime sensor data that is put on a control bus. These are tools to understand the nature of the data.

Class Methods

.new

Create a new SensorSonificator

Arguments:

input	A bus onto which control data is put.
outbus	Audio output bus, if left blank a bus is created
server	The server on which to run the sonification. If left blank, the default server is used.

Instance Methods

.addSonification

Add a sonification.

Arguments:

type	Should be one of \value (sonify the value to a frequency), \intrig (gives a small toc each time the control bus receives a new value; frequency is the time between updates), \inrange (gives a toc when the value is within a certain range).

.query

Query the group of sonifying synths.

Arguments:

args	Whether or not to post the arguments of the synths (default is true).

.group

The group within which the sonification synths are running

Returns:

a Group

.synths

The Synths that are doing the sonification.

Returns:

an Array of Synths

.server

The Server on which the sonification is running.

Returns:

a Server

Examples

s = Server.local.boot;

b = Bus.control(s,1);

( // generate some data
Tdef( \updateBus, {
    loop{
        b.set( 1.0.rand.postln; );
        rrand(0.05,0.3).wait;
    }
}).play;
);

~output = Bus.new('audio', 0 );

// create a sonificator for the first bus:
x = SensorSonificator.new( b, ~output );

// right now there are three different kinds of sonificators
// \value : sonifies the current value as frequency, amplitude is controlled by the rate of change in value
// \inrange : makes sound when the value is within a certain range
// \intrig : makes a sound whenever new data is coming in. Pitch is higher when the time since the last trigger was longer ago

// add value sonification:
x.addSonification( \value );

// start the sonification
x.start;

// set parameters for it
x.synths[0].set( \amp, 0.01 ); // base amplitude
x.synths[0].set( \slamp, 1 );  // slope amplitude

// post a list of available parameter names:
x.synths[0].controlNames;

// add inrange sonification:
x.addSonification( \inrange );

x.start;

// set parameters:
x.synths[1].set( \amp, 0.2 );
x.synths[1].set( \freq, 600 );
x.synths[1].set( \lo, 0.8 );

x.stop;
// arguments are kept when the sonification is stopped and started
x.start;

// add another inrange sonificator
x.addSonification( \inrange );
x.synths[2].set( \amp, 0.2 );
x.synths[2].set( \freq, 700 );
x.synths[2].set( \lo, 0 );
x.synths[2].set( \hi, 0.2 );
x.start;

// add an intrig sonificator:
x.addSonification( \intrig );

x.start;
x.synths[3].set( \amp, 0.5 );
x.synths[3].set( \dur, 0.05 );
x.synths[3].set( \freq, 300 );
x.synths[3].set( \fmmod, 100 );

x.synths[3].controlNames;

// query the group of sonificators (including argument values)
x.query

// with argument values:
x.query( false );

// stop the sonification:
x.stop;

helpfile source: HelpSource/Classes/SensorSonificator.schelp
link::SenseWorld/Classes/SensorSonificator::

SensorSonificator
Extension

Description

Class Methods

.new

Arguments:

Instance Methods

.addSonification

Arguments:

.start

.stop

.query

Arguments:

.group

Returns:

.synths

Returns:

.server

Returns:

.inbus

Returns:

.outbus

Returns:

Examples

SensorSonificatorExtension

Description

Class Methods

.new

Arguments:

Instance Methods

.addSonification

Arguments:

.start

.stop

.query

Arguments:

.group

Returns:

.synths

Returns:

.server

Returns:

.inbus

Returns:

.outbus

Returns:

Examples

SensorSonificator
Extension