Share via


AdvancedColorInfo Class

Definition

Contains a snapshot of the Advanced Color-related information of a monitor or display driver.

public ref class AdvancedColorInfo sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AdvancedColorInfo final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AdvancedColorInfo
Public NotInheritable Class AdvancedColorInfo
Inheritance
Object Platform::Object IInspectable AdvancedColorInfo
Attributes

Windows requirements

Device family
Windows 10, version 1803 (introduced in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v6.0)

Remarks

Advanced color is a Windows developer term indicating support for high dynamic range (HDR), wide color gamut (WCG), and high precision (bit depth) visual content such as videos, games and photos. To use advanced color, your computer must have an advanced color-capable GPU and display; further, the composition and display stack must enter a new advanced color mode that uses FP16 rendering and composition.

To exploit advanced color, applications must be updated with enhanced rendering pipelines (for example, DirectX) and they must detect and adapt to the specific capabilities of the current display. In terms of API design, advanced color has similarities to features such as high DPI and stereoscopic 3D.

  • Apps need to understand the current feature state, such as if HDR active, and what kind of HDR is active. Apps mus also understand the quantitative display characteristics (for example, peak luminance, color primaries) and underlying capabilities of the hardware (for example, can HDR be enabled at all).

  • User action or OS policy can change the feature state and display characteristics at any time.

Properties

BluePrimary

Gets the native Blue color primary for the display.

CurrentAdvancedColorKind

Gets the AdvancedColorKind which is currently being set on the display.

GreenPrimary

Gets the native Green color primary for the display.

MaxAverageFullFrameLuminanceInNits

Gets the maximum frame average luminance of the display which can be achieved on the whole display.

MaxLuminanceInNits

Gets the maximum peak luminance of the display in nits, which is usually valid for a small part of the display.

MinLuminanceInNits

Get the minimum luminance of the display in nits.

RedPrimary

Gets the native Red color primary for the display.

SdrWhiteLevelInNits

Get the luminance value, in nits, which is currently being used by the operating system for all the SDR content on this display.

WhitePoint

Gets the native white point for the display.

Methods

IsAdvancedColorKindAvailable(AdvancedColorKind)

Returns a boolean value that describes if the specified Advanced Color kind value is inherently supported by the monitor or display driver.

IsHdrMetadataFormatCurrentlySupported(HdrMetadataFormat)

Returns a boolean value that describes whether the specified HDR metadata format is supported by the display in its current state.

Applies to