# Imágenes

> La biblioteca de Imágenes: importar archivos PNG y JPG y lo que se rechaza, la rejilla de tarjetas y su inspector, renombrar una imagen con sus referencias, eliminar, dónde se usa una imagen, y de dónde viene el logotipo predeterminado del informe.

**Images** es la primera categoría bajo la raíz Assets: las imágenes que posee la estación, importadas de archivos que usted elige, más las cuatro imágenes que siembra el producto (la marca y el logotipo de Ganter Lab, cada uno en claro y en oscuro). El panel se encabeza "Imágenes", con la línea "Imágenes importadas para los componentes de imagen de los paneles de control y para cada diseño del informe." y la insignia del recuento ("4 imágenes"). Leerla necesita **Ver Logic**; importar, renombrar y eliminar necesitan **Configurar Logic**.

## Importar imagen… {#import-image}

El verbo sobre la fila Images es un selector de archivos (Importar imagen…): abre el propio diálogo de archivos del navegador, funciona igual desde la ventana de la estación y desde un navegador remoto, y lee el archivo donde usted esté. La biblioteca acepta:

| Regla | Qué se rechaza |
| --- | --- |
| Extensión `.png`, `.jpg` o `.jpeg` | Cualquier otra cosa: "'.gif' no es un tipo de imagen admitido. Use PNG o JPG." |
| Contenido que es un PNG entero o un JPEG entero | Un HEIC, un PDF o una página web renombrados, o un archivo cortado a medio copiar, rechazados con el mismo mensaje |
| 16 MB como mucho | "La imagen supera el límite de 16 MB.", rechazada por el tamaño que declara el navegador, antes de que viajen los bytes |

Los bytes se copian a la carpeta de recursos propia de la aplicación bajo un nombre de archivo opaco, así que la imagen sobrevive a que el archivo de origen se mueva o se elimine. El nombre en la biblioteca es el nombre del archivo sin su extensión; tiene que sanearse hasta un segmento que ninguna otra imagen use. Si sale bien, la tarjeta nueva queda seleccionada, su inspector se abre, el recuento del árbol crece y el registro de acciones dice "Imagen importada."; una negativa dice "Error al importar: …".

## El catálogo {#the-catalog}

Las tarjetas muestran la miniatura, el nombre y el origen (**Sistema** en una imagen del producto, **Míos** en una importada). Filtros: **Origen** y **Por página**; una biblioteca vacía dice "Todavía no hay imágenes. Use Importar imagen… en la barra de tareas para añadir una.", y un filtro vacío "Ninguna imagen coincide con este filtro." con **Borrar el filtro**. El resto de la rejilla y de la paginación se comportan como en todas las [bibliotecas](logic-assets#the-shape-every-library-shares).

## El inspector {#the-inspector}

Seleccionar una tarjeta muestra la imagen en grande, su nombre y:

| Fila | Qué muestra |
| --- | --- |
| Dirección | `Assets.Images.<segment>`: la dirección que devuelve para esta imagen una variable con salida de imagen |
| Origen | Biblioteca del producto, o Mi biblioteca |
| Tipo | PNG o JPG, según la extensión del archivo |
| Dimensiones | El tamaño en píxeles de la imagen, medido al mostrarla ("1280 × 720 píxeles"), y un guion hasta entonces |
| Tamaño del archivo | El tamaño en disco (B, KB o MB), y un guion cuando el archivo falta |

Una imagen de Sistema muestra "Las imágenes del sistema son de solo lectura." Una imagen de Míos ofrece, a un rol con Configurar Logic, **Editar** y **Eliminar**; las dos se ponen en gris mientras la estación está bloqueada o corre un comando de la biblioteca.

## Editar {#edit}

Editar abre "Editar `<name>`" en lugar de la rejilla ("Renombre el recurso de imagen estable y, si quiere, actualice sus referencias."): la imagen y un campo **Nombre** que es un campo de cambio de nombre como el de una [variable](logic-variables#name-and-address). Mientras se escribe, una línea previsualiza el impacto ("Al renombrar se actualizan los 2 lugares que leen esta dirección.", "Ninguna referencia usa la dirección actual." o "La dirección efectiva no cambia; no hay referencias que actualizar." cuando el nombre nuevo se sanea hasta el mismo segmento). Intro, o salir del campo, lo confirma ("Un renombrado válido se guarda al pulsar Intro o al salir del campo."): la imagen conserva su id y su archivo, todas las referencias enraizadas a la dirección antigua se reescriben, y el registro de acciones dice "Imagen renombrada y N referencias actualizadas." Un nombre ya ocupado se rechaza en el sitio, bajo el campo. **Atrás** vuelve al catálogo. Cambiar el nombre de una imagen pasa por la misma reescritura de referencias que cambiar el de un icono o el de un color.

## El logotipo del informe {#the-report-logo}

Un [diseño del informe](process-reports) dibuja como logotipo la imagen de esta biblioteca que nombra. Un diseño que no nombra ninguna dibuja el Logotipo de la [marca](settings-branding) de la estación, que no es una imagen de esta biblioteca: la biblioteca no tiene logotipo propio que elegir. En una estación actualizada desde una versión que marcaba una imagen como logotipo de la organización, cada diseño que no nombraba imagen pasó a nombrar esa imagen, así que cada informe imprime el mismo logotipo que antes, y la imagen sigue aquí.

## Eliminar {#delete}

**Eliminar** pregunta "¿Eliminar 'X'? Las referencias a ella pasan a un marcador de posición. Esta acción no se puede deshacer." y luego quita la fila y el archivo; un componente Imagen de un panel de control o un informe que la nombre no dibujan nada en su lugar. El registro de acciones dice "Imagen eliminada." Una imagen de Sistema no se puede eliminar.

## Dónde se usa una imagen {#where-an-image-is-used}

El componente [Imagen](component-image) de los paneles de control dibuja una imagen de esta biblioteca, ya sea la que él nombra o la que devuelve una [variable](logic-variables#output-types) con salida de imagen (`Assets.Images.<name>` resuelve al id del recurso); un diseño del informe dibuja como logotipo la imagen que nombra. Nada más lee la carpeta: las imágenes no son iconos, no se pueden vincular como símbolos, y no se sirven a los clientes OPC UA externos.

## Lo que la biblioteca no hace {#what-the-library-does-not-do}

No redimensiona, ni recorta, ni convierte una imagen, no acepta SVG, GIF, BMP ni WebP, no organiza las imágenes en carpetas, y no sustituye en el sitio los bytes de una imagen: importe el archivo nuevo y vuelva a apuntar lo que usaba el antiguo.