# Zeigerinstrument

> Referenz der Dashboard-Komponente für das radiale Zeigerinstrument, seine Geometrie, die Voreinstellungen, die Anzeige, die Bereiche der Skala und alle Eigenschaften des Editors.

Das **Zeigerinstrument** zeichnet einen numerischen Datenpunkt auf ein radiales Zifferblatt.
Alles daran ist eine Aussage darüber, was das Zifferblatt *ist*: sein Bogen, was auf den
Messwert zeigt, welche Teile der Skala gezeichnet werden, was der Messwert sagt und womit er
gemalt ist. Hat der Datenpunkt keinen Messwert (schlechte Qualität, eine nicht aufgelöste
Adresse), verschwinden Zeiger, Füllung und Wert zusammen, und das Zifferblatt zeigt das Zeichen
für die Lücke (`—`) an der Stelle einer Zahl; die Bahn mit ihren Bereichen bleibt, denn die
Bereiche sind eine Erklärung und keine Messung. Auch `NaN` ist ein Messwert und keine Lücke: Das
Zifferblatt schreibt dieses Wort neben seine Einheit und zeigt auf nichts, denn `NaN` hat keinen
Platz auf der Skala.

## Inhalt und Daten {#content-and-data}

| Eigenschaft | Was sie tut | Werte | Vorgabe |
|---|---|---|---|
| Beschriftung | Wahlweise eine Bildunterschrift, die unter den Messwert geschrieben wird. | Text | leer |
| Adresse | Verwurzelte Logic-Adresse des gezeigten numerischen Datenpunkts. Das Feld schlägt aus der Liste der lebenden Datenpunkte vor, auf numerische Datenpunkte eingeengt, und zeigt den aktuellen Messwert des Datenpunkts, sobald er benannt ist. | Adresse | leer |

## Format {#format}

| Eigenschaft | Was sie tut | Werte | Vorgabe |
|---|---|---|---|
| Min. | Wo die Skala beginnt, in der technischen Einheit des Datenpunkts. | Zahl | 0 |
| Max. | Wo die Skala endet. | Zahl | 100 |
| Einheit | Wahlweise ein Einheitenzeichen, das neben den Wert geschrieben wird. | Text | leer |
| Dezimalstellen | Feste Nachkommastellen für die Anzeige. Bleibt das Feld leer, wird ein Datenpunkt, dessen Typ eine Ganzzahl ist, ohne Nachkommastellen geschrieben und jede andere Zahl mit den Stellen der Station. Die Stellen des Messwerts sind zugleich das Höchste, was eine Zahl rund um den Bogen trägt: die hier eingetragenen oder, bei leerem Feld, die des Datenpunkts selbst (keine bei einer Ganzzahl, die der Station bei jeder anderen Zahl, und die der Station, bis der Datenpunkt zum ersten Mal antwortet). Jede Zahl des Bogens trägt nur die Stellen, die sie braucht, ein Zifferblatt mit ganzen Teilungen liest also 30 und 60, nicht 30,0 und 60,0. | 0 bis 15 | leer verwendet die Vorgabe der Station |
| Ziffern | Wie viele Stellen der mittige Messwert vor dem Dezimaltrennzeichen reserviert. Das entscheidet zugleich, wann ein Wert als zu breit für sein Feld markiert wird (`####`, mit dem ganzen Messwert im Tooltip). Ein Datenpunkt, der in Worten antwortet (ein Auftrag, eine Charge, ein Kennzeichen), trägt dieses Zeichen nie: was die Mitte des Zifferblatts nicht fasst, endet in Auslassungspunkten (…), mit dem ganzen Messwert im Tooltip. | 1 bis 20 | leer leitet es aus dem größeren von Min. und Max. ab |
| Schriftgröße | Ob die Zelle über die Schriftgröße entscheidet oder der Bediener sie angibt. Eine angegebene Größe ist wörtlich: sie wird in jeder Zelle in dieser Größe gezeichnet und nie verkleinert, damit etwas passt. Entscheidet die Zelle, wird der Messwert so groß geschrieben, wie der Raum zwischen dem Bogen und seinen Zahlen es zulässt, und nie kleiner als 11 Pixel. Ist der Messwert breiter als der Raum, den das Zifferblatt ihm lässt, in der angegebenen Größe oder, wenn die Zelle entscheidet, schon bei 11 Pixeln, schreibt das Zifferblatt `####` anstelle der Zahl, mit dem ganzen Messwert im Tooltip. Ein Messwert in Worten trägt dieses Zeichen nie und behält seine Auslassungspunkte. | So groß, wie die Zelle es zulässt · Eine Größe, die ich angebe | So groß, wie die Zelle es zulässt |
| Punkt | Die angegebene Größe. Nur im angegebenen Modus gezeigt. | 9 bis 144 | 12 |
| Liest sich als | Wie der Messwert ausgeschrieben wird. | Zahl · Prozent · Dauer | Zahl |
| Der Wert zählt in | Was eine Einheit des Werts bedeutet, solange das Format eine Dauer ist. | Sekunden · Millisekunden · Minuten | Sekunden |
| Den Messwert schreiben | Ob der Messwert im Zifferblatt geschrieben wird. | ein / aus | ein |
| Die Beschriftung schreiben | Ob die Beschriftung unter dem Messwert mitfährt. | ein / aus | ein |

