# Imagem

> Uma imagem do usuário na tela, ajustada de quatro maneiras, opcionalmente trocada por uma variável Imagem.

**Imagem** mostra uma das figuras que você importou: a foto de uma máquina, um esquema da
planta, a marca da empresa. A figura é fixa ou conduzida por uma variável da Logic com saída
Imagem, de modo que o que está na tela pode seguir a planta (um diagrama diferente por
receita ativa, uma figura de estado por modo da máquina). É um componente de *Mídia*; um novo
ocupa 4 × 4 células.

As imagens são importadas em **Logic ▸ Assets ▸ Images**; o componente só escolhe daquela
biblioteca. Sem nada escolhido e sem nada vinculado, a célula diz "Sem imagem" em vez de
ficar vazia.

## Conteúdo {#content}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Imagem padrão | A figura fixa, e o recurso de reserva do editor enquanto uma variável está vinculada. `(nenhum)` mostra o texto de espera. Quando a biblioteca está vazia e nenhuma variável está vinculada, o painel diz onde importar uma. | `(nenhum)` ou um recurso de imagem | `(nenhum)` |

## Dados {#data}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Da variável Imagem | Um endereço com raiz de uma variável da Logic com saída Imagem. A lista nomeia cada uma pelo nome ou, arquivada numa pasta, pelas pastas e pelo nome (Oven / Door), e guarda o endereço com essas pastas (`Variables.Oven.Door`). Vinculado, o componente desenha o recurso em que a variável resolver no momento: a lógica de valor para imagem, e o padrão que ela exige, moram na variável (veja a [página da Logic](logic)). `(nenhum)` limpa o vínculo. | Uma variável Imagem, ou `(nenhum)` | `(nenhum)` |

Sob o campo, o painel confirma o vínculo com a própria figura, uma miniatura do recurso em que
a variável resolve agora, porque o id de um recurso não diz nada sobre a imagem que ele
representa.

Enquanto uma variável está vinculada, um ponto que não consegue ler (endereço não resolvido,
ou qualidade ruim) faz a figura cair para o texto de espera e ganha a marca compartilhada de
leitura ruim: o recurso velho que a variável guardou por último não pode ficar de pé na tela
como se fosse uma leitura.

## Encaixe {#fit}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Encaixe | Como a figura encontra a caixa que ela recebeu. Cada opção carrega uma prévia do resultado, porque os quatro nomes sozinhos não dizem nada que um operador consiga imaginar. | `Caber inteira`, mantida inteira nas proporções dela, encolhida o quanto for preciso para caber; nunca ampliada além do tamanho natural · `Preencher e cortar`, preenche a caixa, proporções mantidas, o excesso é cortado · `Esticar`, esticada exatamente até a caixa, proporções não mantidas · `Nenhum`, a figura no tamanho dela; uma maior que a caixa encolhe inteira, então hoje ela desenha igual à `Caber inteira` | `Caber inteira` |

A Imagem é um componente de exibição: ela 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).