> 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/german/function-blocks/data-logic/flow-control/hmi-background.md).

# HMI Background

Dieser Funktionsblock bietet eine große, skalierbare visuelle Leinwand, die zum Erstellen von Human‑Machine‑Interface‑(HMI)‑Layouts innerhalb Ihres Szenarios gedacht ist. Er fungiert als Hintergrundgrafik, auf der Sie interaktive Blöcke und visuelle Elemente platzieren und organisieren können, um eine dashboardartige Oberfläche zu erstellen.

## 📥 Eingänge <a href="#inputs" id="inputs"></a>

Dieser Block hat keine Eingänge.

## 📤 Ausgänge <a href="#outputs" id="outputs"></a>

Dieser Block hat keine Ausgänge.

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

* `Resize`\
  Passen Sie die Blockgröße im Editor an, um den gewünschten HMI‑Layoutbereich zu erhalten.
* `Background Canvas`\
  Der visuelle Bereich, in dem Sie andere HMI‑Elemente und visuelle Blöcke anordnen und Vorschauen anzeigen.

## 🎨 Funktionen <a href="#features" id="features"></a>

* Nur visuelle Hintergrundfläche zum Gestalten von HMI‑Bildschirmen und Dashboards.
* Skalierbare Leinwand, damit Sie kompakte oder großzügige Oberflächen entwerfen können.
* Zur Aufnahme und visuellen Organisation anderer Blöcke und Anzeigeelemente (Bilder, Text, Indikatoren) für Bedienpanels und Demos gedacht.
* Leichtgewichtig: verarbeitet selbst keine Bilder- oder Sensordaten; dient zur Strukturierung und Präsentation anderer Blöcke.

## ⚙️ Funktionsweise beim Ausführen <a href="#running-mechanism" id="running-mechanism"></a>

* Dieser Block erzeugt während der Szenarioausführung keine Daten und führt keine Berechnungen durch.
* Sein Zweck ist rein grafisch und organisatorisch: Verwenden Sie ihn, um interaktive und Ausgabe‑Blöcke visuell zu gruppieren und zu positionieren, die bei Laufzeit Daten erzeugen.
* Da er rein visuell ist, beeinflusst das Platzieren rechenintensiver Elemente im selben Bereich nicht das Verhalten des Hintergrunds — die Verarbeitung erfolgt weiterhin in den verbundenen Funktionsblöcken.

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

1. Fügen Sie den `HMI Background`‑Block als Leinwand für Ihre Oberfläche hinzu.
2. Ändern Sie die Größe des Blocks, um dem gewünschten Bildschirmbereich zu entsprechen.
3. Platzieren Sie Anzeige‑ und Steuerblöcke über dem Hintergrund, um Ihr HMI‑Layout zu erstellen (z. B. Bildbetrachter, Textüberlagerungen, Buttons und Statusanzeigen).
4. Verwenden Sie Strukturblöcke, um die Logik hinter der Oberfläche ordentlich und wiederverwendbar zu halten.

## 💡 Tipps und Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Gruppieren Sie Logik und Darstellung: Nutzen Sie `Subsystem`, `Subsystem In` und `Subsystem Out`, um die Verarbeitungslogik von der visuellen Darstellung auf dem Hintergrund zu trennen.
* Kamerabilder visualisieren: Kombinieren Sie mit `Show Image`, um Live‑Kamerabilder auf der HMI‑Leinwand anzuzeigen.
* Statusanzeigen und Beschriftungen hinzufügen: Verwenden Sie `Write Text On Image` und `Led Output`, um dynamischen Text und boolesche Statusindikatoren über angezeigten Bildern darzustellen.
* Bedienelemente bereitstellen: Platzieren Sie `Logic Input`, `Number Input` oder `String Input` in der Nähe der zugehörigen Anzeigen, damit Bediener mit dem Szenario interagieren können.
* Beweise und Logs speichern: Nutzen Sie `Image Logger` oder `Record Video` (sofern verfügbar) zusammen mit angezeigten Bildern, um wichtige Frames von der HMI aus zu archivieren.
* UI reaktionsfähig halten: Platzieren Sie nur Visualisierungs‑ und Eingabeblöcke auf dem Hintergrund. Rechenintensive Verarbeitung (Erkennung, Segmentierung, Tracking) sollte in separaten Funktionsblöcken bleiben.

## 🛠️ Fehlersuche <a href="#troubleshooting" id="troubleshooting"></a>

* Hintergrund nicht sichtbar oder zu klein: Vergrößern Sie die Blockgröße mit der `Resize`‑Steuerung.
* Layout wirkt überladen: Nutzen Sie `Subsystem`‑Blöcke, um komplexe Logik zu komprimieren und die HMI‑Leinwand sauber zu halten.
* Langsame Interaktion im Editor: Entfernen oder verschieben Sie rechenintensive Blöcke aus dem direkten Sichtbereich; behalten Sie den Hintergrund für Präsentation und Steuerungselemente.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/german/function-blocks/data-logic/flow-control/hmi-background.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
