> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/spanish/function-blocks/blocks-reference/data-logic/flow-control/hmi-background.md).

# HMI Background

Este bloque de función proporciona un amplio lienzo visual redimensionable pensado para crear diseños de Human-Machine Interface (HMI) dentro de tu escenario. Actúa como un gráfico de fondo donde puedes colocar y organizar bloques interactivos y elementos visuales para construir una interfaz tipo dashboard.

## 📥 Entradas <a href="#inputs" id="inputs"></a>

Este bloque no tiene entradas.

## 📤 Salidas <a href="#outputs" id="outputs"></a>

Este bloque no tiene salidas.

## 🕹️ Controles <a href="#controls" id="controls"></a>

`Resize` Ajusta el tamaño del bloque en el editor para acomodar el área de diseño de tu HMI.

`Background Canvas` Área visual donde dispones y previsualizas otros elementos y bloques HMI.

## 🎨 Características <a href="#features" id="features"></a>

* Fondo solo visual para diseñar pantallas HMI y dashboards.
* Lienzo redimensionable para crear interfaces compactas o amplias.
* Diseñado para alojar y organizar visualmente otros bloques y elementos de visualización (imágenes, texto, indicadores) para paneles de operador y demostraciones.
* Ligero: no procesa datos de imagen o sensores por sí mismo; existe para estructurar y presentar otros bloques.

## ⚙️ Mecanismo de ejecución <a href="#running-mechanism" id="running-mechanism"></a>

* Este bloque no genera datos ni realiza cálculos durante la ejecución del escenario.
* Su propósito es puramente gráfico y organizativo: úsalo para agrupar y posicionar visualmente bloques interactivos y de salida que sí generan datos cuando el escenario se ejecuta.
* Al ser solo visual, colocar elementos de procesamiento pesado dentro del mismo área visual no cambia el comportamiento del fondo: el procesamiento continúa realizándose en los bloques de función conectados.

## 📝 Uso <a href="#usage" id="usage"></a>

1. Añade el bloque `HMI Background` como lienzo para tu interfaz.
2. Redimensiona el bloque para que coincida con el área de pantalla que quieres diseñar.
3. Coloca bloques de visualización y control sobre el fondo para construir tu HMI (por ejemplo, `Show Image`, `Write Text On Image`, botones e indicadores).
4. Usa bloques estructurales para mantener la lógica detrás de la interfaz ordenada y reutilizable.

## 💡 Consejos y trucos <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Agrupa lógica y presentación: usa `Subsystem`, `Subsystem In` y `Subsystem Out` para mantener la lógica de procesamiento separada del diseño visual colocado en el fondo.
* Visualiza cámaras: combina con `Show Image` para mostrar frames de cámara en vivo en el lienzo HMI.
* Añade indicadores y etiquetas: usa `Write Text On Image` y `Led Output` para mostrar texto dinámico e indicadores booleanos sobre las imágenes mostradas.
* Proporciona controles al usuario: coloca `Logic Input`, `Number Input` o `String Input` cerca de las visualizaciones relacionadas para que los operarios interactúen con el escenario.
* Guarda evidencias y registros: usa `Image Logger` o `Record Video` (cuando estén disponibles) junto con las imágenes mostradas para archivar fotogramas importantes activados desde tu HMI.
* Mantén la UI responsiva: coloca solo bloques de visualización e entrada en el fondo. El procesamiento pesado (detección, segmentación, seguimiento) debe permanecer en bloques funcionales separados.

## 🛠️ Solución de problemas <a href="#troubleshooting" id="troubleshooting"></a>

* Fondo no visible o demasiado pequeño: intenta aumentar el tamaño del bloque con el control `Resize`.
* Diseño sobrecargado: usa bloques `Subsystem` para colapsar y ocultar lógica compleja manteniendo el lienzo HMI limpio.
* Editor lento al interactuar: elimina o reubica bloques de procesamiento pesado fuera del área visual inmediata; mantén el fondo centrado en presentación y control.