Cadran

Référence du composant de tableau de bord Cadran : la géométrie du cadran radial, ses jeux de réglages, son indication, les plages de l'échelle et toutes ses propriétés d'éditeur.

Afficher en Markdown

Le Cadran dessine un point numérique sur un cadran radial. Tout en lui est une déclaration de ce que le cadran est : son balayage, ce qui pointe la lecture, quelles parties de l'échelle sont dessinées, ce que la lecture dit et avec quoi elle est peinte. Quand le point n'a pas de lecture (mauvaise qualité, adresse non résolue), l'aiguille, le remplissage et la valeur disparaissent ensemble et le cadran montre la marque de lacune (—) à la place d'un nombre ; l'arc par plages reste, parce que les plages sont une déclaration et non une mesure. NaN est une lecture, pas une lacune : le cadran écrit ce mot à côté de son unité et ne pointe rien, puisque NaN n'a pas de place sur l'échelle.

Contenu et données

Propriété	Ce qu'elle fait	Valeurs	Par défaut
Libellé	Légende facultative écrite sous la lecture.	texte	vide
Adresse	Adresse Logic enracinée du point numérique montré. Le champ propose depuis la liste des points en direct, filtrée sur les points numériques, et montre la lecture actuelle du point une fois qu'il est nommé.	adresse	vide

Mise en forme

Propriété	Ce qu'elle fait	Valeurs	Par défaut
Mini	Là où l'échelle commence, dans l'unité physique du point.	nombre	0
Maxi	Là où l'échelle finit.	nombre	100
Unité	Suffixe d'unité facultatif écrit à côté de la valeur.	texte	vide
Décimales	Nombre fixe de décimales pour la lecture. Laissé vide, un point dont le type est un nombre entier s'écrit sans fraction, et tout autre nombre aux décimales de la station. Les décimales de la lecture sont aussi le plus qu'un nombre autour de l'arc porte : celles saisies ici ou, le champ vide, celles du point (aucune sur un nombre entier, celles de la station sur tout autre, et celles de la station tant que le point n'a pas encore répondu). Chaque nombre de l'arc ne porte que les décimales dont il a besoin, si bien qu'un cadran aux divisions entières lit 30 et 60, et non 30,0 et 60,0.	de 0 à 15	vide suit la préférence de la station
Chiffres	Combien de places la lecture centrale réserve avant le séparateur décimal. C'est aussi ce qui décide quand une valeur est signalée comme trop large pour son champ (`####`, avec la lecture entière dans l'infobulle). Un point qui répond en mots (un ordre, un lot, un drapeau) ne porte jamais la marque, pas même quand ses mots ne sont faits que de chiffres : ce que le centre du cadran ne peut pas contenir se termine par des points de suspension (…), avec la lecture entière dans l'infobulle.	de 1 à 20	vide le dérive du plus large de Mini et Maxi
Taille du texte	Si la cellule décide de la taille du texte ou si l'opérateur la fixe. Une taille fixée est littérale : elle est dessinée à cette taille dans n'importe quelle cellule et jamais réduite pour entrer. Si la cellule décide, la lecture est écrite aussi grande que le permet la place entre l'arc et ses nombres, et jamais sous 11 pixels. Là où la lecture est plus large que la place que le cadran lui laisse, à la taille fixée ou, si la cellule décide, même à 11 pixels, le cadran écrit `####` à la place du nombre, avec la lecture entière dans l'infobulle. Une lecture en mots ne porte jamais cette marque et garde ses points de suspension.	Aussi grand que la cellule le permet · Une taille que je fixe	Aussi grand que la cellule le permet
Taille (points)	La taille fixée. Montrée seulement dans le mode fixé.	de 9 à 144	12
S'affiche comme	Comment la lecture est écrite.	Nombre · Pourcentage · Durée	Nombre
La valeur compte en	Ce que vaut une unité de la valeur tant que la mise en forme est une durée.	Secondes · Millisecondes · Minutes	Secondes
Écrire la lecture	Si la lecture est écrite à l'intérieur du cadran.	activé / désactivé	activé
Écrire le libellé	Si le libellé se pose sous la lecture.	activé / désactivé	activé

Cadran

Les angles tournent dans le sens antihoraire depuis trois heures, donc 225° à −45° place le milieu de l'échelle en haut. Un jeu de réglages est un raccourci, pas une identité : en appliquer un inscrit les champs de géométrie et d'indication ci-dessous, puis il est oublié, si bien que chaque champ reste modifiable un par un ensuite. Ce dont un jeu de réglages ne dit rien, l'adresse, les extrémités de l'échelle, la mise en forme, les plages, la référence, l'accent, le fait que la lecture et le libellé soient écrits, survit intact.

