Color Space

Classes:

• ColorSpace –

  Store color space gamut data and provide CIE XYZ conversion matrices.

Functions:

• hlg_encoding –

  HLG (Hybrid Log-Gamma) OETF as per ARIB STD-B67

• pq_encoding –

  PQ (SMPTE ST 2084) OETF

• rec_709_encoding –

  The Rec. 709 OETF.

• srgb_encoding –

  The sRGB OETF.

Attributes:

• COLOR_SPACES –

  The Default output color spaces.

• GAMMA_FUNCTIONS –

  Different gamma functions for output encoding.

COLOR_SPACES = {
    "Rec. 709": ColorSpace(0.3127, 0.329, 0.64, 0.33, 0.3, 0.6, 0.15, 0.06),
    "Display P3": ColorSpace(0.3127, 0.329, 0.68, 0.32, 0.2651, 0.69, 0.15, 0.06),
    "Rec. 2020": ColorSpace(0.3127, 0.329, 0.708, 0.292, 0.17, 0.797, 0.131, 0.046),
    "ACES AP1": ColorSpace(0.32168, 0.33767, 0.713, 0.293, 0.165, 0.83, 0.128, 0.044),
    "ACES AP0": ColorSpace(0.32168, 0.33767, 0.7347, 0.2653, 0.0, 1.0, 0.0001, -0.077),
    "CIE XYZ": None,
    "DCI-P3": ColorSpace(0.314, 0.351, 0.68, 0.32, 0.2651, 0.69, 0.15, 0.06),
    "DCI-P3 D60": ColorSpace(0.32168, 0.33767, 0.68, 0.32, 0.2651, 0.69, 0.15, 0.06),
}

GAMMA_FUNCTIONS = {
    "Linear": lambda x: x,
    "Gamma 1.8": lambda x: x ** (1 / 1.8),
    "Gamma 2.0": lambda x: x ** (1 / 2.0),
    "Gamma 2.2": lambda x: x ** (1 / 2.2),
    "Gamma 2.4": lambda x: x ** (1 / 2.4),
    "Gamma 2.6": lambda x: x ** (1 / 2.6),
    "Rec. 709": rec_709_encoding,
    "sRGB": srgb_encoding,
    "HLG": hlg_encoding,
    "PQ": pq_encoding,
}

ColorSpace(
    w_x: float,
    w_y: float,
    r_x: float,
    r_y: float,
    g_x: float,
    g_y: float,
    b_x: float,
    b_y: float,
)

hlg_encoding(x, peak=203)

pq_encoding(x, peak=203)

rec_709_encoding(x)

srgb_encoding(x)