colour.log_decoding#

colour.log_decoding(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['ACEScc', 'ACEScct', 'ACESproxy', 'ARRI LogC3', 'ARRI LogC4', 'Canon Log 2', 'Canon Log 3', 'Canon Log', 'Cineon', 'D-Log', 'ERIMM RGB', 'F-Log', 'F-Log2', 'Filmic Pro 6', 'L-Log', 'Log2', 'Log3G10', 'Log3G12', 'N-Log', 'PLog', 'Panalog', 'Protune', 'REDLog', 'REDLogFilm', 'S-Log', 'S-Log2', 'S-Log3', 'T-Log', 'V-Log', 'ViperLog'], str] = 'Cineon', **kwargs: Any) → numpy.ndarray[Any, numpy.dtype[Union[numpy.float16, numpy.float32, numpy.float64]]][source]#

Decode \(R'G'B'\) video component signal value to scene-referred exposure values using given log decoding function.

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]]]) – Log values.
function (Union[Literal['ACEScc', 'ACEScct', 'ACESproxy', 'ARRI LogC3', 'ARRI LogC4', 'Canon Log 2', 'Canon Log 3', 'Canon Log', 'Cineon', 'D-Log', 'ERIMM RGB', 'F-Log', 'F-Log2', 'Filmic Pro 6', 'L-Log', 'Log2', 'Log3G10', 'Log3G12', 'N-Log', 'PLog', 'Panalog', 'Protune', 'REDLog', 'REDLogFilm', 'S-Log', 'S-Log2', 'S-Log3', 'T-Log', 'V-Log', 'ViperLog'], str]) – Log decoding function.
kwargs (Any) – {colour.models.log_decoding_ACEScc(), colour.models.log_decoding_ACEScct(), colour.models.log_decoding_ACESproxy(), colour.models.log_decoding_ARRILogC3(), colour.models.log_decoding_ARRILogC4(), colour.models.log_decoding_CanonLog2(), colour.models.log_decoding_CanonLog3(), colour.models.log_decoding_CanonLog(), colour.models.log_decoding_Cineon(), colour.models.log_decoding_DJIDLog(), colour.models.log_decoding_ERIMMRGB(), colour.models.log_decoding_FLog(), colour.models.log_decoding_FLog2(), colour.models.log_decoding_FilmicPro6(), colour.models.log_decoding_LLog(), colour.models.log_decoding_Log2(), colour.models.log_decoding_Log3G10(), colour.models.log_decoding_Log3G12(), colour.models.log_decoding_NLog(), colour.models.log_decoding_PivotedLog(), colour.models.log_decoding_Panalog(), colour.models.log_decoding_Protune(), colour.models.log_decoding_REDLog(), colour.models.log_decoding_REDLogFilm(), colour.models.log_decoding_SLog(), colour.models.log_decoding_SLog2(), colour.models.log_decoding_SLog3(), colour.models.log_decoding_FilmLightTLog(), colour.models.log_decoding_VLog(), colour.models.log_decoding_ViperLog()}, See the documentation of the previously listed definitions.

Returns

Scene-referred exposure values.

Return type

numpy.ndarray

Examples

>>> log_decoding(0.457319613085418)  
0.1...
>>> log_decoding(0.413588402492442, function="ACEScc")
... 
0.1...
>>> log_decoding(0.391006842619746, function="PLog", log_reference=400)
... 
0.1...
>>> log_decoding(0.376512722254600, function="S-Log")
... 
0.1...