> 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-multi.md).

# Image ROI Select Multi

Interaktiver Block zum Auswählen und Bearbeiten mehrerer rechteckiger Regions Of Interest (ROIs) in einem Bild. Ziehen, verschieben und skalieren Sie Rechtecke direkt in der Bildvorschau, um zugeschnittene Bilder und Pixel-Rechteckkoordinaten für nachgelagerte Verarbeitungsschritte zu erzeugen.

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

`Image` Verbinden Sie ein Farbbild oder Graustufenbild, das als Quelle für die ROI-Auswahl dient.

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

`Images` Für jede ROI ein zugeschnittenes Bild (Liste).\
`Rectangles` Pixel-Rechtecke für jede ROI (Liste).\
`Selected Image` Zuschitt für die aktuell ausgewählte ROI (ein einzelnes Bild oder None).\
`Selected Rectangle` Pixel-Rechteck der ausgewählten ROI (ein einzelnes Rechteck oder None).

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

* `Draw`: Auf eine freie Fläche in der Bildvorschau klicken und ziehen, um eine neue ROI zu erstellen.
* `Move`: Innerhalb eines Rechtecks klicken und ziehen, um es zu verschieben.
* `Resize`: An den Kanten oder Ecken eines Rechtecks klicken und ziehen, um die Größe zu ändern.
* `Ctrl`: Beim Ziehen gedrückt halten, um immer ein neues Rechteck zu erstellen (auch wenn sich der Mauszeiger über einer bestehenden ROI befindet).
* `C`: Drücken, um alle ROIs zu löschen.
* `U`: Drücken, um die zuletzt erstellte ROI rückgängig zu machen.
* `Delete` / `Backspace`: Drücken, um die ausgewählte ROI zu entfernen.
* `Escape`: Drücken, um Auswahl oder Ziehen abzubrechen.

Die Vorschau zeigt Overlays und Anfasser an, um Hover-, Auswahl- und Vorschauzustände zu kennzeichnen.

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

* Mehrere ROIs bearbeiten: Erstellen Sie mehrere rechteckige ROIs in einer Bildsitzung.
* Live-Vorschau: Interaktive Overlays und Vorschauaktualisierungen während der Bearbeitung.
* Pixelgenaue Ausgaben: `Rectangles` und `Selected Rectangle` werden in Pixelkoordinaten relativ zur Quellbildgröße zurückgegeben.
* Reaktionsfähige UI: Die Vorschau passt sich der Blockgröße an und hält Overlays konsistent.
* Serialisierung: ROIs und Auswahl werden beim Speichern/Laden eines Szenarios erhalten.

## 📊 Wie es läuft <a href="#evaluation" id="evaluation"></a>

* Wenn ein Bild am Eingang `Image` ankommt, speichert der Block es als aktuelle Quelle und aktualisiert die Vorschau.
* Der Block wandelt die aktuellen ROI-Definitionen in Pixelrechtecke um, basierend auf der Quellbildgröße, und liefert als Ausgaben: `Images` (pro ROI zugeschnitten), `Rectangles` (Pixelkoordinaten), `Selected Image` und `Selected Rectangle`.
* Wenn kein Bild verbunden ist, liefert der Block leere Listen und None-Werte (keine Zuschnitte).

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

1. Verbinden Sie einen bildliefernden Block (Kamera, Loader, Stream) mit dem Eingang `Image`.
2. Klicken und ziehen Sie in der Bildvorschau, um ROIs zu erstellen. Passen Sie die Größe über Kanten/Ecken an.
3. Klicken Sie in ein Rechteck, um es auszuwählen; der ausgewählte Zuschnitt ist über `Selected Image` verfügbar.
4. Verwenden Sie die Tastenkürzel (`C`, `U`, `Delete`/`Backspace`, `Escape`) und halten Sie `Ctrl`, um das Erstellungsverhalten zu beeinflussen.
5. Nutzen Sie die Ausgaben in nachgelagerten Blöcken zur Analyse oder zum Speichern der Zuschnitte.

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

* Schnelle Vorschau: Verbinden Sie die Ausgabe `Selected Image` mit `Show Image`, um den aktuell ausgewählten Zuschnitt größer anzuzeigen.
* Batch-Verarbeitung: Führen Sie die Ausgabe `Images` an `Collage Images`, `Image Logger` oder `Image Write` weiter, um alle ROI-Zuschnitte zusammenzuführen oder automatisch zu speichern.
* Fokussierte Analyse: Verwenden Sie die Ausgabe `Rectangles` als Eingabe für `Get ROI`, wenn Sie dieselbe Rechteckliste auf andere Bilder (z. B. Zeitreihen) anwenden möchten.
* Kombinieren mit Detektoren: Erstellen Sie ROIs zur Lokalisation von Interessensbereichen und senden Sie die zugeschnittenen Bilder (`Images`) an Blöcke wie `Find Object`, `Feature Detector`, `Blob Detector` oder `OCR`, um gezielte Erkennungen/Erkennungen pro Zuschnitt durchzuführen.
* Visualisierung: Zeichnen Sie die zurückgegebenen `Rectangles` auf das Quellbild mit `Draw Rectangle` oder `Draw Detections`, um Ergebnisse neben anderen Annotationen darzustellen.
* Vorverarbeitung: Bereiten Sie das Quellbild vor der manuellen ROI-Auswahl mit `Blur`, `Image Threshold` oder `HSV Filter` vor, um Strukturen leichter sichtbar zu machen.
* In Pipelines mit Schleifen: Geben Sie ROI-Zuschnitte an `Analysis`- oder AI-Blöcke (z. B. Object Detection, Background Removal) weiter, um effiziente pro-Bereich-Verarbeitungsabläufe zu erstellen.

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

* Keine Vorschau oder Bedienelemente deaktiviert: Stellen Sie sicher, dass ein gültiges Bild am Eingang `Image` angeschlossen ist.
* ROIs werden nicht korrekt exportiert: Prüfen Sie, ob das Quellbild die korrekten Abmessungen hat; der Block liefert Pixelrechtecke relativ zur Eingangsbildgröße.
* Unerwartetes Auswahlverhalten: Halten Sie beim Ziehen `Ctrl` gedrückt, um die Erstellung einer neuen ROI zu erzwingen, anstatt eine vorhandene zu ändern.
* Zu viele oder fehlende ROIs in nachgelagerten Schritten: Vergewissern Sie sich, dass Sie die richtige Ausgabe verwenden (`Images` vs. `Selected Image`) und dass nachgelagerte Blöcke Listen-Eingaben akzeptieren, wenn Sie mehrere Zuschnitte übergeben.