> 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/shape-analysis/find-contour.md).

# Find Contour

Dieser Funktionsblock ermöglicht es Benutzern, Konturen in einem Graustufenbild zu erkennen. Er bietet Optionen zur Auswahl der Konturen-Approximationsmethode und zur Festlegung eines Mindestbereichs für erkannte Konturen. Die Ergebnisse umfassen die ausgewählte Kontur, ihre Position, Rotation und Fläche.

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

`Input Image (Gray)` Ein Graustufenbild, in dem Konturen erkannt werden.

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

`Selected Contour` Die Kontur, die derzeit basierend auf der Benutzereingabe ausgewählt ist.

`Contours` Eine Liste aller erkannten Konturen aus dem Eingangsbild.

`Contour Image` Das Originalbild mit der hervorgehobenen ausgewählten Kontur.

`Object Position` Die Position (Mitte) der ausgewählten Kontur.

`Object Rotation` Die Rotation der ausgewählten Kontur.

`Object Area` Die Fläche der ausgewählten Kontur.

`Object Count` Die Gesamtzahl der erkannten Konturen.

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

`Minimum Contour Area %` Ein Schieberegler, der den Mindestflächenprozentsatz für Konturen festlegt, um als gültig betrachtet zu werden.

`Approximation Method` Ein Dropdown-Menü zur Auswahl der Konturen-Approximationsmethode, wie Standard, Einfach oder verschiedene Teh-Chin-Methoden.

`Select Contour Object` Ein Dropdown-Menü zur Auswahl einer bestimmten Kontur aus der Liste der erkannten Konturen.

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

`Dynamic Contour Detection` In der Lage, Konturen in Echtzeit zu erkennen und visuelles Feedback zu geben.

`Multiple Methods for Contour Approximation` Benutzer können aus verschiedenen Approximationsmethoden wählen, um den Erkennungsprozess zu verfeinern.

`Detailed Outputs` Bietet nicht nur die erkannten Konturen, sondern auch relevante Attribute wie Fläche und Rotation.

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

1. **Input Image**: Verbinden Sie ein Graustufenbild mit dem Eingangsbereich `Input Image (Gray)`.
2. **Minimum Area festlegen**: Passen Sie den Schieberegler `Minimum Contour Area %` an, um kleine Konturen, die nicht von Interesse sind, herauszufiltern.
3. **Wählen Sie die Approximationsmethode aus**: Wählen Sie die gewünschte Konturen-Approximationsmethode aus dem Dropdown-Menü.
4. **Knoten ausführen**: Bewerten Sie den Block und untersuchen Sie die erkannten Konturen und deren Attribute.
5. **Spezifische Kontur auswählen**: Falls nötig, wählen Sie eine spezifische Kontur aus dem Dropdown-Menü `Select Contour Object`, um sich auf die Details dieser Kontur zu konzentrieren.

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

Bei der Ausführung generiert dieser Funktionsblock eine detaillierte Analyse der Konturen im Eingangsbild und gibt die ausgewählte Kontur zusammen mit der visuellen Ausgabe zurück.

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

<details>

<summary>Vorverarbeitung</summary>

Verwenden Sie einen `Blur`- oder `Image Threshold`-Funktionsblock vor diesem, um das Eingangsbild zu bereinigen, was zu einer genaueren Konturenerkennung führen kann.

</details>

<details>

<summary>Konturen-Spezifizität</summary>

Passen Sie den `Minimum Contour Area %` für Ihren spezifischen Anwendungsfall an, um Rauschen und unerwünschte kleine Konturen herauszufiltern.

</details>

<details>

<summary>Konturvisualisierung</summary>

Nachdem Sie eine Kontur ausgewählt haben, können Sie diese leicht im Ausgabebild visualisieren, um die Kontur effektiver zu erfassen.

</details>

<details>

<summary>Konturenbeschränkungen</summary>

Wenn Sie nicht die erwarteten Ergebnisse erhalten, überprüfen Sie die Flächenlimits und die Approximationssettings. Die Verwendung von Standardeinstellungen kann oft bessere anfängliche Ergebnisse liefern.

</details>

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

<details>

<summary>Keine Konturen erkannt</summary>

Wenn keine Konturen gefunden werden, stellen Sie sicher, dass Sie ein gültiges Graustufenbild eingeben, da Konturen nicht aus Farbbildern erkannt werden können.

</details>

<details>

<summary>Kontur nicht ausgewählt</summary>

Überprüfen Sie, ob Sie einen gültigen Index aus dem Dropdown-Menü `Select Contour Object` ausgewählt haben. Wenn keine Konturen die Kriterien erfüllen, passen Sie die Mindestfläche an oder überprüfen Sie das Eingangsbild.

</details>