# 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>


---

# Agent Instructions: 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/shape-analysis/find-contour.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.
