Contents



DH_PatchArray-Text

Next

Function:

Stores and retrieves text-based values by index, with separate indexes for read and write. Values are saved in patch storage in one of two modes:

  • Global mode saves a single text array that does not change when the patch is changed.
     

  • Per Patch mode provides a separate text array for each patch.


Left-hand side pins:

Input  - Text string to be stored

Read Index - Selects the output slot. Index input is rounded to the nearest integer.

Write Index - Selects the slot to which the Input text string will be written. Index input is rounded to the nearest integer.

Write - Writes the Input text string to the currently indexed slot on a TRUE to FALSE change.
 
Clear - Erases the text from all slots.

Output - Provides the text string stored in the slot currently indexed by the Read Index.
 

Right-hand side pin:

Output - Provides the text string stored in the slot currently indexed by the Read Index.
 

Parameters: (right-click Properties)

Mode - Global or Per Patch, as described above under Function.

Notes:

The module allocates working memory for the list as needed. The amount of data that can be saved in patch storage is limited, however, to the equivalent of 1000 characters. A message box is displayed when the limit is exceeded, and the excess is not saved.

 

top

Next