> 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-multi.md). # Image ROI Polygon Multi Dieser Funktionsblock ermöglicht es Ihnen, mehrere polygonale Regions of Interest (ROIs) direkt auf einem Bild zu zeichnen und zu speichern. Verwenden Sie ihn, um Bereiche hervorzuheben, mehrere unregelmäßige Regionen zuzuschneiden und jede Polygonfläche als eigenes Bild für die weitere Verarbeitung zu exportieren. ## 📥 Eingänge * `Image` — Bild, das Sie annotieren und aus dem Sie Polygone extrahieren möchten. ## 📤 Ausgänge * `Highlighted Image` — Das Originalbild mit markierten gespeicherten Polygonen und der aktuellen Zeichen-Overlay. * `Polygon Images` — Liste der zugeschnittenen Bildbereiche für jedes gespeicherte Polygon. * `Polygons` — Liste der Polygon-Koordinatensätze (Shape-Daten), die jedes gespeicherte Polygon beschreiben. ## 🕹️ Steuerungen * `Image Area` — Klickbare Bildfläche, auf der Sie Polygone mit der Maus zeichnen. * `Left mouse click` — Fügt einen Scheitelpunkt zum aktuellen Polygon hinzu. * `S` — Speichert das aktuelle Polygon (muss mindestens drei Punkte haben). * `U` — Macht den letzten Punkt rückgängig oder öffnet den Bearbeitungsmodus für das zuletzt gespeicherte Polygon. * `C` — Löscht das aktuelle Polygon oder entfernt das zuletzt gespeicherte Polygon. * `Info` — On-Block Hilfetext, der an die wichtigsten Steuerungen und Shortcuts erinnert. ## 🎨 Funktionen * Interaktives Zeichnen: Polygone durch direktes Klicken auf das Bild erstellen. * Mehrfach-Polygon-Unterstützung: Mehrere Polygone im selben Bild speichern und verwalten. * Bearbeiten und Rückgängig: Das zuletzt gespeicherte Polygon kann zur Anpassung wieder geladen werden (Shortcut `U`). * Visuelle Overlays: Gespeicherte Polygone werden hervorgehoben und nummeriert; das aktuell gezeichnete Polygon zeigt eine Live-Vorschau. * Zugeschnittene Ausgaben: Jedes gespeicherte Polygon wird als separates Bild exportiert und kann direkt weiterverarbeitet werden. * Effizientes Caching: Vermeidet unnötige Neuzeichnungen, wenn Bild und Polygone unverändert sind. ## ⚙️ Ausführungsmechanismus * Speisen Sie ein `Image` in den Block ein. Das Bild erscheint auf der interaktiven Zeichenfläche. * Zeichnen Sie ein Polygon, indem Sie nacheinander Scheitelpunkte mit der linken Maustaste setzen. Eine Live-Overlay zeigt Linien und eine gefüllte Vorschau des aktuellen Polygons. * Drücken Sie `S`, um ein abgeschlossenes Polygon zu speichern (mindestens drei Punkte). Gespeicherte Polygone werden Teil des `Highlighted Image` und erscheinen in den Ausgängen `Polygon Images` und `Polygons`. * Verwenden Sie `U` zum Rückgängig machen des letzten Punkts (oder zum Bearbeiten des zuletzt gespeicherten Polygons). Verwenden Sie `C`, um die aktuelle Zeichnung zu löschen oder das letzte gespeicherte Polygon zu entfernen. * Bei Ausführung liefert der Block das annotierte Bild, die Liste der zugeschnittenen Polygon-Bilder und die Polygon-Koordinatendaten. ## 💡 Tipps und Tricks * Für eine größere Vorschau kombinieren Sie den Block mit `Show Image`: Verbinden Sie `Highlighted Image` mit `Show Image` für einen erweiterten Viewer. * Benötigen Sie rechteckige ROIs statt Polygonen, probieren Sie `Image ROI Select` oder `Image ROI Select Multi` für schnelles Zeichnen von Rechtecken. * Verwenden Sie `Get ROI`, wenn Sie andere Blöcke auf rechteckige Zuschnitte anwenden möchten, die aus Polygon-Bounding-Boxes abgeleitet wurden. * Um das Polygon als binäre Maske zu verwenden und Bildinhalte zu filtern, kombinieren Sie mit `Apply Mask`. Geben Sie das Polygonbild als `Mask` und das Originalbild als `Image` ein, um nur den Polygonbereich zu extrahieren. * Zur Analyse von Merkmalen innerhalb eines Polygons (z. B. Linienpeaks) schneiden Sie das Polygon-Ergebnis aus und verbinden es mit `Histogram On Line` oder `Histogram On Curve`. * Für Erkennungs-Pipelines senden Sie jede Ausgabe aus `Polygon Images` an `Find Object`, `Object Detection` oder `Object Detection - Custom`, um Matching/Detektion nur innerhalb der ausgewählten Bereiche auszuführen. * Speichern Sie Ergebnisse automatisch mit `Image Logger` oder `Image Write`, indem Sie diese mit den entsprechenden zugeschnittenen Bildern verbinden. * Bei sehr großen Quellbildern: Verwenden Sie `Image Resizer` vor dem Zeichnen, um die Interaktion zu beschleunigen, und rechnen Sie bei Bedarf die Polygon-Koordinaten später auf das Originalbild zurück. ## 🛠️ Fehlersuche * Nichts auf der Zeichenfläche sichtbar: Stellen Sie sicher, dass ein `Image` verbunden ist und der Block mindestens einmal ausgeführt wurde. * Gespeichertes Polygon wird nicht korrekt exportiert: Prüfen Sie, ob das Polygon vor dem Speichern mit `S` mindestens drei Punkte hatte. * Zugeschnittenes Polygon wirkt verschoben oder abgeschnitten: Überprüfen Sie das Bildseitenverhältnis und vorhandene Resizing-Blöcke stromaufwärts. Wenn Sie vor dem Zeichnen verkleinert haben, merken Sie sich die Skalierung für spätere Verarbeitungsschritte. * Zu langsam bei vielen Polygonen: Reduzieren Sie die Bildauflösung mit `Image Resizer` während des Zeichnens oder begrenzen Sie die Anzahl der gespeicherten Polygone. Nutzen Sie die Ausgänge des Blocks, um nur die wirklich benötigten Polygonbilder zu speichern. --- # 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-multi.md?ask= ``` 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.