> 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/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. --- # 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/translate-shape.md?ask=&goal= ``` `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.