QuNeo | SuperCollider 3.13.0 Help

Description

A class to make it easier to interface with the Keith McMillen QuNeo - http://www.keithmcmillen.com/QuNeo/ .

If this is your first time using the class I recommend looking at the example QuNeo preset and Supercollider code in the \QuNeo\QuNeoPresets\ directory of your Supercollider extentions directory.

Instance Methods

.createDrumPad

Create a new drum pad controller and add it to the pads array.

Arguments:

index	The index to create the new drum pad control with.
noteNum	MIDI note number for the control.
pressCC	MIDI CC number for pressure data.
xCC	(describe argument here)
yCC	(describe argument here)
channel	MIDI channel for the control. Will use the default if one is not provided.

.createVSlider

Create a new vertical slider controller and add it to the vSliders array.

Arguments:

index	The index to create the new verticle slider control with.
noteNum	MIDI note number for the control.
pressCC	MIDI CC number for pressure data.
locCC	MIDI CC number for location data.
channel	MIDI channel for the control. Will use the default if one is not provided.
scInPort	The port that this control will recieve MIDI data from the QuNeo on.
scOutPort	The port that this control will use to send MIDI to the QuNeo.

.createHSlider

Create a new horizontal slider controller and add it to the hSliders array.

Arguments:

index	The index to create the new horizontal slider control with.
noteNum	MIDI note number for the control.
pressCC	MIDI CC number for pressure data.
locCC	MIDI CC number for location data.
channel	MIDI channel for the control. Will use the default if one is not provided.
scInPort	The port that this control will recieve MIDI data from the QuNeo on.
scOutPort	The port that this control will use to send MIDI to the QuNeo.

.createLSlider

Create a new long slider controller and add it to the lSliders array.

Arguments:

index	The index to create the new long slider control with.
noteNum	MIDI note number for the control.
pressCC	MIDI CC number for pressure data.
locCC	MIDI CC number for location data.
widthCC	MIDI CC number for width data.
channel	MIDI channel for the control. Will use the default if one is not provided.
scInPort	The port that this control will recieve MIDI data from the QuNeo on.
scOutPort	The port that this control will use to send MIDI to the QuNeo.

.createCircle

Create a new circle controller and add it to the circles array.

Arguments:

index	The index to create the new circle control with.
noteNum	MIDI note number for the control.
pressCC	MIDI CC number for pressure data.
locCC	MIDI CC number for location data.
channel	MIDI channel for the control. Will use the default if one is not provided.
scInPort	The port that this control will use to recieve MIDI data from the QuNeo.
scOutPort	The port that this control will use to send MIDI to the QuNeo.

.createButton

Create a new button controller and add it to the buttons array.

Arguments:

index	The index to create the new button control with.
noteNum	MIDI note number for the control.
pressCC	MIDI CC number for pressure data.
channel	MIDI channel for the control. Will use the default if one is not provided.
scInPort	The port that this control will recieve MIDI data from the QuNeo on.
scOutPort	The port that this control will use to send MIDI to the QuNeo.

.scInPort

Port that will recieve MIDI data from the QuNeo.

.scOutPort

Port that will send MIDI data to the QuNeo.

.defaultChannel

MIDI channel that new controls will use to recieve MIDI data unless one is specified when they are created.

.detectInPort

Searches the MIDIClient source for a device named "QuNeo" and returns the port number.

Returns:

The MIDIClient port number.

.detectOutPort

Searches the MIDIClient destinations for a device named "QuNeo" and returns the port number.

Returns:

The MIDIClient port number.

.debug

Allows you to enable or disable debugging for every controller on the QuNeo. This setting can also be changed on a per control and per datasource basis.

Arguments:

setDebug

Enable debugging? true/false.

.postInfo

Posts info about the current QuNeo setup to the console.

Examples

/*
All examples assume QuNeo has been mapped properly and is stored in the variable ~quNeo.  Please see the sample files referanced at the top of this document for setup instructions.
*/

//Test if QuNeo is hooked up correctly
~quNeo.debug(true)

//Stop debugging
~quNeo.debug(false)

//Just debug pad 0
~quNeo.pads[0].debug(true)

//Stop debugging
~quNeo.pads[0].debug(false)

//Grab the current value of a control (local server only)
~quNeo.pads[0].x.value.postln

(
//One pad theremin
{
    var freq = ~quNeo.pads[0].x.kr(5000, 300);
    var amp = ~quNeo.pads[0].y.kr;
    SinOsc.ar(freq, mul: amp);
}.play
)

