# Símbolo

> Referencia del componente Símbolo, un SVG industrial animado gobernado por puntos en vivo, con sus entradas, sus trazos y su orientación.

El **Símbolo** coloca en el sinóptico un dibujo SVG industrial (una bomba, una válvula, un
depósito) y gobierna sus entradas declaradas desde puntos en vivo, así que el arte se anima con la
planta. Es el único componente cuya identidad se elige antes de colocarlo: la entrada de la paleta
abre la biblioteca de símbolos (el paquete de sistema embebido más los símbolos propios importados
por el operador), y el que usted elija es lo que aterriza en el lienzo. Un componente cuya
referencia no se puede resolver dibuja un relleno neutro en lugar de un equipo cualquiera, con el
motivo en su información emergente.

Lo que un símbolo *puede hacer* (qué subelementos se animan, qué admite cada entrada, dónde están
sus bornes) se escribe en el propio símbolo, no en este panel. El formato de archivo y su
vocabulario están documentados en [Símbolos SVG portátiles](ganter-symbols).

## Contenido {#content}

El panel abre con lo que es esta instancia: una vista previa, el nombre del símbolo y su origen
(`<biblioteca> · <categoría>`). **Cambiar el símbolo…** abre la biblioteca para intercambiar el
dibujo; solo cambia el dibujo: la posición, el tamaño, la orientación y todos los trazos y vínculos
que el símbolo nuevo sigue declarando se quedan como están. Un símbolo que no declara ninguna
entrada dinámica lo dice aquí.

## Datos: las entradas del símbolo {#data-the-symbols-inputs}

Cada entrada que declara el símbolo aparece como un campo, rotulado con lo que admite: la categoría
del valor y, donde la declaración acota la entrada, el intervalo, por ejemplo
`decimal · de 0 a 100`, `booleano`, `color`, `texto`. La misma categoría filtra las sugerencias de
dirección, así que lo que dice el campo y lo que ofrece no se pueden contradecir.

Todas las entradas llevan una elección explícita de origen, así que exactamente uno de los dos está
en vigor en cada momento: el origen es la decisión del operador, nunca una conjetura sobre qué
campo resulta contener texto:

| Origen | Qué admite el campo |
|---|---|
| Dirección | Una dirección de Logic con raíz de la categoría declarada. Una vez nombrada, la lectura actual del punto se muestra bajo el campo: un color llega pintado junto a su hexadecimal, ya que el literal no dice nada sobre la pintura que representa. |
| Valor fijo | Una constante, escrita en los términos propios de la declaración: un campo de número con los límites declarados, un interruptor de verdadero o falso, un selector de color (un valor hexadecimal, un nombre de color de CSS o un testigo `var(--color-…)`), o texto a secas. |

Un valor fijo que la entrada rechaza (un número fuera del intervalo declarado, una pintura que el
saneador rechaza) se queda en pantalla con el motivo al lado en lugar de volver atrás en silencio;
no se guarda nada hasta que la entrada es una que el símbolo acepta. Una entrada vacía es un origen
cuyo valor todavía no está puesto: la entrada se queda neutra, exactamente igual que una dirección
vacía. La mala calidad en un punto vinculado se lee como una muestra inservible: la entrada no
aplica nada, y ese elemento conserva su estado escrito en lugar de animarse con un valor que nadie
midió.

## Trazos {#connections}

Se muestra solo en los símbolos que declaran bornes. La sección enumera:

- **Configuraciones de tipo**: donde el símbolo comparte un tipo de trazo entre varios bornes (un
  fluido de proceso, por ejemplo), cada configuración es una lista desplegable sobre sus tipos
  permitidos, y la elección la comparten todos los bornes que la usan. Cambiar la elección
  arrastra el trazo consigo: un punto de conexión que tenía el tipo anterior del borne pasa al
  nuevo, mientras que uno al que se dio otro tipo conserva el suyo.
- **Bornes**: una relación de solo lectura de los bornes del símbolo: anclaje, rol
  (entrada, salida, bidireccional) y tipo resuelto. Responde a "a qué se puede cablear este
  símbolo" sin salir del panel; el estado de libre u ocupado se queda en los marcadores del lienzo,
  que es donde está el gesto de cableado.

## Orientación {#orientation}

Hacia dónde mira el dibujo es la única apariencia que tiene un Símbolo y que no tiene ningún otro
tipo. Lo grande que se dibuja no se pregunta aquí: eso es la escala del contenido compartida, en la
sección Apariencia.

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Rotación | La rotación del arte en sentido horario, en cuartos de vuelta. | 0° · 90° · 180° · 270° | 0° |
| Voltear en horizontal | Refleja el arte alrededor de su eje vertical. | activado / desactivado | desactivado |
| Voltear en vertical | Refleja el arte alrededor de su eje horizontal. | activado / desactivado | desactivado |