Color Models

group NVCV_C_CORE_COLORSPEC

Defines color models. A color model gives meaning to each channel of an image format. They are specified in a canonical XYZW ordering that can then be swizzled to the desired ordering.

Defines

NVCV_MAKE_COLOR_SPEC

Creates a user-defined color spec constant.

Example:

NVCVColorSpec cspec = NVCV_MAKE_COLOR_SPEC(NVCV_COLOR_SPACE_BT709,
                                           NVCV_YCbCr_ENC_sRGB,
                                           NVCV_COLOR_XFER_sYCC,
                                           NVCV_COLOR_RANGE_FULL,
                                           NVCV_CHROMA_LOC_ODD,
                                           NVCV_CHROMA_LOC_EVEN);

Parameters:

cspace – [in] Color Space.
encoding – [in] R’G’B’ <-> Y’CbCr encoding.
xferFunc – [in] Color transfer function.
range – [in] Color quantization range.
locHoriz – [in] Horizontal chroma location.
locVert – [in] Vertical chroma location.

Returns:

The user-defined NVCVColorSpec constant.

Enums

enum NVCVColorModel

Values:

enumerator NVCV_COLOR_MODEL_UNDEFINED: Color model is undefined.

enumerator NVCV_COLOR_MODEL_YCbCr: Luma + chroma (blue-luma, red-luma).

enumerator NVCV_COLOR_MODEL_RGB: red, green, blue components.

enumerator NVCV_COLOR_MODEL_RAW: RAW color model, used for Bayer image formats.

enumerator NVCV_COLOR_MODEL_XYZ: CIE XYZ tristimulus color spec.

enumerator NVCV_COLOR_MODEL_HSV: hue, saturation, value components.

enumerator NVCV_COLOR_MODEL_CMYK: cyan, magenta, yellow, black components.

enumerator NVCV_COLOR_MODEL_YCCK: Luma + chroma (blue-luma, red-luma) and black components.

enum NVCVColorSpace

Defines the color primaries and the white point of a NVCVColorSpec.

Values:

enumerator NVCV_COLOR_SPACE_BT601: Color primaries from ITU-R BT.601/625 lines standard, also known as EBU 3213-E.

enumerator NVCV_COLOR_SPACE_BT709: Color primaries from ITU-R BT.709 standard, D65 white point.

enumerator NVCV_COLOR_SPACE_BT2020: Color primaries from ITU-R BT.2020 standard, D65 white point.

enumerator NVCV_COLOR_SPACE_DCIP3: Color primaries from DCI-P3 standard, D65 white point.

enum NVCVWhitePoint

Defines the white point associated with a NVCVColorSpace.

Values:

enumerator NVCV_WHITE_POINT_D65: D65 white point, K = 6504.

enum NVCVYCbCrEncoding

Defines the YCbCr encoding used in a particular NVCVColorSpec.

Values:

enumerator NVCV_YCbCr_ENC_UNDEFINED: Encoding not defined. Usually used by non-YCbCr color specs.

enumerator NVCV_YCbCr_ENC_BT601: Encoding specified by ITU-R BT.601 standard.

enumerator NVCV_YCbCr_ENC_BT709: Encoding specified by ITU-R BT.709 standard.

enumerator NVCV_YCbCr_ENC_BT2020: Encoding specified by ITU-R BT.2020 standard.

enumerator NVCV_YCbCr_ENC_BT2020c: Encoding specified by ITU-R BT.2020 with constant luminance.

enumerator NVCV_YCbCr_ENC_SMPTE240M: Encoding specified by SMPTE 240M standard.

enum NVCVColorTransferFunction

Defines the color transfer function in a particular NVCVColorSpec.

Values:

enumerator NVCV_COLOR_XFER_LINEAR: Linear color transfer function.

enumerator NVCV_COLOR_XFER_sRGB: Color transfer function specified by sRGB standard.

enumerator NVCV_COLOR_XFER_sYCC: Color transfer function specified by sYCC standard.

enumerator NVCV_COLOR_XFER_PQ: Perceptual quantizer color transfer function.

enumerator NVCV_COLOR_XFER_BT709: Color transfer function specified by ITU-R BT.709 standard.

enumerator NVCV_COLOR_XFER_BT2020: Color transfer function specified by ITU-R BT.2020 standard.

enumerator NVCV_COLOR_XFER_SMPTE240M: Color transfer function specified by SMPTE 240M standard.

enum NVCVColorRange

