Enum TransferCharacteristics

#[non_exhaustive]
pub enum TransferCharacteristics {
    Bt709 = 1,
    Unspecified = 2,
    Bt601 = 6,
    Smpte240 = 7,
    Linear = 8,
    Log = 9,
    LogSqrt = 10,
    Iec61966 = 11,
    Srgb = 13,
    Bt2020_10 = 14,
    Bt2020_12 = 15,
    Smpte2084 = 16,
    Smpte428 = 17,
    Hlg = 18,
}

This controls how color data is interpreted (gamma).

If you don’t know what to do with these, pick Srgb.

Reasonable options include Bt709 (HDTV), Bt2020_10 (Wide Gamut), Smpte2084, Hlg (HDR).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Bt709 = 1

Rec.709. May be appropriate for conversions from video.

Unspecified = 2

Don’t use this for color channels.

Bt601 = 6

ITU-R BT601-6 525. Not recommended, unless you’re converting from unlabelled low-res video clips. See Bt709 and Srgb.

Smpte240 = 7

Don’t use this. SMPTE 240 M. It’s just a worse Rec.709.

Linear = 8

“Linear transfer characteristics”

Log = 9

“Logarithmic transfer characteristic (100:1 range)”

LogSqrt = 10

“Logarithmic transfer characteristic (100 * Sqrt(10) : 1 range)”

Iec61966 = 11

IEC 61966-2-4

Srgb = 13

sRGB. This is the safe choice for encoding “standard” RGB images, especially 8-bit inputs.

Bt2020_10 = 14

ITU-R BT2020 for 10-bit system. Reasonable for encoding wide gamut.

Bt2020_12 = 15

ITU-R BT2020 for 12-bit system

Smpte2084 = 16

SMPTE ST 2084, ITU BT.2100 PQ

Smpte428 = 17

SMPTE ST 428. Not recommended. Overkill for images. Use Bt2020_10 instead.

Hlg = 18

BT.2100 HLG (Hybrid Log Gamma), ARIB STD-B67

Trait Implementations

impl Clone for TransferCharacteristics

fn clone(&self) -> TransferCharacteristics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransferCharacteristics

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

Formats the value using the given formatter.

impl PartialEq for TransferCharacteristics

fn eq(&self, other: &TransferCharacteristics) -> 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 TransferCharacteristics

impl Eq for TransferCharacteristics

impl StructuralPartialEq for TransferCharacteristics