> 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/funktionsblocke/blocks-reference/detections-shapes/roi-processing/image-roi-select.md).

# 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 <a href="#inputs" id="inputs"></a>

`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 <a href="#outputs" id="outputs"></a>

`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 <a href="#controls" id="controls"></a>

`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 <a href="#features" id="features"></a>

* 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 <a href="#how-it-works" id="how-it-works"></a>

* 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 <a href="#usage" id="usage"></a>

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 <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* 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 <a href="#troubleshooting" id="troubleshooting"></a>

* 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).