> 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-concatenate.md).

# Image Concatenate

Esta función combina varias imágenes en una sola colocándolas una al lado de otra (horizontal) o una después de otra (vertical). Alinea automáticamente las imágenes añadiendo bordes cuando las entradas tienen dimensiones diferentes, para obtener una imagen de salida limpia y única.

## 📥 Entradas

* `Image List` — Conector de entrada que acepta una o más imágenes para concatenar (soporta múltiples imágenes).

## 📤 Salidas

* `Image` — Conector de salida que entrega la imagen concatenada.

## 🕹️ Controles

* `Relation` — Desplegable para elegir la dirección de concatenación.
  * Elija entre HORIZONTAL o VERTICAL.

## 🎯 Características clave

* Alineación automática: si las imágenes de entrada tienen diferente ancho o alto, el bloque añade bordes para igualar tamaños y que queden alineadas.
* Soporta múltiples entradas: entregue una lista de imágenes y el bloque producirá una única imagen combinada.
* Cambio simple de orientación: alterne entre concatenación horizontal o vertical con el control `Relation`.

## ⚙️ Mecanismo de ejecución

Al ejecutarse, el bloque lee la `Image List`, asegura que cada imagen tenga dimensiones compatibles añadiendo bordes cuando sea necesario, y luego las fusiona según la `Relation` seleccionada. La imagen resultante se envía al conector `Image` para uso en bloques posteriores o para su visualización.

## 📝 Uso

1. Suministre imágenes al conector `Image List` — puede conectar varios bloques que generen imágenes o pasar una lista de imágenes.
2. Seleccione la distribución deseada con el desplegable `Relation`.
3. Lea el resultado combinado en la salida `Image` y úselo para mostrar, registrar o procesar más adelante.

## 💡 Consejos y trucos

* Para evitar bordes visibles y obtener resultados consistentes, use `Image Resizer` o `Image Resize` antes de este bloque para hacer que todas las imágenes tengan el mismo tamaño.
* Para controlar el color del relleno o añadir márgenes personalizados, prepare las imágenes con `Image Padding` y luego concaténelas.
* Recorte las entradas a las regiones exactas que desea combinar usando `Image ROI Select` o `Image ROI` antes de alimentarlas aquí.
* Use `Show Image` para previsualizar interactivamente el resultado concatenado.
* Para guardar o grabar la salida combinada, conecte `Image` a `Image Logger` o `Image Write`.
* Si desea un estilo tipo collage con bordes que indiquen estados OK/NOK, considere `Collage Images` como bloque alternativo o complementario.

## 🛠️ Solución de problemas

* Bordes negros inesperados: las imágenes tienen diferentes relaciones de aspecto. Acepte los bordes o use `Image Resizer` / `Image Padding` / `Image ROI Select` para igualar los tamaños de entrada.
* Salida vacía o faltante: asegúrese de que cada entrada en `Image List` sea una imagen válida. Use un bloque de vista previa como `Show Image` río arriba para verificar las entradas.
* Salida muy alta o muy ancha: elija la `Relation` VERTICAL u HORIZONTAL apropiada o redimensione las entradas a dimensiones manejables antes de concatenar.