.. _stdlib_color_mapping:

=============
Color mapping
=============

.. das:module:: color_mapping

Module color_mapping



++++++++++++
Tone mapping
++++++++++++

  *  :ref:`tone_aces_fit (value: float3) : float3 <function-color_mapping_tone_aces_fit_float3>`
  *  :ref:`tone_pbr_neutral (value: float3) : float3 <function-color_mapping_tone_pbr_neutral_float3>`
  *  :ref:`tone_reinhard (value: float3) : float3 <function-color_mapping_tone_reinhard_float3>`

.. _function-color_mapping_tone_aces_fit_float3:

.. das:function:: tone_aces_fit(value: float3) : float3

Apply the Narkowicz ACES approximation, clamping negative
input to zero. This is not a full ACES transform.


:Arguments: * **value** : float3

.. _function-color_mapping_tone_pbr_neutral_float3:

.. das:function:: tone_pbr_neutral(value: float3) : float3

Apply Khronos PBR Neutral to nonnegative RGB, compressing and
desaturating highlights together.


:Arguments: * **value** : float3

.. _function-color_mapping_tone_reinhard_float3:

.. das:function:: tone_reinhard(value: float3) : float3

Compress RGB channels independently with the Reinhard curve;
negative input is clamped to zero.


:Arguments: * **value** : float3


+++++++++++++++++++++++
sRGB transfer functions
+++++++++++++++++++++++

  *  :ref:`color_srgb_decode (value: float3) : float3 <function-color_mapping_color_srgb_decode_float3>`
  *  :ref:`color_srgb_decode_channel (value: float) : float <function-color_mapping_color_srgb_decode_channel_float>`
  *  :ref:`color_srgb_encode (value: float3) : float3 <function-color_mapping_color_srgb_encode_float3>`
  *  :ref:`color_srgb_encode_channel (value: float) : float <function-color_mapping_color_srgb_encode_channel_float>`

.. _function-color_mapping_color_srgb_decode_float3:

.. das:function:: color_srgb_decode(value: float3) : float3

Decode nonnegative sRGB channels independently to linear RGB;
values above one remain above one.


:Arguments: * **value** : float3

.. _function-color_mapping_color_srgb_decode_channel_float:

.. das:function:: color_srgb_decode_channel(value: float) : float

Decode one sRGB channel to linear light, clamping negative
input to zero.


:Arguments: * **value** : float

.. _function-color_mapping_color_srgb_encode_float3:

.. das:function:: color_srgb_encode(value: float3) : float3

Encode nonnegative linear RGB with the sRGB transfer function;
values above one remain above one.


:Arguments: * **value** : float3

.. _function-color_mapping_color_srgb_encode_channel_float:

.. das:function:: color_srgb_encode_channel(value: float) : float

Encode one linear channel with the sRGB transfer function,
clamping negative input to zero.


:Arguments: * **value** : float