> 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/image-roi-center.md).

# Image ROI Center

Dieser Funktionsblock wird verwendet, um ein Bild basierend auf angegebenen Mittelpunktkoordinaten, Breite und Höhe zuzuschneiden. Er ermöglicht es den Benutzern, einen bestimmten Interessensbereich (ROI) innerhalb eines Bildes für die weitere Verarbeitung zu definieren.

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

`Image Any` Das Eingangsbild, aus dem der Interessensbereich extrahiert wird.

`Center` Ein Punkt, der den Mittelpunkt des Bereichs darstellt, den Sie zuschneiden möchten.

`Width` Die Breite des Zuschneidebereichs.

`Height` Die Höhe des Zuschneidebereichs.

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

`Image Any` Das zugeschnittene Bild, das aus dem angegebenen Interessensbereich extrahiert wurde.

`Rectangle` Die Koordinaten des rechteckigen Bereichs, der den ROI definiert.

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

Dieser Funktionsblock hat keine direkten Steuerungen, da die Eingabeparameter direkt über die verbundenen Knoten angegeben werden.

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

`Flexible Cropping` Ermöglicht das dynamische Festlegen des Zuschneidebereichs basierend auf den Mittelpunktkoordinaten und anpassbaren Abmessungen.

`Output Rectangle Coordinates` Gibt die Koordinaten des zugeschnittenen Rechtecks aus und bietet nützliche Informationen über den Zuschneidebereich für die weitere Verarbeitung oder Annotation.

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

1. **Connect Input Image**: Verbinden Sie ein Bild mit dem `Image Any` Eingang.
2. **Specify Center**: Geben Sie einen Punkt für den Mittelpunkt des Zuschneidebereichs im `Center` Eingang an.
3. **Set Dimensions**: Definieren Sie die gewünschte `Width` und `Height` für den Zuschneidebereich.
4. **Evaluate Block**: Führen Sie den Block aus, um das Bild zu verarbeiten und die zugeschnittene Ausgabe zusammen mit den Rechteckkoordinaten zu erhalten.

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

Wenn er ausgeführt wird, gibt dieser Funktionsblock den Bereich des Bildes aus, der durch den Mittelpunkt und die angegebenen Abmessungen definiert ist, wodurch ein neues Bild entsteht, das eine zugeschnittene Version des Originals ist.

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

<details>

<summary>Setzen von Mittelpunktkoordinaten</summary>

Stellen Sie sicher, dass die Mittelpunktkoordinaten innerhalb der Grenzen des Originalbildes gültig sind, um Fehler zu vermeiden.

</details>

<details>

<summary>Gültige Abmessungen sicherstellen</summary>

Stellen Sie sicher, dass die definierte Breite und Höhe des Zuschneidebereichs die Abmessungen des Originalbildes nicht überschreiten.

Sie sollten einen Schritt mit dem Block `Image Resolution and Channel Value` hinzufügen, um die Originalabmessungen korrekt zu überprüfen.

</details>

<details>

<summary>Verwendung mit anderen Funktionen</summary>

Dieser Block funktioniert gut mit dem Block `Show Image`, um die ROI nach dem Zuschneiden visuell zu bestätigen.

</details>

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

<details>

<summary>Zugeschnittenes Bild ist leer</summary>

Wenn das resultierende zugeschnittene Bild leer erscheint, stellen Sie sicher, dass die Mittelpunktkoordinaten und Abmessungen korrekt für den Bereich eingestellt sind, den Sie zuschneiden möchten.

</details>

<details>

<summary>Koordinaten außerhalb der Grenzen</summary>

Wenn Sie einen Fehler bezüglich außerhalb der Grenzen liegender Koordinaten erhalten, überprüfen Sie die Eingaben, um sicherzustellen, dass sie innerhalb der Grenzen der Originalbildabmessungen bleiben.

</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/image-roi-center.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.