Progress
Dashboard component reference for the Progress track, one bounded reading as a bar, a bargraph or a banded scale, with every editor property.
The Progress component draws one bounded numeric reading along a track. Its three presentations answer different questions about the same value — how much of the range is taken, how many steps of it are taken, and which declared stretch the reading is in — which is why they are a choice and not a style. A track with no reading draws no fill at all (an empty bar would read as a measured zero) and shows the gap mark (—) where the number goes.
Content and data
| Property | What it does | Values | Default |
|---|---|---|---|
| Label | Optional caption above the track. A long label truncates with the whole of it in the tooltip and never takes room from 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. Below Min there is no scale to place a reading on. | number | 100 |
| Unit | Optional unit suffix beside the reading. | text | empty |
| Decimals | Fixed decimal places for the readout. | 0 to 15 | blank uses the station's preference |
| Digits | How many places the reading reserves before the decimal separator; a reading past it is marked (####) with the whole of itself 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. | 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 beside the track. | on / off | on |
| Write the ends of the scale | Whether the two ends are written under the track. | on / off | off |
Track
| Property | What it does | Values | Default |
|---|---|---|---|
| Draws | The presentation: a continuous fill from the start of the scale up to the reading; the same fill cut into equal cells lit up to the reading (a bargraph); or the declared bands painted along the track with the reading riding them as a mark — nothing fills, because the question is where on the scale the value is, not how much of it is used. | A bar filled to the reading · Steps lit up to the reading · The bands, with the reading marked on them | A bar filled to the reading |
| Runs | Which way the track runs: across the cell with the scale starting at the left edge, or up the cell with the scale starting at the bottom — a level column. | Across the cell · Up the cell | Across the cell |
| Cells | How many cells a stepped track is cut into. Only asked of that presentation. | 2 to 50 | 10 |
| The scale starts at the far end | Reverses the direction of the scale, so the fill grows back toward the near end. It is the direction only, never a second pair of ends: Min stays the minimum. | on / off | off |
| Accent | Where the fill's colour comes from. Identity, not meaning — the bands keep the last word over the reading's meaning. | The ordinary ink · A color · A color point | The ordinary ink |
| Light / Dark | The accent as a light and dark 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 bands and the reference.
- Each band covers everything up to its bound, from where the band above it ended; a reading past the last bound belongs to no band. The tone (Neutral, Information, Success, Caution, Critical) tints the written reading, and on the banded presentation the bands are the track itself, painted whether or not the point is answering — they are the declaration, not the measurement. A worded band writes its name in the head, before the number so the reading keeps the end of the line.
- The reference marks a setpoint or nominal on the track: nothing, a fixed value, or a point that moves with the recipe. The mark's tooltip carries the reference value, and it is drawn only while the scale reaches it.