OpenColorIO Quick Start

Create OpenColorIO Configuration Assets from OpenColorIO configuration files.

Choose your operating system:

Windows

macOS

Linux

This page guides you through getting started with OpenColorIO in Unreal Engine. It shows how to create an OpenColor Configuration Asset from your OCIO configuration file, and apply color transformations in Unreal Editor's Viewport.

Prerequisites

You must enable the OpenColorIO plugin to use OpenColorIO (OCIO) in Unreal Engine (UE). Refer to Working with Plugins for how to enable plugins in Unreal Engine.

Importing OCIO Config Files

You can import your OCIO configuration (.ocio) file into your project's Content folder shown in the Content Browser.

UE may display a warning when copying your config file directly into the Content folder. One such warning is that it does not recognize the .ocio file extension. If this happens, copy your OCIO config file into your project's Content folder using your computer's file explorer.

Example OCIO Config File

If you don't have your own OCIO configuration file, you can use the example OCIO config file simple.config.ocio and luts included with the OpenColorIO plugin. This example config file is located in your Unreal Engine install folder under Engine\Plugins\Compositing\OpenColorIO\Content\OCIO.

Browsing to the OpenColorIO plugin's contents in the Content Browser does not show these files since the Content Browser only shows .uasset files. Use your computer's file explorer to browse to the files.

Creating an OCIO Configuration Asset

Follow these steps to create an OCIO Configuration Asset from your OCIO configuration file. This example uses the simple.config.ocio configuration file included in the OpenColorIO plugin.

  1. In the Content Browser, right-click to open the context menu and select Miscellaneous > OpenColorIO Configuration to create an OCIO Configuration Asset. Rename the Asset.

    Create OCIO Configuration Asset in Content Browser

  2. Double-click your OCIO Configuration Asset to edit its settings. In this example, the Asset is named OCIO_Example.

    OCIO Config Asset Settings

  3. For the Configuration File parameter, click Browse to locate and select an OCIO configuration (.ocio) file on your computer.

    Set OCIO Configuration File

  4. For the Desired Color Spaces parameter, click Add (+) to add a new color space entry.

    Add new color space entry

  5. In the new entry, open the drop-down list and select one of the color spaces defined in the config file that you want to use in UE.

    Set Color Space

  6. Repeat the last two steps for each color profile that you want to use, then Save your Asset. Only set up the color profiles that you actually need to use in UE. This helps your configuration Asset remain as lightweight as possible.

    OCIO Configuration Asset with Color Spaces Added

Your OpenColorIO Configuration Asset is now set up so you can use it to apply color transformations to different systems of Unreal Engine.

While the method to set up color conversions for systems in UE may be different, the color conversion settings with OpenColorIO are the same. You'll need to specify which OpenColorIO Configuration Asset to use, and the source and destination color spaces:

  • Configuration Source: The OpenColorIO Configuration Asset you're using.

  • Source Color Space: The input color space you want to convert from..

  • Destination Color Space: The output color space you want to convert to.

General OCIO Asset Settings in Unreal Engine

Next Steps

Now that you have your OpenColorIO Configuration Asset created, learn how to apply color conversion in other areas of UE. These pages guide you through how to manage colors in various systems of UE.

This page was written for a previous version of Unreal Engine and has not been updated for the current Unreal Engine 5.0 release.