ComfyUI Node: OCIO Display

OCIO Display:

The OCIODisplay node is designed to facilitate the transformation of images from one color space to another, specifically for display purposes. It leverages the OpenColorIO (OCIO) framework to apply display-specific color transformations, ensuring that images are accurately represented on different display devices. This node is particularly beneficial for artists and designers who need to ensure color consistency across various viewing environments. By using the OCIODisplay node, you can manage how your images appear on different screens, taking into account the specific characteristics of each display. This is crucial for maintaining the intended look of your artwork, especially in professional settings where color accuracy is paramount.

OCIO Display Input Parameters:

image

This parameter represents the input image that you want to transform. It is the source image data that will undergo color space conversion for display purposes. The image should be in a format compatible with the OCIO framework, typically a high dynamic range format to preserve color fidelity during transformation.

in_colorspace

The in_colorspace parameter specifies the color space of the input image. It is crucial for the node to understand the source color space to accurately convert it to the desired display color space. This parameter ensures that the transformation process starts with the correct color interpretation of the input image.

display

This parameter defines the target display device for which the color transformation is intended. It allows the node to apply the appropriate display-specific color adjustments, ensuring that the image appears correctly on the specified device. The display parameter is essential for achieving consistent color representation across different screens.

view

The view parameter specifies the viewing conditions or settings associated with the target display. It provides additional context for the color transformation, allowing for adjustments based on specific viewing scenarios. This parameter helps fine-tune the display output to match the intended viewing experience.

invert_direction

This boolean parameter determines the direction of the color transformation. If set to True, the transformation is inverted, effectively reversing the color space conversion. This can be useful for scenarios where you need to convert an image back to its original color space from a display-specific space.

mix

The mix parameter controls the blending of the transformed image with the original image. It is a floating-point value between 0 and 1, where 0 means no transformation is applied, and 1 means full transformation. This parameter allows for gradual application of the color transformation, providing flexibility in achieving the desired visual effect.

config_path

This parameter specifies the path to the OCIO configuration file. The configuration file contains the necessary information for color space definitions and transformations. Providing the correct config path ensures that the node can access the appropriate color transformation settings for the specified display and view.

video

The video parameter is an optional input that allows for the processing of video data instead of static images. When provided, the node applies the color transformation to each frame of the video, ensuring consistent color representation throughout the video playback.

OCIO Display Output Parameters:

transformed_image

The transformed_image is the primary output of the OCIODisplay node. It represents the input image after undergoing the specified color space transformation for the target display. This output ensures that the image is accurately represented according to the display's characteristics, maintaining color fidelity and consistency.

OCIO Display Usage Tips:

• Ensure that the in_colorspace parameter accurately reflects the color space of your input image to avoid incorrect color transformations.
• Use the mix parameter to gradually apply the transformation, allowing you to compare the original and transformed images and adjust the effect as needed.
• Verify that the config_path points to a valid OCIO configuration file to ensure the node can access the necessary color transformation settings.

OCIO Display Common Errors and Solutions:

No OCIO config found.

• Explanation: This error occurs when the node cannot locate the specified OCIO configuration file.
• Solution: Check the config_path parameter to ensure it points to a valid and accessible OCIO configuration file.

Incorrect color space transformation

• Explanation: This issue arises when the in_colorspace parameter does not match the actual color space of the input image.
• Solution: Verify and set the in_colorspace parameter to the correct color space of your input image to ensure accurate transformation.

Display-specific color mismatch

• Explanation: This problem occurs when the display and view parameters do not correspond to the intended target display settings.
• Solution: Double-check the display and view parameters to ensure they match the characteristics of the target display device for accurate color representation.