colour.oetf#

colour.oetf(value: Union[numpy._typing._array_like._SupportsArray[numpy.dtype[Any]], numpy._typing._nested_sequence._NestedSequence[numpy._typing._array_like._SupportsArray[numpy.dtype[Any]]], bool, int, float, 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.2020', 'ITU-R BT.2100 HLG', 'ITU-R BT.2100 PQ', 'ITU-R BT.601', 'ITU-R BT.709', 'ITU-T H.273 Log', 'ITU-T H.273 Log Sqrt', 'ITU-T H.273 IEC 61966-2', 'SMPTE 240M'], str] = 'ITU-R BT.709', **kwargs: Any) → numpy.ndarray[Any, numpy.dtype[Union[numpy.float16, numpy.float32, numpy.float64]]][source]#

Encode estimated tristimulus values in a scene to \(R'G'B'\) video component signal value using given opto-electronic transfer function (OETF).

Parameters

value (Union[numpy._typing._array_like._SupportsArray[numpy.dtype[Any]], numpy._typing._nested_sequence._NestedSequence[numpy._typing._array_like._SupportsArray[numpy.dtype[Any]]], bool, int, float, 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.2020', 'ITU-R BT.2100 HLG', 'ITU-R BT.2100 PQ', 'ITU-R BT.601', 'ITU-R BT.709', 'ITU-T H.273 Log', 'ITU-T H.273 Log Sqrt', 'ITU-T H.273 IEC 61966-2', 'SMPTE 240M'], str]) – Opto-electronic transfer function (OETF).
kwargs (Any) – {colour.models.oetf_ARIBSTDB67(), colour.models.oetf_BlackmagicFilmGeneration5(), colour.models.oetf_DaVinciIntermediate(), colour.models.oetf_BT2020(), colour.models.oetf_BT2100_HLG(), colour.models.oetf_BT2100_PQ(), colour.models.oetf_BT601(), colour.models.oetf_BT709(), colour.models.oetf_SMPTE240M()}, See the documentation of the previously listed definitions.

Returns

\(R'G'B'\) video component signal value.

Return type

numpy.ndarray

Examples

>>> oetf(0.18)  
0.4090077...
>>> oetf(0.18, function="ITU-R BT.601")  
0.4090077...