Applications Helpers¶

ColorSpaceMenuHelpers¶

PyOpenColorIO.ColorSpaceHelpers.AddColorSpace(config: PyOpenColorIO.PyOpenColorIO.Config, name: str, transformFilePath: str, categories: str = '', connectionColorSpaceName: str) → None¶

class PyOpenColorIO.ColorSpaceMenuParameters¶

ColorSpaceMenuParameters(*args, **kwargs)¶

Overloaded function.

__init__(self: PyOpenColorIO.PyOpenColorIO.ColorSpaceMenuParameters, config: PyOpenColorIO.PyOpenColorIO.Config) -> None
__init__(self: PyOpenColorIO.PyOpenColorIO.ColorSpaceMenuParameters, config: PyOpenColorIO.PyOpenColorIO.Config, role: str = ‘’, includeColorSpaces: bool = True, searchReferenceSpaceType: PyOpenColorIO.PyOpenColorIO.SearchReferenceSpaceType = <SearchReferenceSpaceType.SEARCH_REFERENCE_SPACE_ALL: 2>, includeNamedTransforms: bool = False, treatNoCategoryAsAny: bool = True, appCategories: str = ‘’, encodings: str = ‘’, userCategories: str = ‘’, includeRoles: bool = False) -> None

addColorSpace(colorSpace: str) → None¶

clearAddedColorSpaces() → None¶

getAddedColorSpaces() → PyOpenColorIO.PyOpenColorIO.ColorSpaceMenuParameters.AddedColorSpaceIterator¶

getAppCategories() → str¶

getConfig() → PyOpenColorIO.PyOpenColorIO.Config¶

getEncodings() → str¶

getIncludeColorSpaces() → bool¶

getIncludeNamedTransforms() → bool¶

getIncludeRoles() → bool¶

getRole() → str¶

getSearchReferenceSpaceType() → PyOpenColorIO.PyOpenColorIO.SearchReferenceSpaceType¶

getTreatNoCategoryAsAny() → bool¶

getUserCategories() → str¶

setAppCategories(appCategories: str) → None¶

setConfig(config: PyOpenColorIO.PyOpenColorIO.Config) → None¶

setEncodings(encodings: str) → None¶

setIncludeColorSpaces(includeColorSpaces: bool = True) → None¶

setIncludeNamedTransforms(includeNamedTransforms: bool = True) → None¶

setIncludeRoles(includeRoles: bool = True) → None¶

setRole(role: str) → None¶

setSearchReferenceSpaceType(searchReferenceSpaceType: PyOpenColorIO.PyOpenColorIO.SearchReferenceSpaceType) → None¶

setTreatNoCategoryAsAny(treatNoCategoryAsAny: bool = True) → None¶

setUserCategories(categories: str) → None¶

class PyOpenColorIO.ColorSpaceMenuHelper¶

ColorSpaceMenuHelper(parameters: PyOpenColorIO.PyOpenColorIO.ColorSpaceMenuParameters) → None¶

getDescription(index: SupportsInt) → str¶

getFamily(index: SupportsInt) → str¶

getHierarchyLevels(index: SupportsInt) → PyOpenColorIO.PyOpenColorIO.ColorSpaceMenuHelper.ColorSpaceLevelIterator¶

getIndexFromName(name: str) → int¶

getIndexFromUIName(name: str) → int¶

getName(index: SupportsInt) → str¶

getNameFromUIName(name: str) → str¶

getNumColorSpaces() → int¶

getUIName(index: SupportsInt) → str¶

getUINameFromName(name: str) → str¶

class PyOpenColorIO.ColorSpaceMenuHelper.ColorSpaceLevelIterator¶

self[arg0: SupportsInt] → str¶

iter(self) → PyOpenColorIO.PyOpenColorIO.ColorSpaceMenuHelper.ColorSpaceLevelIterator¶

len(self) → int¶

next(self) → str¶

class ColorSpaceMenuParameters¶

Parameters controlling which color spaces appear in menus.

The ColorSpaceMenuHelper class is intended to be used by applications to get the list of items to show in color space menus.

The ColorSpaceMenuParameters class is used to configure the behavior as needed for any given menu. Here is the algorithm used to produce a list of “items” (or strings) that will appear in a menu:

1) Use setRole to identify a role that controls a given menu. If the config has this role, then only that color space is returned. The name is set to the color space name, the UIName is presented as “<role name> (<color space name>)”. It may be useful for the application to then grey-out the menu or otherwise indicate to the user that the value for this menu is not user selectable since it was pre-determined by the config. If the config does not have that role, the algorithm continues to the remaining steps.

2) The IncludeColorSpaces, SearchReferenceSpaceType, and IncludeNamedTransforms parameters are used to identify a set of items from the config that are potential candidates for use in the menu, as follows:

IncludeColorSpaces: Set to true to include color spaces in the menu.
SearchReferenceSpaceType: Use this to control whether the menu should include all color spaces, only display color spaces, or only non-display color spaces.
IncludeNamedTransforms: Set to true to include named transforms in the menu.

3) The set of items from step 2 is then filtered in step 3 using the following parameters:

AppCategories: A list of strings specified by the application based on the purpose of the menu. For example, if the menu is used to select a color space for importing an image, the application might specify the ‘file-io’ category, whereas if it is to select a working color space, it might specify the ‘working-space’ category. Application developers should document what strings they are using for each menu so that config authors know what categories to use in their configs. Alternatively, an application could let advanced users customize the string to use for a given menu in the application.
Encodings: A list of strings used to further refine the items selected from the AppCategories. For example, an application might specify ‘working-space’ as the category and then specify ‘scene-linear’ as the encoding to only use items that have both of those properties (e.g., only select scene-linear working color spaces).
UserCategories: A list of strings specified by the end-user of the application. OCIO will check for these strings in an environment variable, or they may be passed in from the application.
TreatNoCategoryAsAny: By default, color spaces (or named transforms) that have no categories are handled as if they had any of the categories. Config authors that want to hide color spaces without categories should either put them in the inactiveColorSpaces list or add a category that will never be searched for (e.g., “invisible” or “hidden”). App developers may set this option to false to hide items without any categories.

