# Immagini

> La libreria Immagini: importare file PNG e JPG e che cosa viene rifiutato, la griglia di schede e il suo ispettore, rinominare un'immagine con i suoi riferimenti, l'eliminazione, dove si usa un'immagine e da dove viene il logo predefinito del rapporto.

**Images** è la prima categoria sotto la radice Assets: le figure che la stazione possiede, importate dai file scelti dall'operatore, più le quattro immagini che il prodotto semina (il marchio e il logo Ganter Lab, ciascuno su chiaro e su scuro). Il pannello è intitolato « Immagini », con la riga « Immagini importate per i componenti immagine della dashboard e i layout del rapporto. » e la pillola di conteggio (« 4 immagini »). Per leggerlo serve **Visualizzare Logic**; importare, rinominare ed eliminare richiedono **Configurare Logic**.

## Importa immagine… {#import-image}

Il verbo sopra la riga Images è un selettore di file (Importa immagine…): apre la finestra di dialogo dei file del browser, funziona allo stesso modo dalla finestra della stazione e da un browser remoto, e legge il file dove si trova l'operatore. La libreria accetta:

| Regola | Che cosa viene rifiutato |
| --- | --- |
| Estensione `.png`, `.jpg` o `.jpeg` | Qualunque altra: « '.gif' non è un tipo di immagine supportato. Usare PNG o JPG. » |
| Contenuto che è un PNG intero o un JPEG intero | Un HEIC, un PDF o una pagina web rinominati, oppure un file troncato mentre veniva copiato, rifiutati con lo stesso messaggio |
| Al massimo 16 MB | « L'immagine supera il limite di 16 MB. », rifiutata sulla dimensione dichiarata dal browser, prima che i byte viaggino |

I byte vengono copiati nella cartella delle risorse dell'applicazione con un nome di file opaco, così la figura sopravvive allo spostamento o all'eliminazione del file di origine. Il nome nella libreria è quello del file senza estensione; una volta ripulito deve dare un segmento che nessun'altra immagine usa. Al buon esito la nuova scheda viene selezionata, il suo ispettore si apre, il conteggio nell'albero cresce e il registro delle azioni dice « Immagine importata. »; un rifiuto dice « Importazione non riuscita: … ».

## Il catalogo {#the-catalog}

Le schede mostrano la miniatura, il nome e l'origine (**Sistema** per un'immagine del prodotto, **Mie** per una importata). Filtri: **Origine** e **Per pagina**; una libreria vuota dice « Nessuna immagine. Usare Importa immagine… nella barra dei comandi per aggiungerne una. », un filtro vuoto « Nessuna immagine corrisponde a questo filtro. » con **Azzera il filtro**. Il resto della griglia e la paginazione si comportano come in ogni [libreria](logic-assets#the-shape-every-library-shares).

## L'ispettore {#the-inspector}

Selezionare una scheda mostra la figura in grande, il suo nome e:

| Riga | Che cosa mostra |
| --- | --- |
| Indirizzo | `Assets.Images.<segment>`: l'indirizzo che una variabile con uscita Immagine restituisce per questa figura |
| Origine | Libreria del prodotto, oppure La mia libreria |
| Tipo | PNG o JPG, dall'estensione del file |
| Dimensioni | La dimensione in pixel della figura, misurata quando viene mostrata (« 1280 × 720 pixel »), un trattino fino ad allora |
| Dimensione del file | La dimensione su disco (B, KB o MB), un trattino quando il file manca |

Un'immagine di Sistema mostra « Le immagini di sistema sono di sola lettura. » Un'immagine Mie offre, a un ruolo che ha Configurare Logic, **Modifica** ed **Elimina**; tutti e due restano grigi mentre la stazione è bloccata o mentre un comando della libreria è in corso.

## Modifica {#edit}

Modifica apre « Modifica `<name>` » al posto della griglia (« Rinominare la risorsa immagine stabile e, se serve, aggiornarne i riferimenti. »): la figura e un campo **Nome** che è un campo di ridenominazione come quello di una [variabile](logic-variables#name-and-address). Mentre scrivi, una riga anticipa l'effetto (« La rinomina aggiorna i 2 punti che leggono questo indirizzo. », « Nessun riferimento usa l'indirizzo attuale. », oppure « L'indirizzo effettivo non cambia; nessun riferimento deve essere aggiornato. » quando il nuovo nome dà lo stesso segmento). Invio, o uscire dal campo, conferma (« Una rinomina valida viene salvata premendo Invio o quando il campo perde il fuoco. »): l'immagine conserva il suo id e il suo file, ogni riferimento radicato al vecchio indirizzo viene riscritto e il registro delle azioni dice « Immagine rinominata e N riferimenti aggiornati. » Un nome già preso viene rifiutato lì sotto il campo. **Indietro** riporta al catalogo. Rinominare un'immagine passa dalla stessa riscrittura dei riferimenti di quando si rinomina un'icona o un colore.

## Il logo del rapporto {#the-report-logo}

Un [layout del rapporto](process-reports) disegna come logo l'immagine di questa libreria che indica. Un layout che non ne indica nessuna disegna il logo aziendale del [marchio](settings-branding) della stazione, che non è un'immagine di questa libreria: la libreria non ha un logo proprio da scegliere. Su una stazione aggiornata da una versione che segnava un'immagine come logo dell'organizzazione, ogni layout che non indicava un'immagine è stato impostato per indicare quell'immagine, così ogni rapporto stampa lo stesso logo di prima, e l'immagine resta qui.

## Elimina {#delete}

**Elimina** chiede « Eliminare 'X'? I riferimenti a essa degradano a un segnaposto. L'operazione non è reversibile. » e poi rimuove la riga e il file; un componente immagine di una dashboard o un rapporto che la nomina non disegnano nulla al suo posto. Il registro delle azioni dice « Immagine eliminata. » Un'immagine di Sistema non si può eliminare.

## Dove si usa un'immagine {#where-an-image-is-used}

Il componente di dashboard [Immagine](component-image) disegna un'immagine di questa libreria, o quella che nomina o quella che restituisce una [variabile](logic-variables#output-types) con uscita Immagine (`Assets.Images.<name>` si risolve nell'id della risorsa); un layout del rapporto disegna come logo l'immagine che indica. Nient'altro legge la cartella: le immagini non sono icone, non si possono collegare come simboli e non vengono servite ai client OPC UA esterni.

## Che cosa non fa la libreria {#what-the-library-does-not-do}

Non ridimensiona, non ritaglia e non converte una figura, non accetta SVG, GIF, BMP o WebP, non organizza le immagini in cartelle e non sostituisce i byte di un'immagine sul posto: importa il nuovo file e ripunta ciò che usava il vecchio.