colour.log_decoding¶
- colour.log_decoding(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['ACEScc', 'ACEScct', 'ACESproxy', 'ALEXA Log C', 'Canon Log 2', 'Canon Log 3', 'Canon Log', 'Cineon', 'D-Log', 'ERIMM RGB', 'F-Log', 'Filmic Pro 6', '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) Union[float, numpy.ndarray] [source]¶
Decode \(R'G'B'\) video component signal value to scene-referred exposure values using given log decoding function.
- 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]]]) – Log values.
function (Union[Literal['ACEScc', 'ACEScct', 'ACESproxy', 'ALEXA Log C', 'Canon Log 2', 'Canon Log 3', 'Canon Log', 'Cineon', 'D-Log', 'ERIMM RGB', 'F-Log', 'Filmic Pro 6', '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_ALEXALogC()
,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_FilmicPro6()
,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
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...