ComfyUI Node: Load Images (Upload) 🎥🅥🅗🅢

Load Images (Upload) 🎥🅥🅗🅢:

The VHS_LoadImages node is designed to facilitate the loading of images from a specified directory, making it an essential tool for AI artists who need to work with large batches of images. This node allows you to upload images directly from a directory, providing flexibility and efficiency in managing image data. It supports various configurations such as limiting the number of images loaded, skipping initial images, and selecting every nth image, which can be particularly useful for handling large datasets. By leveraging this node, you can streamline your workflow, ensuring that only the necessary images are processed, thereby saving time and computational resources.

Load Images (Upload) 🎥🅥🅗🅢 Input Parameters:

directory

This parameter specifies the path to the directory from which images will be loaded. It is crucial to provide a valid directory path to ensure the node can locate and load the images. If the directory does not exist, an error will be raised. There is no default value for this parameter, and it must be provided by the user.

image_load_cap

This parameter sets the maximum number of images to load from the directory. If set to 0, all images in the directory will be loaded. This is useful for limiting the dataset size for quicker processing. The default value is 0, with a minimum value of 0 and no specified maximum value.

skip_first_images

This parameter allows you to skip a specified number of initial images in the directory. This can be useful if you want to bypass certain images that are not relevant to your current task. The default value is 0, with a minimum value of 0 and no specified maximum value.

select_every_nth

This parameter enables you to select every nth image from the directory, which can be useful for downsampling the dataset. For example, setting this to 2 will load every second image. The default value is 1, with a minimum value of 1 and no specified maximum value.

meta_batch

This optional parameter is used for batch processing, allowing you to manage and process images in batches. If not provided, the node will process images individually. There is no default value for this parameter.

unique_id

This optional parameter is used to uniquely identify the batch of images being processed. It is particularly useful when working with multiple batches to ensure that each batch is processed correctly. There is no default value for this parameter.

Load Images (Upload) 🎥🅥🅗🅢 Output Parameters:

images

This output parameter contains the loaded images as a tensor. The images are converted to a format suitable for further processing in AI models. If the images have an alpha channel, it will be separated from the main image data.

masks

This output parameter contains the masks for the images if they have an alpha channel. If the images do not have an alpha channel, this parameter will contain a tensor of zeros.

image_count

This output parameter indicates the number of images successfully loaded from the directory. It provides a quick reference to verify that the expected number of images has been processed.

Load Images (Upload) 🎥🅥🅗🅢 Usage Tips:

• Ensure that the directory path provided is valid and contains the images you intend to load.
• Use the image_load_cap parameter to limit the number of images loaded, which can help in managing memory usage and processing time.
• Utilize the skip_first_images and select_every_nth parameters to fine-tune the selection of images, especially when working with large datasets.
• When working with batch processing, make sure to provide unique values for the unique_id parameter to avoid conflicts.

Load Images (Upload) 🎥🅥🅗🅢 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 it exists on your file system.

No files in directory 'directory'.

• Explanation: The specified directory does not contain any files that can be loaded.
• Solution: Ensure that the directory contains image files and that the file extensions are supported.

No images could be loaded from directory 'directory'.

• Explanation: The node was unable to load any images from the specified directory, possibly due to unsupported file formats or other issues.
• Solution: Check that the images in the directory are in a supported format and that there are no issues with the files themselves.