DP Load Image Folder:
The DP Load Image Folder node is designed to efficiently load and process a batch of images from a specified directory. This node is particularly useful for AI artists who need to handle multiple images simultaneously, allowing for streamlined workflows in image processing tasks. It offers capabilities such as resizing images to a target size, extracting metadata like seeds and prompts, and handling images with different color modes. The node also supports various cycling modes to determine the order in which images are processed, providing flexibility in how images are loaded and managed. By automating the image loading process, this node helps you focus on creative tasks rather than manual file handling.
DP Load Image Folder Input Parameters:
directory
This parameter specifies the folder path from which images will be loaded. It is crucial as it determines the source of the images to be processed. Ensure the directory path is correct and accessible to avoid errors.
image_load_cap
This parameter defines the maximum number of images to load in one batch. It impacts the node's performance and memory usage, as loading too many images at once can slow down processing. Adjust this value based on your system's capabilities.
skip_first_images
This parameter allows you to skip a specified number of images at the beginning of the directory. It is useful for bypassing unwanted images and starting processing from a specific point in the folder.
Cycler_Mode
This parameter determines the order in which images are loaded. Options include "fixed," "randomize," "increment," and "decrement," each offering a different method of cycling through images. Choose the mode that best suits your workflow needs.
index
This parameter sets the starting index for image loading. It is used in conjunction with the Cycler_Mode to control which image in the directory is processed first.
resize_image
This boolean parameter indicates whether images should be resized to a specified width and height. Enabling this option ensures all images are processed at a consistent size, which can be important for certain applications.
width
This parameter specifies the target width for resizing images. It is only applicable if resize_image is enabled and should be set according to the desired output dimensions.
height
This parameter specifies the target height for resizing images. Like the width parameter, it is only relevant when resize_image is enabled and should match the intended output size.
unique_id
This parameter is used to uniquely identify the node instance, particularly useful for UI updates and managing multiple instances of the node in a workflow.
DP Load Image Folder Output Parameters:
images
This output contains the processed images as tensors, ready for further processing or analysis. Each image is normalized and converted to a consistent format, ensuring compatibility with subsequent nodes.
prompts
This output provides the extracted prompts from the image metadata, which can be used for generating or guiding AI models in creative tasks.
negatives
This output includes any negative prompts or additional metadata extracted from the images, offering further context or instructions for AI models.
seeds
This output contains the seeds extracted from the image metadata, useful for reproducibility and consistency in AI-generated outputs.
filenames
This output lists the filenames of the processed images, allowing you to track and reference the original files easily.
DP Load Image Folder Usage Tips:
- Ensure the directory path is correct and contains the images you intend to process to avoid loading errors.
- Adjust the image_load_cap based on your system's memory capacity to optimize performance without overloading resources.
- Use the Cycler_Mode to control the order of image processing, which can be particularly useful for tasks requiring specific sequences or randomization.
- Enable resize_image and set appropriate width and height values to maintain consistency in image dimensions, especially when working with models that require fixed input sizes.
DP Load Image Folder Common Errors and Solutions:
Error opening image file
- Explanation: This error occurs when the node cannot access or open an image file, possibly due to an incorrect directory path or file permissions.
- Solution: Verify that the directory path is correct and that you have the necessary permissions to access the files. Ensure that the files are not corrupted.
Image mode not supported
- Explanation: This error arises when an image has an unsupported color mode that the node cannot process.
- Solution: Convert the images to a supported color mode, such as RGB, before loading them into the node.
Index out of range
- Explanation: This error happens when the specified index exceeds the number of available images in the directory.
- Solution: Adjust the index parameter to ensure it falls within the range of available images, or check the directory to confirm the number of images present.
