OCIOCDLTransform
Applies an ASC CDL (American Society of Cinematographers Color Decision List) grade based on the OpenColorIO Library. For more information, see https://opencolorio.org.
Note: There are a number of NDK examples covering OCIO workflows that ship with the Nuke developer documentation, which can be found here:
<install_directory>/Documentation/NDKExamples/Plugins/00b_8source.html
Inputs and Controls
Connection Type |
Connection Name |
Function |
Input |
unnamed |
The image sequence to receive the CDL transform. |
mask |
An optional image to use as a mask. By default, the CDL transform is limited to the non-black areas of the mask. At first, the mask input appears as a triangle on the right side of the node, but when you drag it, it turns into an arrow labeled mask. If you cannot see the mask input, ensure that the mask control is disabled or set to none. |
Control (UI) |
Knob (Scripting) |
Default Value |
Function |
OCIOCDLTransform Tab |
|||
channels |
channels |
rgb |
The CDL transform is applied only to these channels. If you set this to something other than all or none, you can use the checkboxes on the right to select individual channels. |
slope |
slope |
1 |
Adjusts the gain for the entire image. |
offset |
offset |
0 |
Adjusts the offset for the entire image. |
power |
power |
1 |
Adjusts the gamma for the entire image. |
saturation |
saturation |
1 |
Adjusts the saturation for the entire image. |
direction |
direction |
forward |
Select Inverse to invert the transform. |
working space |
working_space |
linear |
Sets the color space in which the file is applied. The input is transformed from scene linear to the selected working space, the file color transform is applied, and then the result is transformed back to scene linear. |
read from file |
read_from_file |
disabled |
Enable this to load color correction information from a .cc or .ccc file. |
file |
file |
none |
The ASC CDL file to use for the transform. This can be a .cc or .ccc file. |
cccid |
cccid |
none |
If the ASC CDL file is a .ccc (Color Correction Collection) file, specify the cccid to look up here. |
select cccid |
select_cccid |
N/A |
Click to open the cccid dialog and select the cccid from the dropdown menu. You can view the Slope, Offset, Power and Saturation settings for the chosen .ccc from within this dialog. These cannot be modified. |
export grade as .cc |
export_cc |
N/A |
Exports the grade as a .cc (Color Correction) file. |
mask |
N/A |
disabled |
Enables the associated mask channel to the right. Disabling this checkbox is the same as setting the channel to none. |
maskChannelInput |
none |
The channel to use as a mask. By default, the colorspace conversion is limited to the non-black areas of this channel. |
|
inject |
inject |
disabled |
Copies the mask input to the predefined mask.a channel. Injecting the mask allows you to use the same mask further downstream. |
invert |
invert_mask |
disabled |
Inverts the use of the mask channel so that the colorspace conversion is limited to the non-white areas of the mask |
fringe |
fringe |
disabled |
When enabled, only apply the effect to the edge of the mask. When disabled, the effect is applied to the entire mask. |
(un)premult by |
N/A |
disabled |
Enables the associated channel to the right. Disabling this checkbox is the same as setting the channel to none. |
unpremult |
none |
The image is divided by this channel before being processed, and multiplied again afterwards. If you are using premultiplied input images, you may want to check (un)premult by and select rgba.alpha here. This will simulate doing the color conversion before the premultiplication was done. It is the same as adding an Unpremult node before this node and a Premult node after, but allows you to work faster if you’re only using one color correct node. If you are using unpremultiplied input images, you should leave this set to none. |
|
invert |
invert_unpremult |
disabled |
Inverts the use of the (un)premultiply channel. |
mix |
mix |
1 |
Dissolves between the original image at 0 and the full colorspace conversion at 1. |