(
//One pad - One Slider - Using Ugens
{
    var freq1 = ~quNeo.pads[0].x.kr(5000, 100);
    var freq2 = ~quNeo.pads[0].y.kr(5000, 100);
    var amp = ~quNeo.pads[0].press.kr;
    var lpfFreq = ~quNeo.vSliders[0].loc.kr(3000, 30);
    var lpfRes = 1 - ~quNeo.vSliders[0].press.kr(0.9, 0.1);
    var sin = Saw.ar(freq1) * Saw.ar(freq2) * amp;
    RLPF.ar(sin, lpfFreq, lpfRes);
}.play
)

(
//One pad - One Slider - Using maps
{
    SynthDef(\test, {|freq1, freq2, amp, lpfFreq, lpfRes|
        var sin;
        freq1 = freq1 * 5000 + 100;
        freq2 = freq2 * 5000 + 100;
        lpfFreq = lpfFreq * 3000 + 30;
        lpfRes = 1 - lpfRes * 0.9 + 0.1;
        sin = Saw.ar(freq1) * Saw.ar(freq2) * amp;
        Out.ar([0,1], RLPF.ar(sin, lpfFreq, lpfRes));
    }).add;

s.sync;

Synth(\test, [
        \freq, ~quNeo.pads[0].x.map,
        \freq2, ~quNeo.pads[0].y.map,
        \amp, ~quNeo.pads[0].press.map,
        \lpfFreq, ~quNeo.vSliders[0].loc.map,
        \lpfRes, ~quNeo.vSliders[0].press.map
    ])
}.fork
)

(
//Calling functions
{
    SynthDef(\test, {|freq1, freq2, amp, lpfFreq, lpfRes|
        var sin = Saw.ar(freq1) * Saw.ar(freq2) * amp;
        lpfFreq = lpfFreq * 3000 + 200;
        sin = sin * EnvGen.ar(Env.perc, doneAction:2);
        Out.ar([0,1], RLPF.ar(sin, lpfFreq, lpfRes));
    }).add;

s.sync;

~quNeo.pads[0].note.onFunc = {
        Pbind(*[instrument: \test,
            freq1: Pseq([300,600,900,1200], 1),
            freq2: 1000,
            amp: 1,
            dur: 0.3,
            lpfFreq: ~quNeo.vSliders[0].loc.map,
            lpfRes: 0.5
        ]).play;
    };

~quNeo.pads[1].note.onFunc = {
        Pbind(*[instrument: \test,
            freq1: Pseq([300,600,900,1200] * 2, 1),
            freq2: 1000,
            amp: 1,
            dur: 0.3,
            lpfFreq: ~quNeo.vSliders[0].loc.map,
            lpfRes: 0.5
        ]).play;
    };

}.fork
)

helpfile source: HelpSource/Classes/QuNeo.schelp
link::QuNeo/Classes/QuNeo::

QuNeo
Extension

Description

Class Methods

.new

Arguments:

Returns:

Instance Methods

.createDrumPad

Arguments:

.createVSlider

Arguments:

.createHSlider

Arguments:

.createLSlider

Arguments:

.createCircle

Arguments:

.createButton

Arguments:

.pads

.vSliders

.hSliders

.lSliders

.circles

.buttons

.scInPort

.scOutPort

.defaultChannel

.detectInPort

Returns:

.detectOutPort

Returns:

.debug

Arguments:

.postInfo

Examples

defaultChannel	This is the MIDI channel that will be used when creating new controls if one is not specified.
scInPort	Specify the port within Supercollider that will recieve MIDI data from the QuNeo. If this argument is not provided it will be auto-detected.
scOutPort	Specify the port within Supercollider that will send MIDI data to the QuNeo. If this argument is not provided it will be auto-detected.

QuNeoExtension

Description

Class Methods

.new

Arguments:

Returns:

Instance Methods

.createDrumPad

Arguments:

.createVSlider

Arguments:

.createHSlider

Arguments:

.createLSlider

Arguments:

.createCircle

Arguments:

.createButton

Arguments:

.pads

.vSliders

.hSliders

.lSliders

.circles

.buttons

.scInPort

.scOutPort

.defaultChannel

.detectInPort

Returns:

.detectOutPort

Returns:

.debug

Arguments:

.postInfo

Examples

QuNeo
Extension