> 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/detections-shapes/draw/write-text-on-image.md).

# Write Text On Image

Dieser Funktionsblock fügt Bildern anpassbare Textüberlagerungen hinzu. Der Text wird relativ zur Bildgröße skaliert, lässt sich mit normalisierten Koordinaten positionieren und kann optional mit einem halbtransparenten Hintergrund für bessere Lesbarkeit versehen werden.

## 📥 Eingänge

* `Image Any` Akzeptiert das Bild, auf das der Text gezeichnet werden soll.
* `String` Optionaler Texteingang. Wenn leer gelassen, zeichnet der Block einen leeren String (kein sichtbarer Text).

## 📤 Ausgänge

* `Image Any` Das Bild mit der aufgebrachten Textüberlagerung.

## 🕹️ Steuerungen

* `Text Position Horizontal` Text nach links/rechts verschieben mit einem normalisierten Wert (0.0 = links, 1.0 = rechts).
* `Text Position Vertical` Text nach oben/unten verschieben mit einem normalisierten Wert (0.0 = oben, 1.0 = unten).
* `Font Scale` Gesamtgröße des Textes relativ zum Bild anpassen.
* `Font Thickness` Strichstärke des Textes einstellen.
* `Font` Schriftstil aus den verfügbaren Optionen wählen.
* `Color` Textfarbe auswählen.
* `Background Enabled` Einen halbtransparenten Hintergrundrahmen hinter dem Text aktivieren/deaktivieren, um den Kontrast zu erhöhen.

## 🎨 Funktionen

* Automatische Skalierung, sodass die Textgröße an verschiedene Bildauflösungen angepasst wird.
* Normalisierte Positionierung ermöglicht proportionales Platzieren unabhängig von der Bildgröße.
* Optionaler halbtransparenter Hintergrund verbessert die Lesbarkeit bei unruhigen Bildern.
* Funktioniert mit dynamischen Texteingaben, sodass z. B. IDs, Labels oder Sensordaten angezeigt werden können.

## 📊 Wie es läuft

Beim Ausführen liest der Block das eingehende Bild und die aktuellen Steuerungswerte, berechnet anhand der Bildmaße eine geeignete Schriftgröße und Position, zeichnet bei Bedarf das Hintergrundrechteck, rendert den Text mit gewählter Schrift, Farbe und Stärke und gibt das resultierende Bild für nachfolgende Blöcke aus.

## 📝 Nutzungshinweise

1. Verbinden Sie eine Bildquelle mit `Image Any`.
2. Geben Sie den gewünschten Text in `String` ein oder lassen Sie das Feld leer, um den internen Text zu verwenden.
3. Stellen Sie `Font`, `Color`, `Font Scale` und `Font Thickness` für das gewünschte Erscheinungsbild ein.
4. Platzieren Sie den Text mit `Text Position Horizontal` und `Text Position Vertical`.
5. Aktivieren Sie `Background Enabled`, wenn Sie bei komplexen Bildern einen höheren Kontrast benötigen.
6. Vorschau: Verbinden Sie den Ausgang mit einem Anzeige-Block wie `Show Image` oder speichern Sie das Ergebnis mit `Image Write` / `Image Logger`.

## 💡 Tipps und Tricks

* Um einen laufenden Zeitstempel zu stempeln, speisen Sie `String` mit dem `Date-Time`- oder `Date-Time List`-Block und formatieren ihn ggf. mit `String Merge`.
* Für Live-Vorschau während der Feinabstimmung verbinden Sie den Ausgang mit `Show Image`.
* Wenn Labels nur in einem bestimmten Bereich erscheinen sollen, schneiden Sie das Bild vorher mit `Image ROI` oder `Image ROI Select` zu und wenden Sie dann diesen Block an.
* Verwenden Sie `Image Resize`, wenn Sie eine konsistente Textgröße über Bilder mit stark variierender Auflösung erzielen möchten.
* Zum Speichern annotierter Frames `Image Logger` oder `Image Write` anschließen.
* Um Erkennungsergebnisse zu überlagern, kombinieren Sie diesen Block mit Erkennungsblöcken wie `Find Object` oder `Object Detection` und geben Sie erkannte Labels oder Zählwerte in `String` weiter.
* Für bedingte Statusanzeigen (z. B. OK / NOK) nutzen Sie logische Blöcke wie `Logic Input` oder Vergleichsblöcke und setzen den Text mit `String Merge` zusammen, bevor Sie ihn an diesen Block senden.

## 🛠️ Fehlersuche

* Text zu klein oder zu groß: `Font Scale` anpassen oder das Eingangsbild mit `Image Resize` skaliere, um konsistente Ergebnisse zu erzielen.
* Text schlecht lesbar auf unruhigem Hintergrund: `Background Enabled` aktivieren oder `Color` auf einen kontrastreichen Wert ändern.
* Position variiert bei verschiedenen Bildern: Stellen Sie sicher, dass Sie normalisierte Werte für `Text Position Horizontal` und `Text Position Vertical` verwenden und testen Sie die Platzierung mit einem repräsentativen Bild in `Show Image`.


---

# 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/detections-shapes/draw/write-text-on-image.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.