> 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-date-on-image.md).

# Write Date On Image

Dieser Funktionsblock schreibt das aktuelle Datum und die Uhrzeit als Text in ein eingehendes Bild. Er bietet flexible Einstellungen für Schriftart, Größe, Position, Farbe und eine optionale Hintergrundfläche für bessere Lesbarkeit. Verwenden Sie diesen Block, wenn Sie zeitgestempelte Bilder für Protokollierung, Aufzeichnung oder visuelles Feedback benötigen.

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

`Image Any` — Das Bild, auf das der Datums-/Zeit-Overlay angewendet werden soll (beliebiges Farb-/Tiefenbild).

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

`Image Any` — Das Bild mit dem darauf geschriebenen Datum und der Zeit.

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

* `Font Scale` — Passt die relative Größe des Datums-/Zeittextes an. Der Wert skaliert automatisch mit der Bildgröße, sodass der Text proportional bleibt.
* `Horizontal Position` — Verschiebt den Text von links nach rechts auf dem Bild (normalisierter Schieberegler).
* `Vertical Position` — Verschiebt den Text von oben nach unten auf dem Bild (normalisierter Schieberegler).
* `Font Thickness` — Legt die Strichstärke des Textes fest.
* `Text Background` — Aktiviert/deaktiviert ein gefülltes Hintergrundrechteck hinter dem Text, um Kontrast und Lesbarkeit zu verbessern.
* `Font` — Wählen Sie den Schriftstil aus den verfügbaren Font-Optionen (z. B. Simplex, Duplex, Script).
* `Color` — Wählen Sie die Textfarbe aus einer vordefinierten Palette.

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

* Anpassbare, bildabhängige Schriftskalierung, sodass die Textgröße an verschiedene Auflösungen angepasst wird.
* Präzise Platzierung mit horizontalen und vertikalen normalisierten Schiebereglern.
* Mehrere Schriftstile und Farbvoreinstellungen zur schnellen Konfiguration.
* Optionale halbtransparente Hintergrundbox hinter dem Text für hohen Kontrast in unruhigen Szenen.
* Echtzeit-Vorschau bei Ausführung des Blocks, damit Sie Platzierung und Sichtbarkeit feinjustieren können.

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

1. Verbinden Sie einen Bildliefernden Block mit dem Eingang `Image Any`.
2. Stellen Sie `Font Scale`, `Horizontal Position` und `Vertical Position` ein, um den Zeitstempel an der gewünschten Stelle zu platzieren.
3. Wählen Sie `Font` und `Color`, die über Ihrem Bild gut sichtbar sind.
4. Aktivieren Sie optional `Text Background`, um die Lesbarkeit auf komplexen Hintergründen sicherzustellen.
5. Führen Sie den Flow aus; der Block liefert das Bild mit dem aktuellen Datum/Uhrzeit als Overlay.

Der geschriebene Zeitstempel verwendet ein kompaktes Datums‑Zeit‑Format (Datum und Zeit kombiniert), sodass er sich gut für Dateinamen und schnelle visuelle Überprüfungen eignet.

## 📊 Bewertung <a href="#evaluation" id="evaluation"></a>

Bei Ausführung überlagert der Block das angegebene Bild mit dem aktuellen Datum und der Uhrzeit und gibt das modifizierte Bild über seinen Ausgang zurück. Das Overlay wird bei jedem Lauf aktualisiert, um den aktuellen Zeitpunkt widerzuspiegeln.

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

* Zur Vorschau im Editor verbinden Sie die Ausgabe mit dem `Show Image`-Block.
* Wenn Sie viele zeitgestempelte Bilder speichern, kombinieren Sie diesen Block mit `Image Logger` oder `Image Write`, um die Bilder mit Overlay abzulegen.
* Für Videoaufnahmen leiten Sie die Ausgabe an `Record Video`, damit jede aufgezeichnete Frame den Zeitstempel enthält.
* Bei sehr großen Bildern empfiehlt es sich, vor diesem Block `Image Resize` zu verwenden, um die Renderzeit zu reduzieren und trotzdem lesbaren Text zu erhalten.
* Wenn Sie zusätzlich weitere Informationen (IDs, Zähler) überlagern möchten, kombinieren Sie diesen Block mit Blöcken, die Text oder Zahlen erzeugen, und führen mehrere Schreib-/Overlay-Schritte aus.

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

* Text außerhalb des Bildes: Passen Sie `Horizontal Position` und `Vertical Position` an, um den Text wieder ins Bild zu bringen.
* Text schlecht lesbar auf unruhigem Hintergrund: Aktivieren Sie `Text Background` oder wählen Sie eine kontrastreiche `Color`.
* Text zu klein oder zu groß: Justieren Sie `Font Scale` und/oder `Font Thickness`, bis die Lesbarkeit stimmt.
* Langsame Verarbeitung bei großen Bildern: Fügen Sie vor diesem Block einen `Image Resize`-Block ein, schreiben Sie den Zeitstempel auf das verkleinerte Bild oder skalieren Sie das Bild bei Bedarf danach wieder hoch.


---

# 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-date-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.