◎ Radiance Load EXR:
The LoadImageEXR node is designed to facilitate the loading of EXR/HDR files, which are known for their ability to store images with a full high dynamic range (HDR). This node allows you to either directly enter the file path of the EXR image or select it from a specified input folder. The primary benefit of using this node is its capability to handle the extended dynamic range of EXR files, which is crucial for maintaining the rich detail and color information that HDR images provide. This is particularly important for tasks that require precise color grading and exposure adjustments, such as in visual effects, 3D rendering, and professional photography. By leveraging multiple methods to load EXR files, including OpenEXR, imageio, OpenImageIO, and OpenCV, the node ensures compatibility and flexibility, making it a robust choice for artists working with HDR content.
◎ Radiance Load EXR Input Parameters:
file_path
The file_path parameter specifies the location of the EXR file you wish to load. This can be a direct path to the file on your system or a selection from a designated input folder. The accuracy of this path is crucial as it determines the file that will be processed by the node. There are no explicit minimum or maximum values for this parameter, but it must be a valid path to an existing EXR file. If the path is incorrect or the file does not exist, the node will not be able to load the image.
◎ Radiance Load EXR Output Parameters:
img
The img output parameter represents the loaded image data in a floating-point format, typically as a NumPy array. This output contains the RGB color information of the EXR file, allowing you to work with the full dynamic range of the image. The data is processed to ensure it is in a format suitable for further manipulation or analysis, such as color grading or compositing.
alpha_img
The alpha_img output parameter provides the alpha channel data from the EXR file, if available. This channel is crucial for tasks that require transparency information, such as compositing images over different backgrounds. If the EXR file does not contain an alpha channel, this output will be None.
depth_img
The depth_img output parameter contains depth information extracted from the EXR file, if present. This data is essential for 3D rendering and compositing tasks where depth cues are needed to create realistic scenes. If the EXR file does not include depth information, this output will be a zero-filled array or None.
◎ Radiance Load EXR Usage Tips:
- Ensure that the file path provided is correct and points to a valid EXR file to avoid loading errors.
- Utilize the alpha and depth outputs for advanced compositing and rendering tasks to take full advantage of the EXR format's capabilities.
- Consider using the node in conjunction with other HDR processing nodes to enhance your workflow, such as blending multiple exposures or recovering shadow and highlight details.
◎ Radiance Load EXR Common Errors and Solutions:
OpenEXR load failed for <file_path>: <error_message>
- Explanation: This error occurs when the OpenEXR library fails to load the specified EXR file, possibly due to an incorrect file path or a corrupted file.
- Solution: Verify that the file path is correct and that the file is not corrupted. Ensure that the OpenEXR library is properly installed and configured.
imageio load failed for <file_path>: <error_message>
- Explanation: This error indicates that the imageio library was unable to read the EXR file, which could be due to compatibility issues or an incorrect file path.
- Solution: Check the file path for accuracy and ensure that the imageio library is installed with the necessary dependencies for EXR support.
OpenCV load failed for <file_path>: <error_message>
- Explanation: This error suggests that OpenCV could not load the EXR file, possibly due to missing EXR support or an incorrect file path.
- Solution: Make sure that OpenCV is compiled with EXR support enabled and that the file path is correct. Consider using alternative methods like OpenImageIO if the issue persists.
