# Símbolo

> Referência do componente de dashboard Símbolo, um SVG industrial animado conduzido por pontos ao vivo, com as entradas, as ligações e a orientação dele.

O **Símbolo** coloca um desenho SVG industrial na tela, uma bomba, uma válvula, um tanque, e
conduz as entradas declaradas dele a partir de pontos ao vivo, de modo que a arte se anima com
a planta. É o único componente cuja identidade é escolhida antes da colocação: a entrada dele
na paleta abre a biblioteca de símbolos (o pacote de sistema embutido mais os símbolos que o
operador importou), e o que você escolher é o que cai no canvas. Um componente cuja referência
não pode ser resolvida desenha um marcador neutro em vez de uma peça de equipamento
arbitrária, com a razão na dica dele.

O que um símbolo *sabe fazer*, quais sub-elementos animam, o que cada entrada aceita, onde os
terminais dele ficam, é escrito no próprio símbolo, não neste painel. O formato de arquivo e o
vocabulário dele estão documentados em [Símbolos SVG portáteis](ganter-symbols).

## Conteúdo {#content}

O painel abre com o que esta instância é: uma prévia, o nome do símbolo e a origem dele
(`<biblioteca> · <categoria>`). **Trocar o símbolo…** abre a biblioteca para trocar o desenho;
só o desenho muda: a posição, o tamanho, a orientação e toda ligação e todo vínculo que o
símbolo novo ainda declara ficam como estão. Um símbolo que não declara entradas dinâmicas diz
isso aqui.

## Dados: as entradas do símbolo {#data-the-symbols-inputs}

Cada entrada que o símbolo declara aparece como um campo, legendado com o que ela aceita, a
categoria de valor e, onde a declaração limita a entrada, a faixa, por exemplo
`decimal · de 0 a 100`, `booleano`, `cor`, `texto`. A mesma categoria filtra as sugestões de
endereço, então o que o campo diz e o que ele oferece não podem discordar.

Toda entrada carrega uma escolha explícita de origem, para que exatamente uma das duas esteja
em vigor: a origem é decisão do operador, nunca um palpite sobre qual campo por acaso guarda
texto.

| Origem | O que o campo aceita |
|---|---|
| Endereço | Um endereço com raiz, na Logic, da categoria declarada. Uma vez nomeado, a leitura atual do ponto aparece sob o campo; uma cor chega pintada ao lado do hex dela, já que o literal não diz nada sobre a tinta que ele representa. |
| Valor fixo | Uma constante, digitada nos termos da própria declaração: um campo numérico com os limites declarados, uma chave de verdadeiro/falso, um seletor de cor (um valor hex, um nome de cor CSS ou um token `var(--color-…)`), ou texto simples. |

Um valor fixo que a entrada recusa, um número fora da faixa declarada, uma tinta que o
sanitizador rejeita, fica na tela com a razão ao lado em vez de voltar em silêncio; nada é
guardado até a entrada ser uma que o símbolo aceita. Uma entrada vazia é uma origem cujo valor
ainda não foi definido: a entrada fica neutra, exatamente como um endereço vazio. A qualidade
ruim num ponto vinculado se lê como uma amostra inutilizável: a entrada não aplica nada, e
aquele elemento mantém o estado escrito dele em vez de animar sobre um valor que ninguém mediu.

## Ligações {#connections}

Mostrada só para símbolos que declaram terminais. A seção lista:

- **Configurações de tipo**: onde o símbolo compartilha um tipo de ligação entre vários
  terminais (um fluido de processo, digamos), cada configuração é uma lista suspensa sobre os
  tipos permitidos dela, e a escolha é compartilhada por todo terminal que a usa. Trocar a
  escolha leva a ligação junto: um ponto de ligação que tinha o tipo anterior do terminal passa
  ao novo, enquanto um posto em outro tipo fica com o dele.
- **Terminais**: uma relação somente leitura dos terminais do símbolo: âncora, função
  (entrada, saída, bidirecional) e tipo resolvido. Ela responde "a que este símbolo pode ser
  ligado" sem sair do painel; o estado livre ou ocupado fica nos marcadores do canvas, onde
  está o gesto de ligar.

## Orientação {#orientation}

Para que lado o desenho aponta é a única aparência que um Símbolo tem e nenhum outro tipo tem.
Quão grande ele é desenhado não é perguntado aqui: isso é a escala de conteúdo compartilhada,
na seção Aparência.

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Rotação | Rotação da arte no sentido horário, em quartos de volta. | 0° · 90° · 180° · 270° | 0° |
| Espelhar na horizontal | Espelha a arte em torno do eixo vertical dela. | ligado / desligado | desligado |
| Espelhar na vertical | Espelha a arte em torno do eixo horizontal dela. | ligado / desligado | desligado |