ComfyUI Node: Multi Image Loader

Multi Image Loader:

The MultiImageLoader is a versatile node designed to streamline the process of loading and processing multiple images for AI art projects. Its primary function is to take a list of image paths, load each image, and convert them into a format suitable for further processing in AI models. This node is particularly beneficial for artists and developers who need to handle batches of images efficiently. It offers advanced resizing options, ensuring that images are uniformly prepared for model input, and includes features like image compression to optimize storage and processing speed. The node's ability to handle different image dimensions and apply consistent transformations makes it an essential tool for maintaining workflow efficiency and consistency in image-based AI projects.

Multi Image Loader Input Parameters:

image_paths

This parameter accepts a string containing paths to the images you wish to load, separated by new lines. It is crucial for specifying which images the node should process. The paths can be absolute or relative, and the node will attempt to resolve them to load the images. There are no explicit minimum or maximum values, but the paths must be valid and accessible.

width

This parameter defines the target width for resizing the images. It impacts the final dimensions of the processed images, ensuring they fit the desired size for model input. The width should be a positive integer, with no specific minimum or maximum values provided.

height

Similar to the width parameter, this defines the target height for resizing the images. It ensures that the images are resized to the correct dimensions for further processing. The height should also be a positive integer, with no specific minimum or maximum values provided.

interpolation

This parameter specifies the interpolation method used during image resizing. Options include methods like lanczos, which can affect the quality and smoothness of the resized images. The choice of interpolation method can impact the visual quality of the output.

resize_method

This parameter determines how the images are resized, with options such as pad or crop. It affects how the node handles images that do not match the target dimensions, either by padding them to fit or cropping them to the desired size.

multiple_of

This parameter ensures that the final dimensions of the images are multiples of a specified value. It is useful for aligning image dimensions with model requirements that necessitate specific size constraints. The value should be a positive integer.

img_compression

This parameter controls the level of compression applied to the images after resizing. It ranges from 0 (no compression) to 100 (maximum compression), affecting the file size and quality of the output images. A higher compression value results in smaller file sizes but may reduce image quality.

Multi Image Loader Output Parameters:

multi_output

This output is a batched tensor containing all successfully loaded and processed images. It is crucial for feeding a batch of images into AI models for simultaneous processing. The tensor's dimensions depend on the number of images and their processed size.

padded_results

This output consists of individual image tensors, each padded to ensure a consistent output length of 50. It provides flexibility for handling images individually, even if the batch size is smaller than 50. Each tensor maintains the processed image's dimensions and format.

Multi Image Loader Usage Tips:

• Ensure that all image paths are valid and accessible to avoid loading errors.
• Choose the appropriate resize method and interpolation to maintain image quality and meet model input requirements.
• Use the multiple_of parameter to align image dimensions with model constraints, ensuring compatibility.
• Adjust the img_compression parameter to balance between image quality and file size, especially when working with large datasets.

Multi Image Loader Common Errors and Solutions:

Warning: Image path not found: <path>

• Explanation: This error occurs when the specified image path does not exist or is inaccessible.
• Solution: Verify that the image paths are correct and that the files are located in the specified directories.

Multi Image Loader Warning: Images have different dimensions due to resize settings. Cannot batch into multi_output.

• Explanation: This warning indicates that the images have varying dimensions after resizing, preventing them from being batched together.
• Solution: Ensure consistent resize settings and dimensions for all images to allow successful batching. Adjust the resize method or dimensions as needed.