Basically the intent is for the filtering to return the intersection of the app categories, encoding, and user categories. However, some fall-backs are in place to ensure that the filtering does not remove all menu items. Here is the detailed description:

3a) The items from step 2 are filtered to generate a list of appItems containing only the ones that contain at least one of the AppCategories strings in their “categories” property and one of the encodings in their “encoding” property. If this list is empty, an attempt is made to generate a non-empty appItems list by only filtering by AppCategories. If that is empty, an attempt is made to only filter by Encodings.

3b) The items from step 2 are filtered to generate a list of userItems containing only the ones that have at least one of the UserCategories strings in their “categories” property.

3c) If both appItems and userItems are non-empty, a list of resultItems will be generated as the intersection of those two lists.

3d) If the resultItems list is empty, the appList will be expanded by only filtering by AppCategories and not encodings. The resultItems will be formed again as the intersection of the appItems and userItems.

3e) If the resultItems is still empty, it will be set to just the appItems from step 3a.

3f) If the resultItems is still empty, it will be set to just the userItems.

3g) If the resultItems is still empty, the items are not filtered and all items from step 2 are returned. The rationale is that if step 2 has produced any items, it is not acceptable for step 3 to remove all of them. An application usually expects to have a non-zero number of items to display in the menu. However, if step 2 produces no items (e.g. the application requests only named transforms and the config has no named transform), then no items will be returned.

4) If IncludeRoles is true, the items from step 3 are extended by including an item for each role. The name is set to the role name, the UIName is presented as “<role name> (<color

space name>)”, and the family is set to “Roles”.

5) If AddColorSpace has been used to add any additional items, these are appended to the final list.

Public Functions

virtual void setConfig(ConstConfigRcPtr config) noexcept = 0¶: Config is required to be able to create a ColorSpaceMenuHelper.

virtual ConstConfigRcPtr getConfig() const noexcept = 0¶

virtual void setRole(const char *role) noexcept = 0¶: If role is a valid role, other parameters are ignored and menu will contain only that role.

virtual const char *getRole() const noexcept = 0¶

virtual void setIncludeColorSpaces(bool include) noexcept = 0¶: Include all color spaces (or not) to ColorSpaceMenuHelper. Default is to include color spaces.

virtual bool getIncludeColorSpaces() const noexcept = 0¶

virtual SearchReferenceSpaceType getSearchReferenceSpaceType() const noexcept = 0¶: Can be used to restrict the search using the ReferenceSpaceType of the color spaces. It has no effect on roles and named transforms.

virtual void setSearchReferenceSpaceType(SearchReferenceSpaceType colorSpaceType) noexcept = 0¶

virtual void setIncludeNamedTransforms(bool include) noexcept = 0¶: Include all named transforms (or not) to ColorSpaceMenuHelper. Default is not to include named transforms.

virtual bool getIncludeNamedTransforms() const noexcept = 0¶

virtual void setTreatNoCategoryAsAny(bool value) noexcept = 0¶: When searching for color spaces using app or user categories, treat color spaces or named transforms that have no categories as if they had any of the categories. Default is true.

virtual bool getTreatNoCategoryAsAny() const noexcept = 0¶

virtual void setAppCategories(const char *appCategories) noexcept = 0¶: App categories is a comma separated list of categories. If appCategories is not NULL and not empty, all color spaces that have one of the categories will be part of the menu.

virtual const char *getAppCategories() const noexcept = 0¶

virtual void setEncodings(const char *encodings) noexcept = 0¶: Encodings is a comma separated list of encodings. When not empty, is retricting the search to color spaces that are using one of the encodings.

virtual const char *getEncodings() const noexcept = 0¶

virtual void setUserCategories(const char *userCategories) noexcept = 0¶: User categories is a comma separated list of categories. If OCIO_USER_CATEGORIES_ENVVAR env. variable is defined and not empty, this parameter is ignored and the value of the env. variable is used for user categories.

virtual const char *getUserCategories() const noexcept = 0¶

virtual void setIncludeRoles(bool include) noexcept = 0¶: Include all roles (or not) to ColorSpaceMenuHelper. Default is not to include roles. Roles are added after color spaces with an single hierarchy level named “Roles”.

virtual bool getIncludeRoles() const noexcept = 0¶

virtual void addColorSpace(const char *name) noexcept = 0¶

Add an additional color space (or named transform) to the menu.

Note that an additional color space could be:

an inactive color space,
an active color space not having at least one of the selected categories,
a newly created color space. Will throw when creating the menu if color space is not part of the config. Nothing is done if it is already part of the menu. It’s ok to call this multiple times with the same color space, it will only be added to the menu once. If a role name is passed in, the name in the menu will be the color space name the role points to.

virtual size_t getNumAddedColorSpaces() const noexcept = 0¶

virtual const char *getAddedColorSpace(size_t index) const noexcept = 0¶

virtual void clearAddedColorSpaces() noexcept = 0¶

virtual ~ColorSpaceMenuParameters() = default¶: Do not use (needed only for pybind11).

Public Static Functions

static ColorSpaceMenuParametersRcPtr Create(ConstConfigRcPtr config)¶

