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

# Image ROI Circle

Dieser Funktionsblock ermöglicht das Erstellen einer einzigen editierbaren, kreisförmigen Region of Interest (ROI) auf einem Bild. Verwenden Sie die interaktive Leinwand, um den Kreis zu zeichnen, zu verschieben und zu skalieren. Der Block liefert das zugeschnittene kreisförmige Bild und eine Kreisform (Mittelpunkt und Radius), die Sie an andere Blöcke weitergeben können.

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

`Image`\
Bild, das zugeschnitten werden soll und auf dem die Kreis-Overlay bearbeitet wird (Graustufen oder Farbe).

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

`Image`\
Zugeschnittenes Bild mit dem kreisförmigen Bereich (Hintergrund außerhalb des Kreises maskiert).

`Circle`\
Kreisform, die die ausgewählte ROI als Mittelpunkt und Radius beschreibt (nützlich für geometrie-bewusste Blöcke).

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

`ROI Canvas`\
Interaktiver Bildbereich, in dem Sie den Kreis per Maus erstellen und bearbeiten.

`Create by Drag`\
Klicken und ziehen auf der Leinwand, um einen neuen Kreis zu erstellen.

`Move Center`\
Ziehen Sie den Kreismittelpunkt, um die ROI zu verschieben.

`Resize Radius`\
Ziehen Sie den Radius-Handle, um die Kreisgröße zu ändern.

`Clear (C)`\
Drücken Sie die Taste C, um den aktuellen Kreis zu löschen und neu zu beginnen.

## ⚙️ Funktionsweise <a href="#how-it-works" id="how-it-works"></a>

* Der Block zeigt das bereitgestellte Bild auf der interaktiven Leinwand an und legt den aktuellen Kreis darüber (falls gesetzt).
* Während der Ausführung reagiert die Leinwand auf Maus-Drag- und Move-Ereignisse, um Kreis zu erstellen, zu verschieben oder zu skalieren.
* Sobald ein gültiger Kreis vorhanden ist, erzeugt der Block das zugeschnittene kreisförmige Bild (maskiert) und eine Formausgabe mit Mittelpunkt- und Radiuswerten.
* Wenn der Kreis nicht definiert ist oder der Radius null ist, gibt der Block für beide Anschlüsse `None` aus, damit nachgeschaltete Blöcke das Fehlen einer ROI behandeln können.

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

* Intuitive Klick-&-Ziehen-Interaktion zum Erstellen einer ROI.
* Separate Griffe zum Verschieben des Mittelpunkts und zum Ändern des Radius.
* Sofortiges visuelles Feedback mit farbiger Überlagerung und Hervorhebung der Griffe.
* Liefert sowohl den maskierten Ausschnitt als auch eine wiederverwendbare Formbeschreibung.

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

1. Verbinden Sie einen bildproduzierenden Block mit dem Eingang `Image` und führen Sie einmal aus, damit das Bild auf der Leinwand erscheint.
2. Klicken und ziehen Sie auf dem `ROI Canvas`, um einen Kreis zu erstellen.
3. Ziehen Sie den Kreismittelpunkt, um ihn zu verschieben, oder ziehen Sie den Radius-Handle, um die Größe zu ändern.
4. Drücken Sie `C`, um zu löschen und bei Bedarf neu zu zeichnen.
5. Verwenden Sie die Ausgänge `Image` und `Circle`, um den Crop oder die Form an andere Blöcke zu senden.

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

* Zeigen Sie den ausgewählten Ausschnitt zur genaueren Prüfung größer mit `Show Image` an, bevor Sie exportieren.
* Wenn Ihr Quellbild groß ist, nutzen Sie `Image Resize` vor diesem Block, um die Interaktion zu beschleunigen und sicherzustellen, dass die ROI in den Arbeitsbereich passt.
* Verwenden Sie `Apply Mask`, um die kreisförmige Maske mit anderen Bildern zu kombinieren oder das Maskenergebnis auf einem anderen Hintergrund zu überlagern.
* Für komplexere oder mehrere Regionen ziehen Sie `Image ROI Select` oder `Image ROI Polygon Multi` in Betracht und verfeinern anschließend ggf. mit diesem kreisförmigen ROI.
* Speichern Sie erfasste Ausschnitte direkt mit `Image Logger` oder `Image Write` für Aufzeichnungen oder nachgelagerte Verarbeitung.
* Vorverarbeiten Sie verrauschte Eingaben mit `Blur` oder `Image Threshold`, damit die visuelle Region besser mit Ihren Erkennungs- oder Mess-Workflows übereinstimmt.
* Kombinieren Sie Kreis-Ausgaben mit Mess- oder Analyseblöcken (z. B. shape-analysis oder Detektoren), indem Sie die `Circle`-Form dort übergeben, wo sie unterstützt wird.

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

* Kein Bild auf der Leinwand sichtbar: Stellen Sie sicher, dass der vorgelagerte Block ein Bild erzeugt und führen Sie das Szenario einmal aus, damit das Bild geladen wird.
* Ausgänge sind `None`: Mittelpunkt oder Radius des Kreises ist nicht definiert oder der Radius ist effektiv null. Zeichnen Sie den Kreis neu.
* Kreis wirkt verschoben oder zu klein: Versuchen Sie, die Leinwand über vorgelagertes `Image Resize` zu skalieren oder den Kreis in größerem Maßstab neu zu zeichnen.
* Interaktion fühlt sich träge an: Bestätigen Sie, dass das Bild mindestens einmal bereitgestellt wurde und die Leinwand das Bild anzeigt; führen Sie den Block bei Bedarf neu aus.