colour.log_decoding¶
- colour.log_decoding(value, function='Cineon', **kwargs)[source]¶
Decodes \(R'G'B'\) video component signal value to linear-light values using given log function.
- Parameters
value (numeric or array_like) – Value.
function (unicode, optional) – {‘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’, ‘Panalog’, ‘PLog’, ‘Protune’, ‘REDLog’, ‘REDLogFilm’, ‘S-Log’, ‘S-Log2’, ‘S-Log3’, ‘T-Log’, ‘V-Log’, ‘ViperLog’}, Computation function.
EI (int, optional) – {
colour.models.log_decoding_ALEXALogC()}, Ei.E_clip (numeric, optional) – {
colour.models.log_decoding_ERIMMRGB()}, Maximum exposure limit.E_min (numeric, optional) – {
colour.models.log_decoding_ERIMMRGB()}, Minimum exposure limit.I_max (numeric, optional) – {
colour.models.log_decoding_ERIMMRGB()}, Maximum code value: 255, 4095 and 650535 for respectively 8-bit, 12-bit and 16-bit per channel.bit_depth (int, optional) – {
colour.models.log_decoding_ACESproxy(),colour.models.log_decoding_SLog(),colour.models.log_decoding_SLog2()}, {8, 10, 12}, Bit depth used for conversion, ACESproxy uses {10, 12}.black_offset (numeric or array_like) – {
colour.models.log_decoding_Cineon(),colour.models.log_decoding_Panalog(),colour.models.log_decoding_REDLog(),colour.models.log_decoding_REDLogFilm()}, Black offset.density_per_code_value (numeric or array_like) – {
colour.models.log_decoding_PivotedLog()}, Density per code value.firmware (unicode, optional) – {
colour.models.log_decoding_ALEXALogC()}, {‘SUP 3.x’, ‘SUP 2.x’}, Alexa firmware version.in_normalised_code_value (bool, optional) – {
colour.models.log_decoding_SLog(),colour.models.log_decoding_SLog2(),colour.models.log_decoding_SLog3()}, Whether the non-linear Sony S-Log, Sony S-Log2 or Sony S-Log3 data \(y\) is encoded as normalised code values.linear_reference (numeric or array_like) – {
colour.models.log_decoding_PivotedLog()}, Linear reference.log_reference (numeric or array_like) – {
colour.models.log_decoding_PivotedLog()}, Log reference.method (unicode, optional) – {
colour.models.log_decoding_Log3G10()}, Whether to use the Log3G10 v1 or v2 log encoding curve.negative_gamma (numeric or array_like) – {
colour.models.log_decoding_PivotedLog()}, Negative gamma.out_reflection (bool, optional) – {
colour.models.log_decoding_SLog(),colour.models.log_decoding_SLog2()}, Whether the light level \(x\) to a camera is reflection.method – {
colour.models.log_decoding_ALEXALogC()}, {‘Linear Scene Exposure Factor’, ‘Normalised Sensor Signal’}, Conversion method.
- Returns
Log value.
- Return type
numeric or 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...