# Symbole

> Référence du composant de tableau de bord Symbole, un SVG industriel animé par des points en direct, avec ses entrées, ses tracés et son orientation.

Le **Symbole** pose un dessin SVG industriel sur la vue, une pompe, une vanne, une cuve, et pilote
ses entrées déclarées depuis des points en direct, si bien que le dessin s'anime avec
l'installation. C'est le seul composant dont l'identité se choisit avant la pose : l'entrée de la
palette ouvre la bibliothèque de symboles (le paquet système embarqué plus les symboles importés par
l'opérateur), et celui que vous retenez est celui qui se pose sur le plan de travail. Un composant
dont la référence ne peut pas être résolue dessine un espace réservé neutre plutôt qu'un équipement
quelconque, avec la raison dans son infobulle.

Ce qu'un symbole sait *faire*, quels sous-éléments s'animent, ce que chaque entrée accepte, où ses
bornes se posent, se compose dans le symbole lui-même, pas dans ce volet. Le format de fichier et
son vocabulaire sont documentés dans [Symboles SVG portables](ganter-symbols).

## Contenu {#content}

Le volet s'ouvre sur ce qu'est cette instance : un aperçu, le nom du symbole et son origine
(`<library> · <category>`). **Changer de symbole…** ouvre la bibliothèque pour échanger le dessin ;
seul le dessin change, la position, la taille, l'orientation et chaque tracé et chaque liaison que
le nouveau symbole déclare encore restent tels quels. Un symbole qui ne déclare aucune entrée
dynamique le dit ici.

## Données : les entrées du symbole {#data-the-symbols-inputs}

Chaque entrée que le symbole déclare apparaît comme un champ, légendé par ce qu'elle accepte, la
catégorie de valeur et, là où la déclaration borne l'entrée, la plage, par exemple
`décimal · de 0 à 100`, `booléen`, `couleur`, `texte`. La même catégorie filtre les propositions
d'adresse, si bien que ce que le champ dit et ce qu'il propose ne peuvent pas se contredire.

Chaque entrée porte un choix de source explicite, si bien qu'une seule des deux est en vigueur à la
fois ; la source est la décision de l'opérateur, jamais une supposition tirée du champ qui se trouve
contenir du texte :

| Source | Ce que le champ accepte |
|---|---|
| Adresse | Une adresse Logic enracinée de la catégorie déclarée. Une fois nommée, la lecture actuelle du point apparaît sous le champ ; une couleur arrive peinte à côté de son hexadécimal, puisque le littéral ne dit rien de la peinture qu'il représente. |
| Valeur fixe | Une constante, tapée selon les termes propres à la déclaration : un champ de nombre avec les bornes déclarées, un interrupteur vrai/faux, un sélecteur de couleur (une valeur hexadécimale, un nom de couleur CSS ou un jeton `var(--color-…)`), ou du texte simple. |

Une valeur fixe que l'entrée refuse, un nombre hors de la plage déclarée, une peinture que
l'assainissement rejette, reste à l'écran avec la raison à côté d'elle au lieu de revenir en arrière
en silence ; rien n'est enregistré tant que la saisie n'est pas une saisie que le symbole accepte.
Une saisie vide est une source dont la valeur n'est pas encore posée : l'entrée reste neutre,
exactement comme une adresse vide. Une mauvaise qualité sur un point lié se lit comme un échantillon
inutilisable : l'entrée n'applique rien, et cet élément garde son état d'origine plutôt que de
s'animer sur une valeur que personne n'a mesurée.

## Tracés {#connections}

Montré seulement pour les symboles qui déclarent des bornes. La section liste :

- **Les configurations de type** : là où le symbole partage un seul type de tracé entre plusieurs
  bornes (un fluide de procédé, par exemple), chaque configuration est une liste déroulante sur ses
  types autorisés, et le choix est partagé par chaque borne qui l'emploie. Changer le choix
  entraîne le tracé avec lui : un point de raccordement qui avait le type précédent de la borne
  prend le nouveau, tandis qu'un point mis dans un autre type garde le sien.
- **Bornes** : un relevé en lecture seule des bornes du symbole : ancrage, rôle
  (entrée, sortie, bidirectionnelle) et type résolu. Il répond à « à quoi ce symbole peut-il être
  raccordé » sans quitter le volet ; l'état libre ou occupé reste sur les marqueurs du plan de
  travail, là où se fait le geste de raccordement.

## Sens {#orientation}

Le sens dans lequel le dessin regarde est la seule apparence qu'un Symbole possède et qu'aucun autre
genre n'a. La taille à laquelle il est dessiné ne se demande pas ici : c'est l'échelle du contenu
partagée, dans la section Apparence.

| Propriété | Ce qu'elle fait | Valeurs | Par défaut |
|---|---|---|---|
| Angle de rotation | Rotation horaire du dessin, en quarts de tour. | 0° · 90° · 180° · 270° | 0° |
| Retourner horizontalement | Retourne le dessin autour de son axe vertical. | activé / désactivé | désactivé |
| Retourner verticalement | Retourne le dessin autour de son axe horizontal. | activé / désactivé | désactivé |