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

# Image ROI Polygon

Dieser Funktionsblock ermöglicht es Benutzern, eine Region von Interesse (ROI) zu definieren, indem sie ein Polygon auf einem Bild mit Mausklicks zeichnen. Die definierte ROI kann für eine weitere Bildverarbeitung verwendet werden.

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

`Input Image` Das Bild, auf dem die polygonale ROI gezeichnet wird.

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

`Output Image` Das Ergebnisbild, das nur den Bereich zeigt, der durch das gezeichnete Polygon definiert ist.

`Polygon` Die Koordinaten der Polygonpunkte, die die ROI definieren.

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

`Mouse Click` Klicken Sie auf das Bild, um Eckpunkte des Polygons hinzuzufügen. Jeder Klick fügt einen Punkt hinzu.

`Key Press`

* **C**: Löscht alle Punkte und das Polygon.
* **U**: Macht den zuletzt hinzugefügten Punkt rückgängig.

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

`Interaktives Zeichnen` Benutzer können Polygone direkt auf dem Bild zeichnen, indem sie klicken, um Punkte zu setzen, was eine flexible ROI-Auswahl ermöglicht.

`Dynamische Linienvisualisierung` Während die Benutzer klicken, um das Polygon zu definieren, werden Linien und Punkte dynamisch auf dem Bild gezeichnet, um sofortiges visuelles Feedback zu geben.

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

1. **Bild verbinden**: Verbinden Sie ein Bild mit dem Socket `Input Image`.
2. **Polygon zeichnen**: Klicken Sie auf das Bild, um Punkte hinzuzufügen. Verbinden Sie mindestens drei Punkte, um ein geschlossenes Polygon zu bilden.
3. **Löschen oder Rückgängigmachen**: Verwenden Sie die **C**-Taste, um alle Punkte zu löschen, oder die **U**-Taste, um den letzten Punkt zu entfernen.
4. **Bewertung**: Führen Sie den Funktionsblock aus, um das Ausgabebild zu erhalten, das sich nur auf die definierte ROI konzentriert.

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

Wenn er ausgeführt wird, generiert dieser Funktionsblock ein Ausgabeimage, das nur den Bereich hervorhebt, der im vom Benutzer gezeichneten Polygon enthalten ist.

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

<details>

<summary>Komplexe Formen</summary>

Sie können komplexe Formen erstellen, indem Sie um den gewünschten Bereich klicken; stellen Sie sicher, dass Sie das Polygon schließen, indem Sie den letzten Punkt mit dem ersten verbinden.

</details>

<details>

<summary>Mit Ebenen</summary>

Dieser Funktionsblock kann effektiv mit anderen Funktionsblöcken wie `Image Threshold` oder `Bilateral Filter` kombiniert werden, um spezifische Bereiche vor oder nach der Definition der ROI zu verbessern.

</details>

<details>

<summary>Überprüfen Sie die Polygonkoordinaten</summary>

Die Ausgabe-Polygonkoordinaten können gespeichert oder als Eingabe für andere Verarbeitungsfunktionen verwendet werden, die spezifische Bereichsreferenzen benötigen.

</details>

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

<details>

<summary>Polygon wird nicht angezeigt</summary>

Stellen Sie sicher, dass ein Bild mit dem Eingangssocket verbunden ist und dass Sie klicken, um mindestens drei Punkte zu erstellen, um eine geschlossene Form zu definieren.

</details>

<details>

<summary>Unerwartete Ausgabe</summary>

Stellen Sie sicher, dass Sie die Punkte nicht versehentlich gelöscht oder mehrere Klicks rückgängig gemacht haben. Verwenden Sie die **U**-Taste, um die letzte Aktion bei Bedarf wiederherzustellen.

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