> 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/function-blocks/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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/german/function-blocks/detections-shapes/roi-processing/image-roi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.