Draw Rectangle

Dieser Funktionsblock zeichnet ein oder mehrere Rechtecke auf ein Eingangsbild. Jedes Rechteck kann je nach optionalem Status-Eingang grün oder rot gezeichnet werden. Nützlich zur Visualisierung von Erkennungsergebnissen, Hervorhebung von Interessensbereichen oder zur Annotation von Bildern für Inspektion und Protokollierung.

📥 Eingänge

• Image Any Quellbild, auf dem die Rechtecke gezeichnet werden (erforderlich).

• Rectangle Ein Rechteck oder eine Liste von Rechtecken. Jedes Rechteck ist definiert durch die obere linke und untere rechte Ecke im Format ((x0, y0), (x1, y1)) (erforderlich). Mehrere Rechtecke werden unterstützt.

• Status Optionales Boolean oder Liste von Booleans. True zeichnet grün, False zeichnet rot. Wird kein Status angegeben, werden Rechtecke standardmäßig grün gezeichnet. Bei mehreren Rechtecken kann eine passende Liste von Statuswerten übergeben werden.

📤 Ausgänge

• Image Any Eine Kopie des Eingangsbildes mit aufgemalten Rechtecken (das Originalbild bleibt unverändert).

🕹️ Steuerungen

Dieser Funktionsblock besitzt keine interaktiven Widgets; das Verhalten wird vollständig über die Eingangs-Sockets gesteuert.

🎨 Funktionen

• Zeichnet ein einzelnes oder mehrere Rechtecke mit klarer Farb-Codierung (grün/rot) für den Status.

• Akzeptiert entweder ein einzelnes Rechteck oder eine Liste von Rechtecken.

• Akzeptiert entweder einen einzelnen Status oder eine Liste von Statuswerten; fehlt der Status, ist der Standardwert True (grün).

• Gibt eine annotierte Kopie des Eingangsbildes zurück, sodass upstream Bilder unverändert bleiben.

• Verwendet eine gut sichtbare Linienstärke, geeignet für typische Bildgrößen bei Inspektionen.

📝 Nutzungshinweise

1. Gib ein Bild an den Eingang Image Any.

2. Gib ein Rechteck oder eine Liste von Rechtecken im Format ((x0, y0), (x1, y1)) an den Eingang Rectangle.

3. Optional: Gib ein Boolean oder eine Liste von Booleans an den Eingang Status, um die Farben zu steuern.

4. Lies das annotierte Bild vom Ausgang Image Any und verbinde es mit Viewern, Loggern oder weiteren Verarbeitungsblöcken.

📊 Bewertung

Beim Ausführen kopiert der Block das eingehende Bild, zeichnet jedes angegebene Rechteck — grün bei True, rot bei False (Standard: grün) — und gibt das annotierte Bild zurück. Einzelne Eingaben erzeugen ein einzelnes annotiertes Bild; bei Listenverarbeitungen werden die Rechtecke jeweils entsprechend gezeichnet.

💡 Tipps und Tricks

• Zur Visualisierung von Erkennungsergebnissen: Verbinde Bounding-Box-Ausgaben von Find Object oder Object Detection mit dem Eingang Rectangle und färbe optional über Status.

• Für getrackte Objekte: Verbinde Tracker-Ausgaben von Object_Detection_Tracker, um persistente Rechtecke mit IDs und Status anzuzeigen.

• Vorfilter: Verwende Image ROI Select, um Zeichnungen auf einen bestimmten Bildausschnitt zu beschränken.

• Filtere unerwünschte Erkennungen mit Rectangles in Rectangle, bevor du zeichnest.

• Wenn du Textbeschriftungen oder strukturierte Overlays brauchst, kombiniere mit Draw Detections, Draw Result On Image oder Write Text On Image.

• Schicke das annotierte Bild an Show Image zur schnellen Ansicht oder an Image Logger / Image Write, um annotierte Frames zu speichern.

🛠️ Fehlersuche

• Rechtecke nicht sichtbar: Prüfe die Reihenfolge der Koordinaten und ob die Koordinaten innerhalb der Bildgrenzen liegen ((x0, y0), (x1, y1)).

• Unerwartete Farben: Stelle sicher, dass der Status-Eingang zur Anzahl der Rechtecke passt oder übergib ein einzelnes Boolean, um die Farbe für alle Rechtecke einheitlich zu setzen.

• Überlappende Annotationen wirken unübersichtlich: Zeichne auf einen beschnittenen Bereich oder verwende weniger/länger anhaltende Rechtecke, z. B. durch Vorverarbeitung wie Find Object mit Flächenfilterung.

• Du benötigst Labels oder Zählwerte zusammen mit Rechtecken: Füge downstream Write Text On Image oder Draw Result On Image hinzu.