# Multi Image Write This function block saves multiple images to disk when a write condition is active. It supports optional compression and accepts a folder path and filename template to organize saved files. ## đŸ“Ĩ Inputs `Folder Path` input socket Provide full folder path where images will be saved.\ `File Name` input socket Provide base file name (without extension). A timestamp or custom text can be used.\ `Write Condition` input socket Boolean trigger that starts the save operation when True.\ `Input Images` input socket Accepts one or multiple images (list). Each image will be saved as a separate file. ## 📤 Outputs This function block does not produce any outputs. ## 🕹ī¸ Controls `Compress Image?` Checkbox When enabled, images are saved as JPEG with reduced quality for smaller file size. When disabled, images are saved as PNG (lossless). ## 🎨 Features * Save many images at once using a single action. * Optional JPEG compression to reduce storage usage. * Customizable folder and base file name to organize saved files. * Logs success or error messages for each saved file. ## 📝 Usage Instructions 1. Provide a path to `Folder Path` (or use a folder selection block upstream). 2. Set a base name in `File Name`. Use a time string or a counter to avoid collisions. 3. Connect a boolean signal to `Write Condition`; set it to True to trigger saving. 4. Feed one or more images into `Input Images`. Each image will be written to disk with the base name and an index suffix. 5. Toggle `Compress Image?` if you prefer JPEG compression over PNG. ## 📊 Evaluation When the `Write Condition` is True and valid inputs are present, the block attempts to save each image in the provided list. Successful saves are logged; failures report an error (for example when the folder is invalid or disk write fails). ## 💡 Tips and Tricks * Use `Choose Folder` to let users pick the save location interactively and feed its output to `Folder Path`. * Combine with `Date-Time` to generate unique file names automatically (e.g., timestamp in `File Name`). * If you need to preview images before saving, send them to `Show Image` first. * Reduce image size before saving to save space and speed up writes by using `Image Resize` or `Image Resizer` upstream. * For saving multiple related images as a single visual summary, create a montage with `Collage Images` and then save the collage. * If you also need continuous logging of frames, consider pairing with `Image Logger` for automatic archival workflows. ## 🛠ī¸ Troubleshooting * Invalid folder errors: check that `Folder Path` exists and is writable. Use `Choose Folder` to avoid typos. * No images saved: ensure `Input Images` is connected and `Write Condition` is True at the evaluation moment. * Corrupted or unexpected file formats: toggle `Compress Image?` to switch between JPEG and PNG and verify downstream compatibility. * Large number of images slows the system: resize images with `Image Resize` before writing or enable compression to reduce disk I/O. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.augelab.com/function-blocks/input-output/outputs-exports/multi-image-write.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.