DH_MultiStepInput
Function:
Provides
a GUI interface for the input and display of a series or collection of
parameter values.
Each parameter value is represented by a vertical bar. The height of the
bars can be adjusted with the mouse. The height of each bar determines its output value, on a scale of 0 to 10.
Fine adjustments can be made by pressing the Ctrl key while dragging. The output is in
the form of an array, which can be transferred into a
DH_FloatArray, converted into individual Float values
using a DH_ArrayToFloats module, or
played out sequentially one value at a time in response to a pulse using a
DH_ArraySequencer. A bar can be selected
for highlighting using the Current Step input. One application of this might
be to animate a step sequencer that is controlled by the module. A bar's top
line segment, bottom line segment, or the entire bar can be highlighted,
depending on the Highlight Mode
Left-hand side pins:
# Points - Sets the number of values to be controlled, and thus the number of bars displayed.
Current Step - Selects the bar to be highlighted, if one of the highlight modes is selected.
Note:
The steps are numbered from 0 to one less than the number of steps. Step numbers generally increase from left to right; however, any step may be selected as "Step 0"( see Current Step Offset below), so incrementing the current step past the rightmost bar causes the highlighting to wrap around to the leftmost bar. For example, with 16 steps and a Current Step Offset of 3, incrementing the Current Step by 1 from 0 to 15 would highlight steps in the following sequence:
3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 0, 1, 2Current Step Offset - Allows any step to be selected as "Step 0". This can sometimes help synchronize animation to the audio.
Highlight Mode - Off, Top, Bottom, or Bar.
Bkgd, Fill, Outline and Highlight RGB - Set the color of the background, the interior of the bars, the outline of the bars, and the highlight color.
Notes:
These are integer COLORREF RGB values, as used by Windows, and can be obtained most easily using the DH_HexRGBtoRGB or DH_HSLtoRGB modules in this package, or the DH_TextToRGB or DH_ColorPicker modules from DH_Sub-ControlPak.
Use a value of -1 for Bkgd RGB for a transparent background.
Lock Display - Makes the GUI read-only.
Load Const Array - Triggers loading the array specified by the Const Array pin.
Const Array - A text string of comma-separated numbers specifying an array to be loaded when triggered by the Load Const Array pin.
Right-hand side pins:
Array Out - The output values are in the form of an array, which you access in 3 ways:
using a DH_ArrayToFloats module. Values are taken from left to right in the multistep display window, and are output from the DH_ArrayToFloats in top-down sequence.
using a DH_FloatArray module to hold the entire array.
using a DH_ArraySequencer module. Values will be output in left to right sequence.
Mouse Down - Becomes TRUE when the left mouse button is pressed while the cursor is on the GUI, and remains TRUE until the button is released.
Parameters (Right-click Properties):
Hide Scale - Removes the vertical scale.
Scale Padding - Slides the display to the right by the specified number of pixels to provide space between the vertical scale and the first bar.
Note:
The module works bidirectionally (input and output). The heights of the bars change when the array values are changed. For example, changing the Value pins of a connected DH_ArrayToFloats, or loading a file into a connected DH_FloatArray will move the bars to reflect the new values. You can automate the bars by connecting the individual float values to Patch Mem - Float modules.
Demo Hookup:
