Enum rerun::external::re_renderer::resource_managers::YuvMatrixCoefficients

pub enum YuvMatrixCoefficients {
    Identity = 0,
    Bt601 = 1,
    Bt709 = 2,
}

Yuv matrix coefficients that determine how a YUV image is meant to be converted to RGB.

A rigorious definition of the yuv conversion matrix would still require to define the transfer characteristics & color primaries of the resulting RGB space. See re_video::decode’s documentation.

However, at this point we generally assume that no further processing is needed after the transform. This is acceptable for most non-HDR content because of the following properties of Bt709/Bt601/ sRGB:

• Bt709 & sRGB primaries are practically identical
• Bt601 PAL & Bt709 color primaries are the same (with some slight differences for Bt709 NTSC)
• Bt709 & sRGB transfer function are almost identical (and the difference is widely ignored) (sources: https://en.wikipedia.org/wiki/Rec._709, https://en.wikipedia.org/wiki/Rec._601) …which means for the moment we pretty much only care about the (actually quite) different YUV conversion matrices!

Variants

Identity = 0

Identity matrix, interpret YUV as GBR.

Bt601 = 1

BT.601 (aka. SDTV, aka. Rec.601)

Wiki: https://en.wikipedia.org/wiki/YCbCr#ITU-R_BT.601_conversion/

Bt709 = 2

BT.709 (aka. HDTV, aka. Rec.709)

Wiki: https://en.wikipedia.org/wiki/YCbCr#ITU-R_BT.709_conversion/

These are the same primaries we usually assume and use for all our rendering since they are the same primaries used by sRGB. https://en.wikipedia.org/wiki/Rec._709#Relationship_to_sRGB/ The OETF/EOTF function (https://en.wikipedia.org/wiki/Transfer_functions_in_imaging) is different, but for all other purposes they are the same. (The only reason for us to convert to optical units (“linear” instead of “gamma”) is for lighting & tonemapping where we typically start out with an sRGB image!)

Trait Implementations

impl Clone for YuvMatrixCoefficients

fn clone(&self) -> YuvMatrixCoefficients

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for YuvMatrixCoefficients

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

Formats the value using the given formatter.

impl Display for YuvMatrixCoefficients

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

Formats the value using the given formatter.

impl Copy for YuvMatrixCoefficients