DH_ContourInput
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 line segment. Dragging
over the contour display window adjusts the height of the segments to the
mouse's vertical position as it passes over each one. The height of each
segment determines its output value, on a scale of 0 to 10. 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.
Left-hand side pins:
# Points - Sets the number of values to be controlled, and thus the number of vertical line segments displayed.
Bkgd and Line RGB - Set the color of the background and the line segments.
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.
Line Width - Adjusts the width of the vertical line segments, from 1 to 4.
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.
Parameter (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 vertical line segment.
Baseline - Selects Bottom, Mid or Top as starting point from which vertical line segments are drawn.
Note:
The module works bidirectionally (input and output). The heights of the vertical line segments 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 vertical line segments to reflect the new values. You can automate the line segments by connecting the individual float values to Patch Mem - Float modules.
Demo Hookup:
