Quick Start for Developers

Get started by following the Installation instructions to build OCIO from source. You will want to make sure to build the command-line tools as well as the library itself, so you should install OpenImageIO before building. Note that active development of OCIO v2 is happening in the master branch.

Grab the available configuration files (and the sample images, if you want) from Downloads.

Try using the command-line tool ociochecklut to send an RGB through a file in the “luts” sub-directory of one of the configs you downloaded. Try using the ocioconvert tool to process an image from one color space to another. Try using ociodisplay to view an image through a color space conversion.

Take a look at the example code in the Usage Examples and then study the code for the command-line tools, which is under src/apps.

There are helper classes under src/libutils/apphelpers for common application tasks such as generating color space menus, building a viewing pipeline for a viewport, and writing a color picker for scene-linear color spaces.

Look through the Overview to get a sense of the big picture.

Check out Upgrading to v2 for an overview of the new features in OCIO v2.