D3DDDI_COLOR_SPACE_TYPE enumeration (d3dukmdt.h)
Defines stream color space information.
Syntax
typedef enum D3DDDI_COLOR_SPACE_TYPE {
D3DDDI_COLOR_SPACE_RGB_FULL_G22_NONE_P709,
D3DDDI_COLOR_SPACE_RGB_FULL_G10_NONE_P709,
D3DDDI_COLOR_SPACE_RGB_STUDIO_G22_NONE_P709,
D3DDDI_COLOR_SPACE_RGB_STUDIO_G22_NONE_P2020,
D3DDDI_COLOR_SPACE_RESERVED,
D3DDDI_COLOR_SPACE_YCBCR_FULL_G22_NONE_P709_X601,
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P601,
D3DDDI_COLOR_SPACE_YCBCR_FULL_G22_LEFT_P601,
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P709,
D3DDDI_COLOR_SPACE_YCBCR_FULL_G22_LEFT_P709,
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P2020,
D3DDDI_COLOR_SPACE_YCBCR_FULL_G22_LEFT_P2020,
D3DDDI_COLOR_SPACE_RGB_FULL_G2084_NONE_P2020,
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G2084_LEFT_P2020,
D3DDDI_COLOR_SPACE_RGB_STUDIO_G2084_NONE_P2020,
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G22_TOPLEFT_P2020,
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G2084_TOPLEFT_P2020,
D3DDDI_COLOR_SPACE_RGB_FULL_G22_NONE_P2020,
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_GHLG_TOPLEFT_P2020,
D3DDDI_COLOR_SPACE_YCBCR_FULL_GHLG_TOPLEFT_P2020,
D3DDDI_COLOR_SPACE_RGB_STUDIO_G24_NONE_P709,
D3DDDI_COLOR_SPACE_RGB_STUDIO_G24_NONE_P2020,
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G24_LEFT_P709,
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G24_LEFT_P2020,
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G24_TOPLEFT_P2020,
D3DDDI_COLOR_SPACE_CUSTOM
} ;
Constants
D3DDDI_COLOR_SPACE_RGB_FULL_G22_NONE_P709* Colorspace: RGB * Range: 0-255 * Gamma: 2.2 * Costing: Image * Primaries: BT.709 This is the standard definition for sRGB. Note that this is often implemented with a linear segment, but in that case the exponent is corrected to stay aligned with a gamma 2.2 curve. This is usually used with 8 bit and 10 bit color channels. |
D3DDDI_COLOR_SPACE_RGB_FULL_G10_NONE_P709* Colorspace: RGB * Range: 0-255 * Gamma: 1.0 * Costing: Image * Primaries: BT.709 This is the standard definition for scRGB. This is usually used with 16 bit integer, 16 bit floating point, and 32 bit floating point channels. |
D3DDDI_COLOR_SPACE_RGB_STUDIO_G22_NONE_P709* Colorspace: RGB * Range: 16-235 * Gamma: 2.2 * Costing: Image * Primaries: BT.709 This is the standard definition for ITU-R Recommendation BT.709. Note that due to the inclusion of a linear segment, the transfer curve looks similar to a pure exponential gamma of 1.9. This is usually used with 8 bit and 10 bit color channels. |
D3DDDI_COLOR_SPACE_RGB_STUDIO_G22_NONE_P2020* Colorspace: RGB * Range: 16-235 * Gamma: 2.2 * Costing: Image * Primaries: BT.2020 This is usually used with 10, 12, or 16 bit color channels. |
D3DDDI_COLOR_SPACE_RESERVEDReserved for future use. |
D3DDDI_COLOR_SPACE_YCBCR_FULL_G22_NONE_P709_X601* Colorspace: YCbCr * Range: 0-255 * Gamma: 2.2 * Costing: Image * Primaries: BT.2020 * Transfer Matrix: BT.601 This definition is commonly used for JPG. This is usually used with 8, 10, 12, or 16 bit color channels. |
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P601* Colorspace: YCbCr * Range: 16-235 * Gamma: 2.2 * Costing: Video * Primaries: BT.601 This definition is commonly used for MPEG2. This is usually used with 8, 10, 12, or 16 bit color channels. |
D3DDDI_COLOR_SPACE_YCBCR_FULL_G22_LEFT_P601* Colorspace: YCbCr * Range: 0-255 * Gamma: 2.2 * Costing: Video * Primaries: BT.601 This is sometimes used for H.264 camera capture. This is usually used with 8, 10, 12, or 16 bit color channels. |
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P709* Colorspace: YCbCr * Range: 16-235 * Gamma: 2.2 * Costing: Video * Primaries: BT.709 This definition is commonly used for H.264 and HEVC. This is usually used with 8, 10, 12, or 16 bit color channels. |
D3DDDI_COLOR_SPACE_YCBCR_FULL_G22_LEFT_P709* Colorspace: YCbCr * Range: 0-255 * Gamma: 2.2 * Costing: Video * Primaries: BT.709 This is sometimes used for H.264 camera capture. This is usually used with 8, 10, 12, or 16 bit color channels. |
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P2020* Colorspace: YCbCr * Range: 16-235 * Gamma: 2.2 * Costing: Video * Primaries: BT.2020 This definition may be used by HEVC. This is usually used with 10, 12, or 16 bit color channels. |
D3DDDI_COLOR_SPACE_YCBCR_FULL_G22_LEFT_P2020* Colorspace: YCbCr * Range: 0-255 * Gamma: 2.2 * Costing: Video * Primaries: BT.2020 This is usually used with 10, 12, or 16 bit color channels. |
D3DDDI_COLOR_SPACE_RGB_FULL_G2084_NONE_P2020* Colorspace: RGB * Range: 0-255 * Gamma: 2084 * Costing: Center * Primaries: BT.2020 |
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G2084_LEFT_P2020* Colorspace: YCbCr * Range: 16-235 * Gamma: 2084 * Costing: Left * Primaries: BT.2020 |
D3DDDI_COLOR_SPACE_RGB_STUDIO_G2084_NONE_P2020* Colorspace: RGB * Range: 16-235 * Gamma: 2084 * Costing: Center * Primaries: BT.2020 |
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G22_TOPLEFT_P2020* Colorspace: YCbCr * Range: 16-235 * Gamma: 2.2 * Costing: Top left * Primaries: BT.2020 |
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G2084_TOPLEFT_P2020* Colorspace: YCbCr * Range: 16-235 * Gamma: 2084 * Costing: Top left * Primaries: BT.2020 |
D3DDDI_COLOR_SPACE_RGB_FULL_G22_NONE_P2020* Colorspace: RGB * Range: 0-255 * Gamma: 2.2 * Costing: None * Primaries: BT.2020 |
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_GHLG_TOPLEFT_P2020* Colorspace: YCbCr * Range: 16-235 * Gamma: HLG * Costing: Top left * Primaries: BT.2020 This color space can be used as an input to the video processor DDIs, but will never be used to scan out. |
D3DDDI_COLOR_SPACE_YCBCR_FULL_GHLG_TOPLEFT_P2020* Colorspace: YCbCr * Range: 0-255 * Gamma: HLG * Costing: Top left * Primaries: BT.2020 This color space can be used as an input to the video processor DDIs, but will never be used to scan out. |
D3DDDI_COLOR_SPACE_RGB_STUDIO_G24_NONE_P709* Colorspace: RGB * Range: 0-255 * Gamma: HLG * Costing: None * Primaries: BT.709 |
D3DDDI_COLOR_SPACE_RGB_STUDIO_G24_NONE_P2020* Colorspace: RGB * Range: 16-235 * Gamma: 2.4 * Costing: None * Primaries: BT.709 |
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G24_LEFT_P709* Colorspace: YCbCr * Range: 16-235 * Gamma: 2.4 * Costing: Left * Primaries: BT.709 |
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G24_LEFT_P2020* Colorspace: YCbCr * Range: 16-235 * Gamma: 2.4 * Costing: Left * Primaries: BT.2020 |
D3DDDI_COLOR_SPACE_YCBCR_STUDIO_G24_TOPLEFT_P2020* Colorspace: YCbCr * Range: 16-235 * Gamma: 2.4 * Costing: Top left * Primaries: BT.2020 |
D3DDDI_COLOR_SPACE_CUSTOMA custom color definition is used. |
Remarks
Subsampling and the layout of the color channels are inferred from the surface format.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 |
| Minimum supported server | Windows Server 2016 |
| Header | d3dukmdt.h (include D3dumddi.h, D3dkmddi.h) |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for