Gauge

Dashboard component reference for the radial Gauge, its dial geometry, presets, indication, scale bands and every editor property.

View as Markdown

The Gauge draws one numeric point on a radial dial. Everything about it is a statement of what the dial is — its sweep, what points at the reading, which parts of the scale are drawn, what the reading says and what it is painted with. When the point has no reading (bad quality, an unresolved address), the pointer, the fill and the value disappear together and the dial shows the gap mark (—) in place of a number; the banded track stays, because the bands are a declaration and not a measurement.

Content and data

Property	What it does	Values	Default
Label	Optional caption written under the reading.	text	empty
Address	Rooted Logic address of the numeric point shown. The field suggests from the live point list, filtered to numeric points, and shows the point's current reading once named.	address	empty

Format

Property	What it does	Values	Default
Min	Where the scale starts, in the point's engineering unit.	number	0
Max	Where the scale ends.	number	100
Unit	Optional unit suffix written beside the value.	text	empty
Decimals	Fixed decimal places for the readout.	0 to 15	blank uses the station's preference
Digits	How many places the central reading reserves before the decimal separator. It also decides when a value is marked as too wide for its field (`####`, with the whole reading in the tooltip).	1 to 15	blank derives it from the wider of Min and Max
Type size	Whether the cell decides the type size or the operator states it. A stated size is literal: it is drawn at that size in any cell and never reduced to fit.	As big as the cell affords · A size I state	As big as the cell affords
Points	The stated size. Only shown in the stated mode.	9 to 144	12
Reads as	How the reading is written out.	Number · Percentage · Duration	Number
The value counts	What one unit of the value means while the format is a duration.	Seconds · Milliseconds · Minutes	Seconds
Write the reading	Whether the reading is written inside the dial.	on / off	on
Write the label	Whether the label rides under the reading.	on / off	on

Dial

Angles run counter-clockwise from three o'clock, so 225° to −45° puts the middle of the scale at the top. A preset is a shortcut, not an identity: applying one writes the geometry and indication fields below and is then forgotten, so every field stays editable one by one afterwards. What a preset says nothing about — the address, the scale endpoints, the format, the bands, the reference, the accent, whether the reading and the label are written — survives untouched.

Preset	What it writes
Dial	Start 225°, end −45°, clockwise, 10 divisions, needle pointer, progress fill, ticks and scale numbers on. The shape a gauge is born with, and the way back from the other two.
Semicircle	Start 180°, end 0°, clockwise, 5 divisions (half the arc carries half the room for numbers), needle, fill, ticks and numbers on.
Ring	Start 90°, end −270° (a full turn), clockwise, no pointer, progress fill on, ticks and numbers off — the arc itself is the indication.

Property	What it does	Values	Default
Start	Where the sweep starts, in degrees counter-clockwise from three o'clock.	−360 to 360	225
End	Where the sweep ends. It may be negative and may pass a full turn from the start.	−360 to 360	−45
Divisions	How many divisions the scale is cut into, and so how many labelled ticks the arc carries.	1 to 50	10
The value grows clockwise	Which end of the arc the minimum sits at: the start angle with the value growing clockwise (the direction a dial is normally read), or the same arc walked the other way.	on / off	on
Draw the division marks	Whether the tick marks are drawn on the arc.	on / off	on
Number the divisions	Whether the divisions are numbered around the arc.	on / off	on

An angle typed outside its band is taken at the nearest edge and the panel says so; text that is not a number leaves the angle in force.

Indication

What points at the value, and what that indication is painted with. The accent is identity, not meaning — the bands below say what a reading means and keep the last word over the reading's colour.

Property	What it does	Values	Default
Pointer	What points at the reading on the arc. The value, its quality and the band it falls in are the same whichever is drawn.	Needle · Marker on the arc · No pointer	Needle
Fill the arc up to the reading	Whether the arc fills from the start of the scale to the reading.	on / off	on
Accent	Where the indication's colour comes from.	The ordinary ink · A color · A color point	The ordinary ink
Light / Dark	The accent as a light-theme and a dark-theme pair, both stated because the running theme decides which half is on screen. Only shown while the accent is a color.	`#RRGGBB` each	`#5470C6` both
Color point	Rooted Logic address of a Color point the accent follows. Only shown while the accent is a color point.	address	empty

Scale

The shared Scale section declares the stretches of the scale and what each means, and the reference the dial marks.

Each band covers everything up to its bound, from where the band above it in the list ended, so the bound is also the band's place; a reading past the last bound belongs to no band and takes the ordinary ink. The tone — Neutral, Information, Success, Caution, Critical — is the interface's own vocabulary, and the theme decides the paint. Wording a band names the state, and the gauge can show that word beside its reading.
The reference marks a setpoint or nominal on the scale: nothing, a fixed value, or a point that moves with the recipe. It is drawn only while the scale reaches it.