Transforms

See also: Grading Transforms

Transform

PythonC++

class PyOpenColorIO.Transform

Base class for all the transform classes.

Transform(*args, **kwargs)

getDirection() → PyOpenColorIO.TransformDirection

getTransformType() → PyOpenColorIO.TransformType

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

validate() → None

Will throw if data is not valid.

AllocationTransform

PythonC++

class PyOpenColorIO.AllocationTransform

Forward direction wraps the ‘expanded’ range into the specified, often compressed, range.

AllocationTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.AllocationTransform) -> None

2. __init__(self: PyOpenColorIO.AllocationTransform, allocation: PyOpenColorIO.Allocation = <Allocation.ALLOCATION_UNIFORM: 1>, vars: List[float] = [], direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

getAllocation() → PyOpenColorIO.Allocation

getDirection() → PyOpenColorIO.TransformDirection

getTransformType() → PyOpenColorIO.TransformType

getVars() → List[float]

setAllocation(allocation: PyOpenColorIO.Allocation) → None

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setVars(vars: List[float]) → None

validate() → None

Will throw if data is not valid.

BuiltinTransform

PythonC++

class PyOpenColorIO.BuiltinTransform

A built-in transform is similar to a FileTransform, but without the file. OCIO knows how to build a set of commonly used transforms on-demand, thus avoiding the need for external files and simplifying config authoring.

BuiltinTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.BuiltinTransform) -> None

2. __init__(self: PyOpenColorIO.BuiltinTransform, style: str = ‘IDENTITY’, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

getDescription() → str

getDirection() → PyOpenColorIO.TransformDirection

getStyle() → str

getTransformType() → PyOpenColorIO.TransformType

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setStyle(style: str) → None

Select an existing built-in transform style from the list accessible through :ref:`BuiltinTransformRegistry`. The style is the ID string that identifies which transform to apply.

validate() → None

Will throw if data is not valid.

BuiltinTransformRegistry

PythonC++

class PyOpenColorIO.BuiltinTransformRegistry

The built-in transform registry contains all the existing built-in transforms which can be used by a configuration (version 2 or higher only).

BuiltinTransformRegistry() → None

Get the current built-in transform registry.

getBuiltins() → PyOpenColorIO.BuiltinTransformRegistry.BuiltinIterator

class PyOpenColorIO.BuiltinTransformRegistry.BuiltinStyleIterator

self[arg0: int] → str

iter(self) → PyOpenColorIO.BuiltinTransformRegistry.BuiltinStyleIterator

len(self) → int

next(self) → str

class PyOpenColorIO.BuiltinTransformRegistry.BuiltinIterator

self[arg0: int] → tuple

iter(self) → PyOpenColorIO.BuiltinTransformRegistry.BuiltinIterator

len(self) → int

next(self) → tuple

CDLTransform

PythonC++

class PyOpenColorIO.CDLTransform

An implementation of the ASC Color Decision List (CDL), based on the ASC v1.2 specification.

ASC_SOP

Slope, offset, power:: out = clamp( (in * slope) + offset ) ^ power

Note

​ If the config version is 1, negative values are clamped if the power is not 1.0. For config version 2 and higher, the negative handling is controlled by the CDL style.

static CreateFromFile(src: str, id: str) → PyOpenColorIO.CDLTransform

Load the CDL from the src .cdl, .cc, or .ccc file.

Note

The cccid can be the ID of a CDL or the index of the CDL (as string). If cccid is NULL or empty the first CDL is returned. The cccid is case-sensitive. The src must be an absolute path reference, no relative directory or envvar resolution is performed. Throws if file does not contain any CDL or if the specified cccid is not found.

static CreateGroupFromFile(src: str) → PyOpenColorIO.GroupTransform

Load all of the CDLs in a .cdl or .ccc file into a single GroupTransform.

Note

This may be useful as a quicker way for applications to check the contents of each of the CDLs. The src must be an absolute path reference, no relative directory or envvar resolution is performed.

CDLTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.CDLTransform) -> None

