Gauge
Dashboard component reference for the radial Gauge, its dial geometry, presets, indication, scale bands and every editor property.
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. NaN is a reading,
not a gap: the dial writes that word beside its unit and points at nothing, since NaN has
no place on the scale.
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. Left blank, a point whose type is a whole number is written without a fraction, and any other number to the station's places. The places of the reading are also the most a number around the arc carries: the ones typed here or, with the field blank, the point's own (none on a whole number, the station's on any other, and the station's until the point first answers). Each number of the arc carries only the places it needs, so a dial of whole divisions reads 30 and 60, not 30.0 and 60.0. | 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). A point that answers in words (an order, a batch, a flag) never wears that mark: what the middle of the dial cannot hold ends in an ellipsis (…), with the whole reading in the tooltip. |
1 to 20 | 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. Left to the cell, the reading is written as large as the room between the arc and its numbers allows, and never under 11 pixels. Where the reading is wider than the room the dial leaves it, at the stated size or, with the cell deciding, even at 11 pixels, the dial writes #### in place of the number, with the whole reading in the tooltip. A reading in words never wears the mark and keeps its ellipsis. |
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 division marks the arc carries; a small dial may number fewer of them (see Number the divisions). | 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. The numbers are written with the station's decimal separator and its grouping mark, each with only the places it needs, up to the places of the reading: a dial of whole divisions reads 30 and 60 whatever places the reading writes, and a division those places do not hold is rounded to them, so a count on 0 to 100 in three divisions is numbered 0, 33, 67 and 100. The unit, the percent sign and the clock belong to the reading in the middle, never to the arc. Where the dial is too small to write every number clear of the next, it numbers fewer divisions at an even step (every second or every fifth of ten, for example), always with both ends of the scale among them, and none where not even the two ends fit. On a dial that closes a full turn, the end of the scale falls where its start is, and only the start is numbered. | 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.