Image Translate

Este bloque de función desplaza una imagen horizontal y/o verticalmente por un número de píxeles especificado. Las áreas que quedan expuestas se rellenan con un color de fondo elegido. Las entradas X displacement, Y displacement y Background Color son opcionales: si están vacías, la imagen permanece sin cambios o se usan valores por defecto.

📥 Entradas

Input Image Una imagen en escala de grises o en color que se va a desplazar.

X displacement Desplazamiento horizontal en píxeles. Valores positivos mueven la imagen hacia la derecha; negativos hacia la izquierda. Opcional — si está vacío se considera 0.

Y displacement Desplazamiento vertical en píxeles. Valores positivos mueven la imagen hacia abajo; negativos hacia arriba. Opcional — si está vacío se considera 0.

Background Color Color para rellenar las zonas expuestas tras el desplazamiento. Opcional — por defecto es negro si no se especifica.

📤 Salidas

Translated Image La imagen resultante tras aplicar el desplazamiento. Mantiene las mismas dimensiones que la entrada; el contenido se desplaza y los bordes se rellenan con el color elegido.

🕹️ Controles

X displacement Introduce el desplazamiento horizontal en píxeles. Usa valores negativos para mover a la izquierda.

Y displacement Introduce el desplazamiento vertical en píxeles. Usa valores negativos para mover hacia arriba.

Background Color Elige un color de fondo para rellenar las áreas vacías (puede venir de un bloque Pixel o de un bloque que genere color).

✨ Características

• Entradas opcionales: deja X displacement o Y displacement vacíos para mantener ese eje sin cambios.

• Conserva el tamaño de la imagen de entrada; el contenido desplazado se recorta al lienzo original.

• Funciona con imágenes en escala de grises y RGB.

• El relleno de fondo acepta valores de un solo canal o RGB según el tipo de imagen.

📝 Instrucciones de uso

1. Conecta un bloque que produzca imagen al Input Image.

2. Proporciona valores en píxeles a X displacement y/o Y displacement para mover la imagen.

3. Opcionalmente, conecta un valor a Background Color para controlar el relleno de las áreas expuestas.

4. Usa la salida Translated Image como entrada para los bloques siguientes (mostrar, analizar, guardar).

Ejemplos:

• Mover una imagen 50 píxeles a la derecha y 20 píxeles hacia abajo: X displacement = 50 y Y displacement = 20.

• Desplazar solo verticalmente: rellena Y displacement y deja X displacement vacío.

📊 Comportamiento al ejecutar

Al ejecutarse, el bloque lee la imagen de entrada y los valores de desplazamiento, desplaza los píxeles según lo solicitado, rellena las regiones descubiertas con el color elegido y devuelve la imagen traducida en la salida Translated Image. Los valores de desplazamiento ausentes se tratan como cero.

💡 Consejos y trucos

• Para evitar que partes importantes queden recortadas tras el desplazamiento, añade margen antes de desplazar usando Image Padding o aumenta el lienzo con Image Resize / Make Image, y luego traduce dentro del lienzo mayor.

• Usa Pixel o un pequeño bloque Make Image para crear un color de fondo preciso y conéctalo a Background Color.

• Combínalo con Image ROI o Image ROI Select para desplazar solo un área recortada, y luego usa Image Concatenate o Collage Images para reensamblar/visualizar los resultados.

• Si necesitas voltear o rotar el contenido tras desplazarlo, encadena Flip Image o Rotate Image Angle después de este bloque.

• Para maquetas en mosaico, desplaza varias secciones y únelas con Image Concatenate o Merge Channels según convenga.

🛠️ Solución de problemas

• Problema: partes importantes se cortan después del desplazamiento. Solución: añade margen antes de desplazar con Image Padding o aumenta el lienzo con Image Resize / Make Image, y luego traduce.

• Problema: el color de fondo no coincide con lo esperado. Solución: verifica que la entrada Background Color tenga el formato de canales correcto (un valor para escala de grises, triple RGB para color). Usa Pixel para asegurar el color exacto.

• Problema: no hay cambio tras indicar desplazamientos. Solución: comprueba que las entradas de desplazamiento estén conectadas y no vacías; los valores vacíos se toman como cero.

• Problema: preservar la calidad al desplazar muchos píxeles. Solución: considera traducir primero sobre un lienzo mayor para evitar recortes sucesivos; usa Show Image para verificar resultados.