2. __init__(self: PyOpenColorIO.CDLTransform, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

3. __init__(self: PyOpenColorIO.CDLTransform, slope: List[float[3]] = [1.0, 1.0, 1.0], offset: List[float[3]] = [0.0, 0.0, 0.0], power: List[float[3]] = [1.0, 1.0, 1.0], sat: float = 1.0, id: str = ‘’, description: str = ‘’, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

equals(other: PyOpenColorIO.CDLTransform) → bool

getDirection() → PyOpenColorIO.TransformDirection

getFirstSOPDescription() → str

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getID() → str

The get/setID methods are now deprecated. The preferred way of interacting with the ID is now via the transform’s formatMetadata.

getOffset() → List[float[3]]

getPower() → List[float[3]]

getSOP() → List[float[9]]

getSat() → float

getSatLumaCoefs() → List[float[3]]

These are hard-coded, by spec, to r709.

getSlope() → List[float[3]]

getStyle() → PyOpenColorIO.CDLStyle

getTransformType() → PyOpenColorIO.TransformType

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setFirstSOPDescription(description: str) → None

setID(id: str) → None

setOffset(rgb: List[float[3]]) → None

setPower(rgb: List[float[3]]) → None

setSOP(vec9: List[float[9]]) → None

setSat(sat: float) → None

setSlope(rgb: List[float[3]]) → None

setStyle(style: PyOpenColorIO.CDLStyle) → None

Use CDL_ASC to clamp values to [0,1] per the ASC spec. Use NO_CLAMP to never clamp values (regardless of whether power is 1.0). The NO_CLAMP option passes negatives through unchanged (like the NEGATIVE_PASS_THRU style of ExponentTransform). The default style is CDL_NO_CLAMP.

validate() → None

Will throw if data is not valid.

ColorSpaceTransform

PythonC++

class PyOpenColorIO.ColorSpaceTransform

ColorSpaceTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.ColorSpaceTransform) -> None

2. __init__(self: PyOpenColorIO.ColorSpaceTransform, src: str = ‘’, dst: str = ‘’, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>, dataBypass: bool = True) -> None

getDataBypass() → bool

Data color spaces do not get processed when true (which is the default).

getDirection() → PyOpenColorIO.TransformDirection

getDst() → str

getSrc() → str

getTransformType() → PyOpenColorIO.TransformType

setDataBypass(dataBypass: bool) → None

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setDst(dst: str) → None

setSrc(src: str) → None

validate() → None

Will throw if data is not valid.

DisplayViewTransform

PythonC++

class PyOpenColorIO.DisplayViewTransform

DisplayViewTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.DisplayViewTransform) -> None

2. __init__(self: PyOpenColorIO.DisplayViewTransform, src: str = ‘’, display: str = ‘’, view: str = ‘’, looksBypass: bool = False, dataBypass: bool = True, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

getDataBypass() → bool

getDirection() → PyOpenColorIO.TransformDirection

getDisplay() → str

getLooksBypass() → bool

getSrc() → str

getTransformType() → PyOpenColorIO.TransformType

getView() → str

setDataBypass(dataBypass: bool) → None

Data color spaces do not get processed when true (which is the default).

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setDisplay(display: str) → None

Specify which display to use.

setLooksBypass(looksBypass: bool) → None

Looks will be bypassed when true (the default is false).

setSrc(src: str) → None

Specify the incoming color space.

setView(view: str) → None

Specify which view transform to use.

validate() → None

Will throw if data is not valid.

ExponentTransform

PythonC++

class PyOpenColorIO.ExponentTransform

Represents exponent transform: pow( clamp(color), value ).

Note

For configs with version == 1: Negative style is ignored and if the exponent is 1.0, this will not clamp. Otherwise, the input color will be clamped between [0.0, inf]. For configs with version > 1: Negative value handling may be specified via setNegativeStyle.

ExponentTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.ExponentTransform) -> None

2. __init__(self: PyOpenColorIO.ExponentTransform, value: List[float[4]] = [1.0, 1.0, 1.0, 1.0], negativeStyle: PyOpenColorIO.NegativeStyle = <NegativeStyle.NEGATIVE_CLAMP: 0>, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

equals(other: PyOpenColorIO.ExponentTransform) → bool

Checks if this exactly equals other.

getDirection() → PyOpenColorIO.TransformDirection

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getNegativeStyle() → PyOpenColorIO.NegativeStyle

Specifies how negative values are handled. Legal values:

• NEGATIVE_CLAMP – Clamp negative values (default).

• NEGATIVE_MIRROR – Positive curve is rotated 180 degrees around the origin to handle negatives.

• NEGATIVE_PASS_THRU – Negative values are passed through unchanged.

getTransformType() → PyOpenColorIO.TransformType

getValue() → List[float[4]]

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setNegativeStyle(style: PyOpenColorIO.NegativeStyle) → None

setValue(value: List[float[4]]) → None

validate() → None

Will throw if data is not valid.

ExponentWithLinearTransform

PythonC++

class PyOpenColorIO.ExponentWithLinearTransform

Represents power functions with a linear section in the shadows such as sRGB and L*.

The basic formula is:

pow( (x + offset)/(1 + offset), gamma ) with the breakpoint at offset/(gamma - 1).

Negative values are never clamped.

ExponentWithLinearTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.ExponentWithLinearTransform) -> None

