ComfyUI Node: Load Image Sequence (mtb)

Load Image Sequence (mtb):

The Load Image Sequence (mtb) node is designed to facilitate the loading of image sequences from a specified folder, making it an essential tool for AI artists working with animations or time-based image data. This node allows you to load individual frames or entire batches of images, providing flexibility in how you manage and process your image sequences. By leveraging this node, you can easily integrate image sequences into your workflows, enabling smooth transitions and consistent frame handling. Whether you are working on video processing, animation projects, or any task that requires sequential image data, this node simplifies the process, ensuring that you can focus on your creative work without getting bogged down by technical details.

Load Image Sequence (mtb) Input Parameters:

path

The path parameter specifies the location of the image sequence files. It accepts a string input, typically in the format of a file path with placeholders for frame numbers (e.g., "videos/####.png"). This parameter is crucial as it directs the node to the correct folder and file naming convention for loading the images. The default value is "videos/####.png".

current_frame

The current_frame parameter determines which specific frame to load from the sequence. It accepts an integer value, where 0 loads the first frame, and -1 loads all frames as a batch. This parameter is essential for controlling the frame-by-frame loading process, allowing you to either focus on a single frame or handle multiple frames simultaneously. The default value is 0, with a minimum of -1 and a maximum of 9999999.

range

The range parameter is optional and allows you to specify a range of frames to load. It accepts a string input that defines the frame range (e.g., "1-10" to load frames 1 through 10). This parameter provides additional flexibility by enabling you to load a subset of frames from the sequence, which can be particularly useful for processing specific segments of an animation or video. The default value is an empty string, indicating that no specific range is set.

Load Image Sequence (mtb) Output Parameters:

image

The image output parameter provides the loaded image or images from the specified sequence. This output is crucial as it delivers the actual visual data that you will work with in your projects. When loading multiple frames, this output will contain a batch of images concatenated along the specified dimension.

mask

The mask output parameter provides the corresponding mask for the loaded image or images. Masks are often used in image processing to isolate specific areas or features within an image. This output ensures that you have access to any associated mask data, which can be essential for tasks like segmentation or object detection.

current_frame

The current_frame output parameter returns the index of the currently loaded frame. This output is useful for tracking which frame is being processed, especially when working with sequences where frame order is important. It helps maintain synchronization and ensures that you can manage frame-specific operations effectively.

total_frames

The total_frames output parameter indicates the total number of frames available in the specified sequence. This output is important for understanding the scope of your image sequence and planning your processing tasks accordingly. It provides a clear indication of the sequence length, allowing you to manage resources and processing time efficiently.

Load Image Sequence (mtb) Usage Tips:

• To load an entire sequence of images as a batch, set the current_frame parameter to -1. This is useful for processing animations or video frames in bulk.
• Use the range parameter to load specific segments of your image sequence. This can help you focus on particular parts of an animation without loading unnecessary frames.
• Ensure that the path parameter correctly matches the naming convention of your image files, including placeholders for frame numbers, to avoid loading errors.

Load Image Sequence (mtb) Common Errors and Solutions:

"File not found"

• Explanation: This error occurs when the specified path does not exist or the file naming convention does not match the actual files.
• Solution: Verify that the path parameter is correct and that the files are named according to the specified convention (e.g., "videos/####.png").

"Invalid frame range"

• Explanation: This error occurs when the range parameter is set to an invalid format or specifies frames that do not exist.
• Solution: Ensure that the range parameter is in the correct format (e.g., "1-10") and that the specified frames are within the available sequence.

"No frames found"

• Explanation: This error occurs when no frames are found at the specified path, possibly due to an incorrect path or empty folder.
• Solution: Check that the folder contains the expected image files and that the path parameter is correctly set to the folder location.

"Mismatch in frame count"

• Explanation: This warning occurs when the number of frames loaded does not match the expected count specified in the range parameter.
• Solution: Verify that the range parameter correctly specifies the desired frames and that all frames are present in the folder.