# Get Pixel

Dieser Funktionsblock ruft die Farbwerte eines bestimmten Pixels aus einem Eingangsbild ab. Er ist nützlich für Anwendungen, die Farbanalysen oder regionsbasierte Verarbeitung erfordern.

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

`Image Any` Diese Eingabe akzeptiert beliebige Bilddaten, aus denen Sie Pixelinformationen erhalten möchten.

`Point` Diese Eingabe gibt die (x, y)-Koordinaten des Pixels an, dessen Farbe Sie abrufen möchten.

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

`(Blue, Green, Red)` Diese Ausgabe liefert den Farbwert des angegebenen Pixels im Format BGR (Blau, Grün, Rot).

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

`Pixel Value Retrieval` Einfach die Farbwerte eines beliebigen Pixels im Eingangsbild abrufen.

`Coordinate Validation` Stellt sicher, dass die angegebenen Koordinaten innerhalb des gültigen Bereichs der Bilddimensionen liegen.

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

1. **Connect Image Input**: Verbinden Sie einen beliebigen bildproduzierenden Funktionsblock mit der Eingabe `Image Any`, um die Bilddaten bereitzustellen.
2. **Specify Pixel Position**: Geben Sie die x- und y-Koordinaten des Pixels ein, den Sie analysieren möchten, in der Eingabe `Point`. Stellen Sie sicher, dass diese Koordinaten gültig sind.
3. **Evaluate**: Führen Sie den Block aus, um den Farbwert des angegebenen Pixels abzurufen.

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

Nach der Auswertung liefert der Funktionsblock die BGR-Werte des durch die Position eingegebenen Pixels.

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

<details>

<summary>Ungültige Bild-Eingabe</summary>

Wenn Sie einen Fehler bezüglich des ungültigen Eingabetypen erhalten, stellen Sie sicher, dass die Bildeingabe korrekt verbunden und vom geeigneten Typ ist.

</details>

<details>

<summary>Ungültige Positionsfehler</summary>

Achten Sie beim Bereitstellen der Koordinaten darauf, dass sie innerhalb der Grenzen der Bilddimensionen liegen. Die Pixelposition muss innerhalb der Breite und Höhe des Bildes liegen, andernfalls erhalten Sie einen Fehler zu Höhe oder Breite.

</details>

<details>

<summary>Kein Bild ausgewählt</summary>

Wenn die Ausgabe nicht Ihren Erwartungen entspricht, überprüfen Sie, ob die Bildeingabe nicht leer (`None`) ist. Eine erfolgreiche Verbindung sollte gültige Pixel-Daten zurückgeben.

</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/blocks-reference/detections-shapes/roi-processing/get-pixel.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.
