For the complete documentation index, see llms.txt. This page is also available as Markdown.

Image ROI Select

Dieser Funktionsblock ermöglicht es Ihnen, interaktiv per Maus einen rechteckigen ROI (Region of Interest) im Bild auszuwählen, indem Sie im Bild-Preview ziehen. Er eignet sich ideal zum Zuschneiden eines Bildbereichs für weitere Verarbeitung oder Inspektion.

📥 Eingänge

Image Any Das Bild, das zugeschnitten werden soll. Verbinden Sie ein Graustufen- oder Farbbild, um den Bereich festzulegen, der ausgewählt werden kann.

📤 Ausgänge

Image Any Das zugeschnittene Bild, das dem ausgewählten Rechteck entspricht.

Rectangle Das Pixel-Rechteck, das den ausgewählten Bereich beschreibt (oben-links und unten-rechts Koordinaten).

🕹️ Steuerung

Image Preview Die interaktive Vorschau, in der Sie den rechteckigen ROI per Maus erstellen und bearbeiten.

Drag Erstellen Sie ein Rechteck durch Ziehen in der Vorschau, oder ziehen Sie innerhalb des Rechtecks, um es zu verschieben.

Edge / Corner Drag Ändern Sie die Größe des Rechtecks, indem Sie eine Kante oder Ecke ziehen.

Ctrl Halten Sie diese Taste gedrückt, um ein neues Rechteck zu erstellen, auch wenn bereits eines vorhanden ist.

🎯 Funktionen

  • Interaktive Rechteck-Erstellung, Verschiebung und Größenänderung direkt in der Bildvorschau.

  • Visuelle Überlagerung zeigt das aktuelle Rechteck und hebt es während der Interaktion hervor.

  • Akzeptiert einzelne oder wiederholte Auswahl; das zuletzt erstellte ROI wird für den Ausgang verwendet.

  • Das zugeschnittene Ergebnis wird sofort als Bild zusammen mit den Rechtecks-Koordinaten zurückgegeben.

  • Das ausgewählte Rechteck bleibt erhalten, sodass dasselbe ROI beim erneuten Laden des Projekts wiederhergestellt werden kann.

⚙️ Funktionsweise

  • Stellen Sie ein Bild an den Eingang Image Any bereit und führen Sie das Szenario einmal aus, damit das Bild in der Vorschau geladen wird.

  • Verwenden Sie die Vorschau, um per Drag ein Rechteck zu zeichnen. Ziehen Sie innerhalb des Rechtecks, um es zu verschieben, oder ziehen Sie an Kanten/Ecken, um die Größe zu ändern.

  • Der Block berechnet die Pixel-Koordinaten des ausgewählten Rechtecks und gibt aus:

    • das aus diesen Koordinaten extrahierte zugeschnittene Bild über Image Any

    • die Rechtecks-Koordinaten über Rectangle

  • Die Overlay-Vorschau wird während der Erstellung oder Bearbeitung des ROI live aktualisiert.

📝 Nutzungshinweise

  1. Verbinden Sie einen bildproduzierenden Block mit dem Eingang Image Any und führen Sie ihn einmal aus, damit die Vorschau gefüllt wird.

  2. Zeichnen Sie den ROI, indem Sie in der Vorschau klicken und ziehen.

  3. Verschieben oder skalieren Sie den ROI nach Bedarf.

  4. Halten Sie Ctrl beim Ziehen gedrückt, um ein neues Rechteck zu erstellen.

  5. Verwenden Sie die Ausgänge, um das zugeschnittene Bild oder die Rechtecks-Koordinaten an nachgelagerte Blöcke weiterzugeben.

💡 Tipps und Tricks

  • Kombinieren Sie mit Show Image, um das zugeschnittene Ergebnis zur besseren Inspektion in einem größeren Viewer zu öffnen.

  • Wenn Sie mehrere bearbeitbare ROIs benötigen, verwenden Sie stattdessen Image ROI Select Multi.

  • Nutzen Sie nach diesem Block Image Resize, um zugeschnittene Bereiche vor der Erkennung oder Analyse zu normalisieren.

  • Geben Sie die zugeschnittene Ausgabe an Find Object weiter, wenn Sie Template Matching nur innerhalb des ausgewählten Bereichs durchführen möchten — das reduziert falsche Treffer und beschleunigt die Verarbeitung.

  • Speichern Sie wichtige Zuschnitte mit Image Logger oder Image Write, um Beispiele für spätere Überprüfungen oder Trainingsdaten zu archivieren.

  • Um Erkennungen oder Koordinaten wieder auf dem Originalbild zu visualisieren, verwenden Sie nachgelagert Draw Rectangle mit dem Ausgang Rectangle.

🛠️ Fehlersuche

  • Wenn die Vorschau leer ist, stellen Sie sicher, dass der erzeugende Block verbunden ist und dass Sie die Pipeline einmal ausgeführt haben, damit Bilddaten geladen werden.

  • Wenn die Auswahl außerhalb des Bildes liegt, prüfen Sie die Abmessungen des Eingangsbildes und zeichnen Sie das ROI innerhalb der Vorschau neu.

  • Für die weitere Verarbeitung prüfen Sie, ob die Auflösung des zugeschnittenen Bildes für nachfolgende Blöcke geeignet ist (bei Bedarf Image Resize verwenden).

Zuletzt aktualisiert