colour.oetf_inverse

colour.oetf_inverse(value: _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | bool | int | float | complex | str | bytes | _NestedSequence[bool | int | float | complex | str | bytes], function: 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'] | str = 'ITU-R BT.709', **kwargs: Any) → ndarray[Any, dtype[float16 | float32 | float64]]

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

Parameters:

• value (_SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | bool | int | float | complex | str | bytes | _NestedSequence[bool | int | float | complex | str | bytes]) – Value.

• function (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'] | 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_BT2020(), colour.models.oetf_inverse_BT2100_HLG(), colour.models.oetf_inverse_BT2100_PQ(), 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.ndarray

Examples

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