# 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.

## Content and data {#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 {#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 {#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 {#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 {#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.