## Zifferblatt {#dial}

Winkel laufen gegen den Uhrzeigersinn von drei Uhr aus, also legt 225° bis −45° die Mitte der
Skala nach oben. Eine **Voreinstellung** ist eine Abkürzung, keine Identität: eine anzuwenden
schreibt die Felder der Geometrie und der Anzeige darunter und wird dann vergessen, jedes Feld
bleibt danach also einzeln bearbeitbar. Was eine Voreinstellung nicht anrührt, nämlich die
Adresse, die Enden der Skala, das Format, die Bereiche, die Referenz, der Akzent und die Frage,
ob Messwert und Beschriftung geschrieben werden, bleibt unberührt.

| Voreinstellung | Was sie schreibt |
|---|---|
| Zifferblatt | Anfang 225°, Ende −45°, im Uhrzeigersinn, 10 Teilungen, Nadel als Zeiger, Füllung bis zum Messwert, Teilstriche und Bezifferung ein. Die Form, mit der ein Zeigerinstrument geboren wird, und der Weg zurück von den beiden anderen. |
| Halbkreis | Anfang 180°, Ende 0°, im Uhrzeigersinn, 5 Teilungen (der halbe Bogen trägt den halben Platz für Zahlen), Nadel, Füllung, Teilstriche und Bezifferung ein. |
| Ringform | Anfang 90°, Ende −270° (eine ganze Umdrehung), im Uhrzeigersinn, kein Zeiger, Füllung bis zum Messwert ein, Teilstriche und Bezifferung aus: der Bogen selbst ist die Anzeige. |

| Eigenschaft | Was sie tut | Werte | Vorgabe |
|---|---|---|---|
| Anfang | Wo der Bogen beginnt, in Grad gegen den Uhrzeigersinn von drei Uhr aus. | −360 bis 360 | 225 |
| Ende | Wo der Bogen endet. Es darf negativ sein und darf vom Anfang aus eine ganze Umdrehung überschreiten. | −360 bis 360 | −45 |
| Teilungen | In wie viele Teilungen die Skala geschnitten wird, und damit, wie viele Teilstriche der Bogen trägt; ein kleines Zifferblatt beziffert davon womöglich weniger (siehe Die Teilungen beziffern). | 1 bis 50 | 10 |
| Der Wert wächst im Uhrzeigersinn | An welchem Ende des Bogens das Minimum sitzt: am Anfangswinkel, mit dem Wert, der im Uhrzeigersinn wächst (die Richtung, in der ein Zifferblatt gewöhnlich gelesen wird), oder derselbe Bogen andersherum begangen. | ein / aus | ein |
| Die Teilstriche zeichnen | Ob die Teilstriche auf dem Bogen gezeichnet werden. | ein / aus | ein |
| Die Teilungen beziffern | Ob die Teilungen rund um den Bogen beziffert werden. Die Zahlen werden mit dem Dezimaltrennzeichen der Station und seinem Gruppierungszeichen geschrieben, jede nur mit den Stellen, die sie braucht, höchstens mit denen des Messwerts: ein Zifferblatt mit ganzen Teilungen liest 30 und 60, mit wie vielen Stellen der Messwert auch geschrieben wird, und eine Teilung, die diese Stellen nicht fassen, wird auf sie gerundet, eine Zählung von 0 bis 100 in drei Teilungen wird also mit 0, 33, 67 und 100 beziffert. Einheit, Prozentzeichen und Uhr gehören zum Messwert in der Mitte, nie zum Bogen. Ist das Zifferblatt zu klein, um jede Zahl frei von der nächsten zu schreiben, beziffert es weniger Teilungen in gleichem Schritt (zum Beispiel jede zweite oder jede fünfte von zehn), stets mit beiden Enden der Skala, und keine, wo nicht einmal die beiden Enden passen. Auf einem Zifferblatt, das eine volle Umdrehung schließt, fällt das Ende der Skala auf ihren Anfang, und nur der Anfang wird beziffert. | ein / aus | ein |