std::ostream &OpenColorIO_v2_6::operator<<(std::ostream&, const ColorSpaceMenuParameters&)¶

class ColorSpaceMenuHelper¶

Helper class to create menus for the content of a config.

Menu can list color spaces, roles, named transforms. Each entry has a name, a UI name, a description, and a family. Family can also be accessed as hierarchy levels; levels are created by splitting the family using the ‘family separator’. Hierarchy levels are meant to be used as sub-menus.

The UI name is what is intended to be put in application menus seen by the end-user. However, please note that the UI name is not guaranteed to remain stable between releases and so if applications need to save something it should be the ‘name’ rather than the ‘UI name’. Currently, the only difference between the ‘name’ and ‘UI name’ is for roles.

The overall ordering of items is: color spaces, named transforms, roles, and additional color spaces. The display color spaces will either come before or after the other color spaces based on where that block of spaces appears in the config. The order of items returned by the menu helper preserves the order of items in the config itself for each type of elements, thus preserving the intent of the config author. For example, if you call getName at idx and idx+1, the name returned at idx+1 will be from farther down in the config than the one at idx as long as both are of the same type. (An application may ask for only the items in one of those blocks if it wants to handle them separately.) If the application makes use of hierarchical menus, that will obviously impose a different order on what the user sees in the menu. Though even with hierarchical menus, applications should try to preserve config ordering (which is equivalent to index ordering) for items within the same sub-menu.

Public Functions

virtual size_t getNumColorSpaces() const noexcept = 0¶: Access to the color spaces (or roles).

virtual const char *getName(size_t idx) const noexcept = 0¶: Get the color space (or role) name used in the config for this menu item. Will be empty if the index is out of range.

virtual const char *getUIName(size_t idx) const noexcept = 0¶: Get the name to use in the menu UI. This might be different from the config name, for example in the case of roles. Will be empty if the index is out of range.

virtual size_t getIndexFromName(const char *name) const noexcept = 0¶: Get the index of the element of a given name. Return (size_t)-1 name if NULL or empty, or if no element with that name is found.

virtual size_t getIndexFromUIName(const char *name) const noexcept = 0¶

virtual const char *getDescription(size_t idx) const noexcept = 0¶

virtual const char *getFamily(size_t idx) const noexcept = 0¶

virtual size_t getNumHierarchyLevels(size_t idx) const noexcept = 0¶: Hierarchy levels are created from the family string. It is split into levels using the ‘family separator’.

virtual const char *getHierarchyLevel(size_t idx, size_t i) const noexcept = 0¶

virtual const char *getNameFromUIName(const char *uiName) const noexcept = 0¶: Get the color space name from the UI name.

virtual const char *getUINameFromName(const char *name) const noexcept = 0¶: Get the color space UI name from the name.

ColorSpaceMenuHelper(const ColorSpaceMenuHelper&) = delete¶

ColorSpaceMenuHelper &operator=(const ColorSpaceMenuHelper&) = delete¶

virtual ~ColorSpaceMenuHelper() = default¶: Do not use (needed only for pybind11).

Public Static Functions

static ColorSpaceMenuHelperRcPtr Create(ConstColorSpaceMenuParametersRcPtr parameters)¶

std::ostream &OpenColorIO_v2_6::operator<<(std::ostream&, const ColorSpaceMenuHelper&)¶

typedef std::shared_ptr<const ColorSpaceMenuHelper> OpenColorIO_v2_6::ConstColorSpaceMenuHelperRcPtr¶

typedef std::shared_ptr<ColorSpaceMenuHelper> OpenColorIO_v2_6::ColorSpaceMenuHelperRcPtr¶

ConfigCompatibilityHelpers¶

ConfigMergingHelpers¶

PyOpenColorIO.ConfigMergingHelpers.MergeConfigs(params: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters, baseConfig: PyOpenColorIO.PyOpenColorIO.Config, inputConfig: PyOpenColorIO.PyOpenColorIO.Config) → PyOpenColorIO.PyOpenColorIO.Config¶

PyOpenColorIO.ConfigMergingHelpers.MergeColorSpace(params: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters, baseConfig: PyOpenColorIO.PyOpenColorIO.Config, colorspace: PyOpenColorIO.PyOpenColorIO.ColorSpace) → PyOpenColorIO.PyOpenColorIO.Config¶

class PyOpenColorIO.ConfigMergingParameters¶

static Create() → PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters¶

STRATEGY_BASE_ONLY = <MergeStrategies.STRATEGY_BASE_ONLY: 3>¶

STRATEGY_INPUT_ONLY = <MergeStrategies.STRATEGY_INPUT_ONLY: 2>¶

STRATEGY_PREFER_BASE = <MergeStrategies.STRATEGY_PREFER_BASE: 1>¶

STRATEGY_PREFER_INPUT = <MergeStrategies.STRATEGY_PREFER_INPUT: 0>¶

STRATEGY_REMOVE = <MergeStrategies.STRATEGY_REMOVE: 4>¶

STRATEGY_UNSPECIFIED = <MergeStrategies.STRATEGY_UNSPECIFIED: 5>¶

ConfigMergingParameters(*args, **kwargs)¶

addEnvironmentVar(name: str, defaultValue: str) → None¶

addSearchPath(path: str) → None¶

getActiveDisplays() → str¶

getActiveViews() → str¶

getBaseConfigName() → str¶

getBaseFamilyPrefix() → str¶

getColorspaces() → PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies¶

getDefaultStrategy() → PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies¶

getDescription() → str¶

getDisplayViews() → PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies¶

getEnvironmentVar(index: SupportsInt) → str¶

getEnvironmentVarValue(index: SupportsInt) → str¶

getFileRules() → PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies¶

