ComfyUI Node: Load EXR

Load EXR:

The LoadEXR node is designed to facilitate the loading of EXR (OpenEXR) image files into your workflow. EXR files are commonly used in high-dynamic-range imaging and visual effects due to their ability to store a wide range of color and brightness information. This node allows you to load single or multiple EXR files from a specified directory, converting them into a format that can be processed further in your pipeline. It supports batch loading, progress tracking, and optional conversion from linear to sRGB color space, making it a versatile tool for handling high-quality image data efficiently.

Load EXR Input Parameters:

filepath

The filepath parameter specifies the path to the EXR file or directory containing EXR files that you want to load. If a single file is specified, it will be loaded directly. If a directory is specified, all EXR files within the directory will be loaded. The path should be a string and must end with .exr or .EXR. This parameter is crucial as it determines the source of the image data to be processed.

image_load_cap

The image_load_cap parameter limits the number of EXR files to be loaded from the specified directory. This is useful when dealing with a large number of files and you only need to process a subset. The value should be an integer, with a default of 0, which means no limit. Setting this parameter helps manage memory usage and processing time.

skip_first_images

The skip_first_images parameter allows you to skip a specified number of initial EXR files in the directory. This can be useful if you want to ignore certain files at the beginning of the list. The value should be an integer, with a default of 0, meaning no files are skipped. This parameter helps in selectively processing files from a large dataset.

select_every_nth

The select_every_nth parameter enables you to load every nth EXR file from the directory. This is particularly useful for downsampling a sequence of images. The value should be an integer, with a default of 1, meaning every file is loaded. Adjusting this parameter can help in reducing the number of files processed, thus saving time and resources.

Load EXR Output Parameters:

samples

The samples output parameter contains the loaded image data in a tensor format. This tensor can be directly used for further processing in your workflow. The samples parameter is essential as it holds the actual image data extracted from the EXR files, ready for subsequent operations.

batch_size

The batch_size output parameter indicates the number of EXR files that were successfully loaded. This is an integer value and provides information about the size of the dataset being processed. The batch_size parameter is useful for understanding the scope of the loaded data and for managing batch processing tasks.

Load EXR Usage Tips:

• Ensure that the filepath parameter correctly points to the desired EXR file or directory to avoid file not found errors.
• Use the image_load_cap parameter to limit the number of files loaded, especially when working with large datasets, to manage memory usage effectively.
• Utilize the skip_first_images and select_every_nth parameters to selectively load files, which can be helpful in scenarios where you need to process a specific subset of images.
• Enable progress tracking if you are loading a large number of files to monitor the loading process and estimate completion time.

Load EXR Common Errors and Solutions:

Path not found: <filepath>

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

No EXRs found in folder

• Explanation: No EXR files were found in the specified directory.
• Solution: Ensure that the directory contains EXR files and that the filepath parameter points to the correct directory.

Filepath needs to end in .exr or .EXR

• Explanation: The specified file path does not have the correct EXR file extension.
• Solution: Make sure the filepath parameter ends with .exr or .EXR.

Invalid frame range

• Explanation: The specified frame range is invalid or empty.
• Solution: Check the frame range parameters to ensure they define a valid range of frames to be loaded.