ComfyUI Node: ◎ Radiance Save EXR/HDR

◎ Radiance Save EXR/HDR:

RadianceSaveEXR is a specialized node designed to facilitate the saving of high dynamic range (HDR) images in the OpenEXR format, which is widely used in professional visual effects and animation due to its ability to store a vast range of color and brightness levels. This node acts as a bridge to the modular implementation found in the radiance.hdr.io module, ensuring that the process of exporting images in the EXR format is both efficient and reliable. The primary benefit of using RadianceSaveEXR is its capability to handle true HDR data, preserving the full range of luminance and color information captured in your images. This is particularly important for workflows that require precise color grading and compositing, as it allows for greater flexibility and accuracy in post-production. By leveraging the OpenEXR library, RadianceSaveEXR ensures compatibility with industry-standard tools and pipelines, making it an essential component for artists and developers working with HDR content.

◎ Radiance Save EXR/HDR Input Parameters:

frame_to_save

This parameter represents the image data that you wish to save in the EXR format. It should be provided as a NumPy array, typically in a floating-point format to preserve the high dynamic range of the image. The data can include multiple channels, such as RGB or RGBA, and should be in a format that supports HDR, such as np.float32. The quality and accuracy of the saved EXR file depend heavily on the precision and format of this input data.

output_dir

The output directory specifies the location where the EXR file will be saved. It is important to ensure that this directory is writable and accessible, as the node will attempt to save the file to this path. Providing a valid directory path is crucial for the successful execution of the node.

exr_filename

This parameter defines the name of the EXR file to be saved. It should include the .exr extension and be a valid filename for the operating system being used. The filename should be unique or appropriately managed to prevent overwriting existing files unless that is the intended behavior.

◎ Radiance Save EXR/HDR Output Parameters:

exr_saved

This output parameter is a boolean value indicating whether the EXR file was successfully saved. A value of True signifies that the file was saved without any issues, while False indicates that an error occurred during the saving process. This output is crucial for error handling and ensuring that the intended file operations were completed successfully.

exr_filepath

The exr_filepath output provides the full path to the saved EXR file. This is useful for subsequent operations that may need to access the file, such as loading it into another application or further processing within a pipeline. It serves as a confirmation of the file's location and can be used to verify that the file was saved in the correct directory with the expected filename.

◎ Radiance Save EXR/HDR Usage Tips:

• Ensure that the input image data is in a floating-point format to fully utilize the HDR capabilities of the EXR format.
• Verify that the output directory is correctly set and accessible to avoid permission-related errors during the saving process.
• Use descriptive and unique filenames to prevent accidental overwriting of existing files and to maintain an organized file structure.

◎ Radiance Save EXR/HDR Common Errors and Solutions:

Failed to save EXR for frame {frame_idx}

• Explanation: This error occurs when the node is unable to save the EXR file, possibly due to issues with the file path, permissions, or the input data format.
• Solution: Check that the output directory is correct and writable, ensure that the filename is valid, and verify that the input data is in the correct format and contains valid HDR information.

Radiance: Failed to import ◎ Radiance Save EXR/HDR from hdr.io

• Explanation: This error indicates that the node could not import the necessary module to perform the EXR saving operation, likely due to a missing dependency.
• Solution: Ensure that the OpenEXR library is installed in your environment. You can install it using the command pip install OpenEXR. Additionally, verify that the radiance.hdr.io module is correctly set up and accessible in your Python environment.