ComfyUI Node: OCIO LogConvert

OCIO LogConvert:

The OCIOLogConvert node is designed to facilitate the conversion between linear and logarithmic color spaces, which is a crucial process in color grading and visual effects workflows. This node supports a variety of log curves, including Cineon, ACEScct, ACEScc, ARRI LogC3, ARRI LogC4, and several camera-native log curves such as Sony S-Log3, Panasonic V-Log, Canon Log 3, RED Log3G10, and Blackmagic DaVinci Intermediate. These curves are essential for decoding camera-log footage to linear color space without assuming the camera's gamut, allowing for more accurate color representation and manipulation. The node operates independently of external dependencies, making it versatile and easy to integrate into different workflows. By converting footage to a linear color space, you can achieve more precise color adjustments and maintain the integrity of the original footage throughout the post-production process.

OCIO LogConvert Input Parameters:

operation

The operation parameter specifies the direction of the conversion, either from linear to logarithmic (lin_to_log) or from logarithmic to linear (log_to_lin). This choice determines how the input data will be transformed, affecting the resulting color space and the subsequent color grading process. The available options are lin_to_log and log_to_lin, with no default value specified, as the choice depends on the specific needs of your workflow.

curve_name

The curve_name parameter defines the specific log curve to be used for the conversion. This parameter is crucial as it determines the mathematical model applied to the input data, affecting the tonal range and contrast of the output. The available options include Cineon, ACEScct, ACEScc, ARRI LogC3, ARRI LogC4, Sony S-Log3, Panasonic V-Log, Canon Log 3, RED Log3G10, and Blackmagic DaVinci Intermediate. Each curve is tailored to specific camera systems or industry standards, allowing for flexibility and precision in color management.

mix

The mix parameter controls the blending between the original and converted data, allowing for a smooth transition between the two states. This parameter is particularly useful for achieving subtle effects or for gradually applying the conversion to maintain certain aspects of the original footage. The mix value ranges from 0.0 to 1.0, with 0.0 representing no conversion and 1.0 representing full conversion. The default value is typically set to 1.0 for complete conversion, but it can be adjusted based on artistic preferences or technical requirements.

OCIO LogConvert Output Parameters:

converted_image

The converted_image parameter represents the output of the conversion process, providing the transformed image data in the desired color space. This output is crucial for further color grading, compositing, or visual effects work, as it ensures that the footage is in the correct format for subsequent processing. The converted_image maintains the integrity of the original data while applying the specified log curve, allowing for accurate and consistent color representation across different stages of production.

OCIO LogConvert Usage Tips:

• When working with footage from different camera systems, ensure you select the appropriate curve_name to match the camera's log profile for accurate color conversion.
• Use the mix parameter to gradually apply the conversion effect, which can be useful for blending the original and converted images to achieve a desired artistic look.
• Always verify the direction of conversion (operation) to ensure that the footage is transformed correctly, as applying the wrong direction can lead to unexpected results.

OCIO LogConvert Common Errors and Solutions:

"This node needs OpenColorIO. Install it: pip install opencolorio."

• Explanation: This error occurs when the OpenColorIO library is not installed, which is required for the node to function properly.
• Solution: Install the OpenColorIO library by running the command pip install opencolorio in your terminal or command prompt.

"Invalid curve name specified."

• Explanation: This error indicates that the curve_name provided does not match any of the supported log curves.
• Solution: Double-check the spelling and ensure that the curve_name matches one of the supported options, such as Cineon, ACEScct, or ARRI LogC3.

"Invalid operation specified."

• Explanation: This error occurs when the operation parameter is set to a value other than lin_to_log or log_to_lin.
• Solution: Ensure that the operation parameter is correctly set to either lin_to_log or log_to_lin based on the desired conversion direction.