getInactiveColorSpaces() → str¶

getInputConfigName() → str¶

getInputFamilyPrefix() → str¶

getLooks() → PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies¶

getName() → str¶

getNamedTransforms() → PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies¶

getNumEnvironmentVars() → int¶

getOutputName() → str¶

getRoles() → PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies¶

getSearchPath() → str¶

getViewTransforms() → PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies¶

isAdjustInputReferenceSpace() → bool¶

isAvoidDuplicates() → bool¶

isErrorOnConflict() → bool¶

isInputFirst() → bool¶

setActiveDisplays(displays: str) → None¶

setActiveViews(views: str) → None¶

setAdjustInputReferenceSpace(enabled: bool) → None¶

setAvoidDuplicates(enabled: bool) → None¶

setBaseConfigName(baseConfig: str) → None¶

setBaseFamilyPrefix(prefix: str) → None¶

setColorspaces(strategy: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies) → None¶

setDefaultStrategy(strategy: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies) → None¶

setDescription(mergedConfigDesc: str) → None¶

setDisplayViews(strategy: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies) → None¶

setErrorOnConflict(enabled: bool) → None¶

setFileRules(strategy: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies) → None¶

setInactiveColorSpaces(colorspaces: str) → None¶

setInputConfigName(inputConfig: str) → None¶

setInputFamilyPrefix(prefix: str) → None¶

setInputFirst(enabled: bool) → None¶

setLooks(strategy: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies) → None¶

setName(mergedConfigName: str) → None¶

setNamedTransforms(strategy: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies) → None¶

setOutputName(outputName: str) → None¶

setRoles(strategy: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies) → None¶

setSearchPath(path: str) → None¶

setViewTransforms(strategy: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters.MergeStrategies) → None¶

class PyOpenColorIO.ConfigMergingParameters.MergeStrategies¶

Members:

STRATEGY_PREFER_INPUT :

STRATEGY_PREFER_BASE :

STRATEGY_INPUT_ONLY :

STRATEGY_BASE_ONLY :

STRATEGY_REMOVE :

STRATEGY_UNSPECIFIED :

STRATEGY_BASE_ONLY = <MergeStrategies.STRATEGY_BASE_ONLY: 3>¶

STRATEGY_INPUT_ONLY = <MergeStrategies.STRATEGY_INPUT_ONLY: 2>¶

STRATEGY_PREFER_BASE = <MergeStrategies.STRATEGY_PREFER_BASE: 1>¶

STRATEGY_PREFER_INPUT = <MergeStrategies.STRATEGY_PREFER_INPUT: 0>¶

STRATEGY_REMOVE = <MergeStrategies.STRATEGY_REMOVE: 4>¶

STRATEGY_UNSPECIFIED = <MergeStrategies.STRATEGY_UNSPECIFIED: 5>¶

property value¶

class PyOpenColorIO.ConfigMerger¶

static Create() → PyOpenColorIO.PyOpenColorIO.ConfigMerger¶

static CreateFromFile(filepath: str) → PyOpenColorIO.PyOpenColorIO.ConfigMerger¶

ConfigMerger(*args, **kwargs)¶

addParams(params: PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters) → None¶

addSearchPath(path: str) → None¶

getMajorVersion() → int¶

getMergedConfig(*args, **kwargs)¶

Overloaded function.

getMergedConfig(self: PyOpenColorIO.PyOpenColorIO.ConfigMerger) -> PyOpenColorIO.PyOpenColorIO.Config
getMergedConfig(self: PyOpenColorIO.PyOpenColorIO.ConfigMerger, index: typing.SupportsInt) -> PyOpenColorIO.PyOpenColorIO.Config

getMinorVersion() → int¶

getNumConfigMergingParameters() → int¶

getNumMergedConfigs() → int¶

getNumSearchPaths() → int¶

getParams(index: SupportsInt) → PyOpenColorIO.PyOpenColorIO.ConfigMergingParameters¶

getSearchPath(index: SupportsInt) → str¶

getWorkingDir() → str¶

mergeConfigs() → PyOpenColorIO.PyOpenColorIO.ConfigMerger¶

serialize() → str¶

setSearchPath(path: str) → None¶

setVersion(major: SupportsInt, minor: SupportsInt) → None¶

setWorkingDir(dirname: str) → None¶

class ConfigMergingParameters¶

The ConfigMergingParameters class holds the options that control how a merge is done.

In terms of OCIOM file, it represent one of the merges in an OCIOM file.

Public Types

enum MergeStrategies¶

Values:

enumerator STRATEGY_PREFER_INPUT¶: Combine elements of the base and input configs, with the input taking priority.

enumerator STRATEGY_PREFER_BASE¶: Combine elements of the base and input configs, with the base taking priority.

enumerator STRATEGY_INPUT_ONLY¶: Use only the input elements for that section of the config.

enumerator STRATEGY_BASE_ONLY¶: Use only the base elements for that section of the config.

enumerator STRATEGY_REMOVE¶: The elements in the input config are removed from the base config. (If the names match, the item is removed, even if the content is not identical.)

enumerator STRATEGY_UNSPECIFIED¶: Strategy has not been set yet.

Public Functions

ConfigMergingParametersRcPtr createEditableCopy() const¶

void setBaseConfigName(const char *baseConfig)¶: Set the file name of the base config. This is used along with the search path of the ConfigMerger object.

const char *getBaseConfigName() const¶

void setInputConfigName(const char *inputConfig)¶: Set the file name of the input config. This is used along with the search path of the ConfigMerger object.

const char *getInputConfigName() const¶

void setOutputName(const char *outputName)¶: Set a name to use for this merger. This may be used as the input or base config name in subsequent mergers.