2. __init__(self: PyOpenColorIO.ExponentWithLinearTransform, gamma: List[float[4]] = [1.0, 1.0, 1.0, 1.0], offset: List[float[4]] = [0.0, 0.0, 0.0, 0.0], negativeStyle: PyOpenColorIO.NegativeStyle = <NegativeStyle.NEGATIVE_LINEAR: 3>, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

equals(other: PyOpenColorIO.ExponentWithLinearTransform) → bool

Checks if this exactly equals other.

getDirection() → PyOpenColorIO.TransformDirection

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getGamma() → List[float[4]]

getNegativeStyle() → PyOpenColorIO.NegativeStyle

Specifies how negative values are handled. Legal values:

• NEGATIVE_LINEAR – Linear segment continues into negatives (default).

• NEGATIVE_MIRROR – Positive curve is rotated 180 degrees around the origin to handle negatives.

getOffset() → List[float[4]]

getTransformType() → PyOpenColorIO.TransformType

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setGamma(values: List[float[4]]) → None

Set the exponent value for the power function for R, G, B, A.

Note

The gamma values must be in the range of [1, 10]. Set the transform direction to inverse to obtain the effect of values less than 1.

setNegativeStyle(style: PyOpenColorIO.NegativeStyle) → None

setOffset(values: List[float[4]]) → None

Set the offset value for the power function for R, G, B, A.

Note

The offset values must be in the range [0, 0.9].

validate() → None

Will throw if data is not valid.

ExposureContrastTransform

PythonC++

class PyOpenColorIO.ExposureContrastTransform

Applies exposure, gamma, and pivoted contrast adjustments. Adjusts the math to be appropriate for linear, logarithmic, or video color spaces.

ExposureContrastTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.ExposureContrastTransform) -> None

2. __init__(self: PyOpenColorIO.ExposureContrastTransform, style: PyOpenColorIO.ExposureContrastStyle = <ExposureContrastStyle.EXPOSURE_CONTRAST_LINEAR: 0>, exposure: float = 0.0, contrast: float = 1.0, gamma: float = 1.0, pivot: float = 0.18, logExposureStep: float = 0.088, logMidGray: float = 0.435, dynamicExposure: bool = False, dynamicContrast: bool = False, dynamicGamma: bool = False, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

equals(other: PyOpenColorIO.ExposureContrastTransform) → bool

Checks if this exactly equals other.

getContrast() → float

getDirection() → PyOpenColorIO.TransformDirection

getExposure() → float

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getGamma() → float

getLogExposureStep() → float

getLogMidGray() → float

getPivot() → float

getStyle() → PyOpenColorIO.ExposureContrastStyle

getTransformType() → PyOpenColorIO.TransformType

isContrastDynamic() → bool

Contrast can be made dynamic so the value can be changed through the CPU or GPU processor, but if there are several ExposureContrastTransform only one can have a dynamic contrast.

isExposureDynamic() → bool

Exposure can be made dynamic so the value can be changed through the CPU or GPU processor, but if there are several ExposureContrastTransform only one can have a dynamic exposure.

isGammaDynamic() → bool

Gamma can be made dynamic so the value can be changed through the CPU or GPU processor, but if there are several ExposureContrastTransform only one can have a dynamic gamma.

makeContrastDynamic() → None

makeContrastNonDynamic() → None

makeExposureDynamic() → None

makeExposureNonDynamic() → None

makeGammaDynamic() → None

makeGammaNonDynamic() → None

setContrast(contrast: float) → None

Applies a contrast/gamma adjustment around a pivot point. The contrast and gamma are mathematically the same, but two controls are provided to enable the use of separate dynamic parameters. Contrast is usually a scene-referred adjustment that pivots around gray whereas gamma is usually a display-referred adjustment that pivots around white.

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setExposure(exposure: float) → None

Applies an exposure adjustment. The value is in units of stops (regardless of style), for example, a value of -1 would be equivalent to reducing the lighting by one half.

setGamma(gamma: float) → None

setLogExposureStep(logExposureStep: float) → None

Set the increment needed to move one stop for the log-style algorithm. For example, ACEScct is 0.057, LogC is roughly 0.074, and Cineon is roughly 90/1023 = 0.088. The default value is 0.088.

setLogMidGray(logMidGray: float) → None

Set the position of 18% gray for use by the log-style algorithm. For example, ACEScct is about 0.41, LogC is about 0.39, and ADX10 is 445/1023 = 0.435. The default value is 0.435.

setPivot(pivot: float) → None

Set the pivot point around which the contrast and gamma controls will work. Regardless of whether linear/video/log-style is being used, the pivot is always expressed in linear. In other words, a pivot of 0.18 is always mid-gray.

setStyle(style: PyOpenColorIO.ExposureContrastStyle) → None

Select the algorithm for linear, video or log color spaces.

validate() → None

Will throw if data is not valid.

FileTransform

PythonC++

class PyOpenColorIO.FileTransform

FileTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.FileTransform) -> None

