ProxyPreset | SuperCollider 3.13.0 Help

Subclasses: NodeProxyPreset, PdefPreset, TdefPreset

Description

ProxyPreset is the base class for a number of Preset classes for JITLib proxies: It can handle proxies that keep their settings in environments, such as TaskProxies and PatternProxies, and proxies that use nodeMaps, like NodeProxy.

Settings are lists of key - value pairs, like [[key1, val1], [key2, val2], ... [keyN, valN]]. One can switch between these settings, or - if the parameter values in the list are single numbers, one can interpolate and morph between them.

Its subclasses using named proxies are: TdefPreset for Tdef, PdefPreset for Pdef, and NdefPreset for Ndef. Finally, there are also gui classes for all of them: ProxyPresetGui, TdefPresetGui, PdefPresetGui, and NdefPresetGui.( // make an empty Tdef a = Tdef(\a); // give it some param settings a.set(\dt, 0.1, \freq, 440, \bend, 4, \bendVar, 4, \sustain, 0.05); // add specs for the params to the Tdef - see Halo class. a.addSpec(\dt, [0.03, 3, \exp]); a.addSpec(\bend, [-24, 24, \lin]); a.addSpec(\bendVar, [-24, 24, \lin]); a.addSpec(\sustain, [0.003, 3, \exp]); // define what the Tdef does Tdef(\a, { |env| loop({ ( instrument: \pingbend, freq: env[\freq], bend: env[\bend] + env[\bendVar].rand2, sustain: env[\sustain], pan: 1.0.rand2 ).play; env[\dt].wait; }) }); Tdef(\a).gui; // will be using this SynthDef: s.boot; SynthDef(\pingbend, { arg out=0, freq=440, bend = 4, sustain=0.05; var env = EnvGen.ar(Env.perc(0.001, sustain, 0.3), doneAction:2); freq = freq * XLine.kr(1, bend.midiratio, sustain); Out.ar(out, SinOsc.ar(freq, 0, env)) }).add; ) // then make a ProxyPreset for the Tdef; // for Tdefs, best use the TdefPreset class b = TdefPreset(a); // these are the param names for which settings are stored, // taken from all proxy keys ... b.namesToStore; // unless you set namesToStore by hand: // clear preset TdefPreset.all.removeAt(\a); // make new one, use namesToStore argument: b = TdefPreset(a, [\freq, \sustain, \dt, \bend, \bendVar ]); // check b.namesToStore; // add the current state of the envir as a setting b.addSet(\ada); // make and add 3 random settings ( b.setRand(0.25); b.addSet(\bobo); b.setRand(0.25); b.addSet(\coco); b.someRand(0.25, 0.5); b.addSet(\dad); ) // by default, add set adds newsettings at the end b.getSetNames; b.settings.printcsAll;""; // the flag to add new setting to the top: b.addsToTop; // set it to add to top: b.addsToTop = true; b.setRand(0.25); b.addSet(\eedee); // eedee was added at beginning, after curr b.getSetNames; b.setCurr(b.getSetNames.choose.postln); b.setTarg(b.getSetNames.choose.postln); // a gui for the NdefPreset g = TdefPresetGui(b, 8).moveTo(10, 200); b.morph(1.0.rand, \ada, \coco); b.xfadeTo(\coco, 3, { "xfade doneFunc done.".postln; }); b.xfadeTo(b.getSetNames.choose.postln, exprand(0.3, 10)); // do recursive crossfading ( f = { "next xfade: ".post; b.xfadeTo(b.getSetNames.choose.postln, exprand(0.3, 10), f) }; f.value; ) f = nil; // stop // set relative to a preset: b.getSetNorm(\coco); b.proxy.setUni(*(b.getSetNorm(\curr) + [0.1.rand2]).flat); b.setRelFrom(\coco, { 0.3.rand2 }.dup(b.namesToStore.size))

Class Methods

ProxyPreset.new(proxy, namesToStore, settings, specs, morphFuncs)

make a new anonymous ProxyPreset

Arguments:

proxy	a TaskProxy or PatternProxy
namesToStore	which paramNames to store in presets. if none given, inferred from the current proxy settings.
settings	provide preset settings for the proxy
specs	provide preset specs for the proxy, mainly for randomizing and morphing. if none given here, and object has a halo of specs, those in halo will be used.
morphFuncs	special functions to provide for morphing between non-numerical settings. not used yet.

Inherited class methods

Undocumented class methods

ProxyPreset.settingsComment

ProxyPreset.settingsComment = value

Instance Methods

instance variables

.proxy

the proxy for which preset contains settings

.namesToStore

the param names for which values will be stored in the settings

.settings

settings stored for the proxy

.currSet

the name of the current setting

.targSet

the name of the target setting used in morphing

.specs

a dict for specs to use for numerical parameter interpolation. by default this is synced with the proxy's Halo specs.

.morphVal

.morphVal = value

the current morph/blend value.

.morphTask

a taskproxy that can crossfade between different settings.

.morphFuncs

.morphFuncs = value

special functions to provide for morphing between non-numerical settings. not used yet.

Methods - settings

instance methods

.useHalo

use the proxy's Halo for syncing specs and namesToStore.

.checkSpecsMissing(autoFill: false, dialog: false)

check if there are specs for all namesToStore. if not, posts an invitation to add the missing ones, or a

.specsDialog(keys, specDict)

From extension in /home/bgola/.local/share/SuperCollider/downloaded-quarks/JITLibExtensions/classes/GUI/extProxyPresetDialogs.sc

open a dialog window to add specs.

.addSet(name, values, toDisk: false, toTop)

add a setting by name. if no values are given, take current setting of proxy.

.removeSet(name, toDisk: false)

remove a setting by name

.addSettings(list)

add a list of named settings

.removeSettings(names)

remove a list of settings by their names

.postSettings

From extension in /home/bgola/.local/share/SuperCollider/downloaded-quarks/JITLibExtensions/classes/GUI/extProxyPresetDialogs.sc

post current settings as compilestring.

.getSetNames

get the names of all currently stored settings.

.setCurr(name)

set the current setting by name within stored settings.

.setTarg(name, setCurr: true)

set the target setting by name within stored settings.

.getSet(name)

get a stored setting by name.

.setProxy(name)

set the proxy's current settings to the setting given by name.

.getFromProxy(except)

get the proxy's current settings as [[key1, val1], ... [keyN, valN]]

.currFromProxy

get the proxy's current settings and store them as \curr.

.stepCurr(incr: 1)

.stepTarg(incr: 1)

step the current and target setting by increment.

Methods - randomizing settings

Note that randomizing settings only fully works for numerical settings!

.randSet(rand: 0.25, startSet, except, seed)

create a rand setting, based on an existing one

Arguments:

rand	how muct to randomize (0.0 to 1.0)
startSet	which set to randomize - if nil, uses currSet
except	which keys not to randomize
seed	a seed number for the random generator

.setRand(rand, startSet, except, seed)

same as randSet, but sets proxy to the random setting.

.someRand(rand: 0.1, ratio: 0.5, seed)

like randSet, but ratio sets how many of the params will be randomized.

Methods - morphing and crossfading

Note that morphing and crossfading only fully works for numerical settings!

.blend(blend: 0.5, name1, name2, mapped: true)

blend between two sets given by name. the mapped flag sets whether to blend between mapped or unmapped values; the result is again unmapped.

.morph(blend, name1, name2, mapped: true)

morph between two settings with a given blend factor.

Arguments:

blend	the blend factor
name1	the name of setting 1
name2	the name of setting 2
mapped	a flag whether to interpolate between mapped values of the params.

.xfadeTo(target, dur, doneFunc)

crossfade to a target setting in the given duration.

.blendSets(blend: 0.5, set1, set2)

the lower-level way to do a straight blend between two sets.

.mapSet(set)

.unmapSet(set)

utilities to convert single settings between mapped and unmapped values. used when blending in mapped mode.

Methods - storage

.storeToDisk

.storeToDisk = value

get and whether to store settings to disk automatically. default = true.

.storePath

.storePath = value

the path where to store and read settings to and from disk.

.loadSettings(path, clear: false)

load settings from disk at given path.

.writeSettings(path, overwrite: false)

write settings to disk. By default, they go next to the source code file where the Preset was created, and by default, a backup of the previous stored settings is made.

.setPath(name)

set storage name

.presetPath(name)

path where to store presets. currently, this is next to the source code file where the Preset was created.

.storeDialog(name, loc)

From extension in /home/bgola/.local/share/SuperCollider/downloaded-quarks/JITLibExtensions/classes/GUI/extProxyPresetDialogs.sc

open a dialog window for entering a storage name. Intended for use with ProxyPresetGui.

.deleteDialog(loc)

From extension in /home/bgola/.local/share/SuperCollider/downloaded-quarks/JITLibExtensions/classes/GUI/extProxyPresetDialogs.sc

open a dialog window for deleting existing settings by name(s). Intended for use with ProxyPresetGui.

Inherited instance methods

Undocumented instance methods

.addsToTop

.addsToTop = value

.checkName(name)

.getCurr

.getCurrUni

.getSetNorm(name)

.morphTo(blend, name, mapped: true)

.morphValStep(inMorphVal)

.openSettingsFile

From extension in /home/bgola/.local/share/SuperCollider/downloaded-quarks/JITLibExtensions/classes/GUI/extProxyPresetDialogs.sc

.setCurrIndex(index, rand: 1.0)

.setRelFrom(name, values)

.settingsString

Examples

// Same example as above, with some more tests and comments:

// will complain about missing specs
(
a = Tdef(\a);
a.set(\dt, 0.1, \freq, 440, \bend, 4, \bendVar, 4, \sustain, 0.05);
b = ProxyPreset(a);
)
    // check if all specs are present:
b.checkSpecsMissing;
    // get a dialog if any are missing:
b.checkSpecsMissing(dialog: true);

(
    // or add missing specs by code to the taskproxy's Halo
    // see the Halo class.
a.addSpec(\dt, [0.03, 3, \exp]);
a.addSpec(\bend, [-24, 24, \lin]);
a.addSpec(\bendVar, [-24, 24, \lin]);
a.addSpec(\sustain, [0.003, 3, \exp]);
);
)
// check if again all specs are present:
b.checkSpecsMissing; // quiet means all fine

