Struct Colorimetry 

pub struct Colorimetry {
    pub space: Option<ColorSpace>,
    pub transfer: Option<ColorTransfer>,
    pub encoding: Option<ColorEncoding>,
    pub range: Option<ColorRange>,
}

Full 4-axis colorimetry. Each axis is Option; None means “undefined” and is never auto-filled — consumers (e.g. convert()) resolve missing axes at use-time without mutating the value.

Fields

space: Option<ColorSpace>

transfer: Option<ColorTransfer>

encoding: Option<ColorEncoding>

range: Option<ColorRange>

Implementations

impl Colorimetry

pub fn jfif() -> Self

JPEG/JFIF colorimetry: sRGB primaries, sRGB transfer, BT.601 encoding, full range.

pub fn from_v4l2( colorspace: u32, xfer: u32, ycbcr_enc: u32, quant: u32, is_rgb_or_hsv: bool, ) -> Self

Build from the four raw V4L2 colorimetry integers of a negotiated format whose pixel encoding is RGB or HSV when is_rgb_or_hsv is true (see [PixelFormat::is_rgb_or_hsv]).

Explicit values map directly. For ycbcr_enc/quantization, the V4L2 DEFAULT (0) sentinel does NOT mean “unknown” — it means “derive” (kernel V4L2_MAP_YCBCR_ENC_DEFAULT / V4L2_MAP_QUANTIZATION_DEFAULT), and those axes are resolved here rather than left None for the at-use height heuristic (which would wrongly pick BT.709/limited for an HD JPEG frame):

• quantization = DEFAULT is full range for an RGB/HSV format, whatever the colorspace, and for V4L2_COLORSPACE_JPEG; limited for a YUV format in any other recognised colorspace; and unset (None) for a YUV format in a DEFAULT or unrecognised colorspace, so the at-use height heuristic decides.
• ycbcr_enc = DEFAULT is the encoding the colorspace implies, and unset (None) for a DEFAULT or unrecognised colorspace.

Unrecognised non-default values also map to None.

pub fn with_space(self, s: ColorSpace) -> Self

Set color primaries (consuming builder).

pub fn with_transfer(self, t: ColorTransfer) -> Self

Set transfer function (consuming builder).

pub fn with_encoding(self, e: ColorEncoding) -> Self

Set YCbCr encoding matrix (consuming builder).

pub fn with_range(self, r: ColorRange) -> Self

Set quantization range (consuming builder).

pub fn pack(&self) -> u32

Pack all four axes into one u32 for crate::protocol::TensorDesc::colorimetry.

One byte per axis, space in the low byte through range in the high byte; 0 on an axis means “undefined”, so an all-None Colorimetry packs to 0. Each byte is that axis’s code(), the same word the C API’s ef_tensor_colorimetry returns. This crosses a package boundary like TensorDesc itself: codes are appended, never renumbered.

pub fn unpack(bits: u32) -> Self

Inverse of Self::pack: rebuild a Colorimetry from a packed u32, e.g. crate::protocol::TensorDesc::colorimetry on import. 0 on an axis byte (undefined, including a build that predates the axis) maps to None rather than erroring, the same forward-compatibility rule crate::protocol::dtype_to_dtype applies to another wire-coded axis – a code this build does not recognise (e.g. one a newer producer added) also maps to None instead of guessing.

Trait Implementations

impl Clone for Colorimetry

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Colorimetry

impl Debug for Colorimetry

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

Formats the value using the given formatter.

impl Default for Colorimetry

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Colorimetry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Colorimetry

impl Hash for Colorimetry

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

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 Colorimetry

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Colorimetry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Colorimetry