2. __init__(self: PyOpenColorIO.FileTransform, src: str = ‘’, cccId: str = ‘’, interpolation: PyOpenColorIO.Interpolation = <Interpolation.INTERP_DEFAULT: 254>, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

getCCCId() → str

The cccid can be the ID of a CDL or the index of the CDL (as string). If cccid is NULL or empty the first CDL is returned. The cccid is case-sensitive.

getCDLStyle() → PyOpenColorIO.CDLStyle

getDirection() → PyOpenColorIO.TransformDirection

static getFormats() → PyOpenColorIO.FileTransform.FormatIterator

getInterpolation() → PyOpenColorIO.Interpolation

The file parsers that care about interpolation (LUTs) will try to make use of the requested interpolation method when loading the file. In these cases, if the requested method could not be used, a warning is logged. If no method is provided, or a method cannot be used, INTERP_DEFAULT is used.

getSrc() → str

getTransformType() → PyOpenColorIO.TransformType

setCCCId(cccId: str) → None

setCDLStyle(style: PyOpenColorIO.CDLStyle) → None

Can be used with CDL, CC & CCC formats to specify the clamping behavior of the CDLTransform. Default is CDL_NO_CLAMP.

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setInterpolation(interpolation: PyOpenColorIO.Interpolation) → None

setSrc(src: str) → None

validate() → None

Will throw if data is not valid.

class PyOpenColorIO.FileTransform.FormatIterator

self[arg0: int] → tuple

iter(self) → PyOpenColorIO.FileTransform.FormatIterator

len(self) → int

next(self) → tuple

FixedFunctionTransform

PythonC++

class PyOpenColorIO.FixedFunctionTransform

Provides a set of hard-coded algorithmic building blocks that are needed to accurately implement various common color transformations.

FixedFunctionTransform(style: PyOpenColorIO.FixedFunctionStyle, params: List[float] = [], direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) → None

equals(other: PyOpenColorIO.FixedFunctionTransform) → bool

Checks if this exactly equals other.

getDirection() → PyOpenColorIO.TransformDirection

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getParams() → List[float]

getStyle() → PyOpenColorIO.FixedFunctionStyle

getTransformType() → PyOpenColorIO.TransformType

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setParams(params: List[float]) → None

Set the parameters (for functions that require them).

setStyle(style: PyOpenColorIO.FixedFunctionStyle) → None

Select which algorithm to use.

validate() → None

Will throw if data is not valid.

GroupTransform

PythonC++

class PyOpenColorIO.GroupTransform

static GetWriteFormats() → PyOpenColorIO.GroupTransform.WriteFormatIterator

GroupTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.GroupTransform) -> None

2. __init__(self: PyOpenColorIO.GroupTransform, transforms: List[PyOpenColorIO.Transform] = [], direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

appendTransform(transform: PyOpenColorIO.Transform) → None

Adds a transform to the end of the group.

getDirection() → PyOpenColorIO.TransformDirection

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getTransformType() → PyOpenColorIO.TransformType

prependTransform(transform: PyOpenColorIO.Transform) → None

Add a transform at the beginning of the group.

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

validate() → None

Will throw if data is not valid.

write(*args, **kwargs)

Overloaded function.

1. write(self: PyOpenColorIO.GroupTransform, formatName: str, fileName: str, config: PyOpenColorIO.Config = None) -> None

Write the transforms comprising the group to the stream.

Writing (as opposed to Baking) is a lossless process. An exception is thrown if the processor cannot be losslessly written to the specified file format. Transforms such as FileTransform or ColorSpaceTransform are resolved into write-able simple transforms using the config and context. Supported formats include CTF, CLF, and CDL. All available formats can be listed with the following: .. code-block:: cpp

// What are the allowed writing output formats? std::ostringstream formats; formats << “Formats to write to: “; for (int i = 0; i < :ref:`GroupTransform::GetNumWriteFormats`(); ++i) {

if (i != 0) formats << “, “; formats << :ref:`GroupTransform::GetFormatNameByIndex`(i); formats << ” (.” << GroupTransform::GetFormatExtensionByIndex(i) << “)”;

}

2. write(self: PyOpenColorIO.GroupTransform, formatName: str, config: PyOpenColorIO.Config = None) -> str

Write the transforms comprising the group to the stream.

Writing (as opposed to Baking) is a lossless process. An exception is thrown if the processor cannot be losslessly written to the specified file format. Transforms such as FileTransform or ColorSpaceTransform are resolved into write-able simple transforms using the config and context. Supported formats include CTF, CLF, and CDL. All available formats can be listed with the following: .. code-block:: cpp

