> 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/input-output/outputs-exports/multi-image-write.md).

# Multi Image Write

Este bloque de función guarda múltiples imágenes en disco cuando una condición de escritura está activa. Soporta compresión opcional y acepta una ruta de carpeta y una plantilla de nombre de archivo para organizar los archivos guardados.

## 📥 Inputs <a href="#inputs" id="inputs"></a>

* `Folder Path`: Socket de entrada. Proporcione la ruta completa de la carpeta donde se guardarán las imágenes.
* `File Name`: Socket de entrada. Proporcione el nombre base del archivo (sin extensión). Puede usar una marca de tiempo o texto personalizado.
* `Write Condition`: Socket de entrada. Trigger booleano que inicia la operación de guardado cuando es True.
* `Input Images`: Socket de entrada. Acepta una o varias imágenes (lista). Cada imagen se guardará como un archivo separado.

## 📤 Outputs <a href="#outputs" id="outputs"></a>

Este bloque de función no produce salidas.

## 🕹️ Controls <a href="#controls" id="controls"></a>

* `Compress Image?`: Checkbox. Si está habilitado, las imágenes se guardan como JPEG con calidad reducida para un tamaño de archivo menor. Si está deshabilitado, las imágenes se guardan como PNG (sin pérdida).

## 🎨 Features <a href="#features" id="features"></a>

* Guardar muchas imágenes a la vez con una sola acción.
* Compresión JPEG opcional para reducir el uso de almacenamiento.
* Carpeta personalizable y nombre base para organizar los archivos guardados.
* Registra mensajes de éxito o error para cada archivo guardado.

## 📝 Usage Instructions <a href="#usage" id="usage"></a>

1. Proporcione una ruta en `Folder Path` (o use un bloque de selección de carpeta aguas arriba).
2. Establezca un nombre base en `File Name`. Use una cadena de tiempo o un contador para evitar colisiones.
3. Conecte una señal booleana a `Write Condition`; póngala en True para activar el guardado.
4. Envíe una o más imágenes a `Input Images`. Cada imagen se escribirá en disco con el nombre base y un sufijo de índice.
5. Active `Compress Image?` si prefiere compresión JPEG en lugar de PNG.

## 📊 Evaluation <a href="#evaluation" id="evaluation"></a>

Cuando `Write Condition` es True y las entradas son válidas, el bloque intenta guardar cada imagen de la lista proporcionada. Los guardados exitosos se registran; los fallos informan un error (por ejemplo, cuando la carpeta no es válida o falla la escritura en disco).

## 💡 Tips and Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Use `Choose Folder` para permitir a los usuarios seleccionar interactivamente la ubicación de guardado y conecte su salida a `Folder Path`.
* Combine con `Date-Time` para generar nombres de archivo únicos automáticamente (por ejemplo, marca temporal en `File Name`).
* Si necesita previsualizar imágenes antes de guardarlas, envíelas primero a `Show Image`.
* Reduzca el tamaño de las imágenes antes de guardarlas para ahorrar espacio y acelerar las escrituras usando `Image Resize` o `Image Resizer` aguas arriba.
* Para guardar múltiples imágenes relacionadas como un solo resumen visual, cree un montaje con `Collage Images` y luego guarde el collage.
* Si también necesita registro continuo de frames, considere emparejar con `Image Logger` para flujos de archivo automáticos.

## 🛠️ Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

* Errores de carpeta inválida: verifique que `Folder Path` exista y sea escribible. Use `Choose Folder` para evitar errores tipográficos.
* No se guardan imágenes: asegúrese de que `Input Images` esté conectado y que `Write Condition` sea True en el momento de la evaluación.
* Formatos corruptos o inesperados: alterne `Compress Image?` para cambiar entre JPEG y PNG y verifique la compatibilidad aguas abajo.
* Gran cantidad de imágenes ralentiza el sistema: redimensione las imágenes con `Image Resize` antes de escribir o habilite la compresión para reducir la E/S de disco.
