> 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/point-polygon-test.md).

# Point Polygon Test

Dieser Funktionsblock ist so konzipiert, dass er bestimmt, ob sich Punkte einer bestimmten Testform innerhalb einer definierten umschließenden Form befinden. Die Ergebnisse werden visuell im Ausgabebild dargestellt.

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

`Image Gray` Das Hintergrundbild, auf dem die Formen gezeichnet werden.

`Test Shape` Die Menge von Punkten (Form), die gegen die umschließende Form getestet werden soll.

`Enclosing Shape` Die größere Form, die verwendet wird, um zu überprüfen, ob die Punkte der Testform darin liegen.

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

`Output Image` Das resultierende Bild, das visuell die Testform und die umschließende Form sowie die Positionen der Punkte anzeigt.

`Plot Image` Eine boolesche Ausgabe, die anzeigt, ob Punkte innerhalb der umschließenden Form liegen.

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

Dieser Funktionsblock hat keine zusätzlichen Steuerungen; jedoch hängt das Verhalten des Blocks von den Konfigurationen der Eingangsformen ab.

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

`Visual Representation` Bietet eine visuelle Ausgabe, die klar zeigt, welche Punkte der Testform innerhalb oder außerhalb der umschließenden Form liegen.

`Distance Calculation` Führt einen Punkt-in-Polygon-Test für jeden Punkt in der Testform durch und markiert sie entsprechend im Ausgabebild.

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

1. **Connect Input Images**: Verknüpfen Sie ein Graustufenbild mit dem Eingangsbereich `Image Gray`, das als Hintergrund dient.
2. **Define Shapes**: Stellen Sie sicher, dass Sie sowohl eine Testform als auch eine umschließende Form mit ihren jeweiligen Eingängen verbinden.
3. **Evaluate**: Führen Sie den Block aus, um den Punkt-in-Polygon-Test durchzuführen. Das Ausgabebild wird mit markierten Punkten generiert, die gemäß ihrem Status (innerhalb oder außerhalb der umschließenden Form) gekennzeichnet sind.

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

Beim Ausführen wird dieser Funktionsblock die angegebenen Punkte gegen die umschließende Form prüfen und ein annotiertes Bild sowie ein boolesches Ergebnis zurückgeben, das angibt, ob alle Punkte innerhalb der Form liegen.

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

<details>

<summary>Visuelle Klarheit</summary>

Verwenden Sie eine hochkontrastierende Farbe für die umschließende Form, um sicherzustellen, dass sie leicht von der Testform zu unterscheiden ist.

</details>

<details>

<summary>Ausrichtung der Formen</summary>

Stellen Sie sicher, dass Ihre Test- und umschließenden Formen richtig überlappen, um bedeutungsvolle Ergebnisse zu gewährleisten.

</details>

<details>

<summary>Vorverarbeitung</summary>

Die Vorverarbeitung des Eingangs-Graustufenbildes mit `Denoising` oder `Image Threshold` kann helfen, die Erkennung der Formen vor dem Test zu verbessern.

</details>

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

<details>

<summary>Keine Punkte erkannt</summary>

Wenn keine Punkte im Ausgabebild erscheinen, stellen Sie sicher, dass die Testform richtig definiert ist und mit der umschließenden Form überlappt. Überprüfen Sie, ob die Eingangsformen korrekt formatiert sind.

</details>

<details>

<summary>Ausgabeambiguität</summary>

Passen Sie die Farben und Linienstärken an, die zum Zeichnen der Konturen verwendet werden, wenn die Ergebnisse nicht deutlich sichtbar sind. Erwägen Sie, kontrastierende Farben für eine bessere Unterscheidung zu verwenden.

</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/point-polygon-test.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.
