> 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/roi-processing/perspective-transform.md).

# Perspective Transform

Dieser Funktionsblock ermöglicht es Benutzern, eine perspektivische Transformation auf ein Bild anzuwenden, indem sie vier Punkte auswählen. Diese Punkte definieren einen rechteckigen Bereich im Eingangsbild, der transformiert wird, um einem gegebenen Zielrechteck zu entsprechen.

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

`Image Any` Das Eingangsbild, auf das Sie die perspektivische Transformation anwenden möchten.

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

`Image Any` Das Ausgabebild nach der Anwendung der perspektivischen Transformation.

`Transform Matrix` Die Matrix, die für die perspektivische Transformation verwendet wird, nützlich, um zu verstehen, wie die Transformation angewendet wurde.

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

`Mouse Clicks` Klicken Sie auf das im Block angezeigte Bild, um vier Punkte für die perspektivische Transformation in Uhrzeigerrichtung ab dem unteren linken Eckpunkt zu definieren.

`Keyboard Controls`

* Drücken Sie `C`, um die vorhandenen Punkte zu löschen.
* Drücken Sie `U`, um den zuletzt hinzugefügten Punkt rückgängig zu machen.

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

`Interactive User Input` Benutzer können interaktiv Punkte auf dem Bild mit Mausklicks auswählen, was eine einfache Anpassung ermöglicht.

`Visual Feedback` Die auf dem Bild gezeichneten Punkte und Linien bieten sofortiges visuelles Feedback und helfen den Benutzern zu verstehen, wie die Transformation erfolgen wird.

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

1. **Input an Image**: Verbinden Sie ein Bild mit dem Eingang des Blocks.
2. **Select Four Points**: Klicken Sie auf das Bild, um die vier Ecken des Bereichs, den Sie transformieren möchten, im Uhrzeigersinn ab dem unteren linken Eckpunkt zu definieren.
3. **Clear or Undo**: Wenn Sie einen Fehler machen, können Sie `C` drücken, um alle Punkte zu löschen, oder `U`, um den zuletzt hinzugefügten Punkt rückgängig zu machen.
4. **Evaluate**: Führen Sie den Block aus, um die perspektivische Transformation durchzuführen. Das Ausgabebild spiegelt die Transformation wider, und die Matrix steht für weitere Nutzung zur Verfügung.

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

Beim Auswerten gibt dieser Funktionsblock das transformierte Bild zurück, basierend auf den ausgewählten Punkten und der entsprechenden Transformationsmatrix.

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

<details>

<summary>Punkte genau definieren</summary>

Für die besten Ergebnisse sollten die Punkte genau definiert werden, insbesondere bei nicht-rechteckigen Formen. Nehmen Sie sich Zeit beim Klicken, um sicherzustellen, dass jeder Punkt so nah wie möglich an der gewünschten Position ist.

</details>

<details>

<summary>Bildgrößenanpassung verwenden</summary>

Wenn die Bildgröße zu groß ist und die Leistung beeinträchtigt, ziehen Sie in Betracht, den Funktionsblock `Image Resizer` vor der Anwendung der perspektivischen Transformation zu verwenden.

</details>

<details>

<summary>Zuschneiden vor der Transformation</summary>

Wenn Sie nur einen bestimmten Bereich transformieren möchten, verwenden Sie `Image ROI`, um den Bereich zuerst zuzuschneiden, bevor Sie die perspektivische Transformation anwenden, um den Fokus und die Leistung zu verbessern.

</details>

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

<details>

<summary>Keine Punkte registriert</summary>

Wenn nichts auf dem Bild gezeichnet zu sein scheint, stellen Sie sicher, dass Sie auf den richtigen Bereich klicken und dass Sie genügend Zeit für die Reaktion der Zeichnungsaktion eingeplant haben, bevor Sie fortfahren.

</details>

<details>

<summary>Transformationsergebnis erscheint nicht korrekt</summary>

Überprüfen Sie erneut, dass die Punkte in der richtigen Reihenfolge ausgewählt wurden und ein gültiges Rechteck definieren. Wenn die Punkte zu nah beieinander liegen oder nicht korrekt positioniert sind, kann das Ergebnis anders als erwartet ausfallen.

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

```
GET https://docs.augelab.com/german/function-blocks/detections-shapes/roi-processing/perspective-transform.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.