AcademySoftwareFoundation / AcademySoftwareFoundation/OpenColorIO

Add code examples for using color space heuristics

Open
#1,870 2 comments 0 reactions 1 assignee Claimed by @andrew-towfiq View on GitHub
Documentation good first issue help wanted
Dominant language
C++
Stars
2.1k
Forks
503
PR merge metrics
No merged PRs in 30d

Description

A common OCIO question is how to convert between some known external color space (e.g., sRGB, linear sRGB, CIE XYZ) and a color space in a user's config.

OCIO 2.0 added the notion of [interchange roles](https://opencolorio.readthedocs.io/en/latest/releases/ocio_2_0.html#providing-an-interchange-mechanism-between-configs) that allow config authors to identify the color space name used in their config for certain standard color spaces. However these are not present in all configs (particularly OCIO v1 configs). OCIO 2.2 [added heuristics](https://opencolorio.readthedocs.io/en/latest/releases/ocio_2_2.html#converting-to-or-from-a-known-color-space) that will search a config (that is missing the interchange roles) for color spaces that mathematically match a transform between well-known color spaces. This API was extended in the [2.3 release](https://opencolorio.readthedocs.io/en/latest/releases/ocio_2_3.html#enhanced-methods-to-find-an-equivalent-color-space-between-configs). However, there is a need for some example code that explains how to use these new features.

This issue is to [add example code](https://opencolorio.readthedocs.io/en/latest/guides/developing/developing.html) for the new methods on the Config class such as IdentifyBuiltinColorSpace, isColorSpaceLinear, IdentifyInterchangeSpace, and GetProcessorToBuiltinColorSpace.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.