ComfyUI Node: Load EXR Frames

Load EXR Frames:

The LoadEXRFrames node is designed to load a sequence of EXR image frames from a specified file path. This node is particularly useful for AI artists who work with high-quality image sequences, such as those used in visual effects and animation. By leveraging this node, you can efficiently load multiple frames of EXR images, which are known for their high dynamic range and color accuracy. The node supports both absolute file paths and frame substitution patterns, making it versatile for different workflows. It also includes progress tracking to provide feedback during the loading process, ensuring a smooth and user-friendly experience.

Load EXR Frames Input Parameters:

filepath

The filepath parameter specifies the location of the EXR files to be loaded. It can be an absolute path to a single EXR file or a pattern that includes a frame number placeholder (e.g., frame_%04d.exr). This flexibility allows you to load either a single image or a sequence of images. Ensure that the file path ends with .exr or .EXR to avoid errors. There is no default value, and the parameter must be provided.

linear_to_sRGB

The linear_to_sRGB parameter determines whether the loaded EXR images should be converted from linear color space to sRGB color space. This is important for ensuring that the colors in the images are displayed correctly on standard monitors. The default value is True, meaning that the conversion will be applied by default.

start_frame

The start_frame parameter defines the first frame number in the sequence to be loaded. This is useful when working with a specific range of frames within a larger sequence. The default value is 1001, which is a common starting frame number in visual effects workflows.

end_frame

The end_frame parameter specifies the last frame number in the sequence to be loaded. Similar to start_frame, this allows you to define the range of frames to be processed. The default value is 1001, meaning that by default, only a single frame will be loaded.

Load EXR Frames Output Parameters:

rgb

The rgb output parameter contains the loaded image data in RGB format. If a sequence of frames is loaded, this will be a concatenated tensor of all the frames. This output is essential for further processing or analysis in your AI workflows.

mask

The mask output parameter provides the mask data associated with the loaded EXR images. This can be useful for tasks that require segmentation or other mask-based operations. Similar to rgb, this will be a concatenated tensor if multiple frames are loaded.

batch_size

The batch_size output parameter indicates the number of frames that were successfully loaded. This is useful for understanding the scope of the loaded data and for further batch processing.

Load EXR Frames Usage Tips:

• Ensure that your file path ends with .exr or .EXR to avoid errors.
• Use the frame number placeholder %04d in the file path to load a sequence of frames.
• Adjust the start_frame and end_frame parameters to load only the frames you need, which can save time and resources.
• Enable the linear_to_sRGB conversion if you plan to display the images on standard monitors to ensure correct color representation.

Load EXR Frames Common Errors and Solutions:

Filepath needs to end in .exr or .EXR

• Explanation: The specified file path does not end with the .exr or .EXR extension.
• Solution: Ensure that the file path you provide ends with .exr or .EXR.

Invalid frame range

• Explanation: The specified frame range is invalid, possibly because the end_frame is less than the start_frame.
• Solution: Check and correct the start_frame and end_frame parameters to ensure a valid range.

Path not found: <filepath>

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

Frame not found: <framepath>

• Explanation: A specific frame in the sequence could not be found at the specified path.
• Solution: Ensure that all frames in the specified range exist and are correctly named according to the pattern.

No EXRs found in folder

• Explanation: No EXR files were found in the specified directory.
• Solution: Check the directory path and ensure that it contains EXR files.