Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note that the OCIO corrections are slow. It is advised to use VRayOCIO sparingly and only when it is not possible or practical to apply the necessary transformations to the texture in a pre-process step before use as a texture.

 

UI Path

...

 

Section
Column
width5%


Column
width45%

||

...

mat Network|| > V-Ray

...

> File Textures > V-Ray

...

OCIO

Column
width45%
||out Network|| > V-Ray Render Elements node > V-Ray > File Texture > V-

...

Ray OCIO
Column
width5%


 

Node

...

The V-Ray TexOCIO node provides inputs that correspond to the parameters in the section below.

 

Image RemovedImage Added

 

Parameters

...

 

Image Removed

Color – The Image Added


Base Texture – Specifies the base texture that will be is corrected.Config  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 will be 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

Image Removed

...

These parameters are available when Mode is set to ColorSpace.

 

Image Added


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).

 

 

CDLTransform CDL Transform Parameters

...

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

Image Removed

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


Image Added


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

...

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

CCCIDUse 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 IDSpecifies the color correction ID as specified in the color correction file.

Direction – Specifies whether the forward or the inverse CDL transformation will be is applied.File – Specifies a .cc or .ccc file to read.

 

File Transform Parameters

Image Removed

...

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

 

Image Added


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

CCCID Color Correction IDSpecifies 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.

 

LogConvert Log Convert Parameters

...

These parameters are available when Mode is set to LogConvert.


 Image Added

Image Removed

 

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

...

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

 

Image RemovedImage Added

 

Colorspace 

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.


Image RemovedImage Added


Input Colorspace In – The color space of the base texture.

Looks Out  The output color space.

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

Output Colorspace The output color space.

Direction Specifies whether to apply forward or inverse transformation.

...