c4d.modules.render.OcioConverter¶

class c4d.modules.render.OcioConverter¶: Transforms colors from one OCIO color space to another.

New in version 2025.2.0.

Overview¶

Color Conversion
`OcioConverter.IsOcioConverter()`	Checks if the converter is an OCIO converter.
`OcioConverter.TransformColor()`	Transforms a color.
`OcioConverter.TransformColors()`	Transforms multiple colors.
Magic Methods
`OcioConverter.__init__()`	Creates a new converter and Initializes it with the document settings.

OcioConverter.IsOcioConverter(self)¶

Checks if the converter is an OCIO converter.

Returns: True if the converter is an OCIO converter, False if the converter is a legacy converter.
Return type: bool

OcioConverter.TransformColor(self, v, colorSpaceTransformation)¶

Transforms a color.

Parameters

colorSpaceTransformation (int.) –

The values are:

Symbol ID	Description
NONE	None.
COLORSPACETRANSFORMATION_LINEAR_TO_SRGB	Linear to sRGB color space transformation.
COLORSPACETRANSFORMATION_SRGB_TO_LINEAR	sRGB to linear color space transformation.
COLORSPACETRANSFORMATION_LINEAR_TO_VIEW	Linear to display color space transformation.
COLORSPACETRANSFORMATION_SRGB_TO_VIEW	sRGB to display color space transformation.

Returns

The transformed color.

Return type

c4d.Vector

OcioConverter.TransformColors(self, v, colorSpaceTransformation)¶

Transforms multiple colors.

Parameters

colorSpaceTransformation (int.) –

The values are:

Symbol ID	Description
NONE	None.
COLORSPACETRANSFORMATION_LINEAR_TO_SRGB	Linear to sRGB color space transformation.
COLORSPACETRANSFORMATION_SRGB_TO_LINEAR	sRGB to linear color space transformation.
COLORSPACETRANSFORMATION_LINEAR_TO_VIEW	Linear to display color space transformation.
COLORSPACETRANSFORMATION_SRGB_TO_VIEW	sRGB to display color space transformation.

Returns

The transformed colors.

Return type

list[c4d.Vector]

OcioConverter.__init__(self, doc, overrideViewTransform=-1)¶

Creates a new converter and Initializes it with the document settings.

Parameters

doc (c4d.documents.BaseDocument) – The optional document to initialize with.
overrideViewTransform (int) – Index within the viewtransform array to override the view transform. Ignored, if the value is not a valid index.

Category	Option	Description
Query	Words and phrases	Search is case-insensitive. Put a phrase in quotes for an exact match. Quoted phrases require every word and disable fuzzy matching.
Terms	OR / AND	Choose whether to match any term or require all terms.
Fuzzy	On / Off	Toggle approximate and prefix matches. Quoted phrases always use strict matching.
Results	Sparse / Dense	Sparse groups multiple hits for one entity and hides its owned API members when the class or module itself matches. Dense lists each match separately.
Sort by	Type / Relevance	Group results by entity type then rank within each group, or rank all results by relevance.
Content	All / API / Manuals / Examples / Resources	Search all documentation, API documentation, manuals, the examples index, or the resources index. Code examples embedded in other sections retain their own content area.
Entity	All / Page / Module / Class / Function / Attribute / Description / Node / Symbol / Icon	Page covers results without a specific entity type. Resource entity types are available with All or Resources; API entity types are available with All or API.
Location	All / Text / Code / Name / Signature	Text covers everything outside code, names, and signatures. Name and Signature are available with All or API.