IADLXDisplayGamma

The IADLXDisplayGamma interface configures gamma correction on a display.

InterfaceId:

IADLXDisplayGamma

Smart Pointer Interface Name:

IADLXDisplayGammaPtr

Inherits:

IADLXInterface

Inherited By:

N/A

The IADLXDisplayGamma interface provides two types of gamma correction which are gamma ramp and gamma coefficient. Both gamma ramp and gamma coefficient have two sub-types: de-gamma and re-gamma.

  • Gamma ramp provides a Lookup Table (LUT) for the gamma correction, it applies the LUT with the assumption that all pixels are in sRGB space.

  • Re-Gamma coefficient uses the following non-linear formula:

    Copied!

    if (linear_pixel < CofficientA0)
         output = linear_pixel * CofficientA1
    else
         output = (1 + CofficientA3) * linear_pixel ^ (1/Gamma) - CofficientA2

  • De-Gamma coefficient uses the following non-linear formula:

    Copied!

    if (linear_pixel < CofficientA0)
         output = linear_pixel / CofficientA1
    else
         output = ((linear_pixel + CofficientA3) / (1 + CofficientA2)) ^ (Gamma)

Methods

Method

Description

GetGammaCoefficient

Gets the re-gamma coefficient settings on a display.

GetGammaRamp

Gets the gamma ramp LUT on a display.

IsCurrentDeGammaRamp

Checks if de-gamma ramp is used by a display.

IsCurrentReGamma36

Checks if the 3.6 re-gamma is used by a display.

IsCurrentReGammaBT709

Checks if the BT709 re-gamma is used by a display.

IsCurrentReGammaPQ

Checks if the PQ re-gamma is used by a display.

IsCurrentReGammaPQ2084Interim

Checks if the PQ2084 re-gamma curve is used by a display.

IsCurrentReGammaRamp

Checks if re-gamma ramp is used by a display.

IsCurrentReGammaSRGB

Checks if the sRGB re-gamma is used by a display.

IsCurrentRegammaCoefficient

Checks if re-gamma coefficient is used by a display.

IsSupportedReGamma36

Checks if the 3.6 re-gamma is supported on a display.

IsSupportedReGammaBT709

Checks if the BT709 re-gamma is supported on a display.

IsSupportedReGammaPQ

Checks if the PQ re-gamma is supported on a display.

IsSupportedReGammaPQ2084Interim

Checks if the PQ2084 re-gamma curve is supported on a display.

IsSupportedReGammaSRGB

Checks if the sRGB re-gamma is supported on a display.

ResetGammaRamp

Resets the gamma ramp on a display.

SetDeGammaRamp

Sets the de-gamma on a display using a ramp file.

SetDeGammaRamp

Sets the de-gamma on a display using a ramp buffer.

SetReGamma36

Sets the 3.6 re-gamma on a display.

SetReGammaBT709

Sets the BT709 re-gamma on a display.

SetReGammaCoefficient

Sets the re-gamma coefficient on a display.

SetReGammaPQ

Sets the PQ re-gamma on a display.

SetReGammaPQ2084Interim

Sets the PQ2084 re-gamma curve on a display.

SetReGammaRamp

Sets the re-gamma on a display using a ramp file.

SetReGammaRamp

Sets the re-gamma on a display using a ramp buffer.

SetReGammaSRGB

Sets the sRGB re-gamma on a display.

Requirements

Header

include “IDisplayGamma.h”

Minimum version

1.0

Example

To see how to use this interface in a C++ application, refer to the DisplayGamma C++ sample .

For a C application, refer to the DisplayGamma C sample .