> 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/get-roi.md).

# Get ROI

Dieser Funktionsblock extrahiert eine Region von Interesse (ROI) aus einem gegebenen Bild basierend auf angegebenen Rechteckkoordinaten. Er ermöglicht es den Benutzern, bedeutende Teile eines Bildes für weitere Analysen oder Verarbeitungen zu isolieren.

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

`Image Any` Das Eingangsbild, aus dem Sie eine Region von Interesse extrahieren möchten.

`Rectangle` Die Koordinaten, die das Rechteck für die Region von Interesse definieren. Es sollten zwei Punkte im Format `[(x1, y1), (x2, y2)]` angegeben werden.

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

`Image Any` Das Ausgabe-Bild, das nur die extrahierte Region von Interesse enthält.

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

`Flexible ROI Definition` Benutzer können jede rechteckige ROI angeben, indem sie die Koordinaten bereitstellen.

`Boundary Handling` Passt die Koordinaten automatisch an, um sicherzustellen, dass sie innerhalb der Bilddimensionen bleiben, um Fehler zu vermeiden.

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

1. **Input Image**: Verbinden Sie das Bild, aus dem Sie eine Region extrahieren möchten, mit dem Eingang `Image Any`.
2. **Define Rectangle**: legen Sie die Koordinaten für das Rechteck fest, in dem Sie die ROI extrahieren möchten. Diese Koordinaten müssen im Format `[(x1, y1), (x2, y2)]` angegeben werden.
3. **Evaluate**: Sobald konfiguriert, führen Sie den Block aus, um die designated ROI zu extrahieren.

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

Bei der Auswertung gibt dieser Funktionsblock die angegebene Region aus dem Eingangsbild basierend auf den bereitgestellten Rechteckkoordinaten aus.

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

<details>

<summary>Definieren Sie genaue Koordinaten</summary>

Stellen Sie sicher, dass Sie die Koordinaten genau für die gewünschte Region definieren. Wenn Sie unsicher sind, verwenden Sie den Funktionsblock `Get Pixel`, um korrekte Koordinaten zu erhalten.

</details>

<details>

<summary>Verwendung mit anderen Blöcken</summary>

Sie können die Ausgabe dieses Blocks mit beliebigen Bildverarbeitungsblöcken wie `Image ROI Select Multi` oder `Blur` verbinden, um die extrahierte ROI weiter zu verarbeiten.

</details>

<details>

<summary>Grenzen berücksichtigen</summary>

Wenn das Ausgabe-Bild nicht wie erwartet erscheint, stellen Sie sicher, dass das angegebene Rechteck die Eingangsbilddimensionen nicht überschreitet.

</details>

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

<details>

<summary>Fehler bei der ROI-Extraktion</summary>

Wenn Sie Probleme mit der ROI-Extraktion haben, überprüfen Sie die Rechteckkoordinaten und stellen Sie sicher, dass sie innerhalb der Grenzen des Eingangsbildes liegen.

</details>

<details>

<summary>Leere ROI-Ausgabe</summary>

Wenn die Ausgabe leer ist, überprüfen Sie die angegebenen Koordinaten, um sicherzustellen, dass sie gültig sind und einer Region entsprechen, die im Eingangsbild existiert.

</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/get-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.