> 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/collage-images.md).
# Collage Images
Esta función crea una sola imagen en collage a partir de múltiples imágenes de entrada. Si se proporciona una lista de banderas correspondiente (OK/NOK), el collage añade bordes coloreados a cada mosaico para indicar el estado.
## 📥 Entradas
* `Image List` Una lista de imágenes que se combinarán en el collage (pueden ser imágenes de distintos tamaños).
* `Flag List` Lista opcional de banderas booleanas o de estado (OK/NOK) que coinciden con cada imagen en la `Image List`. Si se proporciona, los mosaicos muestran un borde de color que indica el estado.
## 📤 Salidas
* `Collaged Image` La imagen combinada resultante creada a partir de la lista de entrada.
## 🕹️ Controles
* `Select Image Size (Pixel)` Use este control deslizante para establecer el tamaño de cada mosaico en el diseño del collage. Valores mayores producen mosaicos más grandes y una imagen final de collage mayor.
## 🎨 Funcionalidades
* Fusión sencilla de múltiples imágenes en una única vista previa adecuada para informes, paneles o inspecciones rápidas.
* Soporte opcional de marcado por bandera para señalar visualmente cada mosaico como OK o NOK mediante bordes.
* Tamaño de mosaico ajustable para equilibrar detalle y dimensiones finales del collage.
* Acepta fuentes de imagen mixtas (fotogramas de cámara, recortes procesados, imágenes guardadas).
## ⚙️ Mecanismo de ejecución
Al ejecutarse, el bloque lee la `Image List` proporcionada y, opcionalmente, la `Flag List`. Redimensiona o adapta las imágenes según el valor de `Select Image Size (Pixel)` y las coloca en una cuadrícula. Si hay banderas y coinciden con la cantidad de imágenes, cada mosaico recibe un borde de color que indica su estado OK/NOK. La imagen final combinada se emite por la salida `Collaged Image`.
## 📝 Instrucciones de uso
1. Prepare las imágenes que desea combinar y conéctelas a la entrada `Image List`.
2. Opcionalmente, proporcione una `Flag List` de la misma longitud para añadir bordes de estado.
3. Ajuste `Select Image Size (Pixel)` para cambiar el tamaño de los mosaicos según legibilidad o compacidad.
4. Conecte la salida `Collaged Image` a un bloque de visualización o de guardado para inspeccionar o almacenar el resultado.
## 💡 Consejos y recomendaciones
* Normalice los tamaños de entrada para obtener collages más estéticos: use `Image Resize` o `Image Resizer` antes de alimentar las imágenes en la `Image List`.
* Si desea recolectar múltiples regiones recortadas de una misma fuente, use `Image ROI Select Multi` para construir su `Image List`.
* Genere banderas automáticamente combinando bloques de detección como `Mask Detection`, `Object Detection` o `Object Detection - Custom`. Use los resultados de detección (lógica OK/NOK) para construir la `Flag List` para inspección visual.
* Previsualice el collage conectando la salida a `Show Image`.
* Guarde collages automáticamente usando `Multi Image Write` o regístrelos con `Image Logger` para trazabilidad.
* Cuando use muchas imágenes, reduzca `Select Image Size (Pixel)` para mantener el collage dentro de los límites de visualización o tamaño de archivo.
## 🛠️ Solución de problemas
* Si los bordes aparecen faltantes o incorrectos, confirme que la longitud de la `Flag List` sea igual a la de la `Image List`.
* Si las imágenes se ven estiradas o recortadas inesperadamente, agregue un paso de `Image Resize` para estandarizar las relaciones de aspecto antes de crear el collage.
* Si el collage es demasiado grande para mostrarlo o guardarlo, disminuya el valor de `Select Image Size (Pixel)`.