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
- Open the solution with the OpenGL ES device package that is used by the target.
- In the Scene Composer, select View > Libraries > RenderTargets. In the RenderTarget panel, select the HDR10-capable Display.
- In the Properties panel, expand Editing Utilities.
- Set GlColorSpace to the color space expected by the physical display, compositor, and target graphics stack.
- Save the solution and rebuild the target assets.
- 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:
EGL_KHR_gl_colorspaceis available for color-space surface attributes.- The EGL extension for the selected color space is available. Depending on the selection, this is one of the
EGL_EXT_gl_colorspace_*extensions for BT.2020, Display P3, or scRGB. EGL_EXT_pixel_format_floatand a matching RGBA16F window configuration are available for the four half-float values.- A matching RGB10_A2 window configuration is available for PQ, HLG, and the non-linear Display P3 values.
- The target device package's EGL configuration does not override the required channel sizes or component type with incompatible values.
- The operating system or compositor accepts the requested surface color space and drives the physical display in the corresponding mode.
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:
EGL_GL_COLORSPACE_KHRreports the color space of the created surface.EGL_BUFFER_SIZE,EGL_RED_SIZE,EGL_GREEN_SIZE,EGL_BLUE_SIZE, andEGL_ALPHA_SIZEreport the selected surface format.- A message containing
falling back to linear color space,falling back to SDR, orcould not be setmeans that the requested output is not active.
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
- The Windows host used by Scene Composer supports SDR output only. Its
cgi_studio_3psw/src/OpenGLES/Win32/OpenGLAdapterimplementation reports no EGL extensions and does not supportEGL_GL_COLORSPACE_KHRsurface selection, RGB10_A2 HDR surfaces, or RGBA16F half-float window surfaces. - Consequently, Scene Composer falls back to its default SDR surface for every HDR or wide-gamut selection. The selected property still configures generated target assets.
- Actual target support is driver- and platform-dependent. A value appearing in the Scene Composer list does not guarantee that the target EGL stack supports it.
- Wayland implementations may ignore linear and sRGB color-space surface attributes. Verify compositor behavior on the target platform.
- This setting controls the output surface and final output conversion. It does not by itself convert source assets, assign color profiles to textures, enable an HDR operating-system mode, or calibrate the display.