StoredList | SuperCollider 3.13.0 Help

Description

A StoredList is typically used for storing settings to disk, and recalling them later. These are often parameter lists of processes like Ndefs, Pdefs, Tdefs. StoredList are used in PxChainPreset for now, and may be adapted for ProxyPreset as well.

First code examples:z = StoredList(\myTestID); // a storedList has these internal items: z.id.postcs; // this come from an ndef name z.list; // add two named settings: z.add(\base, [\amp, 0.25, \freq, 300]); z.add(\var1, [\amp, 0.50, \freq, 600]); // the current list z.list // or printed more readably z.prettyList // adding by an existing name replaces list at that name z.add(\base, [\amp, 0.25, \freq, 444]); z.add(\var1, [\amp, 0.50, \freq, 666]); z.prettyList // get names and values separately z.names z.values // access by index or name (or array) z.at(0) z.at(100) // nil outside index range z.at(\base); // by name z.at(\nope) // nil when unknown name z.at([\base, 1, \nope]); // also by array, also mixed z.removeAt(\otto); // nil z.removeAt(4); // nil z.removeAt(0) // removes base z.removeAt(\var1) z.list // empty now z.add(\base, [\amp, 0.25, \freq, 300]); z.add(\var1, [\amp, 0.50, \freq, 600]); /// storage to disk - by default, this is in Platform.userAppSupportDir z.write; // posts: StoredList('myTestID'): stored 2 settings at: "/Users/adc/Library/Application Support/SuperCollider/settings/myTestID.pxpreset.scd" z.filename z.dir z.storePath z.storePath.openOS // add more settings z.add(\base2, [\amp, 0.25, \freq, 444]); z.add(\var2, [\amp, 0.50, \freq, 666]); z.list.size; z.write; // the currently written settings: z.dir.openOS; // previous settings are always backed up here: z.backupDir.openOS; // a different storedList object with the same id // will read and store the same settings! y = StoredList(\myTestID); y.read; y.list; y.storePath == z.storePath y.prettyList;