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.