Colour Models¶
- Tristimulus Values, CIE xyY Colourspace and Chromaticity Coordinates
- CIE L*a*b* Colourspace
- CIE L*u*v* Colourspace
- CIE 1960 UCS Colourspace
- CIE 1964 U*V*W* Colourspace
- Hunter L,a,b Colour Scale
- Hunter Rd,a,b Colour Scale
- DIN99 Colourspace
- CAM02-LCD, CAM02-SCD, and CAM02-UCS Colourspaces - Luo, Cui and Li (2006)
- CAM16-LCD, CAM16-SCD, and CAM16-UCS Colourspaces - Li et al. (2017)
- IPT Colourspace
- hdr-CIELAB Colourspace
- hdr-IPT Colourspace
- OSA UCS Colourspace
- \(JzAzBz\) Colourspace
- RGB Colourspace and Transformations
- Pointer’s Gamut
Tristimulus Values, CIE xyY Colourspace and Chromaticity Coordinates¶
colour
XYZ_to_xyY (XYZ[, illuminant]) |
Converts from CIE XYZ tristimulus values to CIE xyY colourspace and reference illuminant. |
xyY_to_XYZ (xyY) |
Converts from CIE xyY colourspace to CIE XYZ tristimulus values. |
XYZ_to_xy (XYZ[, illuminant]) |
Returns the xy chromaticity coordinates from given CIE XYZ tristimulus values. |
xy_to_XYZ (xy) |
Returns the CIE XYZ tristimulus values from given xy chromaticity coordinates. |
xyY_to_xy (xyY) |
Converts from CIE xyY colourspace to xy chromaticity coordinates. |
xy_to_xyY (xy[, Y]) |
Converts from xy chromaticity coordinates to CIE xyY colourspace by extending the array last dimension with \(Y\) Luminance. |
CIE L*a*b* Colourspace¶
colour
XYZ_to_Lab (XYZ[, illuminant]) |
Converts from CIE XYZ tristimulus values to CIE L*a*b* colourspace. |
Lab_to_XYZ (Lab[, illuminant]) |
Converts from CIE L*a*b* colourspace to CIE XYZ tristimulus values. |
Lab_to_LCHab (Lab) |
Converts from CIE L*a*b* colourspace to CIE L*C*Hab colourspace. |
LCHab_to_Lab (LCHab) |
Converts from CIE L*C*Hab colourspace to CIE L*a*b* colourspace. |
CIE L*u*v* Colourspace¶
colour
XYZ_to_Luv (XYZ[, illuminant]) |
Converts from CIE XYZ tristimulus values to CIE L*u*v* colourspace. |
Luv_to_XYZ (Luv[, illuminant]) |
Converts from CIE L*u*v* colourspace to CIE XYZ tristimulus values. |
Luv_to_LCHuv (Luv) |
Converts from CIE L*u*v* colourspace to CIE L*C*Huv colourspace. |
LCHuv_to_Luv (LCHuv) |
Converts from CIE L*C*Huv colourspace to CIE L*u*v* colourspace. |
Luv_to_uv (Luv[, illuminant]) |
Returns the \(uv^p\) chromaticity coordinates from given CIE L*u*v* colourspace array. |
Luv_uv_to_xy (uv) |
Returns the xy chromaticity coordinates from given CIE L*u*v* colourspace \(uv^p\) chromaticity coordinates. |
xy_to_Luv_uv (xy) |
Returns the CIE L*u*v* colourspace \(uv^p\) chromaticity coordinates from given xy chromaticity coordinates. |
CIE 1960 UCS Colourspace¶
colour
XYZ_to_UCS (XYZ) |
Converts from CIE XYZ tristimulus values to CIE 1960 UCS colourspace. |
UCS_to_XYZ (UVW) |
Converts from CIE 1960 UCS colourspace to CIE XYZ tristimulus values. |
UCS_to_uv (UVW) |
Returns the uv chromaticity coordinates from given CIE 1960 UCS colourspace array. |
UCS_uv_to_xy (uv) |
Returns the xy chromaticity coordinates from given CIE 1960 UCS colourspace uv chromaticity coordinates. |
xy_to_UCS_uv (xy) |
Returns the CIE 1960 UCS colourspace uv chromaticity coordinates from given xy chromaticity coordinates. |
CIE 1964 U*V*W* Colourspace¶
colour
XYZ_to_UVW (XYZ[, illuminant]) |
Converts from CIE XYZ tristimulus values to CIE 1964 U*V*W* colourspace. |
UVW_to_XYZ (UVW[, illuminant]) |
Converts CIE 1964 U*V*W* colourspace to CIE XYZ tristimulus values. |
Hunter L,a,b Colour Scale¶
colour
XYZ_to_Hunter_Lab (XYZ[, XYZ_n, K_ab]) |
Converts from CIE XYZ tristimulus values to Hunter L,a,b colour scale. |
Hunter_Lab_to_XYZ (Lab[, XYZ_n, K_ab]) |
Converts from Hunter L,a,b colour scale to CIE XYZ tristimulus values. |
XYZ_to_K_ab_HunterLab1966 (XYZ) |
Converts from whitepoint CIE XYZ tristimulus values to Hunter L,a,b \(K_{a}\) and \(K_{b}\) chromaticity coefficients. |
Hunter Rd,a,b Colour Scale¶
colour
XYZ_to_Hunter_Rdab (XYZ[, XYZ_n, K_ab]) |
Converts from CIE XYZ tristimulus values to Hunter Rd,a,b colour scale. |
Hunter_Rdab_to_XYZ (R_d_ab[, XYZ_n, K_ab]) |
Converts from Hunter Rd,a,b colour scale to CIE XYZ tristimulus values. |
DIN99 Colourspace¶
colour
Lab_to_DIN99 (Lab[, k_E, k_CH]) |
Converts from CIE L*a*b* colourspace to DIN99 colourspace. |
DIN99_to_Lab (Lab_99[, k_E, k_CH]) |
Converts from DIN99 colourspace to CIE L*a*b* colourspace. |
CAM02-LCD, CAM02-SCD, and CAM02-UCS Colourspaces - Luo, Cui and Li (2006)¶
colour
JMh_CIECAM02_to_CAM02LCD (JMh) |
Converts from CIECAM02 \(JMh\) correlates array to Luo et al.(2006) CAM02-LCD colourspace \(J'a'b'\) array.. |
CAM02LCD_to_JMh_CIECAM02 (Jpapbp) |
Converts from Luo et al.(2006) CAM02-LCD colourspace \(J'a'b'\) array to CIECAM02 \(JMh\) correlates array.. |
JMh_CIECAM02_to_CAM02SCD (JMh) |
Converts from CIECAM02 \(JMh\) correlates array to Luo et al.(2006) CAM02-SCD colourspace \(J'a'b'\) array.. |
CAM02SCD_to_JMh_CIECAM02 (Jpapbp) |
Converts from Luo et al.(2006) CAM02-SCD colourspace \(J'a'b'\) array to CIECAM02 \(JMh\) correlates array.. |
JMh_CIECAM02_to_CAM02UCS (JMh) |
Converts from CIECAM02 \(JMh\) correlates array to Luo et al.(2006) CAM02-UCS colourspace \(J'a'b'\) array.. |
CAM02UCS_to_JMh_CIECAM02 (Jpapbp) |
Converts from Luo et al.(2006) CAM02-UCS colourspace \(J'a'b'\) array to CIECAM02 \(JMh\) correlates array.. |
CAM16-LCD, CAM16-SCD, and CAM16-UCS Colourspaces - Li et al. (2017)¶
colour
JMh_CAM16_to_CAM16LCD (JMh, *[, …]) |
Converts from CAM16 \(JMh\) correlates array to Li et al.(2017) CAM16-LCD colourspace \(J'a'b'\) array.. |
CAM16LCD_to_JMh_CAM16 (Jpapbp, *[, …]) |
Converts from Li et al.(2017) CAM16-LCD colourspace \(J'a'b'\) array to CAM16 \(JMh\) correlates array.. |
JMh_CAM16_to_CAM16SCD (JMh, *[, …]) |
Converts from CAM16 \(JMh\) correlates array to Li et al.(2017) CAM16-SCD colourspace \(J'a'b'\) array.. |
CAM16SCD_to_JMh_CAM16 (Jpapbp, *[, …]) |
Converts from Li et al.(2017) CAM16-SCD colourspace \(J'a'b'\) array to CAM16 \(JMh\) correlates array.. |
JMh_CAM16_to_CAM16UCS (JMh, *[, …]) |
Converts from CAM16 \(JMh\) correlates array to Li et al.(2017) CAM16-UCS colourspace \(J'a'b'\) array.. |
CAM16UCS_to_JMh_CAM16 (Jpapbp, *[, …]) |
Converts from Li et al.(2017) CAM16-UCS colourspace \(J'a'b'\) array to CAM16 \(JMh\) correlates array.. |
IPT Colourspace¶
colour
XYZ_to_IPT (XYZ) |
Converts from CIE XYZ tristimulus values to IPT colourspace. |
IPT_to_XYZ (IPT) |
Converts from IPT colourspace to CIE XYZ tristimulus values. |
IPT_hue_angle (IPT) |
Computes the hue angle in degrees from IPT colourspace. |
hdr-CIELAB Colourspace¶
colour
XYZ_to_hdr_CIELab (XYZ[, illuminant, Y_s, …]) |
Converts from CIE XYZ tristimulus values to hdr-CIELAB colourspace. |
hdr_CIELab_to_XYZ (Lab_hdr[, illuminant, …]) |
Converts from hdr-CIELAB colourspace to CIE XYZ tristimulus values. |
HDR_CIELAB_METHODS |
Supported hdr-CIELAB colourspace computation methods. |
hdr-IPT Colourspace¶
colour
XYZ_to_hdr_IPT (XYZ[, Y_s, Y_abs, method]) |
Converts from CIE XYZ tristimulus values to hdr-IPT colourspace. |
hdr_IPT_to_XYZ (IPT_hdr[, Y_s, Y_abs, method]) |
Converts from hdr-IPT colourspace to CIE XYZ tristimulus values. |
HDR_IPT_METHODS |
Supported hdr-IPT colourspace computation methods. |
OSA UCS Colourspace¶
colour
XYZ_to_OSA_UCS (XYZ) |
Converts from CIE XYZ tristimulus values under the CIE 1964 10 Degree Standard Observer to OSA UCS colourspace. |
OSA_UCS_to_XYZ (Ljg[, optimisation_parameters]) |
Converts from OSA UCS colourspace to CIE XYZ tristimulus values under the CIE 1964 10 Degree Standard Observer. |
\(JzAzBz\) Colourspace¶
colour
XYZ_to_JzAzBz (XYZ_D65[, constants]) |
Converts from CIE XYZ tristimulus values to \(J_zA_zB_z\) colourspace. |
JzAzBz_to_XYZ (JzAzBz[, constants]) |
Converts from \(J_zA_zB_z\) colourspace to CIE XYZ tristimulus values. |
RGB Colourspace and Transformations¶
colour
XYZ_to_RGB (XYZ, illuminant_XYZ, …[, …]) |
Converts from CIE XYZ tristimulus values to RGB colourspace array. |
RGB_to_XYZ (RGB, illuminant_RGB, …[, …]) |
Converts given RGB colourspace array to CIE XYZ tristimulus values. |
RGB_to_RGB (RGB, input_colourspace, …[, …]) |
Converts given RGB colourspace array from given input RGB colourspace to output RGB colourspace using given chromatic adaptation method. |
RGB_to_RGB_matrix (input_colourspace, …[, …]) |
Computes the matrix \(M\) converting from given input RGB colourspace to output RGB colourspace using given chromatic adaptation method. |
Ancillary Objects
colour
XYZ_to_sRGB (XYZ[, illuminant, …]) |
Converts from CIE XYZ tristimulus values to sRGB colourspace. |
sRGB_to_XYZ (RGB[, illuminant, …]) |
Converts from sRGB colourspace to CIE XYZ tristimulus values. |
RGB Colourspace Derivation¶
colour
normalised_primary_matrix (primaries, whitepoint) |
Returns the normalised primary matrix using given primaries and whitepoint \(xy\) chromaticity coordinates. |
chromatically_adapted_primaries (primaries, …) |
Chromatically adapts given primaries \(xy\) chromaticity coordinates from test whitepoint_t to reference whitepoint_r . |
primaries_whitepoint (npm) |
Returns the primaries and whitepoint \(xy\) chromaticity coordinates using given normalised primary matrix. |
RGB_luminance (RGB, primaries, whitepoint) |
Returns the luminance \(Y\) of given RGB components from given primaries and whitepoint. |
RGB_luminance_equation (primaries, whitepoint) |
Returns the luminance equation from given primaries and whitepoint. |
RGB Colourspaces¶
colour
RGB_Colourspace (name, primaries, whitepoint) |
Implements support for the RGB colourspaces dataset from colour.models.dataset.aces_rgb , etc…. |
RGB_COLOURSPACES |
Aggregated RGB colourspaces. |
colour.models
ACES_2065_1_COLOURSPACE |
ACES2065-1 colourspace, base encoding, used for exchange of full fidelity images and archiving. |
ACES_CC_COLOURSPACE |
ACEScc colourspace, a working space for color correctors, target for ASC-CDL values created on-set. |
ACES_CCT_COLOURSPACE |
ACEScct colourspace, an alternative working space for colour correctors, intended to be transient and internal to software or hardware systems, and is specifically not intended for interchange or archiving. |
ACES_PROXY_COLOURSPACE |
ACESproxy colourspace, a lightweight encoding for transmission over HD-SDI (or other production transmission schemes), onset look management. |
ACES_CG_COLOURSPACE |
ACEScg colourspace, a working space for paint/compositor applications that don’t support ACES2065-1 or ACEScc. |
ADOBE_RGB_1998_COLOURSPACE |
Adobe RGB (1998) colourspace. |
ADOBE_WIDE_GAMUT_RGB_COLOURSPACE |
Adobe Wide Gamut RGB colourspace. |
ALEXA_WIDE_GAMUT_COLOURSPACE |
ALEXA Wide Gamut colourspace. |
APPLE_RGB_COLOURSPACE |
Apple RGB colourspace. |
BEST_RGB_COLOURSPACE |
Best RGB colourspace. |
BETA_RGB_COLOURSPACE |
Beta RGB colourspace. |
BT470_525_COLOURSPACE |
ITU-R BT.470 - 525 colourspace. |
BT470_625_COLOURSPACE |
ITU-R BT.470 - 625 colourspace. |
BT709_COLOURSPACE |
ITU-R BT.709 colourspace. |
BT2020_COLOURSPACE |
ITU-R BT.2020 colourspace. |
CIE_RGB_COLOURSPACE |
CIE RGB colourspace. |
CINEMA_GAMUT_COLOURSPACE |
Cinema Gamut colourspace. |
COLOR_MATCH_RGB_COLOURSPACE |
ColorMatch RGB colourspace. |
DCDM_XYZ_COLOURSPACE |
DCDM XYZ colourspace. |
DCI_P3_COLOURSPACE |
DCI-P3 colourspace. |
DCI_P3_P_COLOURSPACE |
DCI-P3+ colourspace. |
DON_RGB_4_COLOURSPACE |
Don RGB 4 colourspace. |
ECI_RGB_V2_COLOURSPACE |
ECI RGB v2 colourspace. |
EKTA_SPACE_PS_5_COLOURSPACE |
Ekta Space PS 5 colourspace. |
PROTUNE_NATIVE_COLOURSPACE |
Protune Native colourspace. |
MAX_RGB_COLOURSPACE |
Max RGB colourspace. |
NTSC_COLOURSPACE |
NTSC colourspace. |
P3_D65_COLOURSPACE |
P3-D65 colourspace. |
PAL_SECAM_COLOURSPACE |
Pal/Secam colourspace. |
RED_COLOR_COLOURSPACE |
REDcolor colourspace. |
RED_COLOR_2_COLOURSPACE |
REDcolor2 colourspace. |
RED_COLOR_3_COLOURSPACE |
REDcolor3 colourspace. |
RED_COLOR_4_COLOURSPACE |
REDcolor4 colourspace. |
RED_WIDE_GAMUT_RGB_COLOURSPACE |
REDWideGamutRGB colourspace. |
DRAGON_COLOR_COLOURSPACE |
DRAGONcolor colourspace. |
DRAGON_COLOR_2_COLOURSPACE |
DRAGONcolor2 colourspace. |
ROMM_RGB_COLOURSPACE |
ROMM RGB colourspace. |
RIMM_RGB_COLOURSPACE |
RIMM RGB colourspace. |
ERIMM_RGB_COLOURSPACE |
ERIMM RGB colourspace. |
PROPHOTO_RGB_COLOURSPACE |
ProPhoto RGB colourspace, an alias colourspace for ROMM RGB. |
RUSSELL_RGB_COLOURSPACE |
Russell RGB colourspace. |
SMPTE_240M_COLOURSPACE |
SMPTE 240M colourspace. |
S_GAMUT_COLOURSPACE |
S-Gamut colourspace. |
S_GAMUT3_COLOURSPACE |
S-Gamut3 colourspace. |
S_GAMUT3_CINE_COLOURSPACE |
S-Gamut3.Cine colourspace. |
sRGB_COLOURSPACE |
sRGB colourspace. |
V_GAMUT_COLOURSPACE |
V-Gamut colourspace. |
XTREME_RGB_COLOURSPACE |
Xtreme RGB colourspace. |
Colour Component Transfer Functions¶
colour
encoding_cctf (value[, function]) |
Encodes linear \(RGB\) values to non linear \(R'G'B'\) values using given encoding colour component transfer function (Encoding CCTF). |
ENCODING_CCTFS |
Supported encoding colour component transfer functions (Encoding CCTFs), a collection of the functions defined by colour.LOG_ENCODING_CURVES , colour.OETFS , colour.EOTFS_REVERSE attributes and 3 gamma encoding functions (1 / 2.2, 1 / 2.4, 1 / 2.6). |
decoding_cctf (value[, function]) |
Decodes non-linear \(R'G'B'\) values to linear \(RGB\) values using given decoding colour component transfer function (Decoding CCTF). |
DECODING_CCTFS |
Supported decoding colour component transfer functions (Decoding CCTFs), a collection of the functions defined by colour.LOG_DECODING_CURVES , colour.EOTFS , colour.OETFS_REVERSE attributes and 3 gamma decoding functions (2.2, 2.4, 2.6). |
Opto-Electronic Transfer Functions¶
colour
oetf (value[, function]) |
Encodes estimated tristimulus values in a scene to \(R'G'B'\) video component signal value using given opto-electronic transfer function (OETF / OECF). |
OETFS |
Supported opto-electrical transfer functions (OETFs / OECFs). |
oetf_reverse (value[, function]) |
Decodes \(R'G'B'\) video component signal value to tristimulus values at the display using given reverse opto-electronic transfer function (OETF / OECF). |
OETFS_REVERSE |
Supported reverse opto-electrical transfer functions (OETFs / OECFs). |
colour.models
oetf_ARIBSTDB67 (E[, r, constants]) |
Defines ARIB STD-B67 (Hybrid Log-Gamma) opto-electrical transfer function (OETF / OECF). |
oetf_reverse_ARIBSTDB67 (E_p[, r, constants]) |
Defines ARIB STD-B67 (Hybrid Log-Gamma) reverse opto-electrical transfer function (OETF / OECF). |
oetf_DICOMGSDF (L[, out_int]) |
Defines the DICOM - Grayscale Standard Display Function opto-electronic transfer function (OETF / OECF). |
oetf_BT2020 (E[, is_12_bits_system, constants]) |
Defines Recommendation ITU-R BT.2020 opto-electrical transfer function (OETF / OECF). |
oetf_BT2100_HLG (E) |
Defines Recommendation ITU-R BT.2100 Reference HLG opto-electrical transfer function (OETF / OECF). |
oetf_reverse_BT2100_HLG (E) |
Defines Recommendation ITU-R BT.2100 Reference HLG reverse opto-electrical transfer function (OETF / OECF). |
oetf_BT2100_PQ (E) |
Defines Recommendation ITU-R BT.2100 Reference PQ opto-electrical transfer function (OETF / OECF). |
oetf_reverse_BT2100_PQ (E_p) |
Defines Recommendation ITU-R BT.2100 Reference PQ reverse opto-electrical transfer function (OETF / OECF). |
oetf_BT601 (L) |
Defines Recommendation ITU-R BT.601-7 opto-electronic transfer function (OETF / OECF). |
oetf_reverse_BT601 (E) |
Defines Recommendation ITU-R BT.601-7 reverse opto-electronic transfer function (OETF / OECF). |
oetf_BT709 (L) |
Defines Recommendation ITU-R BT.709-6 opto-electronic transfer function (OETF / OECF). |
oetf_reverse_BT709 (V) |
Defines Recommendation ITU-R BT.709-6 reverse opto-electronic transfer function (OETF / OECF). |
oetf_ProPhotoRGB (X[, bit_depth, out_int]) |
Defines the ROMM RGB encoding opto-electronic transfer function (OETF / OECF). |
oetf_RIMMRGB (X[, bit_depth, out_int, E_clip]) |
Defines the RIMM RGB encoding opto-electronic transfer function (OETF / OECF). |
oetf_ROMMRGB (X[, bit_depth, out_int]) |
Defines the ROMM RGB encoding opto-electronic transfer function (OETF / OECF). |
oetf_SMPTE240M (L_c) |
Defines SMPTE 240M opto-electrical transfer function (OETF / OECF). |
oetf_ST2084 (C[, L_p, constants]) |
Defines SMPTE ST 2084:2014 optimised perceptual opto-electronic transfer function (OETF / OECF). |
oetf_sRGB (L) |
Defines the sRGB colourspace opto-electronic transfer function (OETF / OECF). |
oetf_reverse_sRGB (V) |
Defines the sRGB colourspace reverse opto-electronic transfer function (OETF / OECF). |
Ancillary Objects
colour
gamma_function (a[, exponent, …]) |
Defines a typical gamma encoding / decoding function. |
linear_function (a) |
Defines a typical linear encoding / decoding function, essentially a pass-through function. |
Electro-Optical Transfer Functions¶
colour
eotf (value[, function]) |
Decodes \(R'G'B'\) video component signal value to tristimulus values at the display using given electro-optical transfer function (EOTF / EOCF). |
EOTFS |
Supported electro-optical transfer functions (EOTFs / EOCFs). |
eotf_reverse (value[, function]) |
Encodes estimated tristimulus values in a scene to \(R'G'B'\) video component signal value using given reverse electro-optical transfer function (EOTF / EOCF). |
EOTFS_REVERSE |
Supported reverse electro-optical transfer functions (EOTFs / EOCFs). |
colour.models
eotf_DCDM (XYZ_p[, in_int]) |
Defines the DCDM electro-optical transfer function (EOTF / EOCF). |
eotf_reverse_DCDM (XYZ[, out_int]) |
Defines the DCDM reverse electro-optical transfer function (EOTF / EOCF). |
eotf_DICOMGSDF (J[, in_int]) |
Defines the DICOM - Grayscale Standard Display Function electro-optical transfer function (EOTF / EOCF). |
eotf_BT1886 (V[, L_B, L_W]) |
Defines Recommendation ITU-R BT.1886 electro-optical transfer function (EOTF / EOCF). |
eotf_reverse_BT1886 (L[, L_B, L_W]) |
Defines Recommendation ITU-R BT.1886 reverse electro-optical transfer function (EOTF / EOCF). |
eotf_BT2020 (E_p[, is_12_bits_system, constants]) |
Defines Recommendation ITU-R BT.2020 electro-optical transfer function (EOTF / EOCF). |
eotf_BT2100_HLG (E_p[, L_B, L_W, gamma]) |
Defines Recommendation ITU-R BT.2100 Reference HLG electro-optical transfer function (EOTF / EOCF). |
eotf_reverse_BT2100_HLG (F_D[, L_B, L_W, gamma]) |
Defines Recommendation ITU-R BT.2100 Reference HLG reverse electro-optical transfer function (EOTF / EOCF). |
eotf_BT2100_PQ (E_p) |
Defines Recommendation ITU-R BT.2100 Reference PQ electro-optical transfer function (EOTF / EOCF). |
eotf_reverse_BT2100_PQ (F_D) |
Defines Recommendation ITU-R BT.2100 Reference PQ reverse electro-optical transfer function (EOTF / EOCF). |
eotf_ProPhotoRGB (X_p[, bit_depth, in_int]) |
Defines the ROMM RGB encoding electro-optical transfer function (EOTF / EOCF). |
eotf_RIMMRGB (X_p[, bit_depth, in_int, E_clip]) |
Defines the RIMM RGB encoding electro-optical transfer function (EOTF / EOCF). |
eotf_ROMMRGB (X_p[, bit_depth, in_int]) |
Defines the ROMM RGB encoding electro-optical transfer function (EOTF / EOCF). |
eotf_SMPTE240M (V_r) |
Defines SMPTE 240M electro-optical transfer function (EOTF / EOCF). |
eotf_ST2084 (N[, L_p, constants]) |
Defines SMPTE ST 2084:2014 optimised perceptual electro-optical transfer function (EOTF / EOCF). |
Opto-Optical Transfer Functions¶
colour
ootf (value[, function]) |
Maps relative scene linear light to display linear light using given opto-optical transfer function (OOTF / OOCF). |
OOTFS |
Supported opto-optical transfer functions (OOTFs / OOCFs). |
ootf_reverse (value[, function]) |
Maps relative display linear light to scene linear light using given reverse opto-optical transfer function (OOTF / OOCF). |
OOTFS_REVERSE |
Supported reverse opto-optical transfer functions (OOTFs / OOCFs). |
colour.models
ootf_BT2100_HLG (E[, L_B, L_W, gamma]) |
Defines Recommendation ITU-R BT.2100 Reference HLG opto-optical transfer function (OOTF / OOCF). |
ootf_reverse_BT2100_HLG (F_D[, L_B, L_W, gamma]) |
Defines Recommendation ITU-R BT.2100 Reference HLG reverse opto-optical transfer function (OOTF / OOCF). |
ootf_BT2100_PQ (E) |
Defines Recommendation ITU-R BT.2100 Reference PQ opto-optical transfer function (OOTF / OOCF). |
ootf_reverse_BT2100_PQ (F_D) |
Defines Recommendation ITU-R BT.2100 Reference PQ reverse opto-optical transfer function (OOTF / OOCF). |
Log Encoding and Decoding Curves¶
colour
log_encoding_curve (value[, curve]) |
Encodes linear-light values to \(R'G'B'\) video component signal value using given log curve. |
LOG_ENCODING_CURVES |
Supported log encoding curves. |
log_decoding_curve (value[, curve]) |
Decodes \(R'G'B'\) video component signal value to linear-light values using given log curve. |
LOG_DECODING_CURVES |
Supported log decoding curves. |
colour.models
log_encoding_ACEScc (lin_AP1) |
Defines the ACEScc colourspace log encoding / opto-electronic transfer function. |
log_decoding_ACEScc (ACEScc) |
Defines the ACEScc colourspace log decoding / electro-optical transfer function. |
log_encoding_ACEScct (lin_AP1[, constants]) |
Defines the ACEScct colourspace log encoding / opto-electronic transfer function. |
log_decoding_ACEScct (ACEScct[, constants]) |
Defines the ACEScct colourspace log decoding / electro-optical transfer function. |
log_encoding_ACESproxy (lin_AP1[, bit_depth, …]) |
Defines the ACESproxy colourspace log encoding curve / opto-electronic transfer function. |
log_decoding_ACESproxy (ACESproxy[, …]) |
Defines the ACESproxy colourspace log decoding curve / electro-optical transfer function. |
log_encoding_ALEXALogC (x[, firmware, method, EI]) |
Defines the ALEXA Log C log encoding curve / opto-electronic transfer function. |
log_decoding_ALEXALogC (t[, firmware, method, EI]) |
Defines the ALEXA Log C log decoding curve / electro-optical transfer function. |
log_encoding_CanonLog2 (x[, bit_depth, …]) |
Defines the Canon Log 2 log encoding curve / opto-electronic transfer function. |
log_decoding_CanonLog2 (clog2[, bit_depth, …]) |
Defines the Canon Log 2 log decoding curve / electro-optical transfer function. |
log_encoding_CanonLog3 (x[, bit_depth, …]) |
Defines the Canon Log 3 log encoding curve / opto-electronic transfer function. |
log_decoding_CanonLog3 (clog3[, bit_depth, …]) |
Defines the Canon Log 3 log decoding curve / electro-optical transfer function. |
log_encoding_CanonLog (x[, bit_depth, …]) |
Defines the Canon Log log encoding curve / opto-electronic transfer function. |
log_decoding_CanonLog (clog[, bit_depth, …]) |
Defines the Canon Log log decoding curve / electro-optical transfer function. |
log_encoding_Cineon (x[, black_offset]) |
Defines the Cineon log encoding curve / opto-electronic transfer function. |
log_decoding_Cineon (y[, black_offset]) |
Defines the Cineon log decoding curve / electro-optical transfer function. |
log_encoding_ERIMMRGB (X[, bit_depth, …]) |
Defines the ERIMM RGB log encoding curve / opto-electronic transfer function (OETF / OECF). |
log_decoding_ERIMMRGB (X_p[, bit_depth, …]) |
Defines the ERIMM RGB log decoding curve / electro-optical transfer function (EOTF / EOCF). |
log_encoding_Log3G10 (x[, legacy_curve]) |
Defines the Log3G10 log encoding curve / opto-electronic transfer function. |
log_decoding_Log3G10 (y[, legacy_curve]) |
Defines the Log3G10 log decoding curve / electro-optical transfer function. |
log_encoding_Log3G12 (x) |
Defines the Log3G12 log encoding curve / opto-electronic transfer function. |
log_decoding_Log3G12 (y) |
Defines the Log3G12 log decoding curve / electro-optical transfer function. |
log_encoding_Panalog (x[, black_offset]) |
Defines the Panalog log encoding curve / opto-electronic transfer function. |
log_decoding_Panalog (y[, black_offset]) |
Defines the Panalog log decoding curve / electro-optical transfer function. |
log_encoding_PivotedLog (x[, log_reference, …]) |
Defines the Josh Pines style Pivoted Log log encoding curve / opto-electronic transfer function. |
log_decoding_PivotedLog (y[, log_reference, …]) |
Defines the Josh Pines style Pivoted Log log decoding curve / electro-optical transfer function. |
log_encoding_Protune (x) |
Defines the Protune log encoding curve / opto-electronic transfer function. |
log_decoding_Protune (y) |
Defines the Protune log decoding curve / electro-optical transfer function. |
log_encoding_REDLog (x[, black_offset]) |
Defines the REDLog log encoding curve / opto-electronic transfer function. |
log_decoding_REDLog (y[, black_offset]) |
Defines the REDLog log decoding curve / electro-optical transfer function. |
log_encoding_REDLogFilm (x[, black_offset]) |
Defines the REDLogFilm log encoding curve / opto-electronic transfer function. |
log_decoding_REDLogFilm (y[, black_offset]) |
Defines the REDLogFilm log decoding curve / electro-optical transfer function. |
log_encoding_SLog (x[, bit_depth, out_legal, …]) |
Defines the Sony S-Log log encoding curve / opto-electronic transfer function. |
log_decoding_SLog (y[, bit_depth, in_legal, …]) |
Defines the Sony S-Log log decoding curve / electro-optical transfer function. |
log_encoding_SLog2 (x[, bit_depth, …]) |
Defines the Sony S-Log2 log encoding curve / opto-electronic transfer function. |
log_decoding_SLog2 (y[, bit_depth, in_legal, …]) |
Defines the Sony S-Log2 log decoding curve / electro-optical transfer function. |
log_encoding_SLog3 (x[, bit_depth, …]) |
Defines the Sony S-Log3 log encoding curve / opto-electronic transfer function. |
log_decoding_SLog3 (y[, bit_depth, in_legal, …]) |
Defines the Sony S-Log3 log decoding curve / electro-optical transfer function. |
log_encoding_VLog (L_in[, bit_depth, …]) |
Defines the Panasonic V-Log log encoding curve / opto-electronic transfer function. |
log_decoding_VLog (V_out[, bit_depth, …]) |
Defines the Panasonic V-Log log decoding curve / electro-optical transfer function. |
log_encoding_ViperLog (x) |
Defines the Viper Log log encoding curve / opto-electronic transfer function. |
log_decoding_ViperLog (y) |
Defines the Viper Log log decoding curve / electro-optical transfer function. |
ACES Spectral Conversion¶
colour
sd_to_aces_relative_exposure_values (sd[, …]) |
Converts given spectral distribution to ACES2065-1 colourspace relative exposure values. |
Ancillary Objects
colour.models
ACES_RICD |
Implements support for the CIE RGB colour matching functions. |
Colour Encodings¶
Y’CbCr Colour Encoding¶
colour
RGB_to_YCbCr (RGB[, K, in_bits, in_legal, …]) |
Converts an array of R’G’B’ values to the corresponding Y’CbCr colour encoding values array. |
YCbCr_to_RGB (YCbCr[, K, in_bits, in_legal, …]) |
Converts an array of Y’CbCr colour encoding values to the corresponding R’G’B’ values array. |
YCBCR_WEIGHTS |
Implements a case-insensitive mutable mapping / dict object. |
RGB_to_YcCbcCrc (RGB[, out_bits, out_legal, …]) |
Converts an array of RGB linear values to the corresponding Yc’Cbc’Crc’ colour encoding values array. |
YcCbcCrc_to_RGB (YcCbcCrc[, in_bits, …]) |
Converts an array of Yc’Cbc’Crc’ colour encoding values to the corresponding RGB array of linear values. |
Ancillary Objects
colour
full_to_legal (CV[, bit_depth, in_int, out_int]) |
Converts given code value \(CV\) or float equivalent of a code value at a given bit depth from full range (full swing) to legal range (studio swing). |
legal_to_full (CV[, bit_depth, in_int, out_int]) |
Converts given code value \(CV\) or float equivalent of a code value at a given bit depth from legal range (studio swing) to full range (full swing). |
CV_range ([bit_depth, is_legal, is_int]) |
Returns the code value \(CV\) range for given bit depth, range legality and representation. |
YCoCg Colour Encoding¶
colour
RGB_to_YCoCg (RGB) |
Converts an array of R’G’B’ values to the corresponding YCoCg colour encoding values array. |
YCoCg_to_RGB (YCoCg) |
Converts an array of YCoCg colour encoding values to the corresponding R’G’B’ values array. |
\(IC_TC_P\) Colour Encoding¶
colour
RGB_to_ICTCP (RGB[, L_p]) |
Converts from ITU-R BT.2020 colourspace to \(IC_TC_P\) colour encoding. |
ICTCP_to_RGB (ICTCP[, L_p]) |
Converts from \(IC_TC_P\) colour encoding to ITU-R BT.2020 colourspace. |
RGB Representations¶
Prismatic Colourspace¶
colour
RGB_to_Prismatic (RGB) |
Converts from RGB colourspace to Prismatic \(L\rho\gamma\beta\) colourspace array. |
Prismatic_to_RGB (Lrgb) |
Converts from Prismatic \(L\rho\gamma\beta\) colourspace array to RGB colourspace. |
HSV Colourspace¶
colour
RGB_to_HSV (RGB) |
Converts from RGB colourspace to HSV colourspace. |
HSV_to_RGB (HSV) |
Converts from HSV colourspace to RGB colourspace. |
HSL Colourspace¶
colour
RGB_to_HSL (RGB) |
Converts from RGB colourspace to HSL colourspace. |
HSL_to_RGB (HSL) |
Converts from HSL colourspace to RGB colourspace. |
CMY Colourspace¶
colour
RGB_to_CMY (RGB) |
Converts from RGB colourspace to CMY colourspace. |
CMY_to_RGB (CMY) |
Converts from CMY colourspace to CMY colourspace. |
CMY_to_CMYK (CMY) |
Converts from CMY colourspace to CMYK colourspace. |
CMYK_to_CMY (CMYK) |
Converts from CMYK colourspace to CMY colourspace. |