EnvirGui

create a new EnvirGui NdefParamGui// simple example g = EnvirGui.new(nil, 5); // empty with 5 slots g.parent.alwaysOnTop_(true); g.object_((a: 1, b: \werty, freq: [500, 2000])); // put some things in g.envir.put(\karl1, \otto1); // one more g.envir.put(\caesar, \julius); // one more g.envir.putAll((b: -12, r: 1, s: 2, t: 3, u: 4, v: 5)) g.object_((x: 2)); // put another object in g.envir.putAll((b: -12, r: 1, s: 2, t: 3, u: 4, v: 5)) g.envir.removeAt(\b) g.envir.removeAt(\r) g.envir.removeAt(\s) g.envir.removeAt(\t) g.envir.removeAt(\u) g.envir.removeAt(\v) g.close;

Arguments:

how many envir items to display

the envir displayed - actually an alias for object.

the composite view the envirgui makes for itself

the paramViews that display the values:

• Single numbers appear in an EZSlider,
• pairs of numbers will be shown in an EZRanger,
• all other values are shown as compileStrings in an EZText.

See ParamView for details.

a local dictionary of the specs used for display ranges of numerical parameters by the paramViews of this envirgui. See the -getSpec method for details.

the keys of the currently displayed items in the dict.

if the size of envir exceeds numItems, the keys displayed can be rotated: e.g. with 10 keys displayed on 5 paramViews, keysRotation 0 means show keys (0..4), keysRotation 2 means show keys (2..6), etc.

gui elements present if requested in options

set the environment to show

Arguments:

same as object_(obj)

if in its own window, set the window's nameg.name_("Yoohoo");

For editing, numerical parameters need control specs for the ranges on the gui. These can be set locally in the EnvirGui, or global specs will be looked up. If no local or global specs exist for that parameter name, getSpec makes a usable guess for them. (With JITLibExtensions, one can also look up specs attached to an object such as a proxy.)// inline example g = EnvirGui.new; g.parent.alwaysOnTop_(true); g.getSpec(\freq, 400); // \freq exists as global spec, so use that g.object_((freq: 150)); g.getSpec(\iFrek, 500); // no global spec, so make a new one: // exponential from val * 0.05 to val * 20; g.specs; // and keep it here g.envir.put(\iFrek, 500);

Arguments:

add a spec for a given key, or (if it is a global key) override a global spec with a local one:// set a desired range and warp: g.putSpec(\iFrek, [10, 1000, \exp]); g.putSpec(\freq, [10, 1000, \exp]); g.specs; g.putSpec(\freq, \freq); // specs are remembered when object changes g.putSpec(\freq, [10, 1000, \exp]); g.object_((freq: 200, iFrek: 20)); // if needed, clear specs by hand when switching objects g.specs.clear; g.object_((freq: 200, iFrek: 20)); g.close

Keys with technical names can be replaced in the display with clearer names: method replaceKeys the current list of keys to replace

add a key to replace and its replacer key

remove a replacer key

showe = (longFreq: 123, amp: 0.25); g = EnvirGui(e); g.parent.alwaysOnTop_(true); g.editKeys; g.addReplaceKey(\longFreq, \freq1, [50, 500, \exp]); g.viewForParam(\longFreq).visible_(false); g.viewForParam(\freq1).visible_(true); e.put(\z, 345); e.put(\a, 34); g.replaceKeys g.removeReplaceKey(\longFreq)

highlight the paramview at a given index, by color and optional prefixg.highlight(0); g.highlight(0, ">>_"); g.highlight(0, ">>_", Color.green(1, 0.6));

remove highlighting at an index g.unhighlight(0);

update the widgets for the current keys

show (num) active fields, make others invisible.

set and get whether arrays of 2 number values should be displayed with EZRangers.

methods that make gui elements:

the method that makes all views specified in the options

the methods that make the individual elements as specified

standard JITGui methods: