> 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/contour-to-image.md).

# Contour to Image

Dieser Funktionsblock ermöglicht es Ihnen, einen rechteckigen Bereich aus einem Eingangsbild basierend auf einem angegebenen Kontur zu extrahieren. Er ist nützlich, um interessante Regionen in der Bildverarbeitung zu isolieren.

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

`Image Any` Das Quellbild, aus dem ein rechteckiger Bereich extrahiert werden soll.

`Contour` Die Kontur, auf der die rechteckige Extraktion basieren wird.

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

`Image Any` Die Ausgabe ist ein Bild, das den rechteckigen Bereich zeigt, der aus dem Quellbild basierend auf der bereitgestellten Kontur ausgeschnitten wurde.

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

Dieser Block hat keine spezifischen Steuerungen, die in der Benutzeroberfläche präsentiert werden – die Eingaben werden über verbundene Sockets verarbeitet.

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

`Contour-Based Extraction` Der Block verwendet Konturen, um zu bestimmen, wie das Quellbild zugeschnitten werden soll, was eine gezielte Isolation bestimmter Regionen ermöglicht.

`Rectangular Transformation` Die extrahierte Kontur wird in ein Standardrechteck umgewandelt, was die Benutzerfreundlichkeit für eine weitere Analyse verbessert.

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

1. **Connect Source Image**: Verbinden Sie das gewünschte Bild, aus dem Sie einen Bereich zuschneiden möchten, mit dem Eingangsbereich `Image Any`.
2. **Provide Contour Data**: Verbinden Sie die Konturdaten mit dem Eingangsbereich `Contour`. Diese Kontur sollte den Bereich von Interesse im Quellbild darstellen.
3. **Run the Block**: Bewerten Sie den Block, um den Zuschneidevorgang durchzuführen. Das Ergebnis zeigt den rechteckigen Bereich, der durch die Kontur definiert ist.

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

Wenn er ausgeführt wird, analysiert dieser Block die bereitgestellte Kontur, bestimmt das geeignete umschließende Rechteck im Quellbild und gibt die zugeschnittene Region aus.

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

<details>

<summary>Konturpräzision</summary>

Für beste Ergebnisse stellen Sie sicher, dass die bereitgestellte Kontur so präzise und geschlossen wie möglich ist. Verwenden Sie geeignete Kantenerkennungstechniken, um Konturen zu erstellen.

</details>

<details>

<summary>Bildvorverarbeitung</summary>

Ziehen Sie in Betracht, `Image Threshold` oder `Blur` anzuwenden, um das Eingangsbild zu verbessern, bevor es diesen Block erreicht, da sauberere Eingabedaten zu besseren Konturauszügen führen.

</details>

<details>

<summary>Umgang mit mehreren Konturen</summary>

Wenn Sie mehrere Konturen analysieren, möchten Sie möglicherweise durch die Konturen iterieren und diesen Block separat für jede Kontur ausführen, um mehrere zugeschnittene Bilder zu sammeln.

</details>

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

<details>

<summary>Keine Kontur bereitgestellt</summary>

Stellen Sie sicher, dass die Kontureingabe gültig und nicht leer ist. Eine leere Kontur führt zu keinem Ausgabebild.

</details>

<details>

<summary>Ungültiges Ausgabebild</summary>

Wenn das Ausgabebild leer oder falsch erscheint, überprüfen Sie die Konturdaten auf Genauigkeit und Integrität und stellen Sie sicher, dass das Eingangsbild korrekt formatiert ist und relevante Inhalte enthält.

</details>