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.