# Piloto de estado

> Un piloto, o el estado escrito con palabras, sobre un punto booleano, una alarma o un punto que informa de un código de estado.

**Piloto de estado** es el indicador de un vistazo: un punto mostrado como un piloto de color, o
como el nombre del estado escrito con las palabras del propio integrador. Es un componente de
*Visualización*; uno nuevo ocupa 3 × 1 celdas. La indicación ocupa la celda entera, centrada;
darle nombre es una [Etiqueta](component-label) que usted coloca donde quiera.

Vinculado a un punto corriente, el piloto lee su verdad. Vinculado a una alarma
(`Alarms.<nombre>`), el valor que se lee es el estado *activo* de la alarma, y el piloto **parpadea**
mientras la alarma espera un reconocimiento, tanto mientras está activa sin reconocer como durante
el enganche de restablecida pero sin reconocer.

## Datos {#data}

| Campo | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Dirección | La dirección de Logic con raíz del punto vigilado: un punto booleano, `Alarms.<nombre>`, o, una vez declarados los estados, el punto que informa del código de estado. La lista de sugerencias encabeza con puntos booleanos. | Texto libre; sugerencias de la lista de puntos en vivo | vacío |

## Estado {#state}

La sección pregunta por las dos caras de un booleano *o* por una lista declarada de estados, nunca
por las dos cosas: una de las dos está en vigor, y el panel muestra solo esa.

### Las dos caras de un booleano {#the-two-sides-of-a-flag}

| Campo | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Muestra | Los dos dibujos que tiene este tipo: un piloto de color, o el texto declarado del estado en su propio color. | `Un piloto` · `El estado, escrito con palabras` | `Un piloto` |
| Encendido | El color con nombre de la paleta mientras el punto lee verdadero. | `Verde` · `Rojo` · `Amarillo` · `Naranja` · `Azul` · `Gris` | `Verde` |
| Apagado | El color mientras el punto lee falso. | la misma paleta | `Gris` |
| Texto de activado / Texto de desactivado | Lo que dice la presentación escrita para cada cara. Explícito porque las dos caras de un estado son su vocabulario ("Running", "Open", "Auto") y ningún componente puede adivinar qué pareja representa un booleano. Se pide solo en la presentación que las escribe. | Texto libre | `On` / `Off` |

La paleta de colores es el conjunto fijo propio del Piloto, pintado igual en los selectores del
editor y en el lienzo; `Gris` es el neutro. Lo que un color *significa* es su convención: el
componente no lee ninguna. El sinóptico guarda un código de cada uno de los seis y el selector lo
nombra en el idioma de la interfaz, de modo que un sinóptico construido en una estación muestra el
mismo piloto en otra, sea cual sea el idioma de esa otra.

### Estados declarados {#declared-states}

Un punto que informa de un código (detenido, arrancando, en marcha, en fallo) tiene más de dos
caras. **Declarar estados** escribe las dos caras de arriba como los dos primeros estados y abre
una fila para rellenar, así que nada de lo ya configurado se escribe dos veces. Cada estado es una
tarjeta:

| Campo | Qué hace | Valores | Por defecto |
|---|---|---|---|
| valor | El código del que informa el punto mientras la planta está en este estado. Se compara exactamente: lo que queda entre dos códigos no es un estado. Un booleano informa de 1 en su cara verdadera y de 0 en la otra. | Cualquier número | vacío (no declara nada hasta que se escribe) |
| color | El color de la paleta del estado. | la misma paleta fija | `Gris` |
| texto | Lo que dice la presentación escrita mientras este estado está en vigor; en blanco no escribe nada. La palabra declarada más ancha es lo que reserva de sitio el estado escrito, así que la palabra conserva un mismo tamaño mientras la planta se mueve entre estados. | Texto libre | vacío |
| icono | Marca opcional dibujada *en lugar del piloto* mientras este estado está en vigor, elegida por nombre de la biblioteca de iconos de la aplicación, con búsqueda por nombre o etiqueta. Solo la presentación de piloto pide uno; un nombre que el catálogo no lleva no dibuja ninguna marca y deja el piloto. `—` en la rejilla es la elección de ningún icono. | Nombre de icono del catálogo | ninguno |

Las filas se ordenan solas por sus códigos (la lista leída de arriba abajo es la palabra de estado
contando hacia arriba) y una fila que todavía no tiene código espera al final. Quitar todos los
estados devuelve el indicador a las dos caras de un booleano. Un valor que ningún estado reclama se
muestra tal como llegó, nunca como el estado más cercano.

## Qué muestra el indicador {#what-the-indicator-shows}

El piloto y el estado escrito responden a las mismas tres situaciones, cada uno con su propio
vocabulario:

| Situación | Piloto | Escrito con palabras |
|---|---|---|
| Un estado (o una cara de un booleano) está en vigor | Piloto lleno en el color del estado; el icono del estado sustituye al piloto cuando se nombra uno; la información emergente lleva la palabra del estado | La palabra del estado, en el color del estado |
| El punto respondió, pero ningún estado declarado reclama la lectura | Un anillo neutro lleno, no el color de un estado, que reclamaría un estado que la declaración no tiene | La propia lectura, escrita (el número como escribe uno la estación, o la respuesta bruta en un punto no numérico) |
| El punto no consigue leer | Un piloto vacío | El guion de hueco `—` |

Solo la tercera situación enciende la marca compartida de mala lectura en el componente (véase la
[página de los componentes](components#addresses-and-live-readings)); un silencio de buena calidad
vacía el piloto sin marcar el componente. Solo parpadea un piloto visible (legible).

El estado escrito nunca se dibuja sobre el título de esquina ni lo recorta la celda. Sus
palabras se quedan en el mínimo de legibilidad en una celda baja, así que donde la celda es
demasiado baja para el título de esquina y el estado escrito juntos, el título cede su fila, como
sobre un componente de mando, y el estado ocupa la celda entera. El piloto y el icono de un estado
son marcas y no escritura: se encogen en cambio al espacio bajo el título, y el título se queda.

Piloto de estado es un componente de visualización: no gobierna nada y no lleva nunca la marca de
candado. Las secciones compartidas Apariencia, Identificación, Posición y capa y Acciones se describen en la
[página de los componentes](components#the-shared-property-sections).