HDR tone map effect

This effect adjusts the dynamic range of an image to better suit its content to the capability of the output display.

The properties for this effect are identified by the D2D1_HDRTONEMAP_PROP enumeration, and the CLSID is CLSID_D2D1HdrToneMap.

Effect properties

Remarks

The value for InputMaxLuminance is typically derived from the image metadata. For cases where the metadata is not present, you can use the D2DAdvancedColorImagesRenderer::ComputeHdrMetadata function (in the Direct2D advanced color image rendering sample) to compute the maximum light level (MaxCLL) of an image, in nits.

The value for OutputMaxLuminance is designed to be derived from the display, using DXGI_OUTPUT_DESC1::MaxLuminance.

The HDR tone map effect has different tone map curves depending on whether the display is an HDR display or an SDR/WCG display.

This effect is intended to be combined with the White level adjustment effect to allow you to render HDR images in Direct2D with proper color management and tone mapping. It's aimed at any framework that wants to provide a best-in-class HDR image viewing experience that handles all of the Windows HDR image formats, and adapts to the capabilities of the display (whether that's HDR or WCG/SDR). The effects are intended to be chained together in sequence, as described below.

• Take the input image, whose color space defined by its codec. Metadata may specify whitePoint. Metadata may specify input luminance level.
• Apply the color management effect. Convert to scRGB (CCCS) space.
• Apply the HDR tone map effect. Lower the light level of the image to the desired level.
• Apply the white level adjustment effect. Scale the white level of the image to the white level required by the swap chain.
• Apply the color management effect again. If rendering to 8bpc, then convert to sRGB.

Requirements

Related topics

• ID2D1Effect interface
• D2D1_HDRTONEMAP_PROP enumeration