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


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.augelab.com/german/function-blocks/detections-shapes/shape-analysis/contour-to-image.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.