Struct Cicp 

#[non_exhaustive]
pub struct Cicp {
    pub color_primaries: u8,
    pub transfer_characteristics: u8,
    pub matrix_coefficients: u8,
    pub full_range: bool,
}

CICP color description (ITU-T H.273).

Coding-Independent Code Points describe the color space of an image without requiring an ICC profile. Used by AVIF, HEIF, JPEG XL, and video codecs (H.264, H.265, AV1).

Common combinations for RGB content (matrix_coefficients = 0 = Identity):

• sRGB: (1, 13, 0, true) — BT.709 primaries, sRGB transfer
• Display P3: (12, 13, 0, true) — P3 primaries, sRGB transfer
• BT.2100 PQ (HDR): (9, 16, 0, true) — BT.2020 primaries, PQ transfer
• BT.2100 HLG (HDR): (9, 18, 0, true) — BT.2020 primaries, HLG transfer

Video/YCbCr content uses non-zero matrix_coefficients (e.g., 6=BT.601, 9=BT.2020).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

color_primaries: u8

Color primaries (ColourPrimaries). Common values: 1 = BT.709/sRGB, 9 = BT.2020, 12 = Display P3.

transfer_characteristics: u8

Transfer characteristics (TransferCharacteristics). Common values: 1 = BT.709, 13 = sRGB, 16 = PQ (HDR), 18 = HLG (HDR).

matrix_coefficients: u8

Matrix coefficients (MatrixCoefficients). Common values: 0 = Identity/RGB, 1 = BT.709, 6 = BT.601, 9 = BT.2020.

full_range: bool

Whether pixel values use the full range (0-255 for 8-bit) or video/limited range (16-235 for 8-bit luma).

Implementations

impl Cicp

pub const SRGB: Cicp

sRGB color space: BT.709 primaries, sRGB transfer, Identity (RGB) matrix, full range.

pub const BT2100_PQ: Cicp

BT.2100 PQ (HDR10): BT.2020 primaries, PQ transfer, BT.2020 matrix, full range.

pub const BT2100_HLG: Cicp

BT.2100 HLG (HDR): BT.2020 primaries, HLG transfer, BT.2020 matrix, full range.

pub const DISPLAY_P3: Cicp

Display P3 with sRGB transfer: P3 primaries, sRGB transfer, Identity matrix, full range.

pub const fn new( color_primaries: u8, transfer_characteristics: u8, matrix_coefficients: u8, full_range: bool, ) -> Cicp

Create a CICP color description from raw code points.

pub fn color_primaries_enum(&self) -> ColorPrimaries

Map the CICP color_primaries code to a ColorPrimaries enum.

Returns Unknown for unrecognized codes. This is a convenience wrapper around ColorPrimaries::from_cicp.

pub fn transfer_function_enum(&self) -> TransferFunction

Map the CICP transfer_characteristics code to a TransferFunction enum.

Returns Unknown for unrecognized codes. This is a convenience wrapper around TransferFunction::from_cicp.

pub fn from_descriptor(desc: &PixelDescriptor) -> Option<Cicp>

Create a CICP from a PixelDescriptor.

Returns None if the descriptor’s transfer function or color primaries cannot be mapped to CICP code points (e.g., Unknown variants).

pub fn to_descriptor(&self, format: PixelFormat) -> PixelDescriptor

Convert to a PixelDescriptor with the given PixelFormat.

Maps the CICP code points to the corresponding enum variants. Unmapped codes become Unknown.

pub fn color_primaries_name(code: u8) -> &'static str

Human-readable name for the color primaries code (ITU-T H.273 Table 2).

pub fn transfer_characteristics_name(code: u8) -> &'static str

Human-readable name for the transfer characteristics code (ITU-T H.273 Table 3).

pub fn matrix_coefficients_name(code: u8) -> &'static str

Human-readable name for the matrix coefficients code (ITU-T H.273 Table 4).

Trait Implementations

impl Clone for Cicp

fn clone(&self) -> Cicp

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Cicp

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for Cicp

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Hash for Cicp

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Cicp

fn eq(&self, other: &Cicp) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Cicp

impl Eq for Cicp

impl StructuralPartialEq for Cicp