Edit

Share via

MFNominalRange enumeration (mfobjects.h)

  • Article

Specifies whether color data includes headroom and toeroom. Headroom allows for values beyond 1.0 white ("whiter than white"), and toeroom allows for values below reference 0.0 black ("blacker than black").

Syntax

typedef enum _MFNominalRange {
  MFNominalRange_Unknown = 0,
  MFNominalRange_Normal = 1,
  MFNominalRange_Wide = 2,
  MFNominalRange_0_255 = 1,
  MFNominalRange_16_235 = 2,
  MFNominalRange_48_208 = 3,
  MFNominalRange_64_127 = 4,
  MFNominalRange_Last,
  MFNominalRange_ForceDWORD = 0x7fffffff
} MFNominalRange;

Constants

 
MFNominalRange_Unknown
Value: 0
Unknown nominal range.
MFNominalRange_Normal
Value: 1
Equivalent to MFNominalRange_0_255.
MFNominalRange_Wide
Value: 2
Equivalent to MFNominalRange_16_235.
MFNominalRange_0_255
Value: 1
The normalized range [0...1] maps to [0...255] for 8-bit samples or [0...1023] for 10-bit samples.
MFNominalRange_16_235
Value: 2
The normalized range [0...1] maps to [16...235] for 8-bit samples or [64...940] for 10-bit samples.
MFNominalRange_48_208
Value: 3
The normalized range [0..1] maps to [48...208] for 8-bit samples or [64...940] for 10-bit samples.
MFNominalRange_64_127
Value: 4
The normalized range [0..1] maps to [64...127] for 8-bit samples or [256...508] for 10-bit samples. This range is used in the xRGB color space.

Note  Requires Windows 7 or later.

 
MFNominalRange_Last
MFNominalRange_ForceDWORD
Value: 0x7fffffff

Remarks

This enumeration is used with the MF_MT_VIDEO_NOMINAL_RANGE attribute.

For more information about these values, see the remarks for the DXVA2_NominalRange enumeration, which is the DirectX Video Acceleration (DXVA) equivalent of this enumeration.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header mfobjects.h (include Mfidl.h)

See also

Extended Color Information

Media Foundation Enumerations

Video Media Types