Display Color Space Configuration

Purpose

CGI Studio can configure the output color space of an OpenGL ES display. The configuration is exposed in Scene Composer through Candera device metainfo and is stored with the display asset for use by the target application.

This feature can also be used to configure HDR and wide-gamut display output on supported target platforms. HDR output requires compatible EGL extensions, graphics drivers, operating system support, and display hardware.

Important: Scene Composer currently previews only standard dynamic range (SDR) output on the Windows host. Selecting an HDR or wide-gamut color space configures the target output, but does not provide an accurate host preview.

Configure a display in Scene Composer

  1. Open the solution with the OpenGL ES device package that is used by the target.
  2. In the Scene Composer, select View > Libraries > RenderTargets. In the RenderTarget panel, select the HDR10-capable Display.
  3. In the Properties panel, expand Editing Utilities.
  4. Set GlColorSpace to the color space expected by the physical display, compositor, and target graphics stack.
  5. Save the solution and rebuild the target assets.
  6. Run the application on the target and check the device log and the physical output. Do not approve HDR or wide-gamut output from the Scene Composer host preview alone.

EglGlColorSpaceLinear is the default and should remain selected unless the complete target display pipeline is configured for another color space.

Available values

Scene Composer value Intended output Required EGL surface format
EglGlColorSpaceLinear Default linear SDR RGBA8 fixed point, 32 bpp
EglGlColorSpaceSrgb sRGB SDR RGBA8 fixed point, 32 bpp
EglGlColorSpaceBt2020Linear Linear BT.2020 RGBA16F half float, 64 bpp
EglGlColorSpaceBT2020Pq BT.2020 with PQ transfer RGB10_A2 fixed point, 32 bpp
EglGlColorSpaceBT2020Hlg BT.2020 with HLG transfer RGB10_A2 fixed point, 32 bpp
EglGlColorSpaceScrgbLinear Linear scRGB RGBA16F half float, 64 bpp
EglGlColorSpaceDisplayP3Linear Linear Display P3 RGBA16F half float, 64 bpp
EglGlColorSpaceDisplayP3 Display P3 RGB10_A2 fixed point, 32 bpp
EglGlColorSpaceDisplayP3Passthrough Display P3 pass-through surface RGB10_A2 fixed point, 32 bpp
EglGlColorSpaceScrgb scRGB RGBA16F half float, 64 bpp

The feature requests RGB10_A2 fixed point or RGBA16F half float surfaces, not full 32-bit floating-point color components.

Target requirements

Color-space selection is conditional on the target EGL implementation, window system, compositor, display controller, and panel. Before using a non-default value, verify all of the following:

Linear and sRGB transfer handling is delegated to EGL/OpenGL. For the other values, Candera's final window-surface shader applies the required gamut and/or transfer conversion before presentation. This also applies when display warping is enabled.

Fallback and verification

At startup, Candera queries the EGL extensions, selects a compatible window configuration, creates the surface with EGL_GL_COLORSPACE_KHR, and queries the created surface. Unsupported requests fall back to a linear SDR surface where possible and produce a device log message.

Check the target log for these entries:

For HDR validation, use known reference content and verify the signal at the physical target display or with suitable display-analysis equipment. A successful asset build or a changed appearance in an SDR preview is not proof that the requested target mode is active.

Current limitations


Revision #3
Created 2026-09-04 00:56:02 UTC by Kanai Tomoaki
Updated 2026-09-09 10:17:15 UTC by Kanai Tomoaki