applies a tone mapping to color values in image so as to make variations of luminance visible even in small intervals of the dynamic range.


maps colors by compressing the overall range of luminance values by a factor c.


applies a mapping only to colors whose initial luminance lies in the specified range.


takes the specified range of colors and compresses their overall luminance values by a factor c.


uses different compression factors ci for different ranges rangei.


uses the color compensation factor s to correct for saturation distortion introduced during tone mapping.

Details and Options

  • Tone mapping is typically used to represent a high dynamic range image on a low dynamic range screen. ColorToneMapping compresses the range of luminance values while preserving local spatial details.
  • ColorToneMapping works with grayscale and color images. Images with ColorSpace->Automatic are converted to "RGB".
  • The compression factor c ranges from 0 to 1. The default setting is c=1/2.
  • With c=0, minimal compression is performed. With c=1, extreme compression is performed, which typically results in a poorly contrasted, nonrealistic image.
  • Pixel luminance interval range can be in one of the following forms:
  • Allfull luminance interval (default)
    {min,max}interval ranging from min to max
    "Low"dark luminance values smaller than
    "Medium"intermediate luminance values ranging from to
    "High"high luminance values greater than
  • With overlapping ranges {rangei,ci} and {rangej,cj}, the maximum compression is used for the overlapping part. »
  • The color compensation factor s can be any non-negative value, with typical values being in the range from to .
  • The following are values and effects of the different values for s:
  • Automaticbased on compression factor and method (default)
    0completely desaturate colors, i.e. grayscale
    0<s<1desaturate colors
    1no effect
    s>1saturate colors
  • ColorToneMapping takes a Method option. Possible settings include:
  • "RGB"global mapping of RGB channels
    "Luminance"global mapping of luminance
    "LogLuminance"global mapping of luminance logarithm
    "DodgingAndBurning"local digital dodging and burning
    {"BaseLuminance",λ}local scaling of the base luminance, combined with details multiplied by λ (default)


open allclose all

Basic Examples  (1)

Apply tone mapping to a high dynamic range image:

Click for copyable input
Click for copyable input

Scope  (8)

Options  (3)

Applications  (1)

See Also

ImageAdjust  HistogramTransform  ImageExposureCombine  ColorBalance  BrightnessEqualize  ImageLevels  ImageClip

Introduced in 2015