ComfyUI Node: ◎ Radiance Load EXR Sequence

◎ Radiance Load EXR Sequence:

The LoadImageEXRSequence node is designed to efficiently load sequences of EXR or HDR images from a specified folder, providing you with a batch of high dynamic range images. This node is particularly beneficial for artists and professionals working with HDR content, as it allows for the seamless integration of image sequences into workflows that require high precision and dynamic range. By leveraging this node, you can easily manage and process multiple frames of HDR content, which is essential for tasks such as visual effects, animation, and any application where maintaining the full dynamic range of images is crucial. The node simplifies the process of handling large image sequences, ensuring that you can focus on creative tasks without worrying about the technical complexities of loading and managing HDR files.

◎ Radiance Load EXR Sequence Input Parameters:

folder_path

The folder_path parameter specifies the directory where the EXR image sequence is stored. It is a string input that should contain the full path to the folder. This parameter is crucial as it directs the node to the correct location to load the images. Ensure that the path is correctly formatted and points to a valid directory containing the desired image sequence.

file_pattern

The file_pattern parameter allows you to define a specific pattern for the filenames of the images you wish to load. This is useful for selecting specific files within a folder, especially when dealing with large datasets. The default pattern is "*.exr", which means all EXR files in the folder will be considered. You can adjust this pattern to match specific naming conventions or file types as needed.

start_frame

The start_frame parameter determines the starting point in the sequence from which images will be loaded. It is an integer value, with a default of 0, which means the sequence will start from the first available frame. You can specify a different starting frame number if you wish to begin loading from a specific point in the sequence.

end_frame

The end_frame parameter sets the endpoint in the sequence, allowing you to limit the number of frames loaded. This is useful for managing memory and processing time, especially when working with long sequences. By default, this parameter is set to 0, indicating that all frames from the start frame to the end of the sequence will be loaded unless specified otherwise.

frame_step

The frame_step parameter controls the interval between frames that are loaded. For example, a frame_step of 1 loads every frame, while a frame_step of 2 loads every other frame. This can be useful for creating time-lapse effects or reducing the number of frames for processing efficiency.

max_frames

The max_frames parameter limits the total number of frames to be loaded from the sequence. This is particularly useful for managing system resources and ensuring that the node does not attempt to load more frames than your system can handle. By default, this is set to 0, meaning there is no limit unless specified.

exposure_adjust

The exposure_adjust parameter allows you to modify the exposure of the loaded images in stops (EV). This floating-point value can range from -10.0 to 10.0, with a default of 0.0, meaning no adjustment. Adjusting exposure can help in achieving the desired brightness and contrast in your images, especially when preparing them for further processing or visualization.

◎ Radiance Load EXR Sequence Output Parameters:

images

The images output provides a batch of loaded EXR images as a tensor. This output is crucial for further processing or analysis, as it contains the high dynamic range data necessary for detailed visual effects and accurate color grading.

alpha_masks

The alpha_masks output contains the alpha channel data for the loaded images, if available. This is important for compositing tasks where transparency and layering are required.

depth_masks

The depth_masks output provides depth information for the images, which can be used in 3D compositing and rendering tasks to create realistic depth effects and interactions between elements.

metadata

The metadata output includes a JSON string with detailed information about the loaded images, such as dimensions, dynamic range, and other relevant properties. This metadata is useful for understanding the characteristics of the image sequence and ensuring compatibility with downstream processes.

frame_count

The frame_count output indicates the total number of frames successfully loaded by the node. This information is helpful for verifying that the correct number of frames has been processed and for coordinating with other nodes or processes that depend on the frame count.

◎ Radiance Load EXR Sequence Usage Tips:

• Ensure that the folder_path is correctly set to the directory containing your EXR sequence to avoid loading errors.
• Use the file_pattern to filter specific files if your directory contains multiple file types or naming conventions.
• Adjust the exposure_adjust parameter to fine-tune the brightness of your images, especially if they appear too dark or too bright after loading.
• Limit the max_frames to a manageable number to prevent memory overload, especially when working with large sequences.

◎ Radiance Load EXR Sequence Common Errors and Solutions:

Folder not found: <folder_path>

• Explanation: The specified folder path does not exist or is incorrectly formatted.
• Solution: Double-check the folder_path to ensure it is correct and points to an existing directory.

No files found matching '<pattern>' in <folder_path>

• Explanation: No files in the specified folder match the given file pattern.
• Solution: Verify that the file_pattern is correct and matches the naming convention of your files.

Could not find file with frame number <start_frame>, starting from first file.

• Explanation: The specified start frame number does not exist in the sequence.
• Solution: Check the start_frame value and ensure it corresponds to an existing frame number in your sequence. Adjust if necessary.