const char *getOutputName() const¶

void setDefaultStrategy(const ConfigMergingParameters::MergeStrategies strategy)¶: Set the default strategy. This will be used if the strategy for a given config section is not set, and will be used for basic attributes such as the config description. Default = STRATEGY_PREFER_INPUT.

ConfigMergingParameters::MergeStrategies getDefaultStrategy() const¶

void setInputFamilyPrefix(const char *prefix)¶: Set a prefix to add to the family of input config items. (It must use ‘/’ as the separator and will be replaced by the actual family separator of the config.)

const char *getInputFamilyPrefix() const¶

void setBaseFamilyPrefix(const char *prefix)¶: Set a prefix to add to the family of base config items. (It must use ‘/’ as the separator and will be replaced by the actual family separator of the config.)

const char *getBaseFamilyPrefix() const¶

void setInputFirst(bool enabled)¶: If true, items from the input config will be higher in the file than those of the base config. Default = true.

bool isInputFirst() const¶

void setErrorOnConflict(bool enabled)¶: If true, throw an exception rather than log a warning when a conflict is detected. Default = false.

bool isErrorOnConflict() const¶

void setAvoidDuplicates(bool enabled)¶: If true, a color space from the input config is compared against those of the base config. If it is mathematically equivalent, it is not added. Instead, its name and aliases are added to the original color space. Default = true.

bool isAvoidDuplicates() const¶

void setAdjustInputReferenceSpace(bool enabled)¶: If true, the reference spaces of the base and input config are compared and color spaces from the input config will be adjusted to use the reference space of the base. If the interchange roles are not set, heuristics will be used to try and determine the reference space. Default = true.

bool isAdjustInputReferenceSpace() const¶

void setName(const char *mergedConfigName)¶: Override the name of the merged config.

const char *getName() const¶

void setDescription(const char *mergedConfigDesc)¶: Override the description of the merged config.

const char *getDescription() const¶

void addEnvironmentVar(const char *name, const char *defaultValue)¶: Override a context variable in the merged config.

int getNumEnvironmentVars() const¶: Get the number of context variable overrides.

const char *getEnvironmentVar(int index) const¶

const char *getEnvironmentVarValue(int index) const¶

void setSearchPath(const char *path)¶: Override the search_path of the merged config.

void addSearchPath(const char *path)¶

const char *getSearchPath() const¶

void setActiveDisplays(const char *displays)¶: Override the active_displays of the merged config.

const char *getActiveDisplays() const¶

void setActiveViews(const char *views)¶: Override the active_views of the merged config.

const char *getActiveViews() const¶

void setInactiveColorSpaces(const char *colorspaces)¶: Override the inactive_colorspaces of the merged config.

const char *getInactiveColorSpaces() const¶

void setRoles(MergeStrategies strategy)¶: Set the merge strategy for the roles section.

MergeStrategies getRoles() const¶

void setFileRules(MergeStrategies strategy)¶: Set the merge strategy for the file_rules section.

MergeStrategies getFileRules() const¶

void setDisplayViews(MergeStrategies strategy)¶: Set the merge strategy for the displays/views section. This includes shared_views, displays, viewing_rules, virtual_display, active_display, and active_views.

MergeStrategies getDisplayViews() const¶

void setViewTransforms(MergeStrategies strategy)¶: Set the merge strategy for the view_transforms section. This includes the view_transforms and default_view_transform.

MergeStrategies getViewTransforms() const¶

void setLooks(MergeStrategies strategy)¶: Set the merge strategy for the looks section.

MergeStrategies getLooks() const¶

void setColorspaces(MergeStrategies strategy)¶: Set the merge strategy for the color spaces section. This includes colorspaces, display_colorspaces, environment, search_path, family_separator, and inactive_colorspaces.

MergeStrategies getColorspaces() const¶

void setNamedTransforms(MergeStrategies strategy)¶: Set the merge strategy for the named_transforms section.

MergeStrategies getNamedTransforms() const¶

ConfigMergingParameters(const ConfigMergingParameters&) = delete¶

ConfigMergingParameters &operator=(const ConfigMergingParameters&) = delete¶

~ConfigMergingParameters()¶: Do not use (needed only for pybind11).

Public Static Functions

static ConfigMergingParametersRcPtr Create()¶

std::ostream &OpenColorIO_v2_6::operator<<(std::ostream&, const ConfigMergingParameters&)¶

class ConfigMerger¶

The ConfigMerger class is the controller for the merging process.

It may be read from or serialized to an OCIOM file.

It is controlling the search_path to find the base and input config, and the merge parameters.

It contains an instance of ConfigMergingParameters for each merge present under the “merge” section.

For example, consider the following OCIOM file contents:

ociom_version: 1.0 search_path:

/usr/local/configs
. merge: Merge_ADD_THIS: […] Merge_ADD_THAT: […]

For this OCIOM, there would be two instances of ConfigMergingParameters. One for the merge with output name “Merge_ADD_THIS” and one for “Merge_ADD_THAT”.

Where the […] sections have the following structure:

Merge_ADD_THIS: base: base.ocio input: input.ocio options: input_family_prefix: “” base_family_prefix: “” input_first: true error_on_conflict: false default_strategy: PreferInput avoid_duplicates: true adjust_input_reference_space: true overrides: name: “” description: “” search_path: “” environment: {} active_displays: [] active_views: [] inactive_colorspaces: [] params: roles: strategy: PreferBase file_rules: strategy: PreferInput display-views: strategy: InputOnly view_transforms: strategy: InputOnly looks: strategy: BaseOnly colorspaces: strategy: PreferInput named_transform: strategy: Remove

