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

# Image ROI

Dieser Funktionsblock ermöglicht es Benutzern, einen Bereich von Interesse (ROI) innerhalb eines Bildes zu definieren. Er nutzt Schieberegler, um das Eingangsbild zuzuschneiden und einen fokusierten Bereich für die weitere Verarbeitung bereitzustellen.

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

`Image Any` Das Eingangsbild, aus dem Sie einen bestimmten Bereich extrahieren möchten.

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

`Image Any` Diese Ausgabe gibt den zugeschnittenen Bereich von Interesse aus dem Eingangsbild zurück.

`Rectangle` Die Koordinaten des definierten ROI, bereitgestellt im Format eines Rechtecks.

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

`Input Image Size (H, W)` Dieses Label zeigt die Höhe und Breite des Eingangsbildes zur Referenz an.

`Width` Ein horizontaler Schieberegler, mit dem Sie die Breite des ROI anpassen können, die aus dem Eingangsbild zugeschnitten werden soll.

`Height` Ein horizontaler Schieberegler, mit dem Sie die Höhe des ROI anpassen können, die aus dem Eingangsbild zugeschnitten werden soll.

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

`Dynamic ROI Definition` Benutzer können den ROI im Eingangsbild interaktiv definieren, indem sie die Schieberegler auf die gewünschten Abmessungen anpassen.

`Real-time Feedback` Während die Größen des ROI angepasst werden, reflektieren die aktualisierten Abmessungen sofort im Label.

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

1. **Input Image Connection**: Verbinden Sie ein beliebiges Bild mit dem `Image Any`-Eingang.
2. **Adjust Width and Height**: Verwenden Sie die Schieberegler `Width` und `Height`, um die gewünschten ROI-Abmessungen aus dem Eingangsbild auszuwählen.
3. **Evaluate**: Führen Sie den Block aus, um die zugeschnittene Region als Ausgabe sowie die Rechteckkoordinaten des definierten Bereichs zu sehen.

## 📊 Bewertung <a href="#evaluation" id="evaluation"></a>

Bei der Ausführung gibt dieser Block das zugeschnittene Bild basierend auf dem definierten ROI aus, der durch die Schieberegler festgelegt wurde.

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

<details>

<summary>Größe des ROI festlegen</summary>

Stellen Sie sicher, dass Sie die ROI-Größe nur innerhalb der Grenzen der ursprünglichen Bildabmessungen definieren, um Indexierungsfehler zu vermeiden.

</details>

<details>

<summary>Dynamische Bereichsanpassung</summary>

Wenn Sie die Bildgröße ändern, sollten Sie überprüfen, ob die Schieberegler dynamisch aktualisiert werden, damit sie immer mit den aktuellen Abmessungen Ihres Eingangsbildes übereinstimmen.

</details>

<details>

<summary>Vorschau vor der Finalisierung</summary>

Für interaktive Sitzungen hilft es, den Block nach der Anpassung der Schieberegler häufig zu bewerten, um den perfekten ROI zu finden.

</details>

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

<details>

<summary>Ungültige ROI-Größe</summary>

Wenn Sie einen Fehler bezüglich der ROI-Abmessungen erhalten, überprüfen Sie, ob die ausgewählte Breite und Höhe innerhalb der Einschränkungen der Eingangsbildgröße liegen.

</details>

<details>

<summary>Ausgabebild erscheint leer</summary>

Wenn das Ausgabebild leer ist, stellen Sie sicher, dass die ausgewählten ROI-Abmessungen tatsächlich einen Bereich des Eingangsbildes abdecken, der sichtbare Daten enthält; andernfalls passen Sie die Schieberegler entsprechend an.

</details>