ComfyUI Node: ◎ Radiance Log Curve Decode

◎ Radiance Log Curve Decode:

RadianceLogCurveDecode is a node designed to transform log-encoded image data back into a linear color space, which is essential for accurate color representation and further image processing. This node is particularly useful in workflows involving high dynamic range (HDR) imaging and color grading, where images are often stored in a logarithmic format to preserve detail across a wide range of brightness levels. By decoding these log curves, RadianceLogCurveDecode ensures that the images are correctly interpreted and displayed, maintaining the integrity of the original scene's lighting and color. The node supports various log curve formats, such as ARRI LogC3, and applies necessary transformations to match the target color gamut, ensuring compatibility with different display standards like sRGB, P3-D65, and Rec.2020. This functionality is crucial for artists and technicians who need to work with precise color data in digital imaging and film production.

◎ Radiance Log Curve Decode Input Parameters:

image

The image parameter represents the input image data that is log-encoded and needs to be decoded into a linear color space. This parameter is crucial as it serves as the primary data source for the decoding process. The input should be in a format compatible with the node's processing capabilities, typically a tensor or array representing the image's pixel values.

curve

The curve parameter specifies the type of log curve applied to the input image. It determines the mathematical transformation used to decode the image back to a linear space. Options may include various industry-standard log curves like "ARRI LogC3". Selecting the correct curve is essential for accurate color reproduction, as it ensures the decoding process aligns with the encoding applied during image capture or storage.

exposure_index

The exposure_index parameter is used to adjust the decoding process based on the exposure settings used during image capture. It typically involves parsing a string value like "EI 800" to extract the numerical exposure index, which influences the brightness and contrast of the decoded image. This parameter is particularly relevant for log curves that require exposure compensation, such as ARRI LogC3.

target_gamut

The target_gamut parameter defines the color space to which the decoded image should be transformed. Options include "Native / No Transform", "Linear sRGB (Rec.709)", "Linear P3-D65", and "Linear Rec.2020". This parameter ensures that the decoded image is compatible with the desired display or processing standard, allowing for consistent color representation across different devices and workflows.

◎ Radiance Log Curve Decode Output Parameters:

decoded_image

The decoded_image parameter is the output of the node, representing the image data that has been transformed from a log-encoded format to a linear color space. This output is crucial for further processing or display, as it ensures that the image's colors and brightness levels are accurately represented according to the selected target gamut. The decoded image is typically returned as a tensor or array suitable for subsequent operations in the imaging pipeline.

◎ Radiance Log Curve Decode Usage Tips:

• Ensure that the curve parameter matches the log encoding used during image capture to avoid color inaccuracies.
• Adjust the exposure_index parameter to compensate for any exposure settings applied during shooting, especially when working with ARRI LogC3. - Select the appropriate target_gamut to match the display or processing requirements, ensuring consistent color representation across different devices.

◎ Radiance Log Curve Decode Common Errors and Solutions:

" ◎ Radiance Log Curve Decode: GPU-accelerated decode is not yet implemented — running on CPU."

• Explanation: This message indicates that the node is currently processing the image on the CPU because GPU acceleration is not available.
• Solution: If performance is a concern, consider optimizing other parts of your workflow or upgrading your hardware to improve CPU processing speed.

"Log curve not found for the specified curve type."

• Explanation: This error occurs when the specified curve parameter does not match any available log curve functions.
• Solution: Verify that the curve parameter is set to a supported log curve type, such as "ARRI LogC3", and ensure that the necessary log curve functions are correctly implemented in the node.