The indentation is significant and must be as shown. Default items may be omitted.

Public Functions

ConfigMergerRcPtr createEditableCopy() const¶

void setSearchPath(const char *path)¶: These search paths are used to locate the input and base config. Set the entire search path. The ‘:’ character is used to separate paths.

void addSearchPath(const char *path)¶: Add a single path to the search paths.

int getNumSearchPaths() const¶: Get the number of search paths.

const char *getSearchPath(int index) const¶

void setWorkingDir(const char *dirname)¶

Set the home directory used to resolve relative search paths.

The working directory defaults to the location of the OCIOM file. It is used to convert any relative paths to absolute. If no search paths have been set, the working directory will be used as the fallback search path.

const char *getWorkingDir() const¶

ConfigMergingParametersRcPtr getParams(int index) const¶: Get the parameters for one of the merges. Returns null if index is out of range.

int getNumConfigMergingParameters() const¶

void addParams(ConfigMergingParametersRcPtr params)¶

ConstConfigMergerRcPtr mergeConfigs() const¶

Execute the merge(s) based on the merger object.

Execute the merge(s) based on the merger object that was previously populated by using ConfigMerger::CreateFromFile or created from scratch by using ConfigMerger::Create() and programmatically configuring it.

Returns:: a merger object (call getMergedConfig to obtain the result)

ConstConfigRcPtr getMergedConfig() const¶: Get the final merged config.

ConstConfigRcPtr getMergedConfig(int index) const¶: Get one of the merged configs (if there are a series of merges). Returns null if index is out of range.

int getNumMergedConfigs() const¶

void serialize(std::ostream &os) const¶: Serialize to the OCIOM file format.

void setVersion(unsigned int major, unsigned int minor)¶: Set the version of the OCIOM file format.

unsigned int getMajorVersion() const¶

unsigned int getMinorVersion() const¶

ConfigMerger(const ConfigMerger&) = delete¶

ConfigMerger &operator=(const ConfigMerger&) = delete¶

~ConfigMerger()¶: Do not use (needed only for pybind11).

Public Static Functions

static ConfigMergerRcPtr Create()¶

static ConstConfigMergerRcPtr CreateFromFile(const char *filepath)¶

std::ostream &OpenColorIO_v2_6::operator<<(std::ostream&, const ConfigMerger&)¶

namespace ConfigMergingHelpers¶

Functions

ConfigRcPtr MergeConfigs(const ConfigMergingParametersRcPtr &params, const ConstConfigRcPtr &baseConfig, const ConstConfigRcPtr &inputConfig)¶

Merge the input into the base config, using the supplied merge parameters.

Parameters:

params – ConfigMergingParameters controlling the merger.
params – The base config.
params – The input config to merge.

Returns:

The merged config object.

ConfigRcPtr MergeColorSpace(const ConfigMergingParametersRcPtr &params, const ConstConfigRcPtr &baseConfig, const ConstColorSpaceRcPtr &colorspace)¶

Merge a single color space into the base config, using the supplied merge parameters.

Note that the AdjustInputReferenceSpace merge parameter will be ignored and set to false. To use automatic reference space conversion, add the color space to an input config that has the necessary interchange role set.

Parameters:

params – ConfigMergingParameters controlling the merger.
params – The base config.
params – The input color space to merge.

Returns:

The merged config object.

DisplayViewHelpers¶

PyOpenColorIO.DisplayViewHelpers.GetProcessor(config: PyOpenColorIO.PyOpenColorIO.Config, context: PyOpenColorIO.PyOpenColorIO.Context = None, workingSpaceName: str, displayName: str, viewName: str, channelView: PyOpenColorIO.PyOpenColorIO.MatrixTransform = None, direction: PyOpenColorIO.PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) → PyOpenColorIO.PyOpenColorIO.Processor¶

PyOpenColorIO.DisplayViewHelpers.GetIdentityProcessor(config: PyOpenColorIO.PyOpenColorIO.Config) → PyOpenColorIO.PyOpenColorIO.Processor¶

PyOpenColorIO.DisplayViewHelpers.AddDisplayView(config: PyOpenColorIO.PyOpenColorIO.Config, displayName: str, viewName: str, lookName: str = '', colorSpaceName: str = '', colorSpaceFamily: str = '', colorSpaceDescription: str = '', colorSpaceCategories: str = '', transformFilePath: str, connectionColorSpaceName: str) → None¶

PyOpenColorIO.DisplayViewHelpers.RemoveDisplayView(config: PyOpenColorIO.PyOpenColorIO.Config, displayName: str, viewName: str) → None¶

LegacyViewingPipeline¶

class PyOpenColorIO.LegacyViewingPipeline¶

LegacyViewingPipeline() → None¶

getChannelView() → PyOpenColorIO.PyOpenColorIO.Transform¶

getColorTimingCC() → PyOpenColorIO.PyOpenColorIO.Transform¶

getDisplayCC() → PyOpenColorIO.PyOpenColorIO.Transform¶

getDisplayViewTransform() → PyOpenColorIO.PyOpenColorIO.DisplayViewTransform¶

getLinearCC() → PyOpenColorIO.PyOpenColorIO.Transform¶

getLooksOverride() → str¶

getLooksOverrideEnabled() → bool¶

getProcessor(config: PyOpenColorIO.PyOpenColorIO.Config, context: PyOpenColorIO.PyOpenColorIO.Context = None) → PyOpenColorIO.PyOpenColorIO.Processor¶

setChannelView(arg0: PyOpenColorIO.PyOpenColorIO.Transform) → None¶

setColorTimingCC(arg0: PyOpenColorIO.PyOpenColorIO.Transform) → None¶

