AcademySoftwareFoundation / AcademySoftwareFoundation/OpenColorIO
Add code examples for using color space heuristics
- 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
Assessment
This issue has not been assessed yet.