Defines the color range of a particular NVCVColorSpec.

Values:

enumerator NVCV_COLOR_RANGE_FULL: Values cover the full underlying type range.

enumerator NVCV_COLOR_RANGE_LIMITED: Values cover a limited range of the underlying type.

enum NVCVChromaLocation

Chroma sampling location.

Values:

enumerator NVCV_CHROMA_LOC_BOTH: Sample chroma from even and odd coordinates. This is used when no sub-sampling is taking place.

enumerator NVCV_CHROMA_LOC_EVEN: Sample the chroma with even coordinate.

enumerator NVCV_CHROMA_LOC_CENTER: Sample the chroma exactly between the even and odd coordinate.

enumerator NVCV_CHROMA_LOC_ODD: Sample the chroma with odd coordinate.

enum NVCVColorSpec

Color spec definitions. These color specs define how color information is to be interpreted. It is defined by several parameters:

NVCVColorModel
NVCVColorSpace
NVCVWhitePoint
NVCVYCbCrEncoding
NVCVColorTransferFunction
NVCVColorRange
NVCVChromaLocation

These parameters together defines how the color representation maps to its corresponding absolute color in a chromacity diagram.

Values:

enumerator NVCV_COLOR_SPEC_UNDEFINED: No color spec defined. Used when color spec isn’t relevant or is not defined. The color spec may be inferred from the context. If this isn’t possible, the values for each color spec component defined below will be used.

enumerator NVCV_COLOR_SPEC_BT601: Color spec defining ITU-R BT.601 standard, limited range, with BT.709 chrominancies and transfer function.

enumerator NVCV_COLOR_SPEC_BT601_ER: Color spec defining ITU-R BT.601 standard, full range, with BT.709 chrominancies and transfer function.

enumerator NVCV_COLOR_SPEC_BT709: Color spec defining ITU-R BT.709 standard, limited range.

enumerator NVCV_COLOR_SPEC_BT709_ER: Color spec defining ITU-R BT.709 standard, full range.

enumerator NVCV_COLOR_SPEC_BT709_LINEAR: Color spec defining ITU-R BT.709 standard, limited range and linear transfer function.

enumerator NVCV_COLOR_SPEC_BT2020: Color spec defining ITU-R BT.2020 standard, limited range.

enumerator NVCV_COLOR_SPEC_BT2020_ER: Color spec defining ITU-R BT.2020 standard, full range.

enumerator NVCV_COLOR_SPEC_BT2020_LINEAR: Color spec defining ITU-R BT.2020 standard, limited range and linear transfer function.

enumerator NVCV_COLOR_SPEC_BT2020_PQ: Color spec defining ITU-R BT.2020 standard, limited range and perceptual quantizer transfer function.

enumerator NVCV_COLOR_SPEC_BT2020_PQ_ER: Color spec defining ITU-R BT.2020 standard, full range and perceptual quantizer transfer function.

enumerator NVCV_COLOR_SPEC_BT2020c: Color spec defining ITU-R BT.2020 standard for constant luminance, limited range.

enumerator NVCV_COLOR_SPEC_BT2020c_ER: Color spec defining ITU-R BT.2020 standard for constant luminance, full range.

enumerator NVCV_COLOR_SPEC_MPEG2_BT601: Color spec defining MPEG2 standard using ITU-R BT.601 encoding.

enumerator NVCV_COLOR_SPEC_MPEG2_BT709: Color spec defining MPEG2 standard using ITU-R BT.709 encoding.

enumerator NVCV_COLOR_SPEC_MPEG2_SMPTE240M: Color spec defining MPEG2 standard using SMPTE 240M encoding.

enumerator NVCV_COLOR_SPEC_sRGB: Color spec defining sRGB standard.

enumerator NVCV_COLOR_SPEC_sYCC: Color spec defining sYCC standard.

enumerator NVCV_COLOR_SPEC_SMPTE240M: Color spec defining SMPTE 240M standard, limited range.

enumerator NVCV_COLOR_SPEC_DISPLAYP3: Color spec defining Display P3 standard, with sRGB color transfer function.

enumerator NVCV_COLOR_SPEC_DISPLAYP3_LINEAR: Color spec defining Display P3 standard, with linear color transfer function.

enum NVCVRawPattern

Defines Bayer patterns used by RAW color model. R,G,B represent the color primaries red, green, blue. C represent a clear channel, it lets all light pass.

Values:

enumerator NVCV_RAW_BAYER_RGGB