Spin Controls
Function:
These GUI input controls can be used in 2 ways:
to select an item from a list
to generate a series of numbers in a preset range.
Because
they are input only, they will usually be used together with a GUI output
control, such as a DH_TextDisplay, as in the example on the right.
The upper DH_HSpinCtrl moves forward or backward through a list of waveforms, with the currently selected waveform displayed in the adjacent DH_TextDisplay window.
The lower DH_VSpinCtrl increments or decrements the number displayed in the adjacent DH_Text display.
To
use a spin control to generate a series of numbers independent of a list,
select the Use Without List option, and provide the minimum and maximum
values of the desired range.
If Use Without List is not selected, the modules expect the List pin to be connected, and will set the range automatically from the list, ignoring the Min Value and Max Value parameters.
The Wrap option can be used with or without a list. When selected, it causes the result of incrementing the maximum of the range to be the minimum of the range, and the result of decrementing the minimum of the range to be the maximum of the range.
When Wrap is not selected, additional clicks in the same
direction after the maximum or minimum has been reached produce no response.
Left-hand side pins:
Selection - Text of the selected item
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:
DH_HSpinCtrl and DH_VSpinCtrl operate identically. The only difference is the horizontal vs. vertical arrangement of the buttons.