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.