This page contains information about the V-Ray TexOCIO node.


Overview


V-Ray TexOCIO is a texture that allows users to apply OpenColorIO (OCIO) color transformations to textures to manage their look.

The example on the right shows the same texture run through four different OCIO configurations.


Parameters


Color – Specifies the base color that is corrected using OCIO.

Input/Output Section – Determines how the input and output color spaces are specified.

By Color Space – The user specifies the input and output color spaces directly.
By Role – The user specifies the input and output color space depending on the task that they want to perform as defined in the OCIO configuration.

Configuration Source – Manually specifies an OCIO configuration. If not specified, the OCIO environment variable is used.

Config File – Specifies the OCIO configuration file.

Mode – Specifies what color transformations are performed:

ColorSpace – The texture performs color space conversions.
CDL Transform – The texture performs an ASC CDL transformation. CDL stands for "Color Decision List", which is a color grading information exchange format developed by the ASC (American Society of Cinematographers).
File Transform – The texture performs a color transformation based on another file (i.e. .3dl, .lut, .cube, etc.).
LogConvert – The texture performs log2lin or lin2log conversion.
Display – The texture performs color space conversion for display.
Look – The texture performs a look transform. The OCIO config must define looks for this mode to work.



Color Space Parameters


These parameters are available when Mode is set to ColorSpace.

In – Specifies the input color space (the color space that the input texture is in).

Out – Specifies the output color space (for rendering, this would typically be a linear color space).



CDL Transform Parameters


These parameters are available when Mode is set to CDL Transform.

Slope RGB – Specifies multipliers for the red/green/blue color components.

Offset RGB – Specifies offsets for the red/green/blue color components.

Power RGB – Specifies gamma values for the red/green/blue color components.

Saturation – Saturation value. A value of 0.0 makes the image grayscale.

Use File – When enabled, the CDL parameters are read from a .cc or a .ccc file instead of specified directly. 

Color Correction File – Specifies a .cc or .ccc file to read.

Color Correction ID – Specifies the color correction ID as specified in the color correction file.

Direction – Specifies whether the forward or the inverse CDL transformation is applied.



File Transform Parameters


These parameters are available when Mode is set to File Transform.

File – Specifies a color transformation file (.3dl, .cube, .lut, etc.).

Color Correction ID – Specifies the color correction ID if present in the file.

Direction – Specifies whether forward or inverse color transformation should be applied. Not all file formats support inverse transformations.

Interpolation – If the file contains tabulated data (i.e. .cube files), specifies how this data is interpolated. 

Nearest – No interpolation. The nearest suitable color from the table is picked up. This method is fast, but may introduce artifacts, especially in textures with smooth gradients.
Linear – The color is linearly interpolated from the nearest values in the table. This is a smooth method, but is slower than nearest.
Tetrahedral – Uses the tetrahedral method to convert colors with high accuracy. 
Best – Chooses the best interpolation method for the requested context.



Log Convert Parameters


These parameters are available when Mode is set to LogConvert.

Operation – Specifies whether to convert from linear to log space or vice versa.



Display Parameters


These parameters are available when the Mode is set to Display.

In – Specifies the color space of the base texture.

Device – Specifies a viewing device from the devices listed in the OCIO configuration.

View Transform – Specifies the desired view transformation.



Look Parameters


These parameters are available when Mode is set to Look.

In – The color space of the base texture.

Out  The output color space.

Looks  The name of the look if the OCIO configuration defines looks.

Direction  Specifies whether to apply forward or inverse transformation.

Ignore Errors – When enabled, attempts to perform color corrections even if there are errors.