colour.oetf_inverse¶

colour.oetf_inverse(value: Union[float, numpy.typing._array_like._SupportsArray[numpy.dtype], numpy.typing._nested_sequence._NestedSequence[numpy.typing._array_like._SupportsArray[numpy.dtype]], bool, int, complex, str, bytes, numpy.typing._nested_sequence._NestedSequence[Union[bool, int, float, complex, str, bytes]]], function: Union[Literal['ARIB STD-B67', 'Blackmagic Film Generation 5', 'DaVinci Intermediate', 'ITU-R BT.2100 HLG', 'ITU-R BT.2100 PQ', 'ITU-R BT.601', 'ITU-R BT.709'], str] = 'ITU-R BT.709', **kwargs: Any) → Union[float, numpy.ndarray][source]¶

Decode \(R'G'B'\) video component signal value to tristimulus values at the display using given inverse opto-electronic transfer function (OETF).

Parameters

value (Union[float, numpy.typing._array_like._SupportsArray[numpy.dtype], numpy.typing._nested_sequence._NestedSequence[numpy.typing._array_like._SupportsArray[numpy.dtype]], bool, int, complex, str, bytes, numpy.typing._nested_sequence._NestedSequence[Union[bool, int, float, complex, str, bytes]]]) – Value.
function (Union[Literal['ARIB STD-B67', 'Blackmagic Film Generation 5', 'DaVinci Intermediate', 'ITU-R BT.2100 HLG', 'ITU-R BT.2100 PQ', 'ITU-R BT.601', 'ITU-R BT.709'], str]) – Inverse opto-electronic transfer function (OETF).
kwargs (Any) – {colour.models.oetf_inverse_ARIBSTDB67(), colour.models.oetf_inverse_BlackmagicFilmGeneration5(), colour.models.oetf_inverse_DaVinciIntermediate(), colour.models.oetf_inverse_HLG_BT2100(), colour.models.oetf_inverse_PQ_BT2100(), colour.models.oetf_inverse_BT601(), colour.models.oetf_inverse_BT709()}, See the documentation of the previously listed definitions.

Returns

Tristimulus values at the display.

Return type

numpy.floating or numpy.ndarray

Examples

>>> oetf_inverse(0.409007728864150)  
0.1...
>>> oetf_inverse(  
...     0.409007728864150, function='ITU-R BT.601')
0.1...

colour.OETFS

colour.OETF_INVERSES