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

# Image ROI Polygon

Dieser Funktionsblock ermöglicht es Ihnen, ein Polygon direkt auf einem Bild zu zeichnen, um eine benutzerdefinierte Region of Interest (ROI) zu definieren. Verwenden Sie ihn, um unregelmäßige Formen auszuwählen, Scheitelpunkte interaktiv zu bearbeiten und sowohl das innerhalb des Polygons ausgeschnittene Bild als auch die Polygon-Koordinaten für die Weiterverarbeitung auszugeben.

## 📥 Eingänge

* `Image Any`\
  Das Bild, das angezeigt und annotiert werden soll. Verbinden Sie hier jeden bildproduzierenden Block, damit Sie das Polygon in einer Live-Vorschau zeichnen können.

## 📤 Ausgänge

* `Image Any`\
  Das zugeschnittene Bild, das dem Polygonbereich entspricht. Wenn kein Polygon definiert ist, kann diese Ausgabe leer sein.
* `Polygon`\
  Die Polygon-Koordinaten, zurückgegeben als Kontur-/Formliste, die sich zur Weiterverwendung in anderen Blöcken eignet.

## 🕹️ Steuerungen

* `Left Click`\
  Fügt an der geklickten Stelle einen Scheitelpunkt hinzu.
* `Drag`\
  Klicken und ziehen Sie einen bestehenden Scheitelpunkt, um ihn zu verschieben.
* `U`\
  Macht den zuletzt hinzugefügten Scheitelpunkt rückgängig.
* `C`\
  Löscht alle Scheitelpunkte und beginnt von vorn.
* `Overlay Preview`\
  Sichtbare Markierungen und Füllung werden während der Bearbeitung angezeigt, sodass Sie Polygon, Scheitelpunkte und Auswahlbereich in Echtzeit sehen.

## ⚙️ Ausführungsmechanismus

* Verbinden Sie eine Bildquelle mit dem `Image Any`-Eingang und führen Sie das Szenario einmal aus, um die Vorschau zu laden.
* Zeichnen Sie das Polygon, indem Sie Punkte (Scheitel) per Klick hinzufügen. Die Overlay-Vorschau aktualisiert sich sofort.
* Verwenden Sie Ziehen und Tastenkürzel, um die Form zu verfeinern.
* Sobald ein Polygon vorhanden ist, liefert der Block bei jeder Auswertung ein zugeschnittenes Bild (enge Bounding-Box des Polygons) sowie die Polygon-Koordinaten.

## ✨ Funktionen

* Interaktives Zeichnen von Polygonen mit Bearbeitung der Scheitelpunkte.
* Rückgängig-/Löschen-Kurzbefehle für schnelle Korrekturen.
* Visuelle Overlay-Anzeige mit Hervorhebung von Scheitelpunkten beim Hovern oder Ziehen.
* Gibt sowohl ein zugeschnittenes Bild als auch präzise Polygon-Koordinaten aus.
* Unterstützt nicht-rechteckige und mehrpunktige ROIs für komplexe Objekte.

## 📝 Nutzungstipps

* Zeichnen Sie mindestens drei Punkte, um ein gefülltes Polygon zu bilden; mit weniger Punkten ist kein gültiger ROI-Crop möglich.
* Führen Sie nach dem Zeichnen nachgelagerte Blöcke aus, um das zugeschnittene Bild oder die Polygon-Koordinaten weiterzuverarbeiten.
* Verwenden Sie die Drag-Funktion, um Scheitelpunkte feinzujustieren und genaue Messungen zu ermöglichen.

## 💡 Tipps und Tricks

* Verbinden Sie die Ausgabe mit `Show Image`, um größere Bilder in einer separaten Ansicht besser zeichnen zu können.
* Wenn Sie mehrere ROIs in einem Bild benötigen, nutzen Sie `Image ROI Polygon Multi`, um mehrere Polygon-Auswahlen zu speichern und diese anschließend einzeln an Verarbeitungsblöcke zu übergeben.
* Kombinieren Sie mit `Get ROI` oder `Image ROI Select`, wenn Sie zuerst rechteckige Zuschnitte bevorzugen und danach mit dem Polygon für komplexe Formen verfeinern möchten.
* Nutzen Sie `Apply Mask` nach diesem Block, um das Originalbild mit dem Polygon zu maskieren und dieses maskierte Bild in Analyseblöcke zu geben.
* Speisen Sie das zugeschnittene Polygon-Bild in Erkennungs- oder Analyseblöcke wie `Find Object`, `Object Detection`, `Mask Detection`, `Histogram On Line` oder `Color Density Percentage`, um die Verarbeitung auf den ausgewählten Bereich zu fokussieren.
* Ist das Bild zu groß zum präzisen Zeichnen, fügen Sie vor diesem Block `Image Resizer` oder `Image Resize` hinzu; beachten Sie, dass eine Größenänderung die Pixelkoordinaten beeinflusst, die von nachgelagerten geometrieempfindlichen Blöcken verwendet werden.
* Speichern Sie ausgewählte ROIs mit `Image Logger`, `Image Write` oder `Multi Image Write` zur Datensatzerfassung oder späteren Überprüfung.

## 🛠️ Fehlersuche

* Kein Bild sichtbar: Stellen Sie sicher, dass ein bildproduzierender Block mit `Image Any` verbunden ist, und führen Sie das Szenario einmal aus, um die Vorschau zu füllen.
* Kein ROI erzeugt: Vergewissern Sie sich, dass Sie mindestens drei Scheitelpunkte gesetzt haben; weniger Punkte können kein gefülltes Polygon bilden.
* Polygon wirkt nach dem Skalieren des Bildes verschoben: Zeichnen Sie im endgültigen Auflösungsmaßstab oder fügen Sie konsequent `Image Resizer` in die Pipeline ein, damit die Koordinaten ausgerichtet bleiben.
* Benötigen Sie exakte Koordinaten für andere Blöcke: Nutzen Sie die `Polygon`-Ausgabe (Koordinatenliste) und prüfen Sie die Werte mit einer Vorschau über `Show Image` oder führen Sie nach Anpassungen eine erneute Auswertung durch.