CR Load Image List Plus Node Documentation

Overview

The CR Load Image List Plus node is a powerful utility within the Comfyroll Studio suite of custom nodes for ComfyUI, designed to facilitate the loading and processing of images from specified directories. This node not only loads images in a flexible manner but also provides additional metadata for enhanced workflow integration.

Features

• Load multiple images from a specified directory and return them as a list.
• Retrieve image masks and metadata such as index, filename, image dimensions, and list length.
• Supports optional direct path inputs for custom directory specifications.

Inputs

1. input_folder: Specifies the directory within the predefined input directory where images are stored. This is a dropdown selection of available folders.

2. start_index (INT): The index from which images are to be loaded. This allows selective loading from any point in the sequence of images in the folder.

3. max_images (INT): The maximum number of images to load starting from the start_index. This is useful for batching and processing a predefined number of images.

4. input_path (STRING, optional): A direct path to a directory that overrides the input_folder if specified. This allows for flexible directory inputs that are not constrained to the predefined folders in the setup.

Outputs

1. IMAGE: A list of images loaded from the specified path. These are ready for further use within ComfyUI workflows.

2. MASK: A list of corresponding image masks, typically used for masking operations in image processing workflows.

3. index (INT): A list of indexes corresponding to each image loaded, which can be used for identifying the order or sequence of images.

4. filename (STRING): Names of the files loaded in order. This is helpful for tracking or identifying images within a process.

5. width (INT): The width of images in pixels. This is standard for all images loaded.

6. height (INT): The height of images in pixels.

7. list_length (INT): The total number of images loaded, providing a quick reference for the scope of the image batch.

8. show_help (STRING): A URL providing further documentation and usage examples for the node: CR Load Image List Plus Documentation.

Usage in ComfyUI Workflows

The CR Load Image List Plus node is indispensable for workflows that require the bulk processing of images. It can be used in:

• Batch Processing: Load a predefined set of images for batch editing or filtering operations.
• Image Selection for Animation: Useful in animation workflows where sequential image manipulation is required.
• Preprocessing for Analysis: Ideal for setting up datasets for analysis by loading images along with their metadata for analysis.
• Masking Operations: Automatically retrieve masks which can be used in differential image editing or compositing tasks.

Special Considerations

• Ensure that the directory you select or specify in the input_path contains image files in supported formats. An empty directory will not produce outputs.
• Use the max_images input to manage memory and processing efficiency, especially when working with large datasets.
• The start_index and max_images parameters afford control over the subset of images you wish to process, allowing targeted processing within larger datasets.

By leveraging the robust features of the CR Load Image List Plus node, users can streamline image handling operations, making them an integral part of any ComfyUI workflow requiring image input management.