// What are the allowed writing output formats? std::ostringstream formats; formats << “Formats to write to: “; for (int i = 0; i < :ref:`GroupTransform::GetNumWriteFormats`(); ++i) {

if (i != 0) formats << “, “; formats << :ref:`GroupTransform::GetFormatNameByIndex`(i); formats << ” (.” << GroupTransform::GetFormatExtensionByIndex(i) << “)”;

}

class PyOpenColorIO.GroupTransform.WriteFormatIterator

self[arg0: int] → tuple

iter(self) → PyOpenColorIO.GroupTransform.WriteFormatIterator

len(self) → int

next(self) → tuple

class PyOpenColorIO.GroupTransform.TransformIterator

self[arg0: int] → PyOpenColorIO.Transform

iter(self) → PyOpenColorIO.GroupTransform.TransformIterator

len(self) → int

next(self) → PyOpenColorIO.Transform

LogAffineTransform

PythonC++

class PyOpenColorIO.LogAffineTransform

Applies a logarithm with an affine transform before and after. Represents the Cineon lin-to-log type transforms:

logSideSlope * log( linSideSlope * color + linSideOffset, base) + logSideOffset

• Default values are: 1. * log( 1. * color + 0., 2.) + 0.

• The alpha channel is not affected.

LogAffineTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.LogAffineTransform) -> None

2. __init__(self: PyOpenColorIO.LogAffineTransform, logSideSlope: List[float[3]] = [1.0, 1.0, 1.0], logSideOffset: List[float[3]] = [0.0, 0.0, 0.0], linSideSlope: List[float[3]] = [1.0, 1.0, 1.0], linSideOffset: List[float[3]] = [0.0, 0.0, 0.0], direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

equals(other: PyOpenColorIO.LogAffineTransform) → bool

Checks if this exactly equals other.

getBase() → float

getDirection() → PyOpenColorIO.TransformDirection

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getLinSideOffsetValue() → List[float[3]]

getLinSideSlopeValue() → List[float[3]]

getLogSideOffsetValue() → List[float[3]]

getLogSideSlopeValue() → List[float[3]]

getTransformType() → PyOpenColorIO.TransformType

setBase(base: float) → None

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setLinSideOffsetValue(values: List[float[3]]) → None

setLinSideSlopeValue(values: List[float[3]]) → None

setLogSideOffsetValue(values: List[float[3]]) → None

setLogSideSlopeValue(values: List[float[3]]) → None

validate() → None

Will throw if data is not valid.

LogCameraTransform

PythonC++

class PyOpenColorIO.LogCameraTransform

Same as LogAffineTransform but with the addition of a linear segment near black. This formula is used for many camera logs (e.g., LogC) as well as ACEScct.

• The linSideBreak specifies the point on the linear axis where the log and linear segments meet. It must be set (there is no default).

• The linearSlope specifies the slope of the linear segment of the forward (linToLog) transform. By default it is set equal to the slope of the log curve at the break point.

LogCameraTransform() → None

LinSideBreak must be set for the transform to be valid (there is no default).

equals(other: PyOpenColorIO.LogCameraTransform) → bool

Checks if this exactly equals other.

getBase() → float

getDirection() → PyOpenColorIO.TransformDirection

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getLinSideBreakValue() → List[float[3]]

getLinSideOffsetValue() → List[float[3]]

getLinSideSlopeValue() → List[float[3]]

getLinearSlopeValue() → List[float[3]]

Return LinearSlope or 3 qnan values if not defined.

getLogSideOffsetValue() → List[float[3]]

getLogSideSlopeValue() → List[float[3]]

Get/Set values for the R, G, B components.

getTransformType() → PyOpenColorIO.TransformType

isLinearSlopeValueSet() → bool

setBase(base: float) → None

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setLinSideBreakValue(values: List[float[3]]) → None

setLinSideOffsetValue(values: List[float[3]]) → None

setLinSideSlopeValue(values: List[float[3]]) → None

setLinearSlopeValue(values: List[float[3]]) → None

Set LinearSlope value.

Note

You must call setLinSideBreakValue before calling this.

setLogSideOffsetValue(values: List[float[3]]) → None

setLogSideSlopeValue(values: List[float[3]]) → None

unsetLinearSlopeValue() → None

Remove LinearSlope values so that default values are used.

validate() → None

Will throw if data is not valid.

LogTransform

PythonC++

class PyOpenColorIO.LogTransform

Represents log transform: log(color, base)

• The input will be clamped for negative numbers.

• Default base is 2.0.

• The alpha channel is not affected.

LogTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.LogTransform) -> None