setDisplayCC(arg0: PyOpenColorIO.PyOpenColorIO.Transform) → None¶

setDisplayViewTransform(arg0: PyOpenColorIO.PyOpenColorIO.DisplayViewTransform) → None¶

setLinearCC(arg0: PyOpenColorIO.PyOpenColorIO.Transform) → None¶

setLooksOverride(looks: str) → None¶

setLooksOverrideEnabled(arg0: bool) → None¶

class LegacyViewingPipeline¶

Whereas the DisplayViewTransform simply applies a specific view from an OCIO display, the LegacyViewingPipeline provides an example of a complete viewing pipeline of the sort that could be used to implement a viewport in a typical application. It therefore adds, around the DisplayViewTransform, various optional color correction steps and RGBA channel view swizzling. The direction of the DisplayViewTranform is used as the direction of the pipeline. Note: The LegacyViewingPipeline class provides the same functionality as the OCIO v1 DisplayTransform.

Legacy viewing pipeline:

Start in display transform input color space.
If linearCC is provided:
- Go to scene_linear colorspace.
- Apply linearCC transform.
If colorTimingCC is provided:
- Go to color_timing colorspace.
- Apply colorTimingCC transform.
Apply looks (from display transform or from looks override).
- Go to first look color space.
- Apply first look transform.
- Iterate for all looks.
Apply channelView transform.
Apply display transform (without looks).
Apply displayCC. Note that looks are applied even if the display transform involves data color spaces.

Public Functions

virtual ConstDisplayViewTransformRcPtr getDisplayViewTransform() const noexcept = 0¶

virtual void setDisplayViewTransform(const ConstDisplayViewTransformRcPtr &dt) noexcept = 0¶

virtual ConstTransformRcPtr getLinearCC() const noexcept = 0¶

virtual void setLinearCC(const ConstTransformRcPtr &cc) noexcept = 0¶

virtual ConstTransformRcPtr getColorTimingCC() const noexcept = 0¶

virtual void setColorTimingCC(const ConstTransformRcPtr &cc) noexcept = 0¶

virtual ConstTransformRcPtr getChannelView() const noexcept = 0¶

virtual void setChannelView(const ConstTransformRcPtr &transform) noexcept = 0¶

virtual ConstTransformRcPtr getDisplayCC() const noexcept = 0¶

virtual void setDisplayCC(const ConstTransformRcPtr &cc) noexcept = 0¶

virtual void setLooksOverrideEnabled(bool enable) = 0¶: Specify whether the lookOverride should be used, or not. This is a separate flag, as it’s often useful to override “looks” to an empty string.

virtual bool getLooksOverrideEnabled() const = 0¶

virtual void setLooksOverride(const char *looks) = 0¶

A user can optionally override the looks that are, by default, used with the expected display / view combination. A common use case for this functionality is in an image viewing app, where per-shot looks are supported. If for some reason a per-shot look is not defined for the current Context, the Config::getProcessor fcn will not succeed by default. Thus, with this mechanism the viewing app could override to looks = “”, and this will allow image display to continue (though hopefully) the interface would reflect this fallback option.

Looks is a potentially comma (or colon) delimited list of lookNames, where +/- prefixes are optionally allowed to denote forward/inverse look specification (and forward is assumed in the absence of either).

virtual const char *getLooksOverride() const = 0¶

virtual ConstProcessorRcPtr getProcessor(const ConstConfigRcPtr &config, const ConstContextRcPtr &context) const = 0¶

virtual ConstProcessorRcPtr getProcessor(const ConstConfigRcPtr &config) const = 0¶

LegacyViewingPipeline(const LegacyViewingPipeline&) = delete¶

LegacyViewingPipeline &operator=(const LegacyViewingPipeline&) = delete¶

virtual ~LegacyViewingPipeline() = default¶: Do not use (needed only for pybind11).

Public Static Functions

static LegacyViewingPipelineRcPtr Create()¶

std::ostream &OpenColorIO_v2_6::operator<<(std::ostream&, const LegacyViewingPipeline&)¶

typedef std::shared_ptr<const LegacyViewingPipeline> OpenColorIO_v2_6::ConstLegacyViewingPipelineRcPtr¶

typedef std::shared_ptr<LegacyViewingPipeline> OpenColorIO_v2_6::LegacyViewingPipelineRcPtr¶

MixingHelpers¶

class PyOpenColorIO.MixingSlider¶

MixingSlider(*args, **kwargs)¶

getSliderMaxEdge() → float¶

getSliderMinEdge() → float¶

mixingToSlider(mixingUnits: SupportsFloat) → float¶

setSliderMaxEdge(arg0: SupportsFloat) → None¶

setSliderMinEdge(arg0: SupportsFloat) → None¶

sliderToMixing(sliderUnits: SupportsFloat) → float¶

class PyOpenColorIO.MixingColorSpaceManager¶

MixingColorSpaceManager(config: PyOpenColorIO.PyOpenColorIO.Config) → None¶

getMixingEncodings() → PyOpenColorIO.PyOpenColorIO.MixingColorSpaceManager.MixingEncodingIterator¶

getMixingSpaces() → PyOpenColorIO.PyOpenColorIO.MixingColorSpaceManager.MixingSpaceIterator¶

getProcessor(workingSpaceName: str, displayName: str, viewName: str, direction: PyOpenColorIO.PyOpenColorIO.TransformDirection = <TransformDirection.TRANSFORM_DIR_FORWARD: 0>) → PyOpenColorIO.PyOpenColorIO.Processor¶

getSelectedMixingEncodingIdx() → int¶

getSelectedMixingSpaceIdx() → int¶

getSlider(*args, **kwargs)¶

Overloaded function.

