ProxyMixer: table of contents
Classes | Libraries > JITLib > GUI | Live Coding

ProxyMixer : JITGui : Object

mix control for a proxyspace or Ndef.all
Subclasses: NdefMixer


ProxyMixer provides controls for handling and editing the node proxies in a proxyspace and their monitors (cross-platform graphics). It replaces the earlier ProxyMixer class. For Ndefs, use NdefMixer.

Overview: JITLib

// First examples:
p = ProxySpace.push(s.boot, p);
"abcde".do { |k| p[k.asSymbol].ar };
m = ProxyMixer(p, 8);
n.parent.alwaysOnTop_(true); // show mixer in front of IDE

// if you have JITLibExtensions installed, try ProxyMeter to see the proxy levels:
if (\ProxyMeter.asClass.notNil) { ProxyMeter.addMixer(m); };

"abcdefghijk".do { |k| p[k.asSymbol].ar };

"lmnopqrtuvw".do { |k| p[k.asSymbol].kr };

"abcdefghijk".do { |k, i|
    p[k.asSymbol].playN(vol: 0.8 - (0.1 * i) );
    p[k.asSymbol].source = { + 1 * 100) + [-1, 1])
        * + 1 * 0.25));

Class Methods

Creation, numItems: 16, parent, bounds, makeSkip: true, options)



the proxyspace to show and control


how many ar and kr proxies can be shown


by default nil, so a window is made automatically. if a parent is supplied, the ProxyMixer will be shown there.


window bounds - default is nil, so it determines it size.


a flag whether to make make a skipjack


additional settings - currently none provided.

ProxyMixer.small(obj, numItems: 16, parent, bounds, makeSkip: true)

like *new, but creates a proxyMixer for small screen sizes.

Inherited class methods

Instance Methods

Instance variables

GUI areas and elements:









current state and access methods:


.proxyspace = obj











Instance methods

.highlight(index, prefix)


highlight and unhighlight an arGui slot in the arZone (left)

.highlightSlots(parOffset, num, highNames: [ ], clearOthers: true)

highlight a block of the arGuis in the arZone/


.switchSize(index, hideZones: false)

switch between display modes 0: ar, 1: ar+kr, 2: ar+kr+ed



if too many proxies are present, by how much to rotate arKeys or krKeys to display.


get the proxymixer window title.


From extension in /usr/local/share/SuperCollider/SCClassLibrary/JITLib/GUI/

gets current left border of nameView

.setNameLeftBorder(xpos: 250)

From extension in /usr/local/share/SuperCollider/SCClassLibrary/JITLib/GUI/

sets current left border of nameView, trading size with volume slider

.shiftNameLeftBorder(x: 0)

From extension in /usr/local/share/SuperCollider/SCClassLibrary/JITLib/GUI/

shifts current left border of nameView

m.getNameLeftBorder; // get its current left border position
m.setNameLeftBorder(250); // default
m.setNameLeftBorder(200); // aps left pos, smaller slider
// relative adjust:

strong::standard JITGui methods: ::
method:: setDefaults, accepts, getState, checkUpdate

strong::internal - making the ProxyMixer gui elements: ::
method:: makeViews, makeTopLine, makeArZone, makeKrZone, makeEditZone, setEdButs



// make a proxyspace and 5 ar proxies, and a mixer to show them
p = ProxySpace.push(s.boot, p);
"abcde".do { |k| p[k.asSymbol].ar };
m = ProxyMixer(p, 8);;

m.object_(nil); // no object
m.object_(p);   // the proxyspace

// if you have JITLibExtensions installed, try ProxyMeter to see the proxy levels:
if (\ProxyMeter.asClass.notNil) { ProxyMeter.addMixer(m); };

    // make too many ar proxies, get a scroller
"abcdefghijk".do { |k| p[k.asSymbol].ar };

    // make too many kr proxies, get a scroller
"lmnopqrtuvw".do { |k| p[k.asSymbol].kr };

    // play some of them
m.arNames.scramble.keep(5).do { |k| p[k.asSymbol].playN };

    // the top left menu sets which proxies will be shown.

        // existingProxies: even an empty proxy is shown;

(        // activeProxies: proxy appears when it is alive
~test = { |freq=250, intv=19, timescale=1, curve=0, loopnode=0|
    var env =
        Env({ 1.0.rand2 }!11, {1.0.rand}!10, curve, releaseNode: 9, loopNode: loopnode),
        timeScale: timescale);
    var pitch = (env * [1, 0.33, -1] * intv).midiratio * freq;, pitch.scramble * 2, pitch.scramble)) * 0.1;
~test.lag(\freq, 4);

        // playingProxies : only those that really play are shown.
~test.playN(vol: 1);

// switch back to active proxies...
        // the reduce button removes all proxies that are not playing
        // and that are not used as sources in other proxies:
~otto = { |dens=12| };

~otto.clear;        // remove it

        // doc and docSel post the current proxyspace as code

        // ProxyMixer has three preset widths:
m.switchSize(0);    // ar zone only
m.switchSize(1);    // ar + kr
m.switchSize(2);    // ar + kr + edit zone

        // try with a small ProxyMixer:
l = ProxyMixer.small(p, 8);
l.switchSize(0, true);    // ar zone only
l.switchSize(1, true);    // ar + kr
l.switchSize(2, true);    // ar + edit zone

        // Record opens a utility window, RecordProxyMixer.
        // this requires the JITLibExtensions quark.

    // the line of controls for one proxy and its monitor is
    // a ProxyMonitorGui, so for full details see

    // it displays current volume,

    // proxy name; play/stop/end control:
~test.playN;        // playN as is
~test.stop;        // stop
~test.end;        // option-click on stop : end the monitor and the proxy itself.
~test.playN(vol: 0);    // option-click on play : start playing with volume zero.

~test.playNDialog;  // shift-click on play/stop: set multichan outputs from code

~test.playN(4);    // set proxy's first output channel:

// One can move the border between sliders and nameView:

n.enableNameResize(true);    // try click and dragging that border now

n.setNameLeftBorder(200);   // or set by code

    //    paus/rsum toggles pause and resume:

    // send button resends the proxy,
    // option-click on send rebuilds the proxy
    // (e.g. for lookup in client-site state)

    // the ed button sends this proxy to the editor - see below

        // kr proxies show up in the middle
~lfo = { };
~lfnoyz0 = { |lofreq = 0.5, mul=1, add|, mul, add) };

        // the editor zone is a NodeProxyEditor
        // open it and set some params
~test.set(\freq, exprand(80, 1250));    // set ~tests parameters
~test.set(\intv, 1.0.linrand);

    //    if you declare global specs for the range of a parameter,
    //    they can be used in the editor:

Spec.add(\intv, [0, 36, \lin]);
Spec.add(\timescale, [0.001, 10, \exp]);
Spec.add(\loopnode, [0, 7, \lin, 1]);
Spec.add(\curve, [-10, 10]);


        // you can map a kr proxy to a control param;\intv, ~lfnoyz0);
        // this also works by dragging the kr proxy name
        // the field left of the param name.

p.reduce(method: \clear);



Inherited instance methods

Undocumented instance methods



.enableNameResize(flag: true)

From extension in /usr/local/share/SuperCollider/SCClassLibrary/JITLib/GUI/


.makeArZone(isSmall: false)






From extension in /usr/local/share/SuperCollider/SCClassLibrary/JITLib/GUI/


.setEdButs(isSmall: false)