// the param names for which settings are stored
b.namesToStore;
(
// make a ParamGui to read along changes to the settings
d = ParamGui(a.envir).moveTo(10, 10);
// and connect it to the proxy's halo,
// so it will use the orderedNames used there
d.useHalo(a);
)

a.envir;
a.controlKeys;

// add a setting with a name
b.addSet(\ada);
b.settings;

// add 3 random settings
(
b.setRand(0.25); b.addSet(\bobo);
b.setRand(0.25); b.addSet(\coco);
b.someRand(0.25, 0.5); b.addSet(\dad);
)
    // print them all
b.settings.printcsAll;"";
b.getSetNames;

// and set current and target to two random choices
b.setCurr(b.getSetNames.choose.postln);
b.setTarg(b.getSetNames.choose.postln);

(
// load a synthdef
s.boot;
SynthDef(\pingbend,
    { arg out=0, freq=440, bend = 4, sustain=0.05;
        var env = EnvGen.ar(Env.perc(0.001, sustain, 0.3), doneAction:2);
        freq = freq * XLine.kr(1, bend.midiratio, sustain);
        Out.ar(out, SinOsc.ar(freq, 0, env))
    }).add;

// and define what the Tdef does
Tdef(\a, { |env|
    loop({
        (
            instrument: \pingbend,
            freq:  env[\freq],
            bend: env[\bend] + env[\bendVar].rand2,
            sustain: env[\sustain],
            pan: 1.0.rand2
        ).play;

env[\dt].wait;
    })
});

Tdef(\a).play;
)