getSlider(self: PyOpenColorIO.PyOpenColorIO.MixingColorSpaceManager) -> PyOpenColorIO.PyOpenColorIO.MixingSlider
getSlider(self: PyOpenColorIO.PyOpenColorIO.MixingColorSpaceManager, sliderMixingMinEdge: typing.SupportsFloat, sliderMixingMaxEdge: typing.SupportsFloat) -> PyOpenColorIO.PyOpenColorIO.MixingSlider

isPerceptuallyUniform() → bool¶

refresh(config: PyOpenColorIO.PyOpenColorIO.Config) → None¶

setSelectedMixingEncoding(mixingEncoding: str) → None¶

setSelectedMixingEncodingIdx(arg0: SupportsInt) → None¶

setSelectedMixingSpace(mixingSpace: str) → None¶

setSelectedMixingSpaceIdx(arg0: SupportsInt) → None¶

class PyOpenColorIO.MixingColorSpaceManager.MixingSpaceIterator¶

self[arg0: SupportsInt] → str¶

iter(self) → PyOpenColorIO.PyOpenColorIO.MixingColorSpaceManager.MixingSpaceIterator¶

len(self) → int¶

next(self) → str¶

class PyOpenColorIO.MixingColorSpaceManager.MixingEncodingIterator¶

self[arg0: SupportsInt] → str¶

iter(self) → PyOpenColorIO.PyOpenColorIO.MixingColorSpaceManager.MixingEncodingIterator¶

len(self) → int¶

next(self) → str¶

class MixingSlider¶

The MixingSlider and MixingColorSpaceManager classes are to help applications implement correct color pickers. The term “color mixing” is used here to describe what is done in a typical application “color picker” user interface.

A user may want to mix colors in different color spaces. The two most common mixing space options are a scene-linear working space or the display space.

Since scene-linear color spaces are not perceptually uniform, it is necessary to compensate UI widgets such as sliders. For example, it is nice if mid-gray falls near the center of mixing controls rather than way over near the black end. This may be done by using a mapping from linear into an approximately perceptually uniform space.

Also note that a color picking/mixing UI may want to present a given color space in several different encodings. The most common two encodings for color mixing are RGB and HSV.

Note that these helpers anticipate that a user may want to mix colors using values that extend outside the typical [0,1] domain.

Public Functions

virtual void setSliderMinEdge(float sliderMixingMinEdge) noexcept = 0¶: Set the minimum edge of a UI slider for conversion to mixing space.

virtual float getSliderMinEdge() const noexcept = 0¶: Minimum edge of a UI slider for conversion to mixing space.

virtual void setSliderMaxEdge(float sliderMixingMaxEdge) noexcept = 0¶: Set the maximum edge of a UI slider for conversion to mixing space.

virtual float getSliderMaxEdge() const noexcept = 0¶: Maximum edge of a UI slider for conversion to mixing space.

virtual float sliderToMixing(float sliderUnits) const noexcept = 0¶: Convert from units in distance along the slider to mixing space units.

virtual float mixingToSlider(float mixingUnits) const noexcept = 0¶: Convert from mixing space units to distance along the slider.

MixingSlider(const MixingSlider&) = delete¶

MixingSlider &operator=(const MixingSlider&) = delete¶

virtual ~MixingSlider() = default¶: Do not use (needed only for pybind11).

std::ostream &OpenColorIO_v2_6::operator<<(std::ostream&, const MixingSlider&)¶

class MixingColorSpaceManager¶

Used to mix (or pick/choose) colors.

Public Functions

virtual size_t getNumMixingSpaces() const noexcept = 0¶: Access to the mixing spaces.

virtual const char *getMixingSpaceUIName(size_t idx) const = 0¶

virtual size_t getSelectedMixingSpaceIdx() const noexcept = 0¶

virtual void setSelectedMixingSpaceIdx(size_t idx) = 0¶

virtual void setSelectedMixingSpace(const char *mixingSpace) = 0¶

virtual bool isPerceptuallyUniform() const noexcept = 0¶

virtual size_t getNumMixingEncodings() const noexcept = 0¶: Access to the mixing encodings.

virtual const char *getMixingEncodingName(size_t idx) const = 0¶

virtual size_t getSelectedMixingEncodingIdx() const noexcept = 0¶

virtual void setSelectedMixingEncodingIdx(size_t idx) = 0¶

virtual void setSelectedMixingEncoding(const char *mixingEncoding) = 0¶

virtual void refresh(ConstConfigRcPtr config) = 0¶: Refresh the instance (i.e. needed following a configuration change for example).

virtual ConstProcessorRcPtr getProcessor(const char *workingName, const char *displayName, const char *viewName, TransformDirection direction) const = 0¶

virtual MixingSlider &getSlider() noexcept = 0¶

virtual MixingSlider &getSlider(float sliderMixingMinEdge, float sliderMixingMaxEdge) noexcept = 0¶

MixingColorSpaceManager(const MixingColorSpaceManager&) = delete¶

MixingColorSpaceManager &operator=(const MixingColorSpaceManager&) = delete¶

virtual ~MixingColorSpaceManager() = default¶: Do not use (needed only for pybind11).

Public Static Functions

static MixingColorSpaceManagerRcPtr Create(ConstConfigRcPtr &config)¶

std::ostream &OpenColorIO_v2_6::operator<<(std::ostream&, const MixingColorSpaceManager&)¶

typedef std::shared_ptr<const MixingColorSpaceManager> OpenColorIO_v2_6::ConstMixingColorSpaceManagerRcPtr¶

typedef std::shared_ptr<MixingColorSpaceManager> OpenColorIO_v2_6::MixingColorSpaceManagerRcPtr¶