colour.log_encoding

colour.log_encoding(value: ArrayLike, function: LiteralLogEncoding | str = 'Cineon', **kwargs: Any) → NDArrayFloat | NDArrayInt

Apply the specified log encoding opto-electronic transfer function (OETF).

Parameters:

• value (ArrayLike) – Scene-linear value.

• function (LiteralLogEncoding | str) – Log encoding function.

• kwargs (Any) – {colour.models.log_encoding_ACEScc(), colour.models.log_encoding_ACEScct(), colour.models.log_encoding_ACESproxy(), colour.models.log_encoding_AppleLogProfile(), colour.models.log_encoding_ARRILogC3(), colour.models.log_encoding_ARRILogC4(), colour.models.log_encoding_CanonLog2(), colour.models.log_encoding_CanonLog3(), colour.models.log_encoding_CanonLog(), colour.models.log_encoding_Cineon(), colour.models.log_encoding_DJIDLog(), colour.models.log_encoding_ERIMMRGB(), colour.models.log_encoding_FLog(), colour.models.log_encoding_FLog2(), colour.models.log_encoding_FilmicPro6(), colour.models.log_encoding_LLog(), colour.models.log_encoding_Log2(), colour.models.log_encoding_Log3G10(), colour.models.log_encoding_Log3G12(), colour.models.log_encoding_MiLog(), colour.models.log_encoding_NLog(), colour.models.log_encoding_OPPOOLog(), colour.models.log_encoding_PivotedLog(), colour.models.log_encoding_Panalog(), colour.models.log_encoding_Protune(), colour.models.log_encoding_REDLog(), colour.models.log_encoding_REDLogFilm(), colour.models.log_encoding_SLog(), colour.models.log_encoding_SLog2(), colour.models.log_encoding_SLog3(), colour.models.log_encoding_FilmLightTLog(), colour.models.log_encoding_VLog(), colour.models.log_encoding_ViperLog()}, See the documentation of the previously listed definitions.

Returns:

Logarithmic encoded value.

Return type:

numpy.ndarray

Examples

>>> log_encoding(0.18)
np.float64(0.4573196...)
>>> log_encoding(0.18, function="ACEScc")
np.float64(0.4135884...)
>>> log_encoding(0.18, function="PLog", log_reference=400)
...
np.float64(0.3910068...)
>>> log_encoding(0.18, function="S-Log")
np.float64(0.3849708...)