colour.log_encoding_curve¶

colour.log_encoding_curve(value, curve='Cineon', **kwargs)[source]¶

Encodes linear-light values to \(R'G'B'\) video component signal value using given log curve.

Other Parameters:
Parameters:	value (numeric or array_like) – Value. curve (unicode, optional) – {‘ACEScc’, ‘ACEScct’, ‘ACESproxy’, ‘ALEXA Log C’, ‘Canon Log 2’, ‘Canon Log 3’, ‘Canon Log’, ‘Cineon’, ‘D-Log’, ‘ERIMM RGB’, ‘Filmic Pro 6’, ‘Log3G10’, ‘Log3G12’, ‘Panalog’, ‘PLog’, ‘Protune’, ‘REDLog’, ‘REDLogFilm’, ‘S-Log’, ‘S-Log2’, ‘S-Log3’, ‘T-Log’, ‘V-Log’, ‘ViperLog’}, Computation curve.
	EI (int, optional) – {`colour.models.log_encoding_ALEXALogC()`}, Ei. E_clip (numeric, optional) – {`colour.models.log_encoding_ERIMMRGB()`}, Maximum exposure limit. E_min (numeric, optional) – {`colour.models.log_encoding_ERIMMRGB()`}, Minimum exposure limit. I_max (numeric, optional) – {`colour.models.log_encoding_ERIMMRGB()`}, Maximum code value: 255, 4095 and 650535 for respectively 8-bit, 12-bit and 16-bit per channel. bit_depth (unicode, optional) – {`colour.models.log_encoding_ACESproxy()`, `colour.models.log_encoding_SLog()`, `colour.models.log_encoding_SLog2()`}, {8, 10, 12}, Bit depth used for conversion, ACESproxy uses {10, 12}. black_offset (numeric or array_like) – {`colour.models.log_encoding_Cineon()`, `colour.models.log_encoding_Panalog()`, `colour.models.log_encoding_REDLog()`, `colour.models.log_encoding_REDLogFilm()`}, Black offset. density_per_code_value (numeric or array_like) – {`colour.models.log_encoding_PivotedLog()`}, Density per code value. firmware (unicode, optional) – {`colour.models.log_encoding_ALEXALogC()`}, {‘SUP 3.x’, ‘SUP 2.x’}, Alexa firmware version. in_reflection (bool, optional) – {`colour.models.log_encoding_SLog()`, `colour.models.log_encoding_SLog2()`}, Whether the light level \(x\) to a camera is reflection. linear_reference (numeric or array_like) – {`colour.models.log_encoding_PivotedLog()`}, Linear reference. log_reference (numeric or array_like) – {`colour.models.log_encoding_PivotedLog()`}, Log reference. out_legal (bool, optional) – {`colour.models.log_encoding_SLog()`, `colour.models.log_encoding_SLog2()`, `colour.models.log_encoding_SLog3()`}, Whether the non-linear Sony S-Log, Sony S-Log2 or Sony S-Log3 data \(y\) is encoded in legal range. negative_gamma (numeric or array_like) – {`colour.models.log_encoding_PivotedLog()`}, Negative gamma. method (unicode, optional) – {`colour.models.log_encoding_ALEXALogC()`}, {‘Linear Scene Exposure Factor’, ‘Normalised Sensor Signal’}, Conversion method.
Returns:	Log value.
Return type:	numeric or ndarray

Examples

>>> log_encoding_curve(0.18)  # doctest: +ELLIPSIS
0.4573196...
>>> log_encoding_curve(0.18, curve='ACEScc')  # doctest: +ELLIPSIS
0.4135884...
>>> log_encoding_curve(0.18, curve='PLog', log_reference=400)
... # doctest: +ELLIPSIS
0.3910068...
>>> log_encoding_curve(0.18, curve='S-Log')  # doctest: +ELLIPSIS
0.3849708...