ComfyUI Node: Load Image Batch From Dir (Inspire)

Load Image Batch From Dir (Inspire):

The LoadImagesFromDir __Inspire node is designed to streamline the process of loading multiple images from a specified directory, making it an essential tool for AI artists who work with large batches of images. This node automates the task of reading images from a folder, converting them into a format suitable for further processing, and optionally applying masks if available. By leveraging this node, you can efficiently manage and preprocess your image datasets, saving time and reducing manual effort. The node ensures that images are correctly oriented and converted to a consistent format, which is crucial for maintaining the quality and consistency of your AI-generated artwork.

Load Image Batch From Dir (Inspire) Input Parameters:

directory

The directory parameter specifies the path to the folder containing the images you want to load. This parameter is crucial as it directs the node to the correct location of your image files. Ensure that the directory path is accurate and accessible. There is no default value for this parameter, and it must be provided by the user.

image_load_cap

The image_load_cap parameter sets a limit on the number of images to load from the specified directory. This is useful when you want to restrict the number of images processed, either for performance reasons or to focus on a subset of your dataset. The default value is 0, which means no limit is applied. You can set this to any positive integer to cap the number of images loaded.

start_index

The start_index parameter determines the starting point within the directory's file list from which images will begin to load. This is helpful if you want to skip a certain number of files at the beginning of the directory. The default value is 0, meaning the loading starts from the first file. Adjust this value to control the starting point of the image loading process.

load_always

The load_always parameter is a boolean flag that, when set to True, forces the node to load images even if certain conditions might otherwise prevent it. This can be useful in scenarios where you need to ensure images are loaded regardless of other settings or constraints. The default value is False.

Load Image Batch From Dir (Inspire) Output Parameters:

images

The images output parameter provides a list of loaded images in a format suitable for further processing. Each image is converted to an RGB format and normalized to a float32 tensor, ensuring consistency and compatibility with subsequent AI processing steps. This output is essential for feeding images into your AI models or pipelines.

masks

The masks output parameter provides a list of masks corresponding to the loaded images. If an image contains an alpha channel, the mask is derived from it; otherwise, a default mask of zeros is provided. Masks are useful for tasks that require distinguishing between different regions of an image, such as segmentation or inpainting.

Load Image Batch From Dir (Inspire) Usage Tips:

• Ensure that the directory path provided is correct and accessible to avoid file not found errors.
• Use the image_load_cap parameter to manage memory usage and processing time by limiting the number of images loaded.
• Adjust the start_index parameter if you need to skip a certain number of files at the beginning of the directory.
• Set the load_always parameter to True if you encounter issues with images not loading due to specific conditions.

Load Image Batch From Dir (Inspire) Common Errors and Solutions:

Directory 'directory' cannot be found.

• Explanation: The specified directory path does not exist or is incorrect.
• Solution: Verify that the directory path is correct and that the directory exists.

No files in directory 'directory'.

• Explanation: The specified directory is empty or does not contain any valid image files.
• Solution: Ensure that the directory contains image files with valid extensions (.jpg, .jpeg, .png, .webp).

Image file format not supported.

• Explanation: The directory contains files with unsupported formats.
• Solution: Make sure that all image files in the directory are in one of the supported formats (.jpg, .jpeg, .png, .webp).

Image loading exceeded the specified cap.

• Explanation: The number of images in the directory exceeds the image_load_cap limit.
• Solution: Increase the image_load_cap value if you need to load more images, or reduce the number of images in the directory.