colour_hdri.tonemapping_operator_filmic#

colour_hdri.tonemapping_operator_filmic(RGB: ArrayLike, shoulder_strength: float = 0.22, linear_strength: float = 0.3, linear_angle: float = 0.1, toe_strength: float = 0.2, toe_numerator: float = 0.01, toe_denominator: float = 0.3, exposure_bias: float = 2, linear_whitepoint: float = 11.2) → NDArrayFloat[source]#

Perform given RGB array tonemapping using Habble (2010) method.

Parameters:

  • RGB (ArrayLike) – RGB array to perform tonemapping onto.

  • shoulder_strength (float) – Shoulder strength.

  • linear_strength (float) – Linear strength.

  • linear_angle (float) – Linear angle.

  • toe_strength (float) – Toe strength.

  • toe_numerator (float) – Toe numerator.

  • toe_denominator (float) – Toe denominator.

  • exposure_bias (float) – Exposure bias.

  • linear_whitepoint (float) – Linear whitepoint.

Returns:

Tonemapped RGB array.

Return type:

numpy.ndarray

References

[Hab10a], [Hab10b]

Examples

>>> tonemapping_operator_filmic(
...     np.array(
...         [
...             [
...                 [0.48046875, 0.35156256, 0.23632812],
...                 [1.39843753, 0.55468757, 0.39062594],
...             ],
...             [
...                 [4.40625388, 2.15625895, 1.34375372],
...                 [6.59375023, 3.43751395, 2.21875829],
...             ],
...         ]
...     )
... )  
array([[[ 0.4507954...,  0.3619673...,  0.2617269...],
        [ 0.7567191...,  0.4933310...,  0.3911730...]],

       [[ 0.9725554...,  0.8557374...,  0.7465713...],
        [ 1.0158782...,  0.9382937...,  0.8615161...]]])