Jeu de réglages	Ce qu'il inscrit
Cadran	Début 225°, fin −45°, horaire, 10 divisions, aiguille, remplissage de progression, marques et nombres de l'échelle activés. La forme avec laquelle un cadran naît, et le chemin de retour depuis les deux autres.
Demi-cercle	Début 180°, fin 0°, horaire, 5 divisions (la moitié de l'arc porte la moitié de la place pour les nombres), aiguille, remplissage, marques et nombres activés.
Anneau	Début 90°, fin −270° (un tour complet), horaire, aucune aiguille, remplissage de progression activé, marques et nombres désactivés : l'arc lui-même est l'indication.

Propriété	Ce qu'elle fait	Valeurs	Par défaut
Début	Là où le balayage commence, en degrés dans le sens antihoraire depuis trois heures.	de −360 à 360	225
Fin	Là où le balayage finit. Elle peut être négative et peut dépasser un tour complet depuis le début.	de −360 à 360	−45
Nombre de divisions	En combien de divisions l'échelle est découpée, et donc combien de marques l'arc porte ; un petit cadran peut en numéroter moins (voir Numéroter les divisions).	de 1 à 50	10
La valeur croît dans le sens horaire	À quelle extrémité de l'arc le minimum se trouve : l'angle de début avec la valeur qui croît dans le sens horaire (le sens dans lequel un cadran se lit normalement), ou le même arc parcouru dans l'autre sens.	activé / désactivé	activé
Tracer les repères de division	Si les marques sont tracées sur l'arc.	activé / désactivé	activé
Numéroter les divisions	Si les divisions sont numérotées autour de l'arc. Les nombres s'écrivent avec le séparateur décimal et la marque de groupement de la station, chacun avec les seules décimales dont il a besoin, jusqu'aux décimales de la lecture : un cadran aux divisions entières lit 30 et 60 quelles que soient les décimales de la lecture, et une division que ces décimales ne gardent pas est arrondie, si bien qu'un compteur de 0 à 100 en trois divisions se lit 0, 33, 67 et 100. L'unité, le signe de pourcentage et l'horloge appartiennent à la lecture du centre, jamais à l'arc. Là où le cadran est trop petit pour écrire chaque nombre à l'écart du suivant, il numérote moins de divisions à pas régulier (une sur deux ou une sur cinq de dix, par exemple), toujours avec les deux extrémités de l'échelle, et aucune là où même les deux extrémités ne tiennent pas. Sur un cadran qui ferme un tour complet, la fin de l'échelle tombe sur son début, et seul le début est numéroté.	activé / désactivé	activé

Un angle tapé hors de sa plage est pris au bord le plus proche et le volet le dit ; un texte qui n'est pas un nombre laisse l'angle en vigueur.

Indications du cadran

Ce qui pointe la valeur, et avec quoi cette indication est peinte. L'accent est une identité, pas un sens : les plages ci-dessous disent ce qu'une lecture signifie et gardent le dernier mot sur sa couleur.

Propriété	Ce qu'elle fait	Valeurs	Par défaut
Indicateur	Ce qui pointe la lecture sur l'arc. La valeur, sa qualité et la plage dans laquelle elle tombe sont les mêmes quel que soit le dessin.	Aiguille · Repère sur l'arc · Aucun indicateur	Aiguille
Remplir l'arc jusqu'à la lecture	Si l'arc se remplit depuis le début de l'échelle jusqu'à la lecture.	activé / désactivé	activé
Teinte d'accent	D'où vient la couleur de l'indication.	L'encre habituelle · Une couleur · Un point de couleur	L'encre habituelle
Clair / Sombre	L'accent sous forme de paire pour le thème clair et le thème sombre, les deux fixées parce que le thème en cours décide quelle moitié est à l'écran. Montré seulement tant que l'accent est une couleur.	`#RRGGBB` chacune	`#5470C6` les deux
Point de couleur	Adresse Logic enracinée d'un point Couleur que l'accent suit. Montré seulement tant que l'accent vaut `Un point de couleur`.	adresse	vide

Échelle

La section Échelle partagée déclare les portions de l'échelle et ce que chacune signifie, ainsi que la référence que le cadran marque.

Chaque plage couvre tout jusqu'à sa borne, depuis là où celle du dessus dans la liste s'est arrêtée, si bien que la borne est aussi la place de la plage ; une lecture au-delà de la dernière borne n'appartient à aucune plage et prend l'encre habituelle. Le sens, Neutre, Informatif, Succès, Prudence, Critique, est le vocabulaire propre à l'interface, et le thème décide de la peinture. Libeller une plage nomme l'état, et le cadran peut écrire ce mot à côté de sa lecture.
La référence marque une consigne ou une valeur nominale sur l'échelle : rien, une valeur fixe, ou un point qui se déplace avec la recette. Elle n'est dessinée que tant que l'échelle l'atteint.