1. Overview & Purpose
The neoGauge plugin provides interactive, vector-rendered radial and linear meter gauges for dashboards, telemetry displays, and control panels in VisualNEO Win applications.
It supports 4 gauge styles (circular, semi-circular, linear-horizontal, linear-vertical), custom unit labels (%, km/h, RPM, °C), customizable needle/face/scale colors, range bounds (minValue, maxValue), and image export (BMP, PNG).
2. Custom Control Properties
Control: neoGauge Display (neogauge-display)
| Property Name | Type | Default Value | Description |
|---|---|---|---|
value | number | 50 | Active gauge value. |
minValue | number | 0 | Minimum scale value bound. |
maxValue | number | 100 | Maximum scale value bound. |
gaugeType | string | "circular" | Meter visual format ("circular", "semi-circular", "linear-horizontal", "linear-vertical"). |
units | string | "%" | Unit text label displayed inside the gauge. |
needleColor | string | "#E74C3C" | Color of indicator needle / bar (#RRGGBB). |
faceColor | string | "#2C3E50" | Dial face background color (#RRGGBB). |
scaleColor | string | "#ECF0F1" | Tick marks and numeric text label color (#RRGGBB). |
showValueText | boolean | true | Displays numeric readout text inside the meter. |
3. Actions & Commands Reference
neoGaugeSetValue
Sets the numeric value of a neoGaugeDisplay control.
- Command Syntax:
neoGaugeSetValue "ObjectName" "Value"
neoGaugeGetValue
Retrieves the current numeric value into [neoGaugeResult] (and optionally into a specified variable).
- Command Syntax:
neoGaugeGetValue "ObjectName" "[ResultVar]" - Parameters:
- •
ObjectName(string): Target control name. - •
ResultVar(string, optional): Variable to receive the numeric string (e.g."[Speed]").
neoGaugeSetRange
Configures minimum and maximum scale bounds.
- Command Syntax:
neoGaugeSetRange "ObjectName" "MinValue" "MaxValue"
neoGaugeSetColors
Updates needle, face background, and scale colors.
- Command Syntax:
neoGaugeSetColors "ObjectName" "NeedleColor" "FaceColor" "ScaleColor"
neoGaugeSetType
Changes the visual gauge layout format.
- Command Syntax:
neoGaugeSetType "ObjectName" "GaugeType" - Parameters:
GaugeTypecan be"circular","semi-circular","linear-horizontal", or"linear-vertical".
neoGaugeSetUnits
Sets the unit label text.
- Command Syntax:
neoGaugeSetUnits "ObjectName" "UnitsText"
neoGaugeGenerate
Generates a meter gauge image file directly in the background without needing a control instance on the page.
- Command Syntax:
neoGaugeGenerate "Value" "MinVal" "MaxVal" "Type" "Units" "FilePath" "Width" "Height"
4. Events Reference
change: Triggered when the gauge value updates.
5. Practical Usage Example (VisualNEO Win Script)
. --- Configure speedometer gauge ---
neoGaugeSetType "Gauge1" "semi-circular"
neoGaugeSetRange "Gauge1" "0" "220"
neoGaugeSetUnits "Gauge1" "km/h"
neoGaugeSetColors "Gauge1" "#FF5722" "#1E293B" "#F8FAFC"
. --- Update speed reading ---
neoGaugeSetValue "Gauge1" "120"