# LED de estado

> Uma lâmpada, ou o estado escrito por extenso, sobre um ponto booleano, um alarme ou um ponto que relata um código de estado.

**LED de estado** é o indicador de relance: um ponto mostrado como uma lâmpada colorida, ou
como o nome do estado escrito nas palavras do próprio integrador. É um componente de
*Exibição*; um novo ocupa 3 × 1 células. A indicação toma a célula inteira, centralizada;
nomeá-la é um [Rótulo](component-label) que você põe onde quiser.

Vinculado a um ponto comum, o LED lê a veracidade dele. Vinculado a um alarme
(`Alarms.<name>`), o valor lido é o estado *ativo* do alarme, e o LED **pisca** enquanto o
alarme espera reconhecimento, tanto enquanto está ativo sem reconhecer quanto durante a
retenção do normalizado sem reconhecer.

## Dados {#data}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Endereço | O endereço com raiz, na Logic, do ponto observado: um ponto booleano, `Alarms.<name>`, ou, uma vez declarados os estados, o ponto que relata o código de estado. A lista de sugestões é encabeçada por pontos booleanos. | Texto livre; sugestões da lista de pontos ao vivo | vazio |

## Estado {#state}

A seção pergunta sobre os dois lados de um sinalizador *ou* sobre uma lista declarada de
estados, nunca as duas coisas: uma das duas está em vigor, e o painel mostra só aquela.

### Os dois lados de um sinalizador {#the-two-sides-of-a-flag}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Mostra | Os dois desenhos que este tipo tem: uma lâmpada colorida, ou a redação declarada do estado na cor dela. | `Uma lâmpada` · `O estado, escrito por extenso` | `Uma lâmpada` |
| Ligado | A cor nomeada da paleta enquanto o ponto lê verdadeiro. | `Verde` · `Vermelho` · `Amarelo` · `Laranja` · `Azul` · `Cinza` | `Verde` |
| Desligado | A cor enquanto o ponto lê falso. | a mesma paleta | `Cinza` |
| Texto de ligado / Texto de desligado | O que a apresentação por extenso diz para cada lado. Explícito porque os dois lados de um estado são o seu vocabulário, "Running", "Open", "Auto", e nenhum componente consegue adivinhar que par um sinalizador representa. Pedido só pela apresentação que os escreve. | Texto livre | `On` / `Off` |

A paleta de cores é o conjunto fixo do próprio LED, pintado igual nos seletores do editor e
no canvas; `Cinza` é o neutro. O que uma cor *significa* é a sua convenção: o componente não
lê nenhuma. A tela grava um código para cada uma das seis e o seletor a nomeia no idioma da
interface, de modo que uma tela feita numa estação lê a mesma lâmpada em outra, seja qual for o
idioma daquela.

### Estados declarados {#declared-states}

Um ponto que relata um código (parado, iniciando, em execução, em falha) tem mais de dois
lados. **Declarar estados** grava os dois lados acima como os dois primeiros estados e abre
uma linha para preencher, para que nada já configurado seja escrito duas vezes. Cada estado é
um cartão:

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| valor | O código que o ponto relata enquanto a planta está neste estado. Casado exatamente: o que fica entre dois códigos não é um estado. Um sinalizador relata 1 para o lado verdadeiro e 0 para o outro. | Qualquer número | vazio (não declara nada até ser digitado) |
| cor | A cor de paleta do estado. | a mesma paleta fixa | `Cinza` |
| texto | O que a apresentação por extenso diz enquanto este estado está em vigor; em branco não escreve nada. A palavra declarada mais larga é aquela para a qual o estado escrito reserva espaço, então a palavra mantém um tamanho só conforme a planta anda entre estados. | Texto livre | vazio |
| ícone | Marca opcional desenhada *no lugar da lâmpada* enquanto este estado está em vigor, escolhida na biblioteca de ícones do aplicativo pelo nome, com busca por nome ou palavra-chave. Só a apresentação em lâmpada pede uma; um nome que o catálogo não tem não desenha marca e deixa a lâmpada. O `—` na grade é a escolha de nenhum ícone. | Nome de ícone do catálogo | nenhum |

As linhas se ordenam pelos códigos delas, então a lista lida de cima para baixo é a palavra
do estado contando para cima, e uma linha ainda sem código espera no fim. Remover todos os
estados devolve o indicador aos dois lados de um sinalizador. Um valor que estado nenhum
reivindica é mostrado como chegou, nunca como o estado mais próximo.

## O que o indicador mostra {#what-the-indicator-shows}

A lâmpada e o estado escrito respondem às mesmas três situações, cada um no vocabulário dele:

| Situação | Lâmpada | Por extenso |
|---|---|---|
| Um estado (ou lado de sinalizador) está em vigor | Lâmpada sólida na cor do estado; o ícone do estado substitui a lâmpada quando um é nomeado; a dica carrega a palavra do estado | A palavra do estado, na cor do estado |
| O ponto respondeu, mas nenhum estado declarado reivindica a leitura | Um anel neutro sólido, não a cor de um estado, que reivindicaria um estado que a declaração não tem | A própria leitura, escrita por extenso (o número do jeito que a estação escreve um, ou a resposta bruta para um ponto não numérico) |
| O ponto não consegue ler | Uma lâmpada vazada | O traço de lacuna `—` |

Só a terceira situação acende a marca compartilhada de leitura ruim no componente (veja a
[página de componentes](components#addresses-and-live-readings)); um silêncio de qualidade
boa vaza a lâmpada sem marcar o componente. Só um LED visível (legível) pisca.

O estado escrito nunca é desenhado sobre o título de canto nem cortado pela célula. As
palavras dele ficam no piso de legibilidade numa célula baixa, então onde a célula é baixa demais
para o título de canto e o estado escrito juntos, o título cede a linha dele, como sobre um
comando, e o estado toma a célula inteira. A lâmpada e o ícone de um estado são marcas e não
escrita: eles encolhem ao espaço sob o título, e o título fica.

O LED de estado é um componente de exibição: ele não comanda nada e nunca ganha a marca de
trava. As seções compartilhadas Aparência, Identificação, Posição e camada e Ações estão descritas na
[página de componentes](components#the-shared-property-sections).