// make a gui for the NdefPreset
g = TdefPresetGui(b, 8).moveTo(10, 200);

// morph between its current and target setting:
b.morph(1.0.rand);
b.morph(1.0.rand);

// morph between two named settings:
b.morph(1.0.rand, \ada, \coco);

// xfade to a given setting from current setting:
b.xfadeTo(\coco, 3, { "xfade doneFunc done.".postln; });
b.xfadeTo(b.getSetNames.choose.postln, exprand(0.3, 10));

// do recursive crossfading
(
f = {
    "next xfade: ".post;
    b.xfadeTo(b.getSetNames.choose.postln, exprand(0.3, 10), f)
};

f.value;
)
f = nil; // stop

helpfile source: /home/bgola/.local/share/SuperCollider/downloaded-quarks/JITLibExtensions/HelpSource/Classes/ProxyPreset.schelp
link::Classes/ProxyPreset::

ProxyPreset : Object Extension

ProxyPreset.new(proxy, namesToStore, settings, specs, morphFuncs)

Arguments:

ProxyPreset.settingsComment

ProxyPreset.settingsComment = value

.proxy

.namesToStore

.settings

.currSet

.targSet

.specs

.morphVal

.morphVal = value

.morphTask

.morphFuncs

.morphFuncs = value

.useHalo

.checkSpecsMissing(autoFill: false, dialog: false)

.specsDialog(keys, specDict)

.addSet(name, values, toDisk: false, toTop)

.removeSet(name, toDisk: false)

.addSettings(list)

.removeSettings(names)

.postSettings

.getSetNames

.setCurr(name)

.setTarg(name, setCurr: true)

.getSet(name)

.setProxy(name)

.getFromProxy(except)

.currFromProxy

.stepCurr(incr: 1)

.stepTarg(incr: 1)

.randSet(rand: 0.25, startSet, except, seed)

Arguments:

.setRand(rand, startSet, except, seed)

.someRand(rand: 0.1, ratio: 0.5, seed)

.blend(blend: 0.5, name1, name2, mapped: true)

.morph(blend, name1, name2, mapped: true)

Arguments:

.xfadeTo(target, dur, doneFunc)

.blendSets(blend: 0.5, set1, set2)

.mapSet(set)

.unmapSet(set)

.storeToDisk

.storeToDisk = value

.storePath

.storePath = value

.loadSettings(path, clear: false)

.writeSettings(path, overwrite: false)

.setPath(name)

.presetPath(name)

.storeDialog(name, loc)

.deleteDialog(loc)

.addsToTop

.addsToTop = value

.checkName(name)

.getCurr

.getCurrUni

.getSetNorm(name)

.morphTo(blend, name, mapped: true)

.morphValStep(inMorphVal)

.openSettingsFile

.setCurrIndex(index, rand: 1.0)

.setRelFrom(name, values)

.settingsString

ProxyPreset : Object
Extension