colour.eotf¶

colour.eotf(value, function='ITU-R BT.1886', **kwargs)[source]¶

Decodes \(R'G'B'\) video component signal value to tristimulus values at the display using given electro-optical transfer function (EOTF / EOCF).

Parameters

value (numeric or array_like) – Value.
function (unicode, optional) – {‘ITU-R BT.1886’, ‘DCDM’, ‘DICOM GSDF’, ‘ITU-R BT.2020’, ‘ITU-R BT.2100 HLG’, ‘ITU-R BT.2100 PQ’, ‘SMPTE 240M’, ‘ST 2084’, ‘sRGB’}, Electro-optical transfer function (EOTF / EOCF).
E_clip (numeric, optional) – {colour.models.cctf_decoding_RIMMRGB()}, Maximum exposure level.
I_max (numeric, optional) – {colour.models.cctf_decoding_ROMMRGB(), colour.models.cctf_decoding_RIMMRGB()}, Maximum code value: 255, 4095 and 650535 for respectively 8-bit, 12-bit and 16-bit per channel.
L_B (numeric, optional) – {colour.models.eotf_BT1886(), colour.models.eotf_HLG_BT2100()}, Screen luminance for black.
L_W (numeric, optional) – {colour.models.eotf_BT1886(), colour.models.eotf_HLG_BT2100()}, Screen luminance for white.
L_p (numeric, optional) – {colour.models.eotf_ST2084()}, Display peak luminance \(cd/m^2\).
gamma (numeric, optional) – {colour.models.eotf_HLG_BT2100()}, System gamma value, 1.2 at the nominal display peak luminance of \(1000 cd/m^2\).
is_12_bits_system (bool, optional) – {colour.models.eotf_BT2020()}, ITU-R BT.2020 alpha and beta constants are used if system is not 12-bit.
method (unicode, optional) – {colour.models.eotf_HLG_BT2100()}, {‘ITU-R BT.2100-1’, ‘ITU-R BT.2100-2’}
out_int (bool, optional) – {colour.models.eotf_DCDM(), colour.models.eotf_DICOMGSDF()}, Whether to return value as integer code value or float equivalent of a code value at a given bit depth.

Returns

Tristimulus values at the display.

Return type

numeric or ndarray

Examples

>>> eotf(0.461356129500442)  
0.1...
>>> eotf(0.409007728864150, function='ITU-R BT.2020')
... 
0.1...
>>> eotf(0.182011532850008, function='ST 2084', L_p=1000)
... 
0.1...