2. __init__(self: PyOpenColorIO.LogTransform, base: float = 2.0, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

equals(other: PyOpenColorIO.LogTransform) → bool

Checks if this exactly equals other.

getBase() → float

getDirection() → PyOpenColorIO.TransformDirection

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getTransformType() → PyOpenColorIO.TransformType

setBase(base: float) → None

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

validate() → None

Will throw if data is not valid.

LookTransform

PythonC++

class PyOpenColorIO.LookTransform

LookTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.LookTransform) -> None

2. __init__(self: PyOpenColorIO.LookTransform, src: str, dst: str, looks: str = ‘’, skipColorSpaceConversion: bool = False, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

getDirection() → PyOpenColorIO.TransformDirection

getDst() → str

getLooks() → str

getSkipColorSpaceConversion() → bool

getSrc() → str

getTransformType() → PyOpenColorIO.TransformType

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setDst(dst: str) → None

setLooks(looks: str) → None

Specify looks to apply. Looks is a potentially comma (or colon) delimited list of look names, Where +/- prefixes are optionally allowed to denote forward/inverse look specification. (And forward is assumed in the absence of either)

setSkipColorSpaceConversion(skipColorSpaceConversion: bool) → None

setSrc(src: str) → None

validate() → None

Will throw if data is not valid.

Lut1DTransform

PythonC++

class PyOpenColorIO.Lut1DTransform

Represents a 1D-LUT transform.

Lut1DTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.Lut1DTransform) -> None

Create an identity 1D-LUT of length two.

2. __init__(self: PyOpenColorIO.Lut1DTransform, length: int, inputHalfDomain: bool) -> None

Create an identity 1D-LUT with specific length and half-domain setting. Will throw for lengths longer than 1024x1024.

3. __init__(self: PyOpenColorIO.Lut1DTransform, length: int = 2, inputHalfDomain: bool = False, outputRawHalfs: bool = False, fileOutputBitDepth: PyOpenColorIO.BitDepth = <BitDepth.BIT_DEPTH_UNKNOWN: 0>, hueAdjust: PyOpenColorIO.Lut1DHueAdjust = <Lut1DHueAdjust.HUE_NONE: 0>, interpolation: PyOpenColorIO.Interpolation = <Interpolation.INTERP_DEFAULT: 254>, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

Create an identity 1D-LUT with specific length and half-domain setting. Will throw for lengths longer than 1024x1024.

equals(other: PyOpenColorIO.Lut1DTransform) → bool

Checks if this exactly equals other.

getData() → numpy.ndarray

getDirection() → PyOpenColorIO.TransformDirection

getFileOutputBitDepth() → PyOpenColorIO.BitDepth

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getHueAdjust() → PyOpenColorIO.Lut1DHueAdjust

getInputHalfDomain() → bool

getInterpolation() → PyOpenColorIO.Interpolation

getLength() → int

getOutputRawHalfs() → bool

getTransformType() → PyOpenColorIO.TransformType

getValue(index: int) → tuple

setData(data: buffer) → None

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setFileOutputBitDepth(bitDepth: PyOpenColorIO.BitDepth) → None

Get the bit-depth associated with the LUT values read from a file or set the bit-depth of values to be written to a file (for file formats such as CLF that support multiple bit-depths). However, note that the values stored in the object are always normalized.

setHueAdjust(hueAdjust: PyOpenColorIO.Lut1DHueAdjust) → None

The 1D-LUT transform optionally supports a hue adjustment feature that was used in some versions of ACES. This adjusts the hue of the result to approximately match the input.

setInputHalfDomain(isHalfDomain: bool) → None

In a half-domain LUT, the contents of the LUT specify the desired value of the function for each half-float value. Therefore, the length of the LUT must be 65536 entries or else validate() will throw.

setInterpolation(interpolation: PyOpenColorIO.Interpolation) → None

setLength(length: int) → None

Changing the length will reset the LUT to identity. Will throw for lengths longer than 1024x1024.

setOutputRawHalfs(isRawHalfs: bool) → None

Set OutputRawHalfs to true if you want to output the LUT contents as 16-bit floating point values expressed as unsigned 16-bit integers representing the equivalent bit pattern. For example, the value 1.0 would be written as the integer 15360 because it has the same bit-pattern. Note that this implies the values will be quantized to a 16-bit float. Note that this setting only controls the output formatting (where supported) and not the values for getValue/setValue. The only file formats that currently support this are CLF and CTF.

setValue(index: int, r: float, g: float, b: float) → None

Set the values of a LUT1D. Will throw if the index is outside of the range from 0 to (length-1).

The LUT values are always for the “forward” LUT, regardless of how the transform direction is set.

These values are normalized relative to what may be stored in any given LUT files. For example in a CLF file using a “10i” output depth, a value of 1023 in the file is normalized to 1.0. The values here are unclamped and may extend outside [0,1].

LUTs in various file formats may only provide values for one channel where R, G, B are the same. Even in that case, you should provide three equal values to the setter.

validate() → None

Will throw if data is not valid.

Lut3DTransform

PythonC++

class PyOpenColorIO.Lut3DTransform

Represents a 3D-LUT transform.

Lut3DTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.Lut3DTransform) -> None

