> 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/funktionsblocke/blocks-reference/detections-shapes/shape-analysis/translate-shape.md).

# Translate Shape

Dieser Funktionsblock verschiebt geometrische Shapes um die angegebenen horizontalen und vertikalen Offsets. Verwenden Sie ihn, wenn Sie Punkte, Rechtecke, Kreise oder Konturen innerhalb des Bild-Koordinatensystems verschieben müssen.

## 📥 Eingänge

`Shape`\
Ein zu verschiebendes Shape. Akzeptierte Typen:

* Einzelner Punkt (x, y)
* Rechteck definiert durch zwei Eckpunkte
* Kreis definiert durch center\_x, center\_y, radius
* Kontur (eine geordnete Liste/Array von (x,y)-Punkten)

`X`\
Horizontaler Verschiebungswert (optional). Ganzzahl in Pixeln, um das Shape entlang der X-Achse zu verschieben. Standard ist 0, falls nicht angegeben.

`Y`\
Vertikaler Verschiebungswert (optional). Ganzzahl in Pixeln, um das Shape entlang der Y-Achse zu verschieben. Standard ist 0, falls nicht angegeben.

(Alle oben genannten sind Eingangs-Sockets.)

## 📤 Ausgänge

`Shape`\
Das verschobene Shape zurückgegeben im selben Format wie der Eingang (Punkt, Rechteck, Kreis oder Kontur).

(Dieser Ausgang ist ein Output-Socket.)

## 🕹️ Controls

Dieser Funktionsblock verfügt über keine zusätzlichen Steuerelemente oder Widgets. Geben Sie die Verschiebungswerte über die Eingangs-Sockets an.

## ⚙️ Ausführungsmechanismus

* Beim Ausführen liest der Block das bereitgestellte `Shape` und die optionalen `X`- und `Y`-Werte ein.
* Verschiebungen werden als ganzzahlige Pixel-Offsets angewendet. Positive Werte bewegen das Shape nach rechts/unten, negative Werte nach links/oben.
* Der Block gibt denselben Shape-Typ zurück, verschoben um die angegebenen Offsets. Bei Konturen wird jeder Scheitelpunkt um denselben (`X`, `Y`) Offset verschoben.
* Wenn ein nicht unterstützter Shape-Typ oder ungültige Daten geliefert werden, meldet der Block einen Konfigurationsfehler — stellen Sie sicher, dass die Shape-Eingabe einem der akzeptierten Formate entspricht.

## ✨ Features

* Unterstützt gängige Shape-Typen: Punkt, Rechteck, Kreis und Kontur.
* Beibehaltung des Ausgabeformats identisch zum Eingang für nahtloses Verketten.
* Einfache, ganzzahlige Verschiebung für deterministische Positionierung.
* Funktioniert mit einzelnen Shapes oder Kontur-Arrays für Batch-Geometrie-Transformationen.

## 📝 Usage instructions

1. Geben Sie ein Shape an den `Shape`-Socket (z. B. die Kontur, die von einem Detector zurückgegeben wurde).
2. Geben Sie die horizontale Verschiebung an den `X`-Socket (optional).
3. Geben Sie die vertikale Verschiebung an den `Y`-Socket (optional).
4. Lesen Sie das verschobene Shape vom Ausgangs-Socket `Shape` und verwenden Sie es zum Zeichnen, Messen oder zur weiteren Verarbeitung.

## 💡 Tips and Tricks

* Kombination mit Detection- und ROI-Blöcken:
  * Verwenden Sie `Find Contour`, `Find Object` oder `Approximate Contour`, um Shapes zu erhalten, und speisen Sie diese dann in diesen Block, um Ergebnisse auszurichten oder zu versetzen.
  * Nutzen Sie `Image ROI`, `Image ROI Select` oder `Get ROI`, um vor dem Verschieben zu beschneiden oder auf einen Bereich zu fokussieren, damit die Koordinaten innerhalb einer Arbeitsregion konsistent bleiben.
* Arbeiten mit mehreren Shapes oder Listen:
  * Verwenden Sie `Batch Processing`, `Debatch` oder `Batch Concatenation`, um eine Liste von Shapes iterativ zu verschieben.
  * Um verschobene Ergebnisse visuell zu prüfen, senden Sie die Ausgabe an `Draw Point`, `Draw Rectangle` oder `Draw Result On Image`.
* Für Mess-Workflows:
  * Nach dem Verschieben von Shapes verwenden Sie `Measure Position Distance`, um Abstände zwischen verschobenen und Referenzpositionen zu berechnen.
  * Verwenden Sie `Minimum Rectangle`, `Hull Convex` oder `Contour to Image`, um geometrische Zusammenfassungen nach der Verschiebung zu konvertieren und zu vergleichen.
* Visualisierung und Debugging:
  * Um verschobene Konturen oder Rechtecke auf Bildern anzuzeigen, leiten Sie das verschobene Shape an `Draw Rectangle` oder `Draw Result On Image` weiter und prüfen Sie mit `Show Image`.

## 🛠️ Troubleshooting

* Keine sichtbare Änderung nach der Verschiebung:
  * Überprüfen Sie, ob nicht-null Werte für `X` oder `Y` angegeben wurden.
  * Stellen Sie sicher, dass der Zeichen-/Anzeige-Block (z. B. `Show Image` oder `Draw Rectangle`) das verschobene Shape erhält und dass dasselbe Koordinatensystem verwendet wird.
* Unerwartete Shape-Format-Fehler:
  * Bestätigen Sie, dass das Eingangs-Shape einem der unterstützten Formate entspricht (Punkt, Rechteck, Kreis oder Kontur).
  * Wenn Sie mit Listen arbeiten, stellen Sie sicher, dass diese über batch- oder listen-kompatiblen Fluss bereitgestellt werden (verwenden Sie `Batch Processing` / `Debatch` nach Bedarf).
* Shapes außerhalb des Bildbereichs:
  * Verschiebungen können Shapes außerhalb des Bildbereichs bewegen. Wenn dies problematisch ist, begrenzen Sie Koordinaten mittels nachgelagerter Prüfungen oder schneiden Sie die ROI vor der Verschiebung zu.