DH_TextList2
Function:
Like
the DH_TextList in the original
DH_Sub-ControlPak, the DH_TextList2 module lets you design custom lists
that can be loaded from a text file, and then used to make selections just
like regular SynthEdit lists.
DH_TextList2 works entirely on the GUI side, so it doesn't need the audio engine to be running to load a file and populate the list. A Selection output has been added for the text of the selected item.
Left-hand side pins:
Selection (green) - Connects to a Dropdown List, DH_PopupMenu, DH_ListBox,
or other GUI selection control, which is used to select an
item from the list.Index - Allows numeric selection of a list item
File Name - Name of the text file containing the list.
Selection (red) - Text of the selected item.
Load - Reloads the list from the text file on change from TRUE to FALSE. (mouse up).
Right-hand side pins:
List - Connection to a List type GUI pin, or Patch Mem - List
module.Index - Index of the selected item.
Selection - Text of the selected item.
Notes:
-
The file is just a text file, so you can edit or create one in a text editor like Notepad.
The format of the file follows two simple rules:
- Each list item must be on a single line
- Each line must be terminated by a semicolon (;)
-
You should use just a file name, without a path, for the File Name pin. Then, while you are working in SynthEdit, the module will look for and save its file in the SynthEdit directory. When saved as part of a VST, the file will be loaded from and saved to the same folder that the VST creates for its .sep/.sem modules.
-
Currently, lists are limited to approximately 1000 characters. This is because queue deadlocks, which can freeze the computer, can occur when too many characters are sent to a list pin. Rather than risk freeze ups, the module enforces a limitation, and sends a message when it has to truncate a list. This does not affect the original file, because DH_TextList2 is read-only. This limitation on the number of characters will be increased or removed when changes in SynthEdit make it safe to do so.
-
Your list items can include formatting characters for DH_PopupMenu to give your menu horizontal separators, non-selectable headings, and forced column breaks. The formatting characters all start with a > as the 1st character in the item:
>--- ; (one or more hyphens, followed by a semicolon to end the line) inserts a horizontal separator.
>~ (tilde) at the beginning of an item marks it as non-selectable for category headings and the like.
>| (vertical bar) at the beginning of an item forces a column break with a vertical bar separator.
>] (right square bracket) at the beginning of an item forces a column break without a vertical bar separator.
Other DH selection sub-controls will ignore these formatting characters. You can use a DH_ListStandardizer to convert a list that contains formatting characters to a standard SE list for use with other modules.