Create an identity 3D-LUT of size 2x2x2.

2. __init__(self: PyOpenColorIO.Lut3DTransform, gridSize: int) -> None

Create an identity 3D-LUT with specific grid size. Will throw for grid size larger than 129.

3. __init__(self: PyOpenColorIO.Lut3DTransform, gridSize: int = 2, fileOutputBitDepth: PyOpenColorIO.BitDepth = <BitDepth.BIT_DEPTH_UNKNOWN: 0>, interpolation: PyOpenColorIO.Interpolation = <Interpolation.INTERP_DEFAULT: 254>, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

Create an identity 3D-LUT with specific grid size. Will throw for grid size larger than 129.

equals(other: PyOpenColorIO.Lut3DTransform) → bool

Checks if this exactly equals other.

getData() → numpy.ndarray

getDirection() → PyOpenColorIO.TransformDirection

getFileOutputBitDepth() → PyOpenColorIO.BitDepth

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getGridSize() → int

getInterpolation() → PyOpenColorIO.Interpolation

getTransformType() → PyOpenColorIO.TransformType

getValue(indexR: int, indexG: int, indexB: int) → tuple

setData(data: buffer) → None

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setFileOutputBitDepth(bitDepth: PyOpenColorIO.BitDepth) → None

Get the bit-depth associated with the LUT values read from a file or set the bit-depth of values to be written to a file (for file formats such as CLF that support multiple bit-depths). However, note that the values stored in the object are always normalized.

setGridSize(gridSize: int) → None

Changing the grid size will reset the LUT to identity. Will throw for grid sizes larger than 129.

setInterpolation(interpolation: PyOpenColorIO.Interpolation) → None

setValue(indexR: int, indexG: int, indexB: int, r: float, g: float, b: float) → None

Set the values of a 3D-LUT. Will throw if an index is outside of the range from 0 to (gridSize-1).

The LUT values are always for the “forward” LUT, regardless of how the transform direction is set.

These values are normalized relative to what may be stored in any given LUT files. For example in a CLF file using a “10i” output depth, a value of 1023 in the file is normalized to 1.0. The values here are unclamped and may extend outside [0,1].

validate() → None

Will throw if data is not valid.

MatrixTransform

PythonC++

class PyOpenColorIO.MatrixTransform

Represents an MX+B Matrix transform.

Note

For singular matrices, an inverse direction will throw an exception during finalization.

static Fit(oldMin: List[float[4]] = [0.0, 0.0, 0.0, 0.0], oldMax: List[float[4]] = [1.0, 1.0, 1.0, 1.0], newMin: List[float[4]] = [0.0, 0.0, 0.0, 0.0], newMax: List[float[4]] = [1.0, 1.0, 1.0, 1.0]) → PyOpenColorIO.MatrixTransform

Convenience functions

Build the matrix and offset corresponding to higher-level concepts.

Note

These can throw an exception if for any component oldmin == oldmax. (divide by 0)

static Identity() → PyOpenColorIO.MatrixTransform

static Sat(sat: float, lumaCoef: List[float[3]]) → PyOpenColorIO.MatrixTransform

static Scale(scale: List[float[4]]) → PyOpenColorIO.MatrixTransform

static View(channelHot: List[int[4]], lumaCoef: List[float[3]]) → PyOpenColorIO.MatrixTransform

MatrixTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.MatrixTransform) -> None

