ComfyUI Node: ◎ Radiance OCIO Display/View

◎ Radiance OCIO Display/View:

The RadianceOCIODisplayView node is a sophisticated tool designed for professional color management in digital content creation. It leverages the OpenColorIO (OCIO) framework to facilitate precise color transformations, ensuring that your final output aligns with industry standards. This node allows you to select a display device, such as sRGB or Rec.709, and apply a view transform, like ACES or Log, to your images. Additionally, it supports the application of optional looks, such as film looks or Color Decision Lists (CDLs), to enhance the visual style of your output. With processor caching for improved performance and full support for OCIO 2.x context variables, this node is an essential component for artists seeking to maintain color fidelity across different display devices and viewing conditions.

◎ Radiance OCIO Display/View Input Parameters:

image

The image parameter is the input image that you want to transform using the OCIO display/view settings. This parameter is crucial as it serves as the base content that will undergo color transformation. There are no specific minimum or maximum values for this parameter, as it accepts any image format compatible with the node's processing capabilities.

config_path

The config_path parameter specifies the path to the OCIO configuration file. This file contains the necessary settings and profiles for color management, allowing the node to perform accurate color transformations. Providing the correct path ensures that the node can access the appropriate color profiles and settings for your project.

display

The display parameter allows you to select the target display device for your output. Options include common displays like "sRGB," "Rec.709," "P3-DCI," "P3-D65," and "Rec.2020." Choosing the correct display ensures that your content is accurately represented on the intended device, maintaining color consistency and fidelity.

view

The view parameter lets you choose the view transform to apply to your image. Available options include "ACES 1.0

• SDR Video," "Raw," "Log," and "Un-tone-mapped." This parameter determines how the image's colors are interpreted and displayed, affecting the overall look and feel of the output.

look

The look parameter is optional and allows you to apply a specific look to your image, such as film looks or CDLs. This can enhance the visual style of your output, adding creative effects or adjustments to the color grading. If not specified, no additional look will be applied.

exposure_adjust

The exposure_adjust parameter provides a way to adjust the exposure of your image. This can be useful for fine-tuning the brightness and contrast of the output, ensuring that it meets your artistic vision. The parameter accepts a range of values, with 0.0 as the default, indicating no exposure adjustment.

context_key

The context_key parameter is used to specify a context variable key for OCIO 2.x configurations. This allows for dynamic adjustments based on specific context variables, providing greater flexibility and control over the color transformation process.

context_value

The context_value parameter works in conjunction with the context_key to define the value of the context variable. This enables you to tailor the color transformation to specific conditions or requirements, enhancing the adaptability of the node.

◎ Radiance OCIO Display/View Output Parameters:

IMAGE

The IMAGE output parameter represents the transformed image after applying the selected display/view settings and optional look. This output is crucial as it reflects the final color-managed result, ready for display or further processing. The transformed image maintains color accuracy and consistency across different viewing conditions, ensuring that your creative intent is preserved.

◎ Radiance OCIO Display/View Usage Tips:

• Ensure that the config_path is correctly set to access the appropriate OCIO configuration file, as this is critical for accurate color management.
• Experiment with different display and view combinations to achieve the desired look for your project, keeping in mind the target display device and viewing conditions.
• Utilize the look parameter to add creative effects or adjustments to your image, enhancing its visual appeal and aligning with your artistic vision.

◎ Radiance OCIO Display/View Common Errors and Solutions:

OCIO version does not support setLooks(); look '<look>' will not be applied. Upgrade to OCIO 2.x.

• Explanation: This error occurs when the OCIO version being used does not support the setLooks function, which is necessary for applying named looks.
• Solution: Upgrade to OCIO version 2.x or higher to enable the use of the setLooks function and apply the desired look to your image.

Invalid config_path specified

• Explanation: This error indicates that the path provided for the OCIO configuration file is incorrect or inaccessible, preventing the node from performing color transformations.
• Solution: Verify that the config_path is correct and points to a valid OCIO configuration file. Ensure that the file is accessible and not corrupted.

Unsupported display or view option

• Explanation: This error occurs when an unsupported display or view option is selected, which is not available in the current OCIO configuration.
• Solution: Check the available display and view options in your OCIO configuration file and select a supported option. Adjust the configuration file if necessary to include the desired options.