DisplayAdvancedColorInfo Class

Definition

Namespace:

Microsoft.Graphics.Display

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

public ref class DisplayAdvancedColorInfo sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65538)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DisplayAdvancedColorInfo final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65538)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DisplayAdvancedColorInfo

Public NotInheritable Class DisplayAdvancedColorInfo

Inheritance

Object Platform::Object IInspectable DisplayAdvancedColorInfo

Attributes

ContractVersionAttribute MarshalingBehaviorAttribute

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 whether HDR is active, and if so what kind of HDR is active. Apps must also understand the quantitative display characteristics (for example, peak luminance, color primaries) and underlying capabilities of the hardware (for example, whether HDR can be enabled at all).

• User action or operating system (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 DisplayAdvancedColorKind that 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 that 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, that is currently being used by the operating system for all of the SDR content on this display.
WhitePoint	Gets the native white point for the display.

Methods

IsAdvancedColorKindAvailable(DisplayAdvancedColorKind)	Returns a Boolean value that indicates whether or not the specified Advanced Color kind value is inherently supported by the monitor or display driver.
IsHdrMetadataFormatCurrentlySupported(DisplayHdrMetadataFormat)	Returns a Boolean value that indicates whether or not the specified HDR metadata format is supported by the display in its current state.