> 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/spanish/function-blocks/blocks-reference/image-transformations/operations/image-translate.md).

# 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 <a href="#inputs" id="inputs"></a>

`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 <a href="#outputs" id="outputs"></a>

`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 <a href="#controls" id="controls"></a>

`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 <a href="#features" id="features"></a>

* 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 <a href="#usage" id="usage"></a>

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 <a href="#evaluation" id="evaluation"></a>

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 <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* 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 <a href="#troubleshooting" id="troubleshooting"></a>

* 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.