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

# Image ROI Select

Dieser Funktionsblock ermöglicht es Benutzern, eine Region of Interest (ROI) innerhalb eines gegebenen Bildes mithilfe von Maus-Eingaben auszuwählen. Er markiert visuell den ausgewählten Bereich und gibt den beschnittenen Abschnitt für weitere Verarbeitung aus.

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

`Image Any` Das ursprüngliche Bild, aus dem die ROI ausgewählt wird.

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

`Image Any` Diese Ausgabe enthält die Bilddaten des zugeschnittenen Bildes basierend auf der ausgewählten ROI.

`Rectangle` Die Koordinaten des ausgewählten rechteckigen Bereichs, der die ROI angibt.

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

`Selected ROI` Benutzer können auf das Bild klicken und ziehen, um den Bereich zu definieren, der zugeschnitten werden soll. Das Rechteck wird visuell dargestellt, während es gezogen wird.

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

`Interactive Selection` Der Block ermöglicht die interaktive Auswahl eines rechteckigen Bereichs direkt auf dem angezeigten Bild und bietet sofortiges visuelles Feedback.

`Visual Feedback` Der ausgewählte Bereich wird mit einem grünen Rechteck umrandet, während der Benutzer ihn auswählt, was die Genauigkeit der Auswahl unterstützt.

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

1. **Connect Input**: Verbinden Sie eine gültige Bilddatenquelle mit dem Eingangsbereich `Image Any`.
2. **Select ROI**: Klicken und ziehen Sie auf dem angezeigten Bild, um das Zuschneiderechteck zu definieren. Das Rechteck wird dynamisch gezeichnet, während Sie die Maus ziehen.
3. **Evaluate the Block**: Führen Sie den Block aus, um die ROI zu extrahieren, nachdem Sie eine Auswahl getroffen haben. Das zugeschnittene Bild und die Koordinaten werden ausgegeben.

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

Bei der Bewertung gibt der Block sowohl das zugeschnittene Bild, das der ausgewählten ROI entspricht, als auch die Koordinaten aus, die den ausgewählten Bereich definieren.

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

<details>

<summary>Mit anderen Blöcken verwenden</summary>

Um die Bildqualität vor der Auswahl zu verbessern, sollten Sie die Funktionsblöcke `Image Threshold`, `Blur` oder `Super Resolution` auf das Eingangsbild anwenden.

</details>

<details>

<summary>Sichere Auswahl gewährleisten</summary>

Vergrößern Sie das Bild (wenn möglich), bevor Sie die ROI auswählen, um sicherzustellen, dass das Rechteck genau mit dem Bereich übereinstimmt, den Sie zuschneiden möchten.

</details>

<details>

<summary>Umgang mit Rändern</summary>

Wenn Sie sehr nah an den Rändern des Bildes zuschneiden, stellen Sie sicher, dass Ihr ausgewähltes Rechteck die Grenzen des Bildes nicht überschreitet, um Fehler zu vermeiden.

</details>

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

<details>

<summary>Kein Ausgabebild</summary>

Wenn das Ausgabebild nicht angezeigt wird, überprüfen Sie, ob das Eingangsbild ordnungsgemäß verbunden ist und ob Sie eine Auswahl im angezeigten Bild getroffen haben.

</details>

<details>

<summary>Fehler bei keiner Auswahl</summary>

Wenn Sie versuchen, den Block auszuführen, ohne eine ROI auszuwählen, stellen Sie sicher, dass Sie die Maus ziehen, um ein Rechteck zu erstellen, bevor Sie bewerten.

</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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.