ComfyUI Node: 📁 Load Image Sequence

📁 Load Image Sequence:

The LoadImageSequence node is designed to facilitate the loading and management of image sequences from a specified folder. This node is particularly useful for AI artists who work with animations or series of images, as it allows for the sequential or random loading of images based on user preferences. The node supports various image formats such as JPG, JPEG, PNG, BMP, TIFF, and WEBP, ensuring compatibility with a wide range of image files. It provides the capability to loop through the sequence or select images randomly, which can be particularly beneficial for creating dynamic visual content. The node also maintains the state of the sequence, allowing you to resume from where you left off, enhancing workflow efficiency.

📁 Load Image Sequence Input Parameters:

folder_path

The folder_path parameter specifies the directory path where the image sequence is stored. It is crucial for the node to locate and access the images you wish to load. Ensure that the path is correct and that the folder contains supported image formats. There are no specific minimum or maximum values, but the path must be valid and accessible.

loop_sequence

This parameter determines whether the image sequence should loop back to the beginning once the end is reached. If set to true, the sequence will restart from the first image, providing a continuous loop. This is particularly useful for animations or when you want to cycle through images repeatedly. The default value is typically false.

random_image

The random_image parameter allows you to load images in a random order rather than sequentially. This can add variability and unpredictability to your image sequence, which might be desirable in certain creative projects. The default value is false.

no_repeats

When random_image is enabled, the no_repeats parameter ensures that images are not repeated until all images have been shown once. This guarantees that each image in the sequence is displayed before any are repeated, providing a more diverse viewing experience. The default value is false.

seed

The seed parameter is used to initialize the random number generator when random_image is enabled. By setting a specific seed, you can reproduce the same random sequence of images, which is useful for consistency in experiments or presentations. There is no default value, and it is optional.

📁 Load Image Sequence Output Parameters:

current_image

The current_image output parameter provides the currently loaded image from the sequence. This is the image that is actively being processed or displayed, and it changes based on the sequence order or random selection settings. It is essential for further processing or display in your workflow.

sequence_state

The sequence_state output parameter contains information about the current state of the image sequence, including the current index and any other relevant metadata. This helps in tracking the progress through the sequence and is useful for resuming or managing the sequence effectively.

📁 Load Image Sequence Usage Tips:

• Ensure that the folder_path is correctly set and accessible to avoid errors related to missing files.
• Use the loop_sequence parameter to create seamless loops for animations or presentations.
• Experiment with the random_image and no_repeats parameters to add variety to your image sequences, especially in creative projects.
• Set a seed value if you need to reproduce the same random sequence for consistency in your work.

📁 Load Image Sequence Common Errors and Solutions:

Folder does not exist: <folder_path>

• Explanation: This error occurs when the specified folder path is incorrect or inaccessible.
• Solution: Verify that the folder_path is correct and that the folder exists and is accessible from your system.

Error getting sequence info: <error_message>

• Explanation: This error indicates an issue while retrieving information about the image sequence, possibly due to file access or format issues.
• Solution: Check the folder for unsupported file formats or permissions issues, and ensure all images are in supported formats like JPG, PNG, etc.