Global Array Save Load File

Saves, loads, or updates all values of several global arrays to/from a file.

Settings

filename

Name of the file to save.

root folder

Folder where the dialogs opens by default.

file extension

Default extension of the file to save or load.

save to file

Opens a dialog box to choose a file name and save the file.

load from file

Opens a dialog box to choose a file name and load the file.

update file

Opens a dialog box to choose a file and update the file with changes.

save to file direct

Saves the file using the filename parameter. If the filename parameter is a NULL string it opens a dialog box to choose the file name.

load from file direct

Loads the file using the filename parameter. If the filename parameter is a NULL string it opens a dialog box to choose the file name.

update file direct

Update the file using the filename parameter. If the filename parameter is a NULL string it opens a dialog box to choose the file name.

filter list

List of global array names to save or load. If the list is empty it saves/loads all global arrays.

  • if the line starts with // it is ignored (comment)
  • the line can start with INCLUDE: myfilename.txt followed by a filename. The filename must be located inside the package of the application or 'nearby' the workspace
  • it can be a regex or containing wildcards like GA-* or .* see regular-expression.
  • if the line is the string WAIT the process will be suspended for 200ms
 MY-GA-NAME
 // a comment line
 INCLUDE: myGAList.txt
 GA-NAME-*
 WAIT

reject list

List of global array names to explicitly not save or load.

  • if the line starts with // it is ignored (comment)
  • the line can start with INCLUDE: myfilename.txt followed by a filename. The filename must be located inside the package of the application or 'nearby' the workspace
  • it can be a regex or containing wildcards like GA-* or .* see regular-expression.
  • if the line is the string WAIT the process will be suspended for 200ms
 MY-GA-NAME
 // a comment line
 INCLUDE: myGAList.txt
 GA-NAME-*
 WAIT

isolate list

List of global array names containing arrays of 0 or 1 to replace isolate on load input array.

  • if the line starts with // it is ignored (comment)
  • the line can start with INCLUDE: myfilename.txt followed by a filename. The filename must be located inside the package of the application or 'nearby' the workspace
  • it can be a regex or containing wildcards like GA-* or .* see regular-expression.
  • if the line is the string WAIT the process will be suspended for 200ms
 MY-GA-NAME
 // a comment line
 INCLUDE: myGAList.txt
 GA-NAME-*
 WAIT

processing

Send a 1 value when the module is processing the operation (load, save, get etc).

A flow-from-1-to-0 must be used to trigger something when the operation is completed or canceled.

A flow-from-1-to-0 must be used to trigger something when the operation is completed or canceled.

canceled

Send 1 value when the open dialog operation has been canceled.

A flow-from-1-to-0 must be used to trigger something when the operation is completed or canceled.

isolate on load

Array of 0 or 1 with determines if the nth indexes are loaded (value 0) or not loaded (value 1). For example if the array is [0,0,1,0,0,0,...] it means that the global array values at the index 2 are not loaded.

silent edit

Disables the trace-panel information when a file is loaded or saved.

fade duration

Duration of the fade applied on the loading operation.

Common Settings

info

show manual

Button. Opens the manual page of the selected object (or of its parent module for a control) in the web browser. If no page exists for this object, an error is traced in the trace panel.

For more details about information/help creation, see create-help-file.

description

Free multi-line text attached to the module, saved with the patch. It is only meant as an internal note for the patch designer: it is not displayed in the interface.

ID's

visible only in god mode, see setup-panel-tab-expert.

unique ID

Read-only, not saved. Current private numeric ID of the object, used internally to identify it (for example as the target of a bind ID).

preset ID

Read-only, not saved. Private ID used to store and recall the values of this control in presets.

recreate ID

Button. Generates a new unique ID, original ID and preset ID for the object. Use it if you experience difficulties in Polyphonic mode or if two objects share the same ID. Preset values and binds referring to the old IDs are lost.

Object Remote Address

absolute

Read-only, not saved. Absolute address of the object in the Usine objects tree, built from the workspace root. This is the address to use to reach the object from scripts, the objects panel or remote messages. Only shown for objects that are registered in the objects list. See objects-address.

local

Read-only, not saved. Address of the object relative to the current patch, valid inside that patch only. See objects-address.

user addr

Free user-defined address for the object (empty by default). When set, the object is also registered in the objects tree under this name, so it can be reached independently of its position in the workspace (the value is also reported in the mouse-over and mouse-down chunks). Changing it rebuilds the objects list. Only available on objects that support a user address. See objects-address.

See also

version 7.0.250121

Edit All Pages