Image Translate

Dieser Funktionsblock verschiebt ein Bild horizontal und/oder vertikal um eine angegebene Anzahl von Pixeln. Der freigelegte Bereich wird mit einer gewählten Hintergrundfarbe gefüllt. Die Eingänge X displacement, Y displacement und Background Color sind optional — leere Werte lassen das Bild unverändert bzw. verwenden voreingestellte Standardwerte.

📥 Eingänge

Input Image Ein Graustufen- oder Farbbild, das verschoben werden soll (image socket).

X displacement Horizontale Verschiebung in Pixeln (number socket). Positive Werte verschieben nach rechts, negative nach links. Optional — bei leerem Wert wird 0 angenommen.

Y displacement Vertikale Verschiebung in Pixeln (number socket). Positive Werte verschieben nach unten, negative nach oben. Optional — bei leerem Wert wird 0 angenommen.

Background Color Füllfarbe für die freigelegten Hintergrundbereiche (pixel socket). Optional — standardmäßig schwarz, wenn nicht angegeben.

📤 Ausgänge

Translated Image Das resultierende Bild nach der Verschiebung (image socket). Das Ausgabebild hat dieselben Abmessungen wie das Eingabebild; der Inhalt ist verschoben und die Ränder mit der gewählten Farbe gefüllt.

🕹️ Steuerungen

X displacement Geben Sie die horizontale Verschiebung in Pixeln ein. Negative Werte verschieben nach links.

Y displacement Geben Sie die vertikale Verschiebung in Pixeln ein. Negative Werte verschieben nach oben.

Background Color Wählen Sie eine Hintergrundfarbe zum Füllen der neu freigelegten Bereiche (verwenden Sie einen Pixel-Eingang oder ein farbproduzierendes Block).

✨ Funktionen

• Optionale Eingänge: Lassen Sie X displacement oder Y displacement leer, um diese Achse unverändert zu lassen.

• Erhält die Größe des Eingabebildes; verschobener Inhalt wird auf die ursprüngliche Leinwand zugeschnitten.

• Funktioniert mit Graustufen- und RGB-Bildern.

• Die Hintergrundfüllung akzeptiert Einzelkanal- oder RGB-Werte, je nach Eingabebild.

📝 Nutzungshinweise

1. Verbinden Sie einen bildproduzierenden Block mit Input Image.

2. Geben Sie Pixelwerte für X displacement und/oder Y displacement an, um das Bild zu verschieben.

3. Optional: Geben Sie Background Color an, um die Füllfarbe der freigelegten Bereiche zu steuern.

4. Verwenden Sie die Ausgabe Translated Image als Eingabe für nachfolgende Blöcke (Anzeigen, Analyse, Speichern).

Beispiele:

• Verschieben Sie ein Bild um 50 Pixel nach rechts und 20 Pixel nach unten, indem Sie X displacement = 50 und Y displacement = 20 setzen.

• Nur vertikal verschieben: Wert bei Y displacement angeben und X displacement leer lassen.

📊 Laufverhalten

Beim Ausführen liest der Block das Eingabebild und die Verschiebungswerte, verschiebt die Pixel um den gewünschten Betrag, füllt die freigelegten Regionen mit der gewählten Farbe und gibt das verschobene Bild über den Socket Translated Image zurück. Fehlende Verschiebungswerte werden als Null behandelt.

💡 Tipps und Tricks

• Damit wichtige Bildinhalte nach der Verschiebung nicht abgeschnitten werden, fügen Sie vorher einen Rand hinzu mit Image Padding oder vergrößern Sie die Leinwand mit Image Resize / Make Image, und verschieben Sie dann innerhalb der größeren Leinwand.

• Verwenden Sie Pixel oder einen kleinen Make Image-Block, um eine präzise Hintergrundfarbe zu erzeugen und diese an Background Color anzuschließen.

• Kombinieren Sie mit Image ROI oder Image ROI Select, um nur einen ausgeschnittenen Bereich zu verschieben, und setzen Sie anschließend mit Image Concatenate oder Collage Images wieder zusammen/visualisieren.

• Benötigen Sie ein Spiegeln oder Drehen nach der Verschiebung, ketten Sie Flip Image oder Rotate Image Angle hinter diesen Block.

• Für Kachel-Layouts oder Komposition: Verschieben Sie mehrere Ausschnitte und fügen Sie sie mit Image Concatenate oder Merge Channels wieder zusammen.

🛠️ Fehlersuche

• Problem: Wichtige Bildteile werden nach der Verschiebung abgeschnitten. Lösung: Fügen Sie vor der Verschiebung Rand hinzu mit Image Padding oder vergrößern Sie die Leinwand mit Image Resize / Make Image, dann verschieben.

• Problem: Hintergrundfarbe entspricht nicht dem erwarteten Ergebnis. Lösung: Stellen Sie sicher, dass der Eingang Background Color das richtige Kanalformat liefert (Einzelwert für Graustufen, RGB-Triple für Farbbilder). Verwenden Sie Pixel, um eine exakte Farbe bereitzustellen.

• Problem: Keine Änderung nach Angabe der Verschiebungswerte. Lösung: Prüfen Sie, ob die Verschiebungs-Eingänge verbunden sind und nicht leer sind; leere Werte entsprechen 0.

• Problem: Bildqualität soll bei großen Verschiebungen erhalten bleiben. Lösung: Verschieben Sie zunächst auf einer größeren Leinwand und vermeiden Sie mehrfaches Zuschneiden; prüfen Sie Ergebnisse mit nachfolgenden Blöcken wie Show Image.