Converting Colors in Composure with OpenColorIO

Apply color transformation to a Composure Element and to the composited output with OpenColorIO in Unreal Engine.

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:

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.

    Add New Transform Pass

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

    Set Transform Pass to OpenColorIO Pass

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

    Expand 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.

    Set Color Conversion Settings

  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.

    Expand Output Pass

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

    Set Output Pass to OpenColoriO Pass

  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.

    Set Color Conversion Settings

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