# Piloto de estado

> Una lámpara, o el estado escrito, sobre un punto booleano, una alarma o un punto que informa un código de estado.

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

Vinculado a un punto simple, el piloto lee si es verdadero. Vinculado a una alarma
(`Alarms.<name>`), el valor que 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 estado memorizado de restablecida sin reconocer.

## Datos {#data}

| Campo | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Dirección | La dirección de Logic con raíz del punto vigilado: un punto booleano, `Alarms.<name>`, o, en cuanto hay estados declarados, el punto que informa el código de estado. La lista de sugerencias encabeza con puntos booleanos. | Texto libre; sugerencias de la lista viva de puntos | vacía |

## Estado {#state}

La sección pregunta por los dos lados de una bandera *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.

### Los dos lados de una bandera {#the-two-sides-of-a-flag}

| Campo | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Muestra | Los dos dibujos que tiene esta clase: una lámpara de color, o la redacción declarada 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 | Qué dice la presentación escrita en cada lado. Son explícitos porque los dos lados de un estado son su vocabulario ("Running", "Open", "Auto") y ningún componente puede adivinar qué par representa una bandera. Solo se le piden a la presentación que los escribe. | Texto libre | `On` / `Off` |

La paleta de colores es el juego fijo propio del piloto, pintado igual en los selectores del
editor y en el lienzo; `Gris` es el neutro. Lo que *significa* un color 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, para que un sinóptico armado en una estación muestre el mismo
piloto en otra, sea cual sea el idioma de esa otra.

### Estados declarados {#declared-states}

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

| Campo | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| valor | El código que informa el punto mientras la planta está en este estado. Se casa exactamente: lo que queda entre dos códigos no es un estado. Una bandera informa 1 en su lado verdadero y 0 en el otro. | Cualquier número | vacío (no declara nada hasta que se escribe) |
| color | El color de paleta del estado. | esa misma paleta fija | `Gris` |
| texto | Qué dice la presentación escrita mientras este estado está en vigor; en blanco no escribe nada. La palabra declarada más ancha es aquella para la que el estado escrito reserva lugar, así que la palabra conserva un solo tamaño mientras la planta se mueve entre estados. | Texto libre | vacío |
| icono | Marca opcional dibujada *en lugar de la lámpara* mientras este estado está en vigor, elegida por nombre de la biblioteca de iconos de la aplicación, buscada por nombre o etiqueta. Solo la presentación de lámpara pide uno; un nombre que el catálogo no trae no dibuja marca y deja la lámpara. El `—` de la cuadrícula 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 le regresa el indicador a los dos lados de una bandera. Un valor que ningún
estado reclama se muestra como llegó, nunca como el estado más cercano.

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

La lámpara y el estado escrito contestan las mismas tres situaciones, cada uno con su propio
vocabulario:

| Situación | Lámpara | Escrito |
|---|---|---|
| Hay un estado (o un lado de bandera) en vigor | Lámpara sólida en el color del estado; el icono del estado reemplaza la lámpara cuando hay uno nombrado; la información emergente lleva la palabra del estado | La palabra del estado, en el color del estado |
| El punto contestó, pero ningún estado declarado reclama la lectura | Un anillo neutro sólido, no el color de un estado, que reclamaría un estado que la declaración no tiene | La lectura misma, escrita (el número como lo escribe la estación, o la respuesta cruda en un punto no numérico) |
| El punto no logra leer | Una lámpara hueca | El guion de hueco `—` |

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

El estado escrito nunca se dibuja sobre el título de esquina ni lo corta 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 renglón,
como sobre un componente de mando, y el estado ocupa toda la celda. La lámpara y el icono de un
estado son marcas y no escritura: en cambio se encogen al espacio bajo el título, y el título se
queda.

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