Converting Colors in Composure with OpenColorIO

This page explains how to apply OpenColorIO (OCIO) color conversions to input and output media in Composure.

Prerequisites

You must set up the following in your project to complete the sections below:

• An OpenColorIO Configuration Asset. Refer to the OpenColorIO Quick Start for steps on creating this Asset.

• A Composure Element set up with a valid Media Source and an Output. Refer to the Real-Time Compositing Quick Start for steps on setting these up.

Converting a Media Element in Composure

This procedure shows how to create a new Transform Pass for a Composure Element, and set up that Transform Pass to convert the color space of the Element's media source from one color profile to another.

1. In the Outliner, select your Composure Element to open its Details panel.

2. In the Details panel under the Composure > Transform/Compositing Passes section, click Add (+) to add a new Transform Pass entry.

3. In the settings for your new Transform Pass, open the dropdown menu and select OpenColorIO Pass from the list.

4. Expand the settings for your Transform Pass, then expand its Color Conversion Settings.

5. Under Color Conversion Settings:

   1. Set the Configuration Source parameter to point to your OpenColorIO Configuration Asset.

   2. Set the Source Color Space parameter to the color profile you want to convert from. This is typically the color space that the media source was originally captured in.

   3. Set the Destination Color Space parameter to the color profile you want to convert to. Typically you will want to use the linear color space so your media matches the linear color space used in Unreal Engine.

   4. Toggle the Enabled setting on.

6. As soon as you set up the source and destination color spaces for your Transform Pass, the colors in your Media Source change in the Composure Element's Preview and in the Level Viewport.

Converting Media Output in Composure

This procedure shows how to set up an output from Composure with a new Color Correction pass that converts the colors of the composited media from one OCIO color profile to another.

1. In the Outliner,select your Composure Element to open its Details panel.

2. In the Details panel under Composure > Output, expand your Output Pass.

3. In the settings for your new Output Pass, open the dropdown menu and select OpenColorIO Pass from the list.

4. Expand the Color Conversion Settings for the Output Pass. Under Color Conversion Settings:

   1. Set the Configuration Source parameter to point to your OpenColorIO Configuration Asset.

   2. Set the Source Color Space parameter to the color profile you want to convert from. Typically you will want to use the linear color space so your media matches the linear color space used in Unreal Engine.

   3. Set the Destination Color Space parameter to the color profile you want to convert to. Typically you will want to match the color space used by the monitor to display the result, or another destination color space that you want.

   4. Toggle the Enabled setting on.

5. When you display your composited media, the colors are changed.