Ein Winkel, der außerhalb seines Bandes getippt wird, wird am nächsten Rand genommen, und der
Bereich sagt das; Text, der keine Zahl ist, lässt den Winkel in Kraft.

## Anzeige {#indication}

Was auf den Wert zeigt, und womit diese Anzeige gemalt ist. Der Akzent ist Identität, nicht
Bedeutung: die Bereiche darunter sagen, was ein Messwert bedeutet, und behalten über der Farbe
des Messwerts das letzte Wort.

| Eigenschaft | Was sie tut | Werte | Vorgabe |
|---|---|---|---|
| Zeiger | Was auf dem Bogen auf den Messwert zeigt. Der Wert, seine Qualität und der Bereich, in den er fällt, sind dieselben, was auch gezeichnet wird. | Nadel · Marke auf dem Bogen · Kein Zeiger | Nadel |
| Den Bogen bis zum Messwert füllen | Ob sich der Bogen vom Anfang der Skala bis zum Messwert füllt. | ein / aus | ein |
| Akzent | Woher die Farbe der Anzeige kommt. | Die übliche Schriftfarbe · Eine Farbe · Ein Farbdatenpunkt | Die übliche Schriftfarbe |
| Hell / Dunkel | Der Akzent als Paar für das helle und das dunkle Design, beide angegeben, weil das laufende Design entscheidet, welche Hälfte auf dem Bild ist. Nur gezeigt, solange der Akzent eine Farbe ist. | je `#RRGGBB` | `#5470C6` für beide |
| Farbdatenpunkt | Verwurzelte Logic-Adresse eines Farbdatenpunkts, dem der Akzent folgt. Nur gezeigt, solange der Akzent ein Farbdatenpunkt ist. | Adresse | leer |

## Skalierung {#scale}

Der gemeinsame Abschnitt **Skalierung** erklärt die Abschnitte der Skala und was jeder bedeutet, dazu
die Referenz, die das Zifferblatt markiert.

- Jeder **Bereich** deckt alles bis zu seiner Grenze ab, von dort, wo der Bereich über ihm in
  der Liste endete, die Grenze ist also zugleich der Platz des Bereichs; ein Messwert hinter der
  letzten Grenze gehört zu keinem Bereich und nimmt die übliche Schriftfarbe. Der Ton, also
  Unauffällig, Hinweis, Erfolg, Vorsicht oder Kritisch, ist der eigene Wortschatz der
  Oberfläche, und das Design entscheidet über die Farbe. Einem Bereich ein Wort zu geben benennt
  den Zustand, und das Zeigerinstrument kann dieses Wort neben seinem Messwert zeigen.
- Die **Referenz** markiert einen Sollwert oder einen Nennwert auf der Skala: nichts, ein fester
  Wert oder ein Datenpunkt, der sich mit dem Rezept bewegt. Sie wird nur gezeichnet, solange die
  Skala sie erreicht.