ComfyUI Node: 💾 Image Sequence Loader

Image Sequence Loader [Dream]:

The Image Sequence Loader [Dream] node is designed to facilitate the loading of image sequences from a specified directory, making it an essential tool for AI artists working with animations or frame-by-frame image processing. This node allows you to specify a directory path and a pattern to match the filenames of the images you want to load. It can handle different indexing methods, such as numeric or alphabetic order, to ensure the correct sequence of images is loaded. Additionally, it provides a fallback option to use a default image if the specified frame is not found, ensuring smooth and uninterrupted workflows. This node is particularly useful for creating animations, processing image sequences, or any task that requires sequential image loading.

Image Sequence Loader [Dream] Input Parameters:

frame_counter

The frame_counter parameter is a required input that keeps track of the current frame to be loaded. It ensures that the correct image in the sequence is selected based on the current frame number.

directory_path

The directory_path parameter specifies the path to the directory containing the image sequence. This is a required input and should be a string. The default value is an empty string (''). This parameter is crucial as it tells the node where to look for the images.

pattern

The pattern parameter defines the filename pattern to match the images in the directory. This is a required input and should be a string. The default value is '*', which matches all files. This parameter helps in filtering the images that need to be loaded based on their filenames.

indexing

The indexing parameter determines the method used to index the images in the sequence. It can be either numeric or alphabetic order. This is a required input and helps in organizing the images in the correct sequence.

default_image

The default_image parameter is an optional input that specifies a fallback image to be used if the specified frame is not found in the directory. This parameter ensures that the workflow is not interrupted due to missing frames.

Image Sequence Loader [Dream] Output Parameters:

image

The image output parameter provides the loaded image for the current frame. If the specified frame is not found, it returns the default image if provided. This output is essential for further processing or animation tasks.

frame_name

The frame_name output parameter returns the name of the loaded frame. This can be useful for logging, debugging, or any task that requires knowledge of the specific frame being processed.

Image Sequence Loader [Dream] Usage Tips:

• Ensure that the directory_path is correctly specified and accessible to avoid issues with loading images.
• Use a consistent naming pattern for your image files to make the most of the pattern parameter.
• Choose the appropriate indexing method based on how your images are named to ensure they are loaded in the correct sequence.
• Provide a default_image to handle cases where some frames might be missing, ensuring a smooth workflow.

Image Sequence Loader [Dream] Common Errors and Solutions:

"Directory not found"

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

"No matching files found"

• Explanation: No files in the directory match the specified pattern.
• Solution: Check the pattern parameter to ensure it correctly matches the filenames of the images you want to load.

"Frame not found"

• Explanation: The specified frame number does not correspond to any file in the directory.
• Solution: Ensure that the frame_counter is within the range of available frames and that the files are correctly indexed.

"Default image not provided"

• Explanation: A frame is missing, and no default image is provided.
• Solution: Provide a default_image to handle missing frames and ensure continuous processing.