IF_LoadImagesS Node Documentation

Overview

The IF_LoadImagesS node is a part of the ComfyUI-IF_AI_tools suite, designed to facilitate the efficient handling and processing of image files within a ComfyUI workflow. This node allows users to load, manage, organize, and manipulate images from specified directories, enhancing the usability and functionality of ComfyUI for visual data workflows.

Functionality

The primary purpose of the IF_LoadImagesS node is to load images from a directory into ComfyUI, providing additional options for thumbnail creation, sorting, filtering, and subfolder inclusion. It generates various outputs including image data, image paths, and metadata, which can be utilized in subsequent processing steps within a ComfyUI pipeline.

Inputs

The IF_LoadImagesS node accepts the following inputs:

• Image: A selection of thumbnail images generated from the specified directory, allowing choice from existing images.
• Input Path: The directory path from where images should be loaded. It can be either an absolute or relative path.
• Start Index: An integer specifying the starting index of images to load from the directory.
• Stop Index: An integer specifying the stopping index (non-inclusive) of images to load.
• Load Limit: A selection to limit the maximum number of images to load, with options ranging from 10 to 100,000.
• Image Selected: A boolean indicating if a specific image has been selected from the thumbnail list.
• Available Image Count: An integer representing the total number of available images in the input directory.
• Include Subfolders: A boolean determining if images should be loaded from subfolders within the input path.
• Sort Method: A selection for sorting the files, with options to sort alphabetically, numerically, by date created, or by date modified.
• Filter Type: A filter for image file types, with options including none, png, jpg, jpeg, webp, gif, and bmp.
• Channel: A selection for handling color channels, defaults to using the "alpha" channel.

Outputs

This node produces multiple outputs that can be used to further process images in a ComfyUI workflow:

• Images: A list of tensor representations of the loaded images ready for processing.
• Masks: A list of mask tensors corresponding to the images, used for various image manipulation operations.
• Image Paths: A list of file paths to the original images, useful for referencing the source files.
• Filenames: A list of filenames of the loaded images.
• Count String: A list of strings representing the count of each image in the form of "current index/total count".
• Count Int: A list of integers representing the index count of each loaded image.

Usage in ComfyUI Workflows

In ComfyUI workflows, the IF_LoadImagesS node can serve as an essential entry point for integrating images into your processes. It allows users to:

1. Load a selection of images from a specified directory, which can then be used for tasks such as object detection, segmentation, or other image processing applications.
2. Filter and sort images based on user-defined criteria, ensuring that only relevant images are processed.
3. Utilize image and mask outputs for tasks requiring image manipulation or enhancement.
4. Seamlessly integrate with other nodes in ComfyUI to build complex workflows for image analysis, augmentation, or transformation.

Special Features and Considerations

• Thumbnail Generation: The node creates thumbnails for images, making it easier to manage and select images visually.
• Backup and Restore: Features for backing up and restoring input directories to safeguard the original images and ensure data integrity.
• Flexible Sorting and Filtering: Supports multiple sorting criteria and image filters, offering extensive customization to fit various use cases.
• Subfolder Inclusion: Capable of recursively loading images from subfolders, enhancing its utility in workflows that require comprehensive data loading.

This node is specifically designed to handle image inputs efficiently, making it an indispensable component in visual data workflows within ComfyUI. For more information on ComfyUI-IF_AI_tools and related functionalities, visit the GitHub repository.