2. __init__(self: PyOpenColorIO.MatrixTransform, matrix: List[float[16]] = [1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0], offset: List[float[4]] = [0.0, 0.0, 0.0, 0.0], direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

equals(other: PyOpenColorIO.MatrixTransform) → bool

Checks if this exactly equals other.

getDirection() → PyOpenColorIO.TransformDirection

getFileInputBitDepth() → PyOpenColorIO.BitDepth

Get the bit-depths associated with the matrix values read from a file or set the bit-depths of values to be written to a file (for file formats such as CLF that support multiple bit-depths).

In a format such as CLF, the matrix values are scaled to take pixels at the specified inBitDepth to pixels at the specified outBitDepth. This complicates the interpretation of the matrix values and so this object always holds normalized values and scaling is done on the way from or to file formats such as CLF.

getFileOutputBitDepth() → PyOpenColorIO.BitDepth

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getMatrix() → List[float[16]]

getOffset() → List[float[4]]

getTransformType() → PyOpenColorIO.TransformType

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setFileInputBitDepth(bitDepth: PyOpenColorIO.BitDepth) → None

setFileOutputBitDepth(bitDepth: PyOpenColorIO.BitDepth) → None

setMatrix(matrix: List[float[16]]) → None

Get or set the values of a Matrix. Expects 16 values, where the first four are the coefficients to generate the R output channel from R, G, B, A input channels.

The Matrix values are always for the “forward” Matrix, regardless of how the transform direction is set.

These values are normalized relative to what may be stored in file formats such as CLF. For example in a CLF file using a “32f” input depth and “10i” output depth, a value of 1023 in the file is normalized to 1.0. The values here are unclamped and may extend outside [0,1].

setOffset(offset: List[float[4]]) → None

Get or set the R, G, B, A offsets to be applied after the matrix.

These values are normalized relative to what may be stored in file formats such as CLF. For example, in a CLF file using a “10i” output depth, a value of 1023 in the file is normalized to 1.0. The values here are unclamped and may extend outside [0,1].

validate() → None

Will throw if data is not valid.

RangeTransform

PythonC++

class PyOpenColorIO.RangeTransform

Represents a range transform

The Range is used to apply an affine transform (scale & offset) and clamps values to min/max bounds on all color components except the alpha. The scale and offset values are computed from the input and output bounds.

Refer to section 7.2.4 in specification S-2014-006 “A Common File Format for Look-Up Tables” from the Academy of Motion Picture Arts and Sciences and the American Society of Cinematographers.

Note

The “noClamp” style described in the specification S-2014-006 becomes a MatrixOp at the processor level.

Note

Changing the transform direction does not modify the in/out values – they are always specified with respect to the “forward” direction.

RangeTransform(*args, **kwargs)

Overloaded function.

1. __init__(self: PyOpenColorIO.RangeTransform) -> None

Creates an instance of RangeTransform.

2. __init__(self: PyOpenColorIO.RangeTransform, minInValue: float = nan, maxInValue: float = nan, minOutValue: float = nan, maxOutValue: float = nan, direction: PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) -> None

Creates an instance of RangeTransform.

equals(other: PyOpenColorIO.RangeTransform) → bool

Checks if this equals other.

getDirection() → PyOpenColorIO.TransformDirection

getFileInputBitDepth() → PyOpenColorIO.BitDepth

File bit-depth

In a format such as CLF, the range values are scaled to take pixels at the specified inBitDepth to pixels at the specified outBitDepth. This complicates the interpretation of the range values and so this object always holds normalized values and scaling is done on the way from or to file formats such as CLF. Get the bit-depths associated with the range values read from a file or set the bit-depths of values to be written to a file (for file formats such as CLF that support multiple bit-depths).

getFileOutputBitDepth() → PyOpenColorIO.BitDepth

getFormatMetadata() → PyOpenColorIO.FormatMetadata

getMaxInValue() → float

Get the maximum value for the input.

getMaxOutValue() → float

Get the maximum value for the output.

getMinInValue() → float

Get the minimum value for the input.

Range values

These values are normalized relative to what may be stored in file formats such as CLF. For example in a CLF file using a “10i” input depth, a MaxInValue of 1023 in the file is normalized to 1.0. Likewise, for an output depth of “12i”, a MaxOutValue of 4095 in the file is normalized to 1.0. The values here are unclamped and may extend outside [0,1].

getMinOutValue() → float

Get the minimum value for the output.

getStyle() → PyOpenColorIO.RangeStyle

getTransformType() → PyOpenColorIO.TransformType

hasMaxInValue() → bool

Is the maximum value for the input set?

hasMaxOutValue() → bool

Is the maximum value for the output set?

hasMinInValue() → bool

Is the minimum value for the input set?

hasMinOutValue() → bool

Is the minimum value for the output set?

setDirection(direction: PyOpenColorIO.TransformDirection) → None

Note that this only affects the evaluation and not the values stored in the object.

setFileInputBitDepth(bitDepth: PyOpenColorIO.BitDepth) → None

setFileOutputBitDepth(bitDepth: PyOpenColorIO.BitDepth) → None

setMaxInValue(value: float) → None

Set the maximum value for the input.

setMaxOutValue(value: float) → None

Set the maximum value for the output.

setMinInValue(value: float) → None

Set the minimum value for the input.

setMinOutValue(value: float) → None

Set the minimum value for the output.

setStyle(style: PyOpenColorIO.RangeStyle) → None

Set the Range style to clamp or not input values.

unsetMaxInValue() → None

Unset the maximum value for the input.

unsetMaxOutValue() → None

Unset the maximum value for the output.

unsetMinInValue() → None

Unset the minimum value for the input.

unsetMinOutValue() → None

Unset the minimum value for the output.

validate() → None

Will throw if data is not valid.