Gauge

The Gauge control displays a numerical value using a speedometer style indicator. Its value is typically set by commands received from a connected device. You can attach up to four labels to the gauge which can be used to display units and status information. The first label can display the current gauge value as a number. Parts of the gauge scale can be marked using colored bands to indicate target or out-of-range values on the scale.

The gauge value is a floating point number.

Example Gauge Controls

Examples of the Gauges that can be created in MegunoLink’s interface panel visualizer.

Properties

Gauge control properties
Property Access Type Method Description
MinValue Design-only Single The minimum value shown on the gauge scale
MaxValue Design-only Single The maximum value shown on the gauge scale
Name Read only string The name of the control
ScaleLinesMajorStepValue Design-only Single The interval between numbered major-ticks on the scale
ScaleLinesMinorTicks Design-only Integer The number of unnumbered ticks between numbered major-ticks on the scale
ScaleNumbersFormat Design-only String The format for numbers shown on the scale
BaseArcStart Design-only Integer The angle where the scale begins. Relative to an analog clock, 0 would be at 3 o’clock; 90 would be at 6 o’clock; 180 would be at 9 o’clock and 270 would be at 12 o’clock.
BaseArcSweep Design-only Integer The length of the scale arc, in degrees. 180° is half a circle; 270° is three-quarters of a circle
GaugeAutoScale Design-only bool When true, the gauge automatically resizes to fit the control rectangle
DisplayValueOnLabel Design-only bool When true, the gauges current value is displayed on the first label
GaugeLabels Design-only Collection A collection of labels attached to the gauge
Label0, Label1, Label2, Label3 Read/Write string SetGaugeLabel Get/set the current value for a gauge label, if the label is present in the GaugeLabels collection.
GaugeRanges Design-only Collection A collection of colored bands attached to the scale
Value Read/write float SetNumber The current value

This control also supports all the common control properties.

Gauge labels

Labels can be included to display text on the gauge. Labels can be static (showing units, for example) or dynamically display the current gauge value. They can also be changed by sending serial commands to the interface panel from your Arduino sketch.

Gauge with units

Labels can be used to display the current gauge value and units.

Use the ellipsis control (…) on the GaugeLabels property to open the label collection editor. The collection editor lets you add, remove and edit the labels attached to the gauge. Each label is positioned relative to the center of the gauge with positive values moving the label down and to the right.

Editing the Gauge Label collection

Add, remove and edit labels using the GaugeLabel collection editor.

The first label shows the current gauge value when the gauge control’s DisplayValueOnLabel is true. You must still create and position at least one gauge label to display the gauge value when DidsplayValueOnLabel is true.

Use SetGaugeLabel(ControlName, LabelIndex, LabelText) to change the label text from your Arduino sketch.

Gauge Ranges

Gauge ranges provide a way to highlight different regions of the gauge scale with different colors. These regions could indicate normal and abnormal ranges for the measurement shown.

Gauge with regions

Colored regions on the gauge can be used to highlight different operating ranges.

Use the ellipsis control(…) on the GaugeRanges property to open the range collection editor. The collection editor lets you add, remove and edit the colored range bars attached to the gauge scale. Each band includes a Color property and Start and End properties which set the portion of the scale that is colored.

gauge range collection editor

Add, remove and edit colored scale bands using the gauge range collection editor

Start typing and press Enter to search