Local Adjustments: Difference between revisions

From RawPedia
Jump to navigation Jump to search
(40 intermediate revisions by the same user not shown)
Line 16: Line 16:
</div>
</div>


The RT-spot algorithm uses shape detection based on ΔE (the change in the visual perception of two given colors) to select the parts of the image to be modified inside the ellipse or rectangle. The  reference values used for the shape detection algorithm are based on the average of the hue, chroma and luminance values inside the variable-diameter circle. This means that in full-image mode (and also in 'normal' or 'excluding' modes) these values and the subsequent shape detection can vary depending on the position of the circle.
The RT-spot algorithm uses shape detection based on ΔE (the change in the visual perception of two given colors) to select the parts of the image to be modified inside the ellipse or rectangle. The  reference values used for the shape detection algorithm are based on the average of the hue, chroma and luminance values inside the variable-diameter circle. This means that in full-image mode (and also in Normal or Excluding modes) these values and the subsequent shape detection can vary depending on the position of the circle.


The extent to which these modifications are applied can be finely controlled allowing for very precise selections. Further refinement is possible with additional parametric masks but the shape-detection algorithms should be sufficient for the vast majority of local editing requirements.  
The extent to which these modifications are applied can be finely controlled allowing for very precise selections. Further refinement is possible with additional parametric masks but the shape-detection algorithms should be sufficient for the vast majority of local editing requirements.  
RT-spots can also be used in 'Excluding' mode to prevent the algorithm from influencing certain parts of the image.
RT-spots can also be used in Excluding mode to prevent the algorithm from influencing certain parts of the image.
The modifications that can be carried out are extensive and incorporate most of the functions available in RawTherapee's global adjustment tools along with some additional tools available only in the Local Adjustments tab.
The modifications that can be carried out are extensive and incorporate most of the functions available in RawTherapee's global adjustment tools along with some additional tools available only in the Local Adjustments tab.


Note: provided the checkbox “Avoid color shift” in the “Settings” module has not been disabled, the following operations will be carried out on the data before and after any "RT Spot" is activated.
Note: provided the checkbox “Avoid color shift” in the Settings module has not been disabled, the following operations will be carried out on the data before and after any RT Spot is activated.
* a relative colorimetric correction to keep the data within gamut
* A relative colorimetric correction to keep the data within gamut.
* a Munsell correction using LUTs to ensure that the data remains linear and avoid hue shifts.
* A Munsell correction using LUTs to ensure that the data remains linear and avoid hue shifts.


The tools are grouped in the following modules (Tool name - position in pipeline):
The tools are grouped in the following modules (Tool name - position in pipeline):
Line 46: Line 46:
====Dynamic Range & Exposure - 10====
====Dynamic Range & Exposure - 10====


Modify exposure in L*a*b* space using Laplacian PDE algorithms to take into account dE and  minimize artifacts.
Modify exposure in L*a*b* space using Laplacian PDE algorithms to take into account deltaE and  minimize artifacts.
Laplacian operators are used because they are particularly good at detecting fine details but you do not need to understand how they work to use this tool!
Laplacian operators are used because they are particularly good at detecting fine details but you do not need to understand how they work to use this tool!


Line 67: Line 67:
====Dehaze & Retinex - 3====
====Dehaze & Retinex - 3====


Dehaze and Retinex (Advanced mode only). Useful for dehaze, local contrast with high values and simulation of 'clarity'.  
Dehaze and Retinex (Advanced mode only). Useful for dehaze, local contrast with high values and simulation of "clarity".  


====Sharpening - 8====
====Sharpening - 8====
Line 75: Line 75:
====Local Contrast & Wavelets - 8====
====Local Contrast & Wavelets - 8====


* Local Contrast: basically the same functions as "Local Contrast" in the "Detail" tab
* Local Contrast: basically the same functions as Local Contrast in the Detail tab.
* Wavelets: based on "Wavelet Levels" in the "Advanced" tab with essentially the same features (clarity, contrast, blur, etc., see documentation). Its use in "Local Adjustments" provides additional possibilities such as the removal of large blemishes, grease stains etc.
* Wavelets: based on Wavelet Levels in the Advanced tab with essentially the same features (clarity, contrast, blur, etc., see documentation). Its use in Local Adjustments provides additional possibilities such as the removal of large blemishes, grease stains etc.


====Contrast By Detail Levels - 4====
====Contrast By Detail Levels - 4====
Line 84: Line 84:
Each tool module can be toggled between Basic, Standard & Advanced modes. The default mode can be set in RawTherapee's Preferences window.
Each tool module can be toggled between Basic, Standard & Advanced modes. The default mode can be set in RawTherapee's Preferences window.


The examples in the next section are designed to give a brief overview of some of the ways the various tools can be used for local adjustments. However, if you prefer to explore the possibilities by yourself, then try setting the 'Default complexity for Local Adjustments' in the Preferences module to "Basic" and uncheck the "Show additional settings" checkbox at the top of the Local Adjustments module. This will give you a simplified yet powerful version of Local Adjustments.
The examples in the next section are designed to give an overview of some of the ways the various tools can be used for local adjustments. However, if you prefer to explore the possibilities by yourself, then try setting the “Default complexity for Local Adjustments” in the Preferences module to Basic and uncheck the "Show additional settings" checkbox at the top of the Local Adjustments module. This will give you a simplified yet powerful version of Local Adjustments.


Explore the capabilities of the "Color & Light", "Shadows/Highlights & Tone Equalizer" and "Vibrance & Warm/Cool" tools to start with and don't hesitate to try out the additional functionality by manually setting the complexity mode to "Standard" (in the combobox in the module you are working on).
Explore the capabilities of the Color & Light, "Shadows/Highlights & Tone Equalizer" and "Vibrance & Warm/Cool" tools to start with and don't hesitate to try out the additional functionality by manually setting the complexity mode to Standard (in the combobox in the module you are working on).


The "Color & Light" tool is extremely powerful and includes functions from both the "Color Toning>Color correction regions" module in the main-menu Color tab as well as the L*a*b* curves available in the Exposure tab.
The Color & Light tool is extremely powerful and includes functions from both the "Color Toning > Color correction regions" module in the main-menu Color tab as well as the L*a*b* curves available in the Exposure tab.


====Combining tools in a single spot====
====Combining tools in a single spot====
Most of the local-adjustment tools can be used together in the same RT-Spot. However, combinations of Log Encoding, Tone Mapping and Retinex should be avoided. This is because the output TIFF or JPG may not correspond to the Preview particularly when the Preview has been magnified using the zoom function.
Most of the local-adjustment tools can be used together in the same RT-spot. However, combinations of Log Encoding, Tone Mapping and Retinex should be avoided. This is because the output TIFF or JPG may not correspond to the Preview particularly when the Preview has been magnified using the zoom function.


Associating any one of the above tools with the other local-adjustment tools such as Color & Light, does not pose a problem.
Associating any one of the above tools with the other local-adjustment tools such as Color & Light, does not pose a problem.


If you do wish to use combinations of the 3 tools mentioned above you can simply add another RT-Spot in close proximity to the first one.
If you do wish to use combinations of the 3 tools mentioned above you can simply add another RT-spot in close proximity to the first one.


For example, the first RT-Spot could be dedicated to Log Encoding, and the second dedicated to Tone Mapping or Retinex. Other tools can be added to either of the two RT-Spots as required.
For example, the first RT-spot could be dedicated to Log Encoding, and the second dedicated to Tone Mapping or Retinex. Other tools can be added to either of the two RT-spots as required.


==Getting started==
==Getting started==


Please note: The screenshots in the following examples are currently being updated to take into account the latest developments. Because of this, some of the slider and module names will be different from the text.
Please note: the screenshots in the following examples are currently being updated to take into account the latest developments. Because of this, some of the slider and module names will be different from the text.


===Activating local adjustments===
===Activating Local Adjustments===


* In the tab bar, select the "hand" icon (Local Adjustments tab)  
* In the Tab tool bar, select the "hand" icon (Local Adjustments tab).
* Turn on the "Local Adjustments" power button (if it is not already activated) and expand the "Settings" module.  
* Turn on the Local Adjustments power button (if it is not already activated) and expand the Settings module.  
*Select "Add"
*Select Add.
<div><ul class="leftalign">  
<div><ul class="leftalign">  
[[File:startspot.jpg|600px|thumb|center|Original]]
[[File:startspot.jpg|600px|thumb|center|Original]]
Line 114: Line 114:
===Preparation===
===Preparation===


Position the RT-spot at the desired location. In this case, we want to increase the saturation of the red flower and reduce the luminance (lightness) without affecting the rest of the image:
Position the RT-spot at the desired location. In this case, we want to increase the saturation of the red flower and reduce the luminance (lightness) without affecting the rest of the image.
* Move the center of the RT-spot so that it is located on an area representative of what you want to change.  
* Move the center of the RT-spot so that it is located on an area representative of what you want to change.  
* Position the 4 delimiters well beyond the flower.  
* Position the 4 delimiters well beyond the flower.  
* Select the "Lockable Color Picker" and locate 3 colors: a) one on the red flower, b) one on the blue sky, c) one on a green leaf.  
* Select the Lockable Color Picker and locate 3 colors: a) one on the red flower, b) one on the blue sky, c) one on a green leaf.  
* In the example the 3 colors are:  
* In the example the 3 colors are:  
** red flower L=48.6 a=74.4 b=47.0
** Red flower L=48.6 a=74.4 b=47.0
** blue sky : L=68.6 a=-3.1 b=-16.6
** Blue sky : L=68.6 a=-3.1 b=-16.6
** green leaf : L=48.3 a=-28.3 b=51.4  
** Green leaf : L=48.3 a=-28.3 b=51.4  
[[File:prepare1.jpg|600px|thumb|center|Preparation]]
[[File:prepare1.jpg|600px|thumb|center|Preparation]]
Raw file: [https://drive.google.com/file/d/1X2g73FqzQl7-WRfzhF7zHa7XWwnKcwtx/view?usp=sharing]
Raw file (Jacques Desmis - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1X2g73FqzQl7-WRfzhF7zHa7XWwnKcwtx/view?usp=sharing]
</ul></div>
</ul></div>


Line 129: Line 129:


In the settings menu, choose "Add tool to current spot".  
In the settings menu, choose "Add tool to current spot".  
* You will see a list of choices : "Color & Light - 11",..., "Log Encoding – 0" etc.. For each RT-spot you can associate 1 or more tools from the list. The processing order in the pipeline corresponds to the number at the end of the tool description : "Log Encoding - 0" is first (if it is activated), "Color & Light -11" is the last one. This is also the case for the associated masks.  
* You will see a list of choices: Color & Light, Shadows/Highlights & Tone Equalizer etc. For each RT-spot you can associate one or more tools from the list. The processing order in the pipeline corresponds to the number at the end of the tool description as described in the Introduction: "Log Encoding - 0" is first (if it is activated), "Color & Light -11" is the last. This is also the case for the associated masks.  
* Select "Color&Light - 11"
* Select Color & Light.


[[File:addtoolcolorandlight1.jpg|600px|thumb|center|Adding the Color & Light tool]]
[[File:addtoolcolorandlight1.jpg|600px|thumb|center|Adding the Color & Light tool]]
Line 136: Line 136:
===Adjusting luminance (lightness) and chrominance===
===Adjusting luminance (lightness) and chrominance===


* Set "Lightness" to -70  
* Set Lightness to -70  
* Set "Chrominance" to 130
* Set Chrominance to 130


* Review the results
* Review the results.
* The red flower now has a new color L= 41.3, a = 66.0, b = 50.4
* The red flower now has a new color L= 41.3, a = 66.0, b = 50.4
* the sky is unchanged  
* The sky is unchanged.
* the green leaf is unchanged
* The green leaf is unchanged.


[[File:lightchro1.jpg|600px|thumb|center|Adjusting luminance (lightness) and chrominance]]
[[File:lightchro1.jpg|600px|thumb|center|Adjusting luminance (lightness) and chrominance]]
Line 148: Line 148:
===Color Tool Scope and Transition Value===
===Color Tool Scope and Transition Value===


In the "Settings" module  
In the Settings module:
* Observe the effect of moving the "Scope (color tools)" slider  
* Observe the effect of moving the "Scope (color tools)" slider.
** if you reduce the value (default 30) only a part of the reds will be affected.  
** If you reduce the value (default 30) only a part of the reds will be affected.  
** if you increase the value, the sky, then the green leaf, then the whole image will be taken into account (Scope=100)
** If you increase the value, the sky, then the green leaf, then the whole image will be taken into account (Scope=100).
Leave the Scope value at 100 and in the "Settings" module select "Show additional settings"  
Leave the Scope value at 100 and in the Settings module select "Show additional settings".
* Observe the effect of moving the "Transition value" slider:
* Observe the effect of moving the "Transition value" slider:
** reduce the value to 5  
** Reduce the value to 5.
** increase the value to 100 and see the result
** Increase the value to 100 and see the result.


===Previewing the adjustment area using deltaE (ΔE)===
===Previewing the adjustment area using deltaE (ΔE)===
Line 161: Line 161:
You can preview the areas of the image that will be affected by any changes. The preview does not show the changes themselves or the transitions, but allows you to set the scope of any adjustments.  
You can preview the areas of the image that will be affected by any changes. The preview does not show the changes themselves or the transitions, but allows you to set the scope of any adjustments.  


There are two possibilities:
There are two possibilities.
* Use the "Preview ΔE" button located in "Settings". This will only work properly if you have activated one (and only one) of the color tools in "Add tool to current spot" menu.  
* Use the Preview ΔE button located in Settings. This will only work properly if you have activated one (and only one) of the color tools in "Add tool to current spot" menu.  
* Use the "Preview ΔE" option in the "Mask and modifications" menu associated with a particular tool (standard and advanced modes only). In this case the GUI takes into account any adjustments made with the tool and works regardless of the number of activated tools.
* Use the Preview ΔE option in the "Mask and modifications" menu associated with a particular tool (standard and advanced modes only). In this case the GUI takes into account any adjustments made with the tool and works regardless of the number of activated tools.


You can vary the intensity and color of this preview with "ΔE preview color " in the "Shape detection" section of the "Settings" module . The preview will also let you see the effect of varying the other sliders in the Shape detection section.   
You can vary the intensity and color of this preview with "ΔE preview color " in the "Shape detection" section of the Settings module. The preview will also let you see the effect of varying the other sliders in the “Shape detection” section.   


[[File:previewdeltae1.jpg|600px|thumb|center|Previewing the modifiable area]]
[[File:previewdeltae1.jpg|600px|thumb|center|Previewing the modifiable area]]
Line 171: Line 171:
===Viewing the changes===
===Viewing the changes===


To see the changes :
To see the changes:
* Go to "Mask and modifications" > "Show modifications without mask" (don't forget to select either "Standard" or "Advanced" in the "Color & Light" combobox) .
* Go to "Mask and modifications" > "Show modifications without mask" (don't forget to select either Standard or Advanced in the Color & Light combobox) .


* You can see the effects of any changes to luminance, contrast, color and saturation, as well as any changes to the texture or structure of the image.
* You can see the effects of any changes to luminance, contrast, color and saturation, as well as any changes to the texture or structure of the image.
* You can also see the effect of the transition settings:
* You can also see the effect of the transition settings.
** "Transition value": percentage of the area that will receive the full effect of any adjustments before dropping off to zero.
** "Transition value": percentage of the area that will receive the full effect of any adjustments before dropping off to zero.
** "Transition decay": the rate with which the zone of influence decreases
** "Transition decay": the rate with which the zone of influence decreases.
** "Transition differentiation XY": difference in coverage between abscissa and ordinate
** "Transition differentiation XY": difference in coverage between abscissa and ordinate.


Try out the following and observe the effect:
Try out the following and observe the effect.
* Change the "Scope (color tools)". Remember that the scope slider acts on deltaE  
* Change the "Scope (color tools)". Remember that the scope slider acts on deltaE.
* Transition settings  
* Transition settings.
* Tool settings (luminance, chroma, etc.)
* Tool settings (luminance, chroma, etc.).


[[File:showmodif.jpg|600px|thumb|center|Viewing the modified areas]]
[[File:showmodif.jpg|600px|thumb|center|Viewing the modified areas]]


===Work on the full image using an "excluding" spot===
===Work on the full image using an Excluding spot===


Local adjustments are not limited to local touch-ups. You can also use the Local Adjustments tool to process the full image. Currently you have to expand a rectangular spot manually to cover the  image completely but this will be done automatically in future versions.
Local adjustments are not limited to local touch-ups. You can also use the Local Adjustments tool to process the full image.  


In "Settings" enable "Show additional settings":  
In Settings enable "Show additional settings":  
* Set the "RT-spot shape" to a rectangle
* Set the "RT-spot shape" to “Full image”
* Position the 4 delimiters outside of the preview  
* This will set the 4 delimiters outside of the preview  
* Set the transition to 100 (or another value if you wish to generate a gradient, bearing in mind that there are other tools for making gradients). You are now ready to use all the tools in full-image mode  
* It will also set the transition to 100 (you can use another value if you wish to generate a gradient, bearing in mind that there are other tools for making gradients). You are now ready to use all the tools in full-image mode.


[[File:fullim1.jpg|600px|thumb|center|Working on the complete image - settings]]
[[File:fullim1.jpg|600px|thumb|center|Working on the complete image - settings]]


===Example: changing the color of the green leaves, except for one===
===Example: changing the color of all the green leaves, except for one===


====Changing the color of the leaves====
====Changing the color of the leaves====


* You can use of the "a" and "b" components of "Lab" in the "Color correction grid ", by choosing "direct" (combobox under the grid) and a high value of "Strength". Moving the dots on the grid as shown will change the color of all the leaves.  
* You can use the "a" and "b" components of "Lab" in the "Color correction grid ", by choosing Direct (combobox under the grid) and a high value of Strength. Moving the dots on the grid as shown will change the color of all the leaves.  
* You can adjust if necessary with "Scope (color tools)".  
* You can adjust if necessary with "Scope (color tools)".  
* The other colors in the flower, sky etc., are not modified.
* The other colors in the flower, sky etc., are not modified.
Line 210: Line 210:
====Restoring the green color to one of the leaves====
====Restoring the green color to one of the leaves====


* Add a second RT-spot ("Add" in the "Settings" module)  
* Add a second RT-spot (Add in the Settings module).
* Choose "Spot Method" = "Excluding Spot"  
* Choose "Spot method" = "Excluding spot".
* Move the RT-spot to the leaf to be changed and expand the spot well beyond the edges of the leaf.
* Move the RT-spot to the leaf to be changed and expand the spot well beyond the edges of the leaf.
* Adjust "Scope" (under the "Excluding" heading in "Settings") until you get the desired effect.  
* Adjust Scope (under the Excluding heading in Settings) until you get the desired effect.  
* If you wish, you can use the "Excluding" spot in the same way as a normal RT-spot and add tools such as Denoise, Blur, etc. (i.e. it not only 'excludes' the effect of the adjacent spot, but it also allows you to use it in the same way as normal spot for the area it encompasses)
* If you wish, you can use the Excluding spot in the same way as a normal RT-spot and add tools such as Denoise, Blur, etc. (i.e. it not only “excludes" the effect of the adjacent spot, but it also allows you to use it in the same way as normal spot for the area it encompasses).


[[File:excluding1.jpg|600px|thumb|center|Using the Excluding spot]]
[[File:excluding1.jpg|600px|thumb|center|Using the Excluding spot]]
Line 220: Line 220:
===Correcting red-eye and removing sensor defects===
===Correcting red-eye and removing sensor defects===


3 steps: preparation, RT-spot adjustment, red-eye removal  
3 steps: preparation, RT-spot adjustment, red-eye removal.


====Preparation====
====Preparation====


* Choose a large area around the eye
* Choose a large area around the eye.
* Put the RT-spot on the red area of the eye (pupil)  
* Put the RT-spot on the red area of the eye (pupil).
* Set 4 "Lockable color pickers" so that you can see the changes
* Set 4 Lockable Color Pickers so that you can see the changes.


[[File:Redeye_prepare1.jpg|600px|thumb|center|Preparation]]
[[File:Redeye_prepare1.jpg|600px|thumb|center|Preparation]]
Line 232: Line 232:
====Adjusting the RT-spot====
====Adjusting the RT-spot====


* Add the "Color and Light" tool  
* Add the Color & Light tool.
* Press the "Preview deltaE" button in "Settings" .  
* Press the "Preview deltaE" button in Settings.  
* Adjust the RT-spot to obtain the desired level of selection.
* Adjust the RT-spot to obtain the desired level of selection.
** here we have chosen to reduce the spot size = 14
** In this example we have chosen to reduce the spot size to 14.
** "Scope (color tools)" = 18
** "Scope (color tools)" = 18.


[[File:Redeye_previewdE1.jpg|600px|thumb|center|Preview dE]]
[[File:Redeye_previewdE1.jpg|600px|thumb|center|Preview dE]]
Line 242: Line 242:
====Removing the red color====
====Removing the red color====


* In the "Color and Light" tool, reduce the chrominance to -100  
* In the Color and Light tool, reduce the chrominance to -100.
* Observe the result :
* Observe the result.
** the pupil of the eye has almost no dominant color anymore
** The pupil of the eye has almost no dominant color anymore.
** the iris, cornea and facial skin are unchanged
** The iris, cornea and facial skin are unchanged.
** you may need to change the "Transition value" (lower it) and "Transition decay" (increase it) in "Settings" depending on the case.
** You may need to change the "Transition value" (lower it) and "Transition decay" (increase it) in "Settings" depending on the case.


[[File:Redeye1.jpg|600px|thumb|center|Eye with red color removed]]
[[File:Redeye1.jpg|600px|thumb|center|Eye with red color removed]]
Line 252: Line 252:
====Removing sensor defects or spots====
====Removing sensor defects or spots====


The principle is the same as above for removing small sensor faults but in this example we will use different tools  
The principle is the same as above for removing small sensor faults but in this example we will use different tools.
* Either CBDL (Contrast By Detail Levels),  
* Either CBDL (Contrast By Detail Levels),  
* Or Wavelet pyramid2 - Contrast by levels (Advanced).
* or Wavelet Pyramid2 > “Contrast by level” (Advanced).
* In both cases, reduce the contrast for the lower levels of decomposition
* In both cases, reduce the contrast for the lower levels of decomposition.
* Adjust "Blur levels" if necessary (wavelet pyramid1)  
* Adjust "Blur levels" if necessary (Wavelet Pyramid1).
* Use a low "Transition value" (less than 20) and high "Transition decay" (greater than 15)in the "Settings" module.  
* Use a low "Transition value" (less than 20) and high "Transition decay" (greater than 15) in the Settings module.  
* The minimum size of the RT-spot for the CBDL and Wavelet pyramid2 decomposition to function is 32x32 pixels. There are workarounds such as the use of transitions and deltaE to deal with defects smaller than the spot.
* The minimum size of the RT-spot for the CBDL and Wavelet Pyramid2 decomposition to function is 32x32 pixels. There are workarounds such as the use of transitions and deltaE to deal with defects smaller than the spot.


Example: removing multiple spots using wavelet pyramid2
Example: removing multiple spots using Wavelet Pyramid2.
* Looking at the image below, we can see that it is blotchy
* Looking at the image below, we can see that it is blotchy.


[[File:Blotches.jpg|600px|thumb|center|Multiple blotches]]
[[File:Blotches.jpg|600px|thumb|center|Multiple blotches]]


* A possible solution:
* A possible solution:
** Activate the tool "Local Contrast & Wavelets".  
** Activate the tool Local Contrast & Wavelets.  
** Choose "Advanced" in the first combobox and then "Wavelet" in the second combobox.
** Choose Advanced in the first combobox and then Wavelets in the second combobox.
** Adjust "Scope" to 20
** Adjust Scope to 20.
** Go to Pyramid2 and activate "Contrast by level".  
** Go to Pyramid2 and activate "Contrast by level".  
** Set high values of "Attenuation response", "Offset" and "Chroma levels" (if necessary)
** Set high values of "Attenuation response", Offset and "Chroma levels" (if necessary).
** Activate the "Contrast by level" curve and reduce the contrast for the lower levels.
** Activate the "Contrast by level" curve and reduce the contrast for the lower levels.


[[File:Blotchesless1.jpg|600px|thumb|center|Fewer blotches]]
[[File:Blotchesless1.jpg|600px|thumb|center|Fewer blotches]]


===Dodging and burning===
===Dodging and Burning===


In many portraits, or photos where light falls directly on the skin, an unpleasant contrast-enhancement phenomenon occurs. Some parts of the skin are slightly overexposed, while others are slightly underexposed.  
In many portraits, or photos where light falls directly on the skin, an unpleasant contrast-enhancement phenomenon occurs. Some parts of the skin are slightly overexposed, while others are slightly underexposed.  
* Traditionally this problem is treated with masks and layers and there are numerous tutorials for doing this with the GIMP and Photoshop (c). You could probably use RT's "Local adjustments" masks also.
* Traditionally this problem is treated with masks and layers and there are numerous tutorials for doing this with the GIMP and Photoshop (c). You could probably use RawTherapee's Local Adjustments masks also.
* Here we are going to use the "Original Retinex" concept (based on Ipol research). It was developed in the 1970s and was originally designed for this sort of application and not for the way it has been subsequently used in Rawtherapee and elsewhere. We are going to:
* Here we are going to use the Original Retinex concept (based on Ipol research). It was developed in the 1970s and was originally designed for this sort of application and not for the way it has been subsequently used in Rawtherapee and elsewhere. We are going to:
** use one or more adjustable-threshold Laplacian functions (see note below)
** Use one or more adjustable-threshold Laplacian functions (see note below).
** solve the Poisson equation (PDE - Partial Derivative Equation)
** Solve the Poisson equation (PDE - Partial Derivative Equation).
** balance the luminance values.
** Balance the luminance values.


Note: Laplacian operators are used because they are particularly good at detecting fine details and Poisson equations are used to solve the partial differential equation generated by the Laplacian and make the tool usable. '''But you do not need to understand how they work to use this tool!'''
Note: Laplacian operators are used because they are particularly good at detecting fine details and Poisson equations are used to solve the partial differential equation generated by the Laplacian and make the tool usable. But you do not need to understand how they work to use this tool!


There are 3 steps: preparation, Laplacian settings and preview, result
There are 3 steps: Preparation, Laplacian settings and preview, Result


====Preparation====
====Preparation====


* The deltaE adjustment steps, the "Scope" (make sure you use the Original Retinex Scope) and the transition adjustment principles are identical to the previous examples and won't be repeated here.  
* The deltaE adjustment, the Scope (make sure you use the Original Retinex Scope) and the transition adjustment principles are identical to the previous examples and won't be repeated here.  
* The portrait we are going to use has had the eyes masked for confidentiality reasons.  
* The portrait we are going to use has had the eyes masked for confidentiality reasons.  
* Choose "Add tool to current spot..." : "Soft Light & Original Retinex" - "Advanced" - "Original Retinex"
* Choose "Add tool to current spot" > Soft Light & Original Retinex > Advanced > Original Retinex.


[[File:Dodgeburn1.jpg|600px|thumb|center|Preparation]]
[[File:Dodgeburn1.jpg|600px|thumb|center|Preparation]]
Line 298: Line 298:
====Adjusting the Laplacian threshold and viewing the changes====
====Adjusting the Laplacian threshold and viewing the changes====


* Adjust the "Strength" slider (which takes into account the threshold of the first Laplacian operator)  
* Adjust the Strength slider (which takes into account the threshold of the first Laplacian operator).
* Adjust the "Laplacian threshold deltaE" slider (which takes into account the deltaE of the image to act on a second Laplacian operator). This processing is upstream of the Scope algorithms and can take into account differences in the background.
* Adjust the "Laplacian threshold deltaE" slider (which takes into account the deltaE of the image to act on a second Laplacian operator). This processing is upstream of the Scope algorithms and can take into account differences in the background.
* View the modifications by choosing: "Show Fourier process" : "Show modifications without mask".
* View the modifications by choosing: "Show Fourier process" > "Show modifications without mask".


[[File:Dodgeburnshow1.jpg|600px|thumb|center|Show Modifications]]
[[File:Dodgeburnshow1.jpg|600px|thumb|center|Show Modifications]]
Line 307: Line 307:


[[File:Dodgeburnmodif1.jpg|600px|thumb|center|Results]]
[[File:Dodgeburnmodif1.jpg|600px|thumb|center|Results]]
A similar algorithm is used in the "Dynamic Range & Exposure" tool. It can be used to process images with large differences in exposure which are often globally underexposed.
A similar algorithm is used in the Dynamic Range & Exposure tool. It can be used to process images with large differences in exposure that are often globally underexposed.
 


===Making a graduated filter based on luminance, chrominance and hue (gradient filter)===
===Making a graduated filter based on luminance, chrominance and hue (gradient filter)===
Line 315: Line 316:
* Choose the flower image that was used in the first example.
* Choose the flower image that was used in the first example.
* Identify 7 points with the "Lockable color picker".
* Identify 7 points with the "Lockable color picker".
* Add the "Color and Light" tool to the current spot and select "Advanced" mode.
* Add the Color & Light tool to the current spot and select “Advanced” mode.
 
[[File:gradprepa1.jpg|600px|thumb|center|Preparation]]  
[[File:gradprepa1.jpg|600px|thumb|center|Preparation]]  


Raw file: [https://drive.google.com/file/d/1X2g73FqzQl7-WRfzhF7zHa7XWwnKcwtx/view?usp=sharing]
Raw file (Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1X2g73FqzQl7-WRfzhF7zHa7XWwnKcwtx/view?usp=sharing]


====Making a graduated filter====
====Making a graduated filter====


Arbitrarily we choose the following settings
Arbitrarily we have chosen the following settings:
* Luminance gradient strength = -0.44  
* Luminance gradient strength = -0.44  
* Chrominance gradient strength = -1.13  
* Chrominance gradient strength = -1.13  
Line 334: Line 334:
====Changing the default settings====
====Changing the default settings====


* Try to gradually change "Scope (color tools)" by increasing the value to 70, 75, 80, 85, 90, 100  
* Try to gradually change "Scope (color tools)" by increasing the value to 70 then 75, 80, 85, 90 and 100.
* Change "Feather gradient" in the "Settings" > "Transient Gradient" module and note the variations  
* Change "Feather gradient" in the Settings > Transition Gradient module and note the variations.
* You can also change the values of the gradients (L, C, H, angle) in the "Graduated Filter" section of the "Color & Light" tool).   
* You can also change the values of the gradients (L, C, H, angle) in the Graduated Filter section of the Color & Light tool).   
* And if you wish, the values of "Color and Light".
* If you wish, you can also change the values of Color & Light.
[[File:gradLCHScopeFeather1.jpg|600px|thumb|center|The settings for Transition, Gradient, Luminance, Chrominance, Hue, Scope & Feather]]
[[File:gradLCHScopeFeather1.jpg|600px|thumb|center|The settings for Transition, Gradient, Luminance, Chrominance, Hue, Scope & Feather]]


Line 344: Line 344:
This example is for demonstration purposes only so that we can see the various (non-exhaustive) possibilities for adjusting exposure. The settings are arbitrary.  
This example is for demonstration purposes only so that we can see the various (non-exhaustive) possibilities for adjusting exposure. The settings are arbitrary.  
* The image is a difficult one with deep shadows and a central area that is almost overexposed.  
* The image is a difficult one with deep shadows and a central area that is almost overexposed.  
* Five possible methods are shown with arbitrary settings  
* Five possible methods are shown with arbitrary settings:
** Shadows/Highlights
** Shadows/Highlights
** Tone Equalizer
** Tone Equalizer
** TRC (Tone Response Curve)
** TRC (Tone Response Curve)
** Log Encoding
** Log Encoding
** Exposure (PDE algorithms & exposure)  
** Exposure (PDE algorithms & Exposure)  


We could also have used :
We could also have used:
* Contrast curves,  
* Contrast curves,  
* or lifted the shadows with "Lightness" (Color and Light),  
* or lifted the shadows with "Lightness" (Color and Light),  
* or used a graduated luminance filter
* or used a graduated luminance filter.
* ...
 


====Preparation====
====Preparation====


* Add a spot as shown in the image below
* Add a spot as shown in the image below.
* Set the  "Scope (color tools)" slider to 50 (this value will be used by the  "Shadows/Highlights" tool when it is added and we will use the separate "Scope" sliders for each of the "Log Encoding" and "Exposure tools")
* Set the  "Scope (color tools)" slider to 50 (this value will be used by the  Shadows/Highlights tool when it is added and we will use the separate Scope sliders for each of the Log Encoding and Exposure tools).
* Try varying this value between 20 and 100
* Try varying this value between 20 and 100


[[File:shadows-prepa1.jpg|600px|thumb|center|Lifting the shadows - preparation]]
[[File:shadows-prepa1.jpg|600px|thumb|center|Lifting the shadows - preparation]]


Raw file: [https://drive.google.com/file/d/1ziux382pWgdYa4jySimwKaKnK_KdDhno/view?usp=sharing]
Raw file (Rawtherapee - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1ziux382pWgdYa4jySimwKaKnK_KdDhno/view?usp=sharing]


====Using Shadows/Highlights====
====Using Shadows/Highlights====


Add tool to current spot..."Shadows/Highlights - Tone Equalizer", "Standard"
* “Add tool to current spot” > "Shadows/Highlights & Tone Equalizer" > "Standard"
* Select "Shadows/Highlights" in the combobox
* Select Shadows/Highlights in the combobox.
* Try changing "Shadows tonal width" and "Highlights"
* Try changing "Shadows tonal width" and "Highlights".


[[File:shadows-sh1.jpg|600px|thumb|center|Lifting the shadows - Shadows Highlights]]
[[File:shadows-sh1.jpg|600px|thumb|center|Lifting the shadows - Shadows Highlights]]
Line 377: Line 377:
====Using the Tone Equalizer====
====Using the Tone Equalizer====


Add tool to current spot..."Shadows/Highlights & Tone Equalizer"
* “Add tool to current spot” > "Shadows/Highlights & Tone Equalizer".
* Select "Tone Equalizer" in the combobox
* Select Tone Equalizer in the combobox.
* Try also sliders 2, 3 et 4
* Try also sliders 2, 3 et 4.
[[File:shadows-toneeq2.jpg|600px|thumb|center|Lifting the shadows - Tone Equalizer]]
[[File:shadows-toneeq2.jpg|600px|thumb|center|Lifting the shadows - Tone Equalizer]]


====Using the Tone Response Curve (TRC)====
====Using the Tone Response Curve (TRC)====


Add tool to current spot..."Shadows/Highlights & Tone Equalizer"
* “Add tool to current spot” > "Shadows/Highlights & Tone Equalizer".
* Select TRC
* Select TRC.
* Increase the "Slope" to 150 and then come back to 60  
* Increase the "Slope" to 150 and then come back to 60.
* Try reducing and then increasing the gamma and observe the effect
* Try reducing and then increasing the gamma and observe the effect.


[[File:shadows-trc1.jpg|600px|thumb|center|Lifting the shadows - TRC]]
[[File:shadows-trc1.jpg|600px|thumb|center|Lifting the shadows - TRC]]
Line 393: Line 393:
====Using Log Encoding====
====Using Log Encoding====


Add tool to current spot..."Log Encoding"
* “Add tool to current spot” > "Log Encoding".
* Note that the "Scope" slider in this case is in the "Log Encodingtool: set "Scope" to 50  
* Note that the Scope slider in this case is in the Log Encoding tool: set Scope to 50.
* Click on the "Automatic" button
* Click on the Automatic button.
* Adjust the "Target gray point"
* Adjust the “Target gray point” (now called “Mean luminance (Yb%)” in the Viewing Conditions panel).
 
[[File:shadows-elog1.jpg|600px|thumb|center|Lifting the shadows – Log Encoding]]
[[File:shadows-elog1.jpg|600px|thumb|center|Lifting the shadows – Log Encoding]]


====Using Exposure====
====Using Exposure====


Add tool to current spot..."Dynamic Range & Exposure"  
* “Add tool to current spot” > "Dynamic Range & Exposure".
* Select "Standard"
* Select Standard.
* Adjust "Exposure compensation ƒ" (a Laplacian and a Fourier transform are applied)
* Adjust "Exposure compensation ƒ" (a Laplacian and a Fourier transform will be applied).
* Set the "Exposure Tools" sliders to: "Black" = -1500, "Shadows" = 50  
* Set the Exposure Tools sliders to Black = -1500, Shadows = 50.
* By default "Highlight compression" is 20. Vary it to see the effect  
* By default "Highlight compression" is 20. Vary it to see the effect.
* Try varying the above settings
* Play around with the above settings to get a feeling for how the tool works.


[[File:shadows-expo1.jpg|600px|thumb|center|Lifting the shadows - Exposure]]
[[File:shadows-expo1.jpg|600px|thumb|center|Lifting the shadows - Exposure]]
Line 414: Line 413:


For portraits and images with low color contrast:  
For portraits and images with low color contrast:  
* Use the "Exposure" slider with care because the algorithm (which is similar to the one used in the Exposure tab) is not well adapted to cases such as portraits which have subtle color variations in skin tones. The algorithm was improved recently (July 5, 2020) by the addition of a Laplacian operator to resolve the differences in contrast but it is still not the best solution for these cases.  
* Use the Exposure slider with care because the algorithm (which is similar to the one used in the Exposure tab) is not well adapted to cases such as portraits which have subtle color variations in skin tones. The algorithm was improved recently (July 5, 2020) by the addition of a Laplacian operator to resolve the differences in contrast but it is still not the best solution for these cases.  
* Try using the "Tone equalizer" or "TRC" instead.
* Try using the "Tone equalizer" or "TRC" instead.


If you do use "Exposure", then it is recommended (but not mandatory) to change the parameters of "Shape detection" in "Settings" as follows:  
If you do use Exposure, then it is recommended (but not mandatory) to change the parameters of "Shape detection" in Settings as follows:  
* Increase "ΔE-scope threshold"  
* Increase "ΔE-scope threshold".
* Reduce "ΔE decay"
* Reduce "ΔE decay".
* Set "ab-L balance (ΔE)" to L  
* Set "ab-L balance (ΔE)" to L.
* Adapt "Scope (color tools)" if necessary
* Adjust "Scope (color tools)" if necessary.


===High dynamic range images - use Log Encoding or the "PDE" algorithms in the "Dynamic Range & Exposure" tool ===
===High dynamic range images - use Log Encoding or the "PDE" algorithms in the "Dynamic Range & Exposure" tool ===
Line 431: Line 430:
=====Chromatic Adaptation Example=====
=====Chromatic Adaptation Example=====


The first step is to find an almost mathematically perfect white balance using 'White Balance' > 'Auto' > 'Temperature correlation' - (same example and settings as in the 'Ciecam Advanced tab' tutorial)  
The first step is to find an almost mathematically perfect white balance using White Balance > Auto > “Temperature correlation” (same example and settings as in the “Ciecam Advanced tab” tutorial).
Raw file [https://drive.google.com/file/d/1CiQ2t4KyD3tdCiNNhskqUG2cH9LT2ly7/view?usp=sharing]
 
Raw file (Rawtherapee - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1CiQ2t4KyD3tdCiNNhskqUG2cH9LT2ly7/view?usp=sharing]


[[File:catATwb.jpg|600px|thumb|center|White Balance - Temperature correlation]]
[[File:catATwb.jpg|600px|thumb|center|White Balance - Temperature correlation]]


======Choose a suitable 'Local adjustments' setting - Preparation ======
======Choose a suitable Local Adjustments setting - Preparation ======


* Select the 'Local Adjustments' tab.
* Select the Local Adjustments tab.
* Add a 'rectangle' spot and move the delimiters well beyond the limits of the preview (so that you can move the center of the RT-spot and still cover the whole image)
* Add a “Full image” spot.
* Set the 'Transition value' = 100
* Set some lockable color pickers as shown.
* Set some lockable color pickers as shown


[[File:catLAset.jpg|600px|thumb|center| Chromatic Adaptation - Preparation]]
[[File:catLAset.jpg|600px|thumb|center| Chromatic Adaptation - Preparation]]


======Select Log encoding======
======Select Log Encoding======


Choose: 'Add tool to current spot' > 'Log Encoding'
Choose: "Add tool to current spot" > Log Encoding
[[File:catLAlog.jpg|600px|thumb|center| Chromatic Adaptation - Log encoding]]
[[File:catLAlog.jpg|600px|thumb|center| Chromatic Adaptation - Log encoding]]


* Try changing the position of the center of the RT-spot
* Try changing the position of the center of the RT-spot.
* Try changing 'Scope': 40 - 60 - 80 - 100
* Try changing the values of Scope e.g. 40 - 60 - 80 100.
* Observe the results
* Observe the results.
* Note that the image is still yellowish
* Note that the image still has a yellow cast.


======Modify Chromatic adaptation - cat02======
======Modify Chromatic adaptation - cat02======
Line 459: Line 458:
[[File:catLAlogadap.jpg|600px|thumb|center| Chromatic Adaptation - Log encoding - Cat02]]
[[File:catLAlogadap.jpg|600px|thumb|center| Chromatic Adaptation - Log encoding - Cat02]]


* Make the image cooler by moving the 'Chromatic adaptation cat02' slider to the left.
* Make the image cooler by moving the “Chromatic adaptation cat02" slider to the left.
* Reducing the slider value by 10 units corresponds to a 300K drop in illuminant temperature.
* Reducing the slider value by 10 units corresponds to a 300K drop in illuminant temperature.
* Try -23
* Try with a value of -23.


=====High dynamic range image + Ciecam=====
=====High dynamic range image + Ciecam=====


The image is a difficult one (the same that was used for the CIECAM in the Advanced tab). It has very marked shadows and strong sunlit backlighting. Use the default RawTherapee settings and position the lockable color pickers as shown so that you can see the changes when processing
The image is a difficult one (the same that was used for the CIECAM example in the Advanced tab). It has very marked shadows and strong sunlit backlighting. Use the default RawTherapee settings and position the lockable color pickers as shown so that you can see the changes when processing.


Raw file[https://drive.google.com/file/d/1ctjOWX2lVmgcAzJtBwt69FGpxZOq-LyP/view?usp=sharing]
Raw file (Pixls.us - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1ctjOWX2lVmgcAzJtBwt69FGpxZOq-LyP/view?usp=sharing]
[[File:ciecam_light_prepa.jpg|600px|thumb|center|Ciecam Lighting Preparation]]
[[File:ciecam_light_prepa.jpg|600px|thumb|center|Ciecam Lighting Preparation]]


======Using Log encoding + Ciecam======
======Using Log Encoding + Ciecam======


Choose 'Add tool to current spot' > 'Log Encoding'. For this example, and for comparison with Example 1 (using Source lighting),  the following arbitrary settings are used:
Create a full-image spot and then  "Add tool to current spot" > Log Encoding. For this example, and for comparison with [[Local_Adjustments#Using_Log_Encoding | Lift the shadows]],  the following arbitrary settings are used:


* Set the delimiters for the rectangular spot beyond the preview area
* Set the value of Scope = 79
* set the 'Transition value' = 100
* Complexity = Advanced.
* 'Scope' = 79
* Press the Automatic button.
* 'Level of complexity' = 'Advanced'
* Press the 'Automatic' button...


[[File:ciecamlog1.jpg|600px|thumb|center|Log encoding]]
[[File:ciecamlog1.jpg|600px|thumb|center|Log encoding]]


* Move the RT-spot and observe the effect
* Move the RT-spot and observe the effect.
* Change the 'Scope' settings and observe the effect
* Change the Scope settings and observe the effect.


======Adjusting the Ciecam settings in the Log Encoding module======
======Adjusting the Ciecam settings in the Log Encoding module======


* For the 'Scene Conditions' choose 'Surround' = 'Dim'. The image will become lighter.
* In the Scene Conditions panel choose Surround = Dim. The image will become lighter.
* In 'Image Adjustments', set the Saturation(s) = 30 and Contrast (J) = -10
* In the Image Adjustments panel, set the Saturation(s) = 30 and Contrast (J) = -10.
* Observe the effect on the shadows...
* Observe the effect on the shadows.


[[File:ciecamlog_cie.jpg|600px|thumb|center|Log encoding + Ciecam saturation (s) - contraste (J) - Dim]]
[[File:ciecamlog_cie.jpg|600px|thumb|center|Log encoding + Ciecam Saturation (s) - Contrast (J) - Dim]]


Now open the 'All tools' expander.
Now open the "All tools" expander.
* Try Colorfulness (M) instead of Saturation (s)
* Try Colorfulness (M) instead of Saturation (s).
* Try Contrast (Q) instead of Contrast (J)
* Try Contrast (Q) instead of Contrast (J).
* Adjust the Lightness
* Adjust the Lightness.


=====Log encoding - Dodge and Burn - Ciecam=====
=====Log encoding - Dodge and Burn - Ciecam=====
Line 503: Line 500:


This is another way to Dodge and Burn using Log Encoding and Ciecam.
This is another way to Dodge and Burn using Log Encoding and Ciecam.
Position the Rt-spot on the face, and set 2 'Lockable color pickers' as shown
Position an Rt-spot on the face and set 2 "Lockable color pickers" as shown.


Raw file[https://drive.google.com/file/d/1oyPu-U6CD1DjWuO8LuqJdIdDau1-2yY1/view?usp=sharing]
Raw file (Copyright - Jean Christophe Frisch - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1oyPu-U6CD1DjWuO8LuqJdIdDau1-2yY1/view?usp=sharing]
[[File:Dblogciecamprepa.jpg|600px|thumb|center|Log encoding Dodge and Burn  - Preparation]]
[[File:Dblogciecamprepa.jpg|600px|thumb|center|Log encoding Dodge and Burn  - Preparation]]


======Using Log encoding in manual mode with Ciecam======
======Using Log Encoding in manual mode with Ciecam======


* 'Add tool to current spot' > 'Log Encoding'
* "Add tool to current spot" > Log Encoding
* Complexity = Advanced
* Complexity = Advanced
* Click on 'Automatic'
* Click on Automatic
* Slightly increase the White Ev value until you get the desired effect (in this example from 3.0 to 5.0)
* Slightly increase the White Ev value until you get the desired effect (in this example from 3.0 to 5.0).
* Slightly increase the Saturation (s)
* Slightly increase the Saturation (s).
* Click on 'All tools' and slightly reduce Brightness (Q)
* Click on "All tools" and slightly reduce Brightness (Q).
* Try the other settings: Dim, lightness, etc.
* Try the other settings e.g. Surround = Dim, Lightness (J), etc.
* You can also adjust the Scope and move the RT-spot
* You can also adjust the Scope and move the RT-spot and observe the variations in the result.


[[File:Dblogciecam.jpg|600px|thumb|center|Log encoding Dodge and Burn  - Preparation]]
[[File:Dblogciecam.jpg|600px|thumb|center|Log encoding Dodge and Burn  - Preparation]]


===Other examples===
===Other Examples===


High dynamic range images are one of the recurring problems in image processing. There are already several algorithms available in Rawtherapee that can be used, more or less successfully, to reduce the dynamic range: Dynamic range compression, Shadows/Highlights, Tone Equalizer, Tone Response Curve, etc.
High dynamic range images are one of the recurring problems in image processing. There are already several algorithms that can be used in Rawtherapee to reduce the dynamic range, with more or less success: Dynamic Range Compression, Shadows/Highlights, Tone Equalizer, Tone Response Curve, etc.


* In this example we are going to use the "Log Encoding" tool (derived from the darktable filmic module and adapted by A. Griggio for ART). The tool has undergone further adaptation by J. Desmis for use in Rawtherapee Local Adjustments
* In this example we are going to use the Log Encoding tool (derived from the darktable filmic module and adapted by A. Griggio for ART). The tool has undergone further adaptation by J. Desmis for use in RawTherapee Local Adjustments.
* To demonstrate the possibilities of this module, we are going to use it to make a luminance gradient, without using the "Graduated filter", which is present in the "Log Encoding" menu.   
* To demonstrate the possibilities of this module, we are going to use it to make a luminance gradient, without using the Graduated Filter in the Log Encoding menu.   
*Three steps: preparation, automatic settings, adjustments  
*There are three steps: preparation, automatic settings, adjustments.


====Preparation====
====Preparation====


* Set the RT-spot so that :  
* Set the RT-spot so that:  
** the center is at the bottom left corner of the image  
** The center is at the bottom left corner of the image.
** the upper right corner is at the limits of the image
** The upper right corner is at the limits of the image.
* Go to "Add tool to current spot...". Go to "Log Encoding " (the tool has been voluntarily disabled in the screenshot)
* Go to "Add tool to current spot" then select Log Encoding (the tool has been deliberately disabled in the screenshot).


[[File:encodlogprepa.jpg|600px|thumb|center|Preparation]]
[[File:encodlogprepa.jpg|600px|thumb|center|Preparation]]


Raw file : [https://drive.google.com/open?id=1RXoXp-AHWzo6mzbd-VyRTRvmRlFtyZDq]
Raw file (Copyright - Roberto Posadas - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/open?id=1RXoXp-AHWzo6mzbd-VyRTRvmRlFtyZDq]


====Automatic settings====
====Automatic settings====


* Press the "Automatic" button  
* Press the Automatic button.
* The image will brighten
* The image will brighten.
* Click the "Automatic" button again to see the settings more clearly.
* Click the Automatic button again to see the settings more clearly.
* The values Black Ev = -6.7, White Ev = 6.9, indicate a large dynamic range = 13.6 EV  
* The values Black Ev = -6.7, White Ev = 6.9, indicate a large dynamic range = 13.6 EV.
* Source gray point : value (set to automatic) = 1.
* “Source gray point” = 1.2 (slider changed to “Mean luminance (Yb%)” in the Scene Conditions panel in the current interface) .
* These settings (that you can change) are the result of calculations made upstream in the pipeline.
* These settings (that you can change) are the result of calculations made upstream in the pipeline.


Line 554: Line 551:


You can now adapt the image to taste:  
You can now adapt the image to taste:  
* Play with the diagonal gradient by adjusting the "Transition Gradient" in "Settings".: "Transition value" = 45. You can also act on "Transition decay" and "Transition differentiation XY" (try it out to see how it affects the result)  
* Play with the diagonal gradient by adjusting the "Transition Gradient" in Settings: "Transition value" = 45. You can also adjust "Transition decay" and "Transition differentiation XY" (try it out to see how it affects the result).
* Modify the distribution of the action inside the image by setting "Scope" (Log Encoding) = 50  
* Modify the way the adjustment is distributed inside the image by setting Scope (Log Encoding) = 50  
* Change the global luminance of the image by setting "Target gray point" = 22.0
* Change the global luminance of the image by setting "Target gray point" = 22.0 (slider changed to “Mean luminance (Yb%)” in the Viewing Conditions panel in the current interface).


[[File:encodloggrad.jpg|600px|thumb|center|Gradient and adjustments]]
[[File:encodloggrad.jpg|600px|thumb|center|Gradient and adjustments]]
===Log Encoding and Highlight Recovery===
===Log Encoding and Highlight Recovery===


The use of "Log Encoding" can sometimes lead to unexpected results. If the image contains highlights that have been overexposed during shooting, then they need to be recovered or reconstructed. However, if this is the case, the Log Encoding module will "overwrite" the reconstructed highlights, resulting in unpleasant effects (e.g. unexpected changes in luminosity, hue and saturation).
The use of Log Encoding can sometimes lead to unexpected results. If the image contains highlights that were overexposed during shooting, then they need to be recovered or reconstructed. However, if this is the case, the Log Encoding module will "overwrite" the reconstructed highlights, resulting in unpleasant effects (e.g. unexpected changes in luminosity, hue and saturation).
We will use 2 methods to overcome this problem and preserve the highlights:
We will use 2 methods to overcome this problem and preserve the highlights.
* using a mask and a recovery process  
* Using a mask and a recovery process.
* with "excluding spots"
* Using excluding spots.


====Préparation====
====Preparation====


Raw file[https://drive.google.com/file/d/1I-Y6xqFoYMaxj9v3uEcvXfZomuJxyX6R/view?usp=sharing]
Raw file (Pixls.us Jonathan Dumaine - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1I-Y6xqFoYMaxj9v3uEcvXfZomuJxyX6R/view?usp=sharing]


PP3 File [https://drive.google.com/file/d/1JQG52i76FxFWUWqi4Mz_5seWpLD-rvT6/view?usp=sharing]
PP3 File [https://drive.google.com/file/d/1JQG52i76FxFWUWqi4Mz_5seWpLD-rvT6/view?usp=sharing]


Preliminary adjustments:
Preliminary adjustments
* adjust the white balance (Color tab): Without the knowledge of the person who took this image we don't know anything about the lighting conditions. Are they LED or incandescent lamps? How was the foreground lit? In this case:
* Adjust the white balance (Color tab). Without the knowledge of the person who took this image we don't know anything about the lighting conditions. Are they LED or incandescent lamps? How was the foreground lit? In this case:
** you can either leave the image as is  
** You can either leave the image as is,
** or use the automatic white balance : "temperature correlation".
** or use the "Temperature correlation" automatic white balance method.
* reconstruct the highlights (Exposure tab): here I have used the excellent "Color Propagation" algorithm designed by Emil Martinec .  
* Reconstruct the highlights (Exposure tab). I have used the excellent Color Propagation algorithm designed by Emil Martinec.  


Preparation of the RT-Spot
Preparation of the RT-spot
* choose "Rectangle".  
* Choose Rectangle.  
* position the delimiters outside the preview area.  
* Position the delimiters outside the preview area.  
* set the transition to a fairly high value  
* Set the transition to a fairly high value.
* position a series of Lockable Color Pickers on the image .
* Position a series of Lockable Color Pickers on the image.
* ensure that the  L*a*b* values of the Lockable Color Pickers match the actual values by setting : "Local adjustments" > "Settings" > "Mask and merge" > "Background color for luminance and color masks = 0".  
* Ensure that the  L*a*b* values of the Lockable Color Pickers match the actual values by setting Mask and Merge > "Background color/luma mask” = 0 in the Settings module.  


[[File:loghigh-prepa.jpg|600px|thumb|center|Preparation]]
[[File:loghigh-prepa.jpg|600px|thumb|center|Preparation]]
Line 590: Line 586:
====Apply Log Encoding====
====Apply Log Encoding====


* add the "Log Encoding" tool using 'Add tool to current spot'
* Add the Log Encoding tool using "Add tool to current spot".
* select "Advanced" (or Standard)  
* Select Advanced (or Standard).
* click on the "Automatic" button  
* Click on the Automatic button.
* set "Scope" to a high value: 80 or more
* Set Scope to a high value i.e. 80 or more.


"Log Encoding" will automatically adjust the image especially in the foreground, but the colors in the previously "reconstructed" highlights in the background will be desaturated and the brightness will be reduced.  
Log Encoding will automatically adjust the image and in particular the foreground, but the colors in the previously "reconstructed" highlights in the background will be desaturated and the brightness will be reduced.  


Not only that, but the overall image is too saturated and the changes in exposure are badly distributed.
Not only that, but the overall image is too saturated and the changes in exposure are badly distributed.
Line 603: Line 599:
====Elaboration of the mask====
====Elaboration of the mask====


We will create a different sort of mask compared to what is normally used in RT. This mask will be used "live" and it will be used to combine two images processed with and without "Log Encoding".
We will create a different sort of mask compared to what we normally use in RawTherapee. This mask will be used "live" to combine two images processed with and without Log Encoding.


Depending on the settings of "Recovery based on luminance mask":  
Depending on the settings of "Recovery based on luminance mask":  
* the dark and black areas of the mask will result in a combined image that is as close as possible to the original.  
* The dark and black areas of the mask will result in a combined image that is as close as possible to the original.  
* the very bright or white areas of the mask will also result in a combined image that is as close as possible to the original.  
* The very bright or white areas of the mask will also result in a combined image that is as close as possible to the original.  
* the intermediate area will be modified by the settings of the "Log Encoding".
* The intermediate area will be modified by the settings of Log Encoding.


In this case I used the LC(H) curve, other images will require the L(L) curve. Note that the C(C) curve has no effect on the "mix" but can be used to improve the selection.
In this case I used the LC(H) curve but other images may require the L(L) curve. Note that the C(C) curve has no effect on the "mix" but can be used to improve the selection.


[[File:loghigh-mask.jpg|600px|thumb|center|Mask]]
[[File:loghigh-mask.jpg|600px|thumb|center|Mask]]
Line 616: Line 612:
====Partial recovery of highlights with mask====
====Partial recovery of highlights with mask====


* make sure that the mask is enabled: "Enable mask" box checked.  
* Make sure that the mask is enabled i.e. the "Enable mask" box is checked.  
* open the expander "Recovery based on luminance mask"  
* Open the expander "Recovery based on luminance mask".
* set "Recovery threshold": the closer the slider is to "2", the more the dark and very bright areas of the mask will be taken into account and restored to the original image values  
* Set "Recovery threshold". The closer the slider is to "2", the more the dark and very bright areas of the mask will be taken into account and restored to the original image values.
* use the "Dark area luminance threshold" and "Light area luminance threshold" sliders to include or exclude parts of the image. The corresponding values (here dark = 25.5 and Light = 98.3) are the two limits below and above which the actions of the mask will be progressively taken into account.  
* Use the "Dark area luminance threshold" and "Light area luminance threshold" sliders to include or exclude parts of the image. The corresponding values (in this case dark = 25.5 and Light = 98.3) are the two limits below and above which the effect of the mask will be progressively taken into account.  
* If necessary, use "decay" to adjust the "rate" of the decay.
* If necessary, use “Decay strength” to adjust the rate of decay.


[[File:loghigh-recov.jpg|600px|thumb|center|Recovery]]
[[File:loghigh-recov.jpg|600px|thumb|center|Recovery]]


====Highlight Recovery using an 'Excluding spot'====
====Highlight Recovery using an Excluding spot====


We can also use one of the strong points of "Local adjustments" by using "Excluding spots". The adjustments are arbitrary.
We can also use one of the strong points of Local Adjustments by using Excluding spots. The adjustments are arbitrary.


[[File:loghigh-exclu.jpg|600px|thumb|center|Excluding spots]]
[[File:loghigh-exclu.jpg|600px|thumb|center|Excluding spots]]
Line 632: Line 628:
====Final adjustment with Ciecam16====
====Final adjustment with Ciecam16====


Once the various "Color propagation" and "Local adjustments" parameters have been set, we can refine the result. In this case I have chosen several Ciecam settings (using Ciecam 2016 in this case) to:  
Once the various parameters have been set, we can refine the result. In this case I have chosen several Ciecam settings (using Ciecam 2016 in this case) to:  
* increase the contrast  
* Increase the contrast.
* reduce the saturation, especially for the skin  
* Reduce the saturation, especially for the skin.
* change the chromatic adaptation, to make the image a little "colder"
* Change the chromatic adaptation, to make the image a little "colder".


Of course, everything is quite arbitrary and depends on one's perception.
Of course, everything is quite arbitrary and depends on one's perception.


A last remark:
A final remark.
* the image is particularly noisy and will need to be denoised. However, to keep things simple, I have excluded this from the example.
* The image is particularly noisy and will need to be denoised. However, to keep things simple, I have excluded this from the example.


[[File:loghigh-ciecam.jpg|600px|thumb|center|Ciecam16]]
[[File:loghigh-ciecam.jpg|600px|thumb|center|Ciecam16]]
Line 646: Line 642:
===Processing a hazy image===
===Processing a hazy image===


We are going to process a very hazy image by first applying the global "Haze Removal" tool in the "Detail" tab and then touch up the sky and horizon using local Retinex.  
We are going to process a very hazy image by first applying the global Haze Removal tool in the Detail tab and then touch up the sky and horizon using Retinex in Local Adjustments.  


====Original Image====
====Original Image====
Line 652: Line 648:
[[File:haze.jpg|600px|thumb|center|Hazy image]]
[[File:haze.jpg|600px|thumb|center|Hazy image]]


Raw file: [https://drive.google.com/file/d/1tc9TxHGwYnVQ2OwiTZIiszDOEXfDjkh6/view?usp=sharing]
Raw file :(Pixls.us - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1tc9TxHGwYnVQ2OwiTZIiszDOEXfDjkh6/view?usp=sharing]


====Processing with the Haze Removal tool (Detail tab in the main menu)====
====Processing with the Haze Removal tool (Detail tab in the main menu)====


We could also have used "local dehaze" and an RT-spot. However when you look at the image there is a lot of haze in the background and the hills so it is better to use a two-step approach.
We could have used the Dehaze tool in Local Adjustments but when you look at the image there is a lot of haze in the background and the hills so it is better to use a two-step approach.


[[File:haze-dehaze.jpg|600px|thumb|center|Hazy image – result with the Haze Removal tool in the main menu (Detail tab)]]
[[File:haze-dehaze.jpg|600px|thumb|center|Hazy image – result with the Haze Removal tool in the main menu (Detail tab)]]
Line 662: Line 658:
====Additional processing with local Retinex====
====Additional processing with local Retinex====


* Choose "Add tools to current spot...". : Dehaze - Retinex - 'Advanced'
* Select "Add tool to current spot" > Dehaze & Retinex > Advanced.
* Try varying the settings  
* Try varying the settings.
* Adjust the "transmission map" curve if necessary by increasing the attenuation on the right side of the curve .  
* Adjust the "Transmission map" curve in Advanced Retinex Tools if necessary by increasing the attenuation on the right side of the curve.  
* Now look at the hills and the sky on the horizon!
* Now look at the difference in the hills and the sky on the horizon!


[[File:haze-reti1.jpg|600px|thumb|center|Hazy image after using Haze removal + Retinex]]
[[File:haze-reti1.jpg|600px|thumb|center|Hazy image after using Haze removal + Retinex]]
Line 671: Line 667:
===Using the Denoise module===
===Using the Denoise module===


Several applications are possible.
There are several ways of using this tool:
* On selected areas to refine any denoising adjustments carried out using the denoise module in the "Detail" tab. In this case keep the denoising to a minimum in the "Detail" tab.
* On selected areas to refine any denoising adjustments carried out with the Noise Reduction module in the Detail tab. In this case keep the Detail tab noise reduction to a minimum.
* By processing the whole image using the denoise module in Local Adjustments and excluding parts of the image with an "Excluding" spot.  
* By processing the whole image using the Denoise module in Local Adjustments and excluding parts of the image with an Excluding spot.  
* Used on its own to reduce noise in low-noise images - for example, to remove noise from the sky or a face  
* By using it on its own to reduce noise in low-noise images. For example, to remove noise from the sky or a face.
* Used on its own to reduce the noise in a selected area and deliberately leave the noise in the rest of the image for artistic purposes
* By using it on its own to reduce the noise in a selected area and deliberately leaving the noise in the rest of the image for artistic purposes.
We are going to look at an example using this last case.
We are going to look at an example using this last case.


Line 682: Line 678:
[[File:denoise-prepa1.jpg|600px|thumb|center|Denoise preparation]]
[[File:denoise-prepa1.jpg|600px|thumb|center|Denoise preparation]]


Raw file : [https://drive.google.com/file/d/1poZporRNILcYfab1Y_f1i-SIEB4acn6L/view?usp=sharing]
Raw file (Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1poZporRNILcYfab1Y_f1i-SIEB4acn6L/view?usp=sharing]


====Zoom 100%====
====Zoom 100%====
Line 690: Line 686:
====Which settings should we use for denoising?====
====Which settings should we use for denoising?====


* The position of the spot and its size are important. We are going to choose a part of the face with strong chromatic noise and use a large "Spot size" for the RT-spot .  
* The position of the spot and its size are important. We are going to choose a part of the face with strong chromatic noise and use a large “Spot size” for the RT-spot .  
* The choice of the "Scope" parameter is also important. In this case, where the noise occupies almost the whole color spectrum (red, green, blue, yellow), a high value of scope must be chosen (90 in this case). If on the other hand the image to be processed has mainly luminance noise, then the "usual" scope value should be chosen, i.e. around 30, to allow the algorithm to differentiate the action according to the colors.
* The choice of the Scope parameter is also important. In this case, where the noise occupies almost the whole color spectrum (red, green, blue, yellow), a high Scope value must be chosen (90 in this case). If on the other hand the image to be processed has mainly luminance noise, then the "usual" Scope value should be chosen, i.e. around 30, to allow the algorithm to differentiate the action according to the colors.
* There are several differences between the local adjustments denoise function and the global denoise module in the Detail tab:
* There are several differences in the Local Adjustments denoise function compared to the global Noise Reduction module in the Detail tab.
** possibility of using a curve to adjust the luminance noise level according to the level of detail (from 0 to 6 depending on the position on the abscissa of the curve).
** You can use a curve to adjust the luminance noise level as a function of the level of detail (from 0 to 6 depending on the position on the abscissa of the curve).
** a distinction is made depending on the level of detail i.e. if levels 3 and above are greater than 20% of the ordinate of the curve, the luminance noise reduction will be more aggressive.  
** A distinction is made depending on the level of detail i.e. if levels 3 and above are greater than 20% of the ordinate of the curve, the luminance noise reduction will be more aggressive.  
** the "dark - light" differentiation for luminance is handled by an "equalizer", rather than by "gamma".  
** The "white - black" differentiation for luminance is handled by an equalizer, rather than gamma.  
** possibility to differentiate the action between "Fine chroma" (impulse noise and low chrominance noise for levels 0 to 4) and "Coarse chroma" (packets of noise, blotches for levels 5 and 6)  
** There is the possibility to distinguish between "Fine chroma" (impulse noise and low chrominance noise for levels 0 to 4) and "Coarse chroma" (packets of noise, blotches for levels 5 and 6) .
** a "red green" / "blue yellow" equalizer which can be useful for low-noise images.  
** There is a "red-green/blue -yellow" equalizer which can be useful for low-noise images.  
** an extra "Chroma detail recovery" slider using DCT (a Fourier-related discrete cosine transform).  
** There is an extra "Chroma detail recovery" slider using DCT (a Fourier-related discrete cosine transform).  
** an added "Luminance & chroma detail threshold (DCT)" slider to differentiate the action depending on the edges ("Edge detection").
** There is an added "Luminance & chroma detail threshold (DCT)" slider to differentiate the action based on edges ("Edge detection").


[[File:denoise1.jpg|600px|thumb|center|Denoise settings]]
[[File:denoise1.jpg|600px|thumb|center|Denoise settings]]
Line 705: Line 701:
====A complex noise reduction problem: how to differentiate between uniform areas and areas with texture or detail?====
====A complex noise reduction problem: how to differentiate between uniform areas and areas with texture or detail?====


Isolating a subject against a background is a common problem in photography. The subject can be an animal, a plant, a person and the background the sky, a lawn, a forest, a wall etc. The problem is a complex one for noise reduction software because the algorithm usually "ignores" the difference between the subject and the background. This means that removing noise in the background will cause a loss of detail, contrast and color in the subject.  
Isolating a subject against a background is a common problem in photography. The subject can be an animal, a plant, a person and the background the sky, grass, a forest, a wall etc. The problem is a complex one for noise reduction software because the algorithm usually "ignores" the difference between the subject and the background. This means that removing noise in the background will cause a loss of detail, contrast and color in the subject.  


=====An example using Andy Astbury's harvest mouse image=====
=====An example using Andy Astbury's harvest mouse image=====
Line 711: Line 707:
I chose this image, with the agreement of its author Andy Astbury, because not only is it excellent (the animal stands out very well against a gray background) but it is also slightly noisy. Removing the noise using only the Noise Reduction tool in the Detail tab will inevitably lead to a loss of detail and a reduction in contrast and saturation in the mouse.  
I chose this image, with the agreement of its author Andy Astbury, because not only is it excellent (the animal stands out very well against a gray background) but it is also slightly noisy. Removing the noise using only the Noise Reduction tool in the Detail tab will inevitably lead to a loss of detail and a reduction in contrast and saturation in the mouse.  


Raw file(Copyright Andy Astbury) [https://drive.google.com/file/d/1uND8pqgfxxaBhs554RnCvOS5NI3KsWT5/view?usp=sharing]
Raw file : (Copyright Andy Astbury - Creative Common Attribution-share Alike 4.0) [https://drive.google.com/file/d/1uND8pqgfxxaBhs554RnCvOS5NI3KsWT5/view?usp=sharing]


PP3 file [https://drive.google.com/file/d/1qwslSsbXlM4Ns8A_2t_8_QSMWfsIuAR8/view?usp=sharing]
PP3 file [https://drive.google.com/file/d/1qwslSsbXlM4Ns8A_2t_8_QSMWfsIuAR8/view?usp=sharing]
The pp3 file is provided as a guide to the tools and possible settings that can be used in cases like this. They are not necessarily the "right" settings.  
The pp3 file is provided as a guide to the tools and possible settings that can be used in cases like this. They are not necessarily the "right" settings.  


Traditionally noise is removed in Rawtherapee using the "Noise Reduction" module (Detail tab).  If we try to remove the luminance and chrominance noise in the background we end up with settings (not shown in the screenshot) in the order of:  
Traditionally noise is removed in Rawtherapee using the Noise Reduction module (Detail tab).  If we try to remove the luminance and chrominance noise in the background we end up with settings (not shown in the screenshot) in the order of:  
* luminance slider = 65  
* Luminance slider = 65  
* chrominance cursor - Master = 20
* Chrominance slider - Master = 20
Certainly the background will be perfect, but our little harvest mouse will become dull and washed out. So how can we go about denoising this image?  
Certainly the background will be perfect, but our little harvest mouse will become dull and washed out. So how can we go about denoising this image?  


Method outline:  
Method outline:  
* use a two-step approach:
* We will use a two-step approach.
** in the first step we will remove the noise in the details we want to preserve (the harvest mouse) using the Noise Reduction module in the Detail tab, paying particular attention to its eye and tail. Note that in other images this step may also reduce large noise packets.  
**In the first step we will remove the noise in the details that we want to preserve (the harvest mouse) using the Noise Reduction module in the Detail tab, paying particular attention to its eye and tail. Note that in other images this step may also reduce large noise packets.  
** because the perception of noise is similar to the principles of color appearance models, it will be more visible on a gray background than on a darker background (especially the chrominance noise). The same principle applies for the brighter parts of the image. It is therefore advisable to adjust the tonal contrast in conjunction with noise reduction. This will enhance the image and reduce the perceived noise at the same time.   
** Because the perception of noise is similar to the principles of color appearance models, it will be more visible on a gray background than on a darker background (especially the chrominance noise). The same principle applies for the brighter parts of the image. It is therefore advisable to adjust the tonal contrast in conjunction with noise reduction. This will enhance the image and reduce the perceived noise at the same time.   
** in the second step, we will treat the noise with some of the tools available in "Local Adjustments" and in particular, the five tools outlined below:
** In the second step, we will treat the noise with some of the tools available in Local Adjustments and in particular, the five tools outlined below:
*** the mask, which will allow us to differentiate between the detailed parts of the image  (mouse, vegetation) and the background.  
*** The mask, which will allow us to differentiate between the detailed parts of the image  (mouse, vegetation) and the background.  
*** the Denoise Hue equalizer which will allow us to differentiate the denoising between the color of the mouse and the background.  
*** The “Denoise hue equalizer” which will allow us to differentiate the denoising between the color of the mouse and the background.  
*** the Scope slider (deltaE) which allows us to differentiate the action based on differences in color.  
*** The Scope slider (i.e. use deltaE) which allows us to differentiate the action based on differences in color.  
*** the "Luminance detail recovery (DCT)" slider and the Luminance and Chroma detail theshold sliders in Edge Detection, which use a noise reduction technique (Fourier) based on the difference between the original image and the image that has been denoised using wavelets.
*** The "Luminance detail recovery (DCT)" slider (abbreviated to “Luma detail recovery” in the current interface) and the “Luminance - Chroma detail theshold” (abbreviated to “Luma-chro detail threshold” in the current interface) slider in Edge Detection, which uses a noise reduction technique (Fourier) based on the difference between the original image and the image that has been denoised using wavelets.
*** Patch-based denoising (also called non-local means), is another denoising algorithm based on pixel and patch similarity. It allows you to differentiate the denoise between areas with detail and texture (e.g. field mouse, vegetation etc.) and uniform areas (background).
*** Patch-based denoising (also called non-local means), is another denoising algorithm based on pixel and patch similarity. It allows you to differentiate the denoise between areas with detail and texture (e.g. field mouse, vegetation etc.) and uniform areas (background).
** finally we will adjust the saturation, local contrast, etc.  
** Finally we will adjust the saturation, local contrast, etc.  


Note: this document is for educational purposes and the settings are designed to clearly demonstrate the different steps rather than to produce a beautiful image.
Note that this document is for didactic purposes and the settings are designed to clearly demonstrate the different steps rather than to produce a beautiful image.


======First step: noise reduction and tonal contrast adjustment======
======First step: noise reduction and tonal contrast adjustment======


The image below only shows the tone equalizer settings and not the luminance and chrominance denoise settings that were made in the Noise Reduction module (Detail tab).  
The image below only shows the tone equalizer settings and not the luminance and chrominance denoise settings that were made in the Noise Reduction module (Detail tab).  
Lockable color pickers have been placed on the eye, the fur, the vegetation, and the tail.  
Lockable Color Pickers have been placed on the eye, the fur, the vegetation, and the tail.  
* Add a new "RT spot" and choose "Full image" in settings. Also in the Settings panel, go to "Mask and merge" and set "Background color for luminance and color masks" to 0 (this will make it easier to distinguish the variations in luminance values).  
* Add a new RT-spot and choose "Full image" in settings. Also in the Settings panel, go to "Mask and merge" and set "Background color/luma mask" to 0 (this will make it easier to distinguish the variations in luminance values).  
* Click on "Add tool to current spot" and select "Dynamic range & Exposure" and then "Shadows/Highlights and Tone Equalizer" in the drop-down menu. Leave the tool in the default "Basic" mode.   
* Click on "Add tool to current spot" and select Shadows/Highlights & Tone Equalizer in the drop-down menu. Leave the tool in the default Basic mode.   
* Position the center of the "RT-spot" on the gray background.  
* Position the center of the RT-spot on the gray background.  
* Adjust the equalizer sliders to get the best compromise, while at the same time adjusting the two sliders in the "Noise Reduction" module (Detail tab). Here I used : luminance = 4,  chrominance = 6.5 (Method:Manual, Chrominance-Master).
* Adjust the equalizer sliders to get the best compromise, while at the same time adjusting the two sliders in the "Noise Reduction" module (Detail tab). Here I used : luminance = 4,  chrominance = 6.5 (Method: Manual > Chrominance-Master).


[[File:mulot_first.jpg|600px|thumb|center|Noise Reduction + Tone Equalizer]]
[[File:mulot_first.jpg|600px|thumb|center|Noise Reduction + Tone Equalizer]]
Line 748: Line 744:
======Second step: Local Adjustments, Blur/Grain & Denoise module======
======Second step: Local Adjustments, Blur/Grain & Denoise module======


* Click on "Add tool to current spot" and select "Blur/Grain & Denoise" and then "Denoise" . Set the tool to "Advanced" mode.   
* Click on "Add tool to current spot" and select Blur/Grain & Denoise and then Denoise. Set the tool to Advanced mode.   
* Use the "Luminance detail by level" curve.  
* Use the "Luminance denoise" curve.  
* For educational purposes and in order to see the effectiveness of the various tools you can set this curve to maximum and activate "aggressive". You will of course have to bring it back to normal values afterwards before continuing.
* For educational purposes and in order to see the effectiveness of the various tools you can set this curve to maximum and activate Aggressive. You will of course have to bring it back to normal values afterwards before continuing.


Familiarize yourself with each of the 5 tools mentioned above, one by one. For example to see the action of the "Denoise hue equalizer", set Scope to 100, set the slider "Recovery based on luminance mask" to 0 and leave the 3 DCT sliders at their default values.  
Familiarize yourself with each of the 5 tools mentioned above, one by one. For example to see the action of the "Denoise hue equalizer", set Scope to 100, set the slider “Recovery threshold" to 1 in “Recovery based on luminance mask" and leave the 3 other sliders at their default values.  
* Adjust the "Denoise hue equalizer" by increasing the noise level for the background and decreasing it for the mouse.  
* Adjust the "Denoise hue equalizer" by increasing the noise level for the background and decreasing it for the mouse.  
* Adjust "Fine chroma" slightly.  
* Adjust "Fine chroma" slightly.  
* Review the results
* Review the results.


[[File:mulot_levelhue.jpg|600px|thumb|center|Luminance Denoise by levels & Denoise hue equalizer]]
[[File:mulot_levelhue.jpg|600px|thumb|center|Luminance Denoise by levels & Denoise hue equalizer]]


Next:  
Next:  
* make a mask (Blur/Grain & Denoise> Denoise > Mask and modifications).
* Make a mask (Blur/Grain & Denoise> Denoise > Mask and modifications).


This mask will be used to differentiate the denoise between the background and the rest of the image i.e. the harvest mouse and the vegetation. In this case I used a simple L(L) curve, a gamma adjustment and the contrast curve, but other images may need to use the LC(H) curve, Structure mask strength, Smooth radius, etc...  
This mask will be used to differentiate the denoise between the background and the rest of the image i.e. the harvest mouse and the vegetation. In this case I used a simple L(L) curve, a gamma adjustment and the contrast curve, but other images may need to use the LC(H) curve, “Structure mask strength”, “Smooth radius”, etc...  


[[File:mulot_mask.jpg|600px|thumb|center|Mask]]
[[File:mulot_mask.jpg|600px|thumb|center|Mask]]
Line 768: Line 764:
[[File:mulot_mask2.jpg|600px|thumb|center|Mask - contrast curve]]
[[File:mulot_mask2.jpg|600px|thumb|center|Mask - contrast curve]]


* activate the mask   
* Activate the mask.  
* expand the "Recovery based on luminance mask" tool
* Expand the "Recovery based on luminance mask" tool.
* adjust "Recovery threshold" to reveal detail. Note: this tool is inactive when set to its default value 1.0. As soon as you move the slider, you will see maximum detail and noise which can then be reduced by moving the slider to the right.  
* Adjust "Recovery threshold" to reveal detail. Note that this tool is inactive when set to its default value 1.0. As soon as you move the slider, you will see maximum detail and noise which can then be reduced by moving the slider to the right.  


For other images it may be necessary to adjust:  
For other images it may be necessary to adjust:  
* "Dark area luminance threshold". The denoise is progressively increased from 0% at the threshold setting to 100% at the maximum black value (determined by the mask).  
* "Dark area luminance threshold". The denoise is progressively increased from 0% at the threshold setting to 100% at the maximum black value (determined by the mask).  
* "Light area luminance threshold", The denoise is progressively decreased from 100% at the threshold setting to 0% at the maximum white value (determined by the mask). In this example, the adjustment will allow us to denoise the vegetation as a function of luminance.  
* "Light area luminance threshold", The denoise is progressively decreased from 100% at the threshold setting to 0% at the maximum white value (determined by the mask). In this example, the adjustment will allow us to denoise the vegetation as a function of luminance.  
* decay allows you to manage the progressiveness of any changes  
* Decay allows you to manage the progressiveness of any changes.
* the two "Gray area" sliders allow you to reapply noise reduction if necessary in the "protected" mid-tone area of the mask.
* The two "Gray area" sliders allow you to reapply noise reduction if necessary in the "protected" mid-tone area of the mask.


[[File:mulot_recovery.jpg|600px|thumb|center|Recovery]]
[[File:mulot_recovery.jpg|600px|thumb|center|Recovery]]


* Using Scope: here we are on familiar ground. In "Mask and modifications" you can use the two selections "Show modified areas with mask" and "Show modified areas without mask" to see the effect of Scope. Or you can simply adjust Scope and see the effect. In this image, with "Equalizer hue" disabled and "Recovery based on luminance mask" at 0, the Scope action is sensitive between 50 and 100.  
* Using Scope: here we are on familiar ground. In "Mask and modifications" you can use the two selections "Show modified areas with mask" and "Show modified areas without mask" to see the effect of Scope. Or you can simply adjust Scope and see the effect. In this image, with "Equalizer hue" disabled and "Recovery based on luminance mask" disabled (“Recovery threshold” set to 1) , the Scope action is sensitive between 50 and 100.  
* Use of the two sliders "Luminance detail recovery" and "Luminance & chroma detail threshold":
* Use of the two sliders "Luminance detail recovery" (now labeled as “Luma detail recovery”) and "Luminance & chroma detail threshold" (now labeled as “Luma-chro detail threshold”).
** gradually increase "Luminance detail recovery".  
** Gradually increase "Luma detail recovery".  
** adjust the "Luminance & chroma detail threshold"in parallel. You will see the details reappear.  
** Adjust the "Luma-chro detail threshold"in parallel. You will see the details reappear.  
** 2 algorithms are possible - the first one uses an internal mask - the second one a Laplacian. Each one has its particularities: the Laplacian is more selective, but less progressive.
** 2 algorithms are possible. The first one uses an internal mask and the second one a Laplacian. Each one has its particularities: the Laplacian is more selective, but less progressive.


* Using patch-based denoise (non-local means)
* Using patch-based denoise (non-local means).
** What is patch-based denoise? Contrary to the usual filters that reduce noise by averaging the values of groups of pixels located around a target pixel, non-local means filters average the values of all the pixels in the image and weight them according to their similarity with the target pixel. This type of filtering reduces the loss of detail compared to filters that use local averaging.
** What is patch-based denoise? Contrary to the usual filters that reduce noise by averaging the values of groups of pixels located around a target pixel, non-local means filters average the values of all the pixels in the image and weight them according to their similarity with the target pixel. This type of filtering reduces the loss of detail compared to filters that use local averaging.


Line 792: Line 788:


To familiarize yourself with this method it is recommended to:
To familiarize yourself with this method it is recommended to:
* activate "Non-local means only" in "Denoise" > "Mode"
* Activate "Non-local means only" in Denoise > Mode.
* deactivate the mask
* Deactivate the mask.
* set Scope to 100
* Set Scope to 100.


In "Advanced" mode you have 5 sliders:
In Advanced mode you have 5 sliders:
* Strength
* Strength
* Detail recovery: allows you to make a preliminary selection between uniform and textured areas. The higher the values, the more the details will be selected.
* Detail recovery: allows you to make a preliminary selection between uniform and textured areas. The higher the values, the more the details will be selected.
* Gamma: allows you to further refine the selection between uniform and textured areas. Lower gamma values will reveal more detail and texture.
* Gamma: allows you to further refine the selection between uniform and textured areas. Lower gamma values will reveal more detail and texture.
* Maximum patch size: allows you to adapt the size of the "patch" to the size of the objects. In theory, the more the noisier the image, the larger this value should be. In practice, you should look for and minimize any artifacts in the transitions between the uniform and textured areas.
* Maximum patch size: allows you to adapt the size of the "patch" to the size of the objects. In theory, the more noisier the image, the larger this value should be. In practice, you should look for and minimize any artifacts in the transitions between the uniform and textured areas.
* Maximum radius size: higher values will theoretically give better noise reduction at the expense of increased processing time.
* Maximum radius size: higher values will theoretically give better noise reduction at the expense of increased processing time.


Line 807: Line 803:
Add a new RT-spot, centered on the mouse.
Add a new RT-spot, centered on the mouse.


Then add 2 tools:
Then add 2 tools.
* add tool to current spot - "Vibrance and Warm/Cool" - Basic  
* “Add tool to current spot” > Vibrance & Warm/Cool > Basic.
** move the Vibrance slider until you get the desired increase in saturation.
** Move the Vibrance slider until you get the desired increase in saturation.
* add tool to current spot - "Local contrast & Wavelets" - Wavelets - Advanced  
* “Add tool to current spot” > Local Contrast & Wavelets > Wavelets >Advanced.
** use "Contrast by level" in Wavelet pyramid 2 , giving priority to the first levels
** Use "Contrast by level" in Wavelet pyramid 2 , giving priority to the first levels.


[[File:mulot_wav.jpg|600px|thumb|center|Wavelet]]
[[File:mulot_wav.jpg|600px|thumb|center|Wavelet]]
Line 817: Line 813:
======Other methods and tools======
======Other methods and tools======


Other methods can be used for the same purpose:
Other methods can be used for the same purpose.
* using "Local Adjustments"
* Using Local Adjustments  
** "Denoise based on luminance mask" - uses the same mask as "Recovery based on luminance mask" but increases or decreases the wavelet denoise. It acts prior to denoise (as does the "Denoise hue equalizer") whereas "Recovery based on luminance mask" acts after denoise by comparing the original noisy image and the denoised image.
** "Denoise based on luminance mask". Uses the same mask as "Recovery based on luminance mask" but increases or decreases the wavelet denoise. It acts prior to denoise (as does the "Denoise hue equalizer") whereas "Recovery based on luminance mask" acts after denoise by comparing the original noisy image and the denoised image.
** "Equalizer white-black" and "Equalizer blue-yellow red-green": the equivalent of the "Luminance curve" in "Noise Reduction" and not very efficient here.  
** "Equalizer white-black" and "Equalizer blue-yellow red-green"are the equivalent of the "Luminance curve" in "Noise Reduction" and not very efficient here.  
** "Guided Filter" in "Blur/grain & Denoise" > "Blur & Noise": uses the same mask and the same process as "Recovery based on luminance mask" using negative values of the "detail" slider  
** Guided Filter in Blur/grain & Denoise > Blur & Noise uses the same mask and the same process as "Recovery based on luminance mask" with negative values of the Detail slider.
** "Excluding spots" - which allow you to restore the image to the settings prior to activating the "Full image" RT-spot .
** Excluding spots allow you to restore the image to the settings prior to activating the "Full image" RT-spot.
** "Median" in "Blur/grain & Denoise" > "Blur & Noise": not very efficient here.
** Median in Blur/Grain & Denoise > Blur & Noise is not very efficient here.
** "Blur levels" in "Local Contrast & Wavelets" > "Wavelets" > "Pyramid1": if you want to blur a part of the image according to the level of detail.   
** "Blur levels" in Local Contrast & Wavelets > Wavelets > Pyramid1: if you want to blur a part of the image according to the level of detail.   


* other Rawtherapee methods (not developed here)  
* Other Rawtherapee methods (not developed here)  
** "Noise reduction": the "Luminance control" and chrominance curves allow some form of selection, but they are not sufficient in this particular case.  
** Noise Reduction: the "Luminance control" and chrominance curves allow some form of selection, but they are not sufficient in this particular case.  
** "Wavelet levels - noise reduction - including an "Denoise hue equalizer" and the use of local contrast.
** Wavelet levels noise reduction, which includes a "Denoise hue equalizer" and makes use of local contrast.


Comparison of Denoise tools
Comparison of Denoise tools
Line 836: Line 832:


Thanks once again to Andy Astbury for this excellent image, which allows us to demonstrate 5 ways of differentiating noise reduction between uniform areas and areas with detail.
Thanks once again to Andy Astbury for this excellent image, which allows us to demonstrate 5 ways of differentiating noise reduction between uniform areas and areas with detail.
* "Denoise hue equalizer"
* Denoise hue equalizer  
* "Recovery based on luminance mask"
* Recovery based on luminance mask  
* "Scope - deltaE"
* Scope - deltaE  
* "DCT - Edge detection"
* DCT - Edge detection
* "Non-local means"
* Non-local means


In a difficult image it will probably be necessary to activate all 5 methods to try and find the right balance. The result is a matter of individual taste and is quite subjective.
In a difficult image it will probably be necessary to activate all 5 methods to try and find the right balance. The result is a matter of individual taste and is quite subjective.
   
   
It also depends on:  
It also depends on:  
* the background ,which is uniform in this example, but may pose problems if it contains detail or texture.  
* The background, which is uniform in this example, but may pose problems if it contains detail or texture.  
* the colors, which are well separated here, but will be more difficult to distinguish if they are "mixed".  
* The colors, which are well separated here, but will be more difficult to distinguish if they are "mixed".  
* DeltaE, which can be affected by chromatic noise, or when the separation of the colors is less distinct.
* DeltaE, which can be affected by chromatic noise, or when the separation of the colors is less distinct.
* "Edge detection" which will also be affected by high luminance noise.
* "Edge detection" which will also be affected by high luminance noise.
Line 854: Line 850:
====An example … (don't run away, it isn't as difficult as all that)====
====An example … (don't run away, it isn't as difficult as all that)====


Original image, with "Exposure compensation" = +1.5
Original image, with “Exposure compensation” = +1.5


[[File:Amsterdam15.jpg|600px|thumb|center|Amsterdam]]
[[File:Amsterdam15.jpg|600px|thumb|center|Amsterdam]]
Raw file (Rawtherapee - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1dJ5yiqF-XdLQdKizCDseUxHf34y4AKZ6/view?usp=sharing]


====The same image with "Wavelet tone-mapping".====
====The same image with Wavelet level tone mapping====


* Leave all settings at their default values  
* Leave all settings at their default values.
* Enable the "Local Contrast & Wavelets" tool ("Advanced" mode) and then open the "Wavelet pyramid2" expander
* Enable the Local Contrast & Wavelets tool (Advanced mode), select Wavelets in the combobox just under the “Overall strength” slider (the default is Unsharp Mask) and then select Pyramid2.
* Set "Scope" (wavelets) to 80  
* Set Scope (Wavelets) to 80.
* Then use the settings visible on the screenshot  
* Use the settings visible on the screenshot.
* Of course the appearance is subjective so feel free to change the settings
* Of course the appearance is subjective so feel free to change the settings.
* This version of "Tone mapping" is different from the other algorithms implemented in Rawtherapee (Fattal for "dynamic range compression" and Mantiuk for "Tone mapping" & Log Encoding) and is specific to Rawtherapee Wavelets.
* This version of tone mapping is different from the other algorithms implemented in Rawtherapee (Mantiuk for both Tone mapping and Log Encoding and Fattal for Dynamic Range Compression) and is specific to Rawtherapee Wavelets.


[[File:Amsterdam15_wavtm1.jpg|600px|thumb|center|Amsterdam image with wavelet tone mapping]]
[[File:Amsterdam15_wavtm1.jpg|600px|thumb|center|Amsterdam image with wavelet tone mapping]]
Line 871: Line 868:
===Three ways of increasing texture===
===Three ways of increasing texture===


For demonstration purposes we can use  
For demonstration purposes we will use:
* Tone-mapping (Mantiuk)
* Tone Mapping (Mantiuk)
* Retinex
* Retinex
* Wavelets
* Wavelets
Line 880: Line 877:
[[File:texture-normal1.jpg|600px|thumb|center|Preparation]]
[[File:texture-normal1.jpg|600px|thumb|center|Preparation]]


Raw file: [https://drive.google.com/file/d/1DASGpHfl_9RDRhbq2_JQVgypgKyrdiBk/view?usp=sharing]
Raw file (Copyright Sébastien Guyader - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1DASGpHfl_9RDRhbq2_JQVgypgKyrdiBk/view?usp=sharing]


====Using Tone mapping====
====Using Tone Mapping====


* Create an elliptical RT-spot as shown then “Add tool to current spot” > Tone Mapping.
* Note that the option "Normalize luminance" is checked. This ensures that the average and variance of the luminance values are the same as in the original image.  
* Note that the option "Normalize luminance" is checked. This ensures that the average and variance of the luminance values are the same as in the original image.  
* Use "Advanced" mode and adjust "Edge stopping" and "Scale".
* Use Advanced mode and adjust "Edge stopping" and Scale.


[[File:texture-tm1.jpg|600px|thumb|center|Tone mapping using the 'Mantiuk' algorithm]]
[[File:texture-tm1.jpg|600px|thumb|center|Tone mapping using the Mantiuk algorithm]]


====Using Retinex====
====Using Retinex====


* Using the same RT-spot as above, turn off the Tone Mapping tool and then “Add tool to current spot” > Dehaze & Retinex > Advanced. Then use the settings in the screenshot.
* Note that the option "Normalize luminance" is checked. This ensures that the average and variance of the luminance values are the same as in the original image.
* Note that the option "Normalize luminance" is checked. This ensures that the average and variance of the luminance values are the same as in the original image.
* Note also that you can enable the "Use Fast Fourier Transform"
* Note also that you can enable the "Use Fast Fourier Transform".


[[File:texture-reti1.jpg|600px|thumb|center|Retinex]]
[[File:texture-reti1.jpg|600px|thumb|center|Retinex]]
Line 898: Line 897:
====Using Wavelets====
====Using Wavelets====


* Note the use of "Dynamic range compression", the values of "Attenuation response", "Balance threshold" and "Compress residual image".  
* Using the same RT-spot as above, turn off the Dehaze & Retinex tool and then “Add tool to current spot” > Local Contrast & Wavelets > Advanced > Wavelets > Pyramid2 and then use the settings in the screenshot.
* Note the use of "Compression by level", the values of "Attenuation response", "Balance threshold" and "Compress residual image".  
* Try "Contrast by level".  
* Try "Contrast by level".  
* Also try "Directional contrast",  
* Also try "Directional contrast",  
* or a combination of these parameters
* or a combination of these parameters.


[[File:texture-wav1.jpg|600px|thumb|center|Wavelet tone-mapping]]
[[File:texture-wav1.jpg|600px|thumb|center|Wavelet tone-mapping]]
Line 907: Line 907:
===Merging layers using blend modes===
===Merging layers using blend modes===


You can use "Merge file" in the "Color and light" tool (advanced mode) to simulate the effect of merging layers. Each RT-spot can be thought of as a layer and the "Merge file" function allows you to merge up to 2 RT-spots with the original image.
You can use "Merge file" in the Color & Light tool (Advanced mode) to simulate the effect of merging layers. Each RT-spot can be thought of as a layer and the "Merge file" function allows you to merge up to 2 RT-spots with the original image.
* The first "layer" is called "Original" and corresponds (in the same way as an "Excluding spot") to the image data prior to any local adjustments being carried out.  
* The first "layer" is called Original and corresponds (in the same way as an Excluding spot) to the image data prior to any local adjustments being carried out.  
* When you stack RT-spots on top of each other, for example 6:
* When you stack RT-spots on top of each other, for example 6:
** If the current Spot is number 6, "Merge file" will merge the 6th (layer) , either with the 5th (Previous Spot), or with the "Original Image" (the original data), or with a color defined in "Background" depending on the option chosen in the combobox.
** If the current Spot is number 6, "Merge file" will merge the 6th layer, either with the 5th (Previous Spot), or with the Original Image (the original data), or with a color defined in Background depending on the option chosen in the combobox.
** If the current spot is number 3 out of the 6, then "Merge file" will merge spot 3 either with the 2nd spot (Previous spot), or with the "Original" (the original data) or with a color defined in "Background".
** If the current spot is number 3 out of the 6, then "Merge file" will merge spot 3 either with the 2nd spot (Previous Spot), or with Original (the original data) or with a color defined in Background.
** For each of these merges you have 21 blend modes inspired by those of Photoshop (C) (Normal, Difference, ...Soft light, ...Overlay, ...)
** For each of these merges you have 21 blend modes inspired by those of Photoshop© (Normal, Difference, Soft light, Overlay, etc.).
** For each blend mode you can adjust the opacity, deltaE, and a "contrast threshold" (except in the case of "Background" )
** For each blend mode you can adjust the opacity, deltaE, and a Contrast Threshold (except in the case of Background).
** The Graduated Filter (Luminance, Chrominance, Hue) - located in "Color and Light" - also works with "Merge file".
** The Graduated Filter (Luminance, Chrominance, Hue), which is located in Color & Light, also works with "Merge file".


As an example we will use these features to create a variable blur (of course this isn't the only application).
As an example we will use these features to create a variable blur (of course this isn't the only application).
Line 920: Line 920:
====Preparation====
====Preparation====


Add an RT-spot as in previous examples and then add the "Blur/Grain & Denoise" tool in "Advanced" mode to the spot using "Add tool to current spot" .  
Add an RT-spot as in the previous examples and then add the Blur/Grain & Denoise tool in Advanced mode using "Add tool to current spot".  
* Set the RT-spot to "Inverse" mode (using the checkbox which will appear when you click on the "Blur & Noise" expander).
* Set the RT-spot to Inverse mode (using the checkbox which will appear when you click on the Blur & Noise expander).
* Choose "Scope" = 90 or 100 depending on the desired effect
* Choose Scope = 90 or 100 depending on the desired effect.
* Set "Radius" to a high value (2000 or more and check the FFTW option), set Blur mode to "Luminance & Chrominance".
* Set Radius to a high value (2000 or more and check the FFTW option), set Blur mode to Luminance & Chrominance (in the combobox at the bottom of the tool panel).            .


[[File:mergeblurinv_2.jpg|600px|thumb|center|Préparation]]
[[File:mergeblurinv_2.jpg|600px|thumb|center|Préparation]]


Raw file: [https://drive.google.com/file/d/1dJ5yiqF-XdLQdKizCDseUxHf34y4AKZ6/view?usp=sharing]
Raw file (Rawtherapee - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1dJ5yiqF-XdLQdKizCDseUxHf34y4AKZ6/view?usp=sharing]


====Adding a second RT-spot====
====Adding a second RT-spot====


Use "Add tool to current spot" to add the "Color and light" tool and set it to "Advanced" mode
Use "Add tool to current spot" to add the Color & Light tool and set it to Advanced mode.
* Set "Scope (color tools) " to 100
* Set "Scope (color tools) " to 100.


[[File:mergetwo1.jpg|600px|thumb|center|Second spot]]
[[File:mergetwo1.jpg|600px|thumb|center|Second spot]]


====First merge in "normal" blend mode====
====First merge in Normal blend mode====


* Go to the "Merge file" expander in the "Color & Light" module.
* Go to the "Merge file" expander in the Color & Light module.
* In the combobox choose one of the options in the list that starts with "None". The options are:
* In the combobox choose one of the options in the list that starts with None. The options are:
** "Original Image"
** Original Image.
** "Previous Spot" which merges with the previous RT-spot (or the Original Image if there is only 1 RT-spot)  
** Previous Spot, which merges with the previous RT-spot (or the Original Image if there is only one RT-spot).
** "Background" which allows you to merge with a colored background;
** Background, which allows you to merge with a colored background.


* Then choose the blend mode (under the heading "Merge with Original or Previous or Background" ) and adjust the settings : "Merge background", "Opacity", "Contrast Threshold"
* Then choose the blend mode (under the heading "Merge with Original/Previous/Background") and adjust the settings : "Merge background", Opacity, Contrast Threshold.
* The other parameters in the "Color and Light" module can also be used if you wish (e.g. "Lightness", "Contrast", "Saturation" etc.).
* The other parameters in the Color & Light module can also be used if you wish (e.g. Lightness, Contrast, Saturation etc.).


[[File:mergeorignrmal1.jpg|600px|thumb|center|Blend mode "Normal"]]
[[File:mergeorignrmal1.jpg|600px|thumb|center|Blend mode "Normal"]]
Line 951: Line 951:
====Second merge using the Soft Light blend mode====
====Second merge using the Soft Light blend mode====


In the list of merge modes try "Soft Light (legacy)" (or another mode...)
In the list of merge modes try “Soft Light (legacy)" or a different mode if you wish.  
* Try adjusting the settings (e.g. "Opacity", etc.) to see what difference they make.  
* Try adjusting the settings (e.g. Opacity, etc.) to see what difference they make.  
* Switch from the "Original Image" option to previous "Previous Spot" and see what difference that makes.
* Switch from the Original Image option to Previous Spot and see what difference that makes.


[[File:mergeorigsoftlight1.jpg|600px|thumb|center|Blend mode "Soft Light (legacy)"]]
[[File:mergeorigsoftlight1.jpg|600px|thumb|center|Blend mode "Soft Light (legacy)"]]
Line 962: Line 962:


* We are going to use an image of the salt mountain in Pammukale (Turkey).
* We are going to use an image of the salt mountain in Pammukale (Turkey).
* It is a difficult image to process, because of the subtle differences in color between the sky and the mountain. Moreover the mountain contains many irregularities.  
* It is a difficult image to process, because of the subtle differences in color between the sky and the mountain. Moreover, the mountain contains many irregularities.  
* The preliminary steps are the same as for previous examples. Note the setting of "Scope (color tools)" to 40 which is a compromise but necessary if we are going to process the mountain correctly.  
* The preliminary steps are the same as for previous examples. Note the setting of "Scope (color tools)" to 40 which is a compromise but necessary if we are going to process the mountain correctly.  
* For the purposes of this example, we are going to strongly increase the luminance (lightness) and the chrominance of the mountain (this is not an artistic objective) and see if we can avoid affecting the sky in the process.  
* For the purposes of this example, we are going to strongly increase the luminance (lightness) and the chrominance of the mountain (this is not an artistic objective) and see if we can avoid affecting the sky in the process.  
* We could have used "Excluding spots" (or in a future GUI release, a polygon), but for now, we are going to use a simple mask. We could also have used several curves for the mask, or created several masks by duplicating the RT-spot.  
* We could have used Excluding spots (or in a future GUI release, a polygon), but for now, we are going to use a simple mask. We could also have used several curves for the mask, or created several masks by duplicating the RT-spot.  
* With "Local Adjustments", 2 types of mask can be managed:
* 2 types of mask are available in Local Adjustments.
** 1) those that don't add or subtract the mask from the image. The aim in this case is to improve the quality of the deltaE selection.  
** 1) Those that don't add or subtract the mask from the image. The aim in this case is to improve the quality of the deltaE selection.  
** 2) those that make use of the resulting differences when they are added to or subtracted from the image.
** 2) Those that make use of the resulting differences when they are added to, or subtracted from the image.
** We are going to use the first case (selection improvement).
** We are going to use the first case (selection improvement).


[[File:masksimpleprepa1.jpg|600px|thumb|center|Preparation]]
[[File:masksimpleprepa1.jpg|600px|thumb|center|Preparation]]


Raw file: [https://drive.google.com/file/d/1azCxu1midw6dcuN7SbvbAiJH4pxX5BTA/view?usp=sharing]
Raw file (Jacques Desmis - Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1azCxu1midw6dcuN7SbvbAiJH4pxX5BTA/view?usp=sharing]


====Strongly increase "Lightness" and "Chrominance"====
====Strongly increase Lightness and Chrominance====


* Observe the result: there is color bleed and the sky has been affected by the changes, which is what we wanted to avoid.
* Observe the result: there is color bleed and the sky has been affected by the changes, which is what we wanted to avoid.
Line 983: Line 983:
====Creating a simple mask====
====Creating a simple mask====


* We are going to use only one of the 3 LCH curves (in this case L)  
* We are going to use only one of the 3 LCH curves (in this case L).  
[[File:Basic_Gamut_with_tags.jpg|600px|thumb|left|Gamut]]
 
 
* For each of the curves, the vertical separation line dark gray / light gray represents the 3 references of the RT-spot respectively: Luminance, Chroma and Hue
* Examine the L(L) curve closely. You will see that the point of inflection is located at the transition between the gray areas. This "transition" corresponds to the 3 references of the RT-spot (chroma, luma, hue) and is common to all the curves -- C(C), L(L), LC(H).
* Examine the L(L) curve closely. You will see that the point of inflection is located at the transition between the gray areas. This "transition" corresponds to the 3 references of the RT-spot (chroma, luma, hue) and is common to all the curves -- C(C), L(L), LC(H).
* Avoid using "blend" to ensure that only the shape detection is improved  
* Avoid using Blend to ensure that only the shape detection is improved.
* You can also use "Show modifications with mask" in "Mask and modifications".
* You can also use "Show modifications with mask" in "Mask and modifications".


Line 1,004: Line 1,000:


* Set "Mask and modifications" to "Show modified image".
* Set "Mask and modifications" to "Show modified image".
* Activate "Enable mask"  
* Activate "Enable mask".
* If necessary, adjust the "Smooth radius" mask.  
* If necessary, adjust the "Smooth radius" mask tool.  
* Retouch the "Contrast curve" mask and L(L) curves if necessary.  
* Retouch the "Contrast curve" mask and L(L) curves if necessary.  
* Switch to "Advanced" mode and try the "Gamma", "Slope", and "Laplacian threshold " masks (instead of the "Smooth radius" mask)  
* Switch to Advanced mode and try the Gamma, Slope, and Laplacian threshold masks (instead of the "Smooth radius" mask).
* Certainly it is not perfect, but much better...the goal is to discover how the masks work
* Certainly it is not perfect, but it is much better -- the goal is to discover how the masks work.


To improve the mask performance, you have 2 solutions:  
To improve the mask performance, you have 2 solutions:  
* Duplicate the RT-spot: if you duplicate the RT-spot, and place it alongside the previous one, the slight change in the position of the center (references), will allow the second mask to 'correct' the "anomalies or incompleteness" of the previous mask. Moreover this option allows you to readjust certain parameters if necessary in the second spot (in this case lightness & chrominance) to give a more homogeneous result.  
* Duplicate the RT-spot: if you duplicate the RT-spot, and place it alongside the previous one, the slight change in the position of the center (references), will allow the second mask to "correct" the "anomalies or incompleteness" of the previous mask. Moreover this option allows you to readjust certain parameters if necessary in the second spot (in this case Lightness & Chrominance) to give a more homogeneous result.  
* Use the mask of another open tool (if of course the tool is equipped with a mask). In this case you keep the same references (luma, chroma, hue) to create the masks and to take into account the deltaE (Scope).
* Use the mask of another open tool (if of course the tool is equipped with a mask). In this case you keep the same references (luma, chroma, hue) to create the masks and to take into account the deltaE (Scope).


Consideration of deltaE:  
DeltaE considerations:  
* You can disable the core function of "Local Adjustments" - i.e. the "Scope" function which takes into account deltaE - if you want to work entirely with masks and ignore "Scope". In this case set "Scope=100". Obviously the "Scope" function is disabled, so you will only be able to use the "blend" function to combine the mask and the image.
* You can disable the core function of Local Adjustments i.e. the Scope function, which takes into account deltaE, if you want to work entirely with masks and ignore Scope. In this case set Scope=100. You can see that the Scope function has been disabled and you will be able to use just the Blend function to combine the mask and the image.
* When you use the "Mask Tools" sliders available in "Mask & modifications" (Contrast curve mask, chroma mask, gamma mask, etc.), you must remember that they are sensitive to the specific deltaE settings for the mask i.e. "deltaE image mask " in the "Settings" module.
* When you use the Mask Tools sliders available in "Mask & modifications" (Contrast curve mask, chroma mask, gamma mask, etc.), you must remember that they are sensitive to the specific deltaE settings for the mask i.e. "deltaE Image mask" in the Mask & Merge panel in Settings.


[[File:masksimple1.jpg|600px|thumb|center|Result]]
[[File:masksimple1.jpg|600px|thumb|center|Result]]


====Improved result with 'Recovery based on luminance mask'====
====Improved result with "Recovery based on luminance mask"====


Normally we use masks in RT to:  
Normally we use masks in RawTherapee to:  
* improve detection (without blend)
* Improve detection (without blend).
* improve detection and add or subtract the mask to or from the image (with blend)
* Improve detection and add or subtract the mask to or from the image (with blend).
In this example we will use the light and dark areas of the mask to select which parts of the image will be modified by the 'Color & Light' settings and then combine them with the unmodified image as follows:  
In this example we will use the light and dark areas of the mask to select the parts of the image that will be modified by the Color & Light settings and then combine them with the unmodified image as follows:  
* the dark and black areas of the mask will be as close as possible to the original image.  
* The dark and black areas of the mask will remain as close as possible to the original image.  
* the very bright or white areas of the mask will also be as close as possible to the original image.  
* The very bright or white areas of the mask will also remain as close as possible to the original image.  
* the intermediate zone will correspond to the settings in the "Color and Light" tool.
* The intermediate zone will correspond to the settings in the Color & Light tool.


The area between the dark and light areas can be adjusted with the "Recovery based on luminance mask" slider.  
The area between the dark and light areas can be adjusted with the "Recovery based on luminance mask" slider.  


Note:  
Note:  
* to ensure that the  L*a*b* values of the Lockable Color Pickers correspond to the real values you need to set : "Local adjustments" > "Settings" > "Mask and merge" > "Background color for luminance and color masks = 0".  
* To ensure that the  L*a*b* values of the Lockable Color Pickers correspond to the real values you need to set : Local Adjustments > Settings > Mask and Merge > "Background color/luma mask” = 0 (slider labeled as “Background color for luminance and color masks” in screenshot).  


Image with "Color and Light" settings - without mask  
Image with Color & Light settings - without mask  


File pp3; [https://drive.google.com/file/d/1BWpBUd5qjpDHv_stdF5ord8qFGhxC0J0/view?usp=sharing]
File pp3; [https://drive.google.com/file/d/1BWpBUd5qjpDHv_stdF5ord8qFGhxC0J0/view?usp=sharing]
Line 1,043: Line 1,039:
=====Mask=====
=====Mask=====


Note the use of 'Blur mask' with 'Contrast threshold' and 'Radius'. This increases the gray value on the right-hand part of the salt mountain and reduces the effect of the 'Color and Light' adjustments.  
Note the use of Blur Mask with "Contrast threshold" and Radius. This increases the gray value on the right-hand part of the salt mountain and reduces the effect of the Color & Light adjustments.  
   
   
[[File:mask_recov.jpg|600px|thumb|center|Mask]]
[[File:mask_recov.jpg|600px|thumb|center|Mask]]
Line 1,049: Line 1,045:
=====Recovery of the original image characteristics=====
=====Recovery of the original image characteristics=====


* make sure that the mask is enabled in "Mask and modifications": "Enable mask" box checked.  
* Make sure that the mask is enabled in "Mask and modifications" and that the "Enable mask" box is checked.  
* open the expander "Recovery based on luminance mask"  
* Open the "Recovery based on luminance mask" expander.
* set the "Recovery threshold": the closer the slider is to "2", the more the dark and very bright areas of the mask will be taken into account and brought back to the original image values  
* Set the "Recovery threshold": the closer the slider is to the value "2", the more the dark and very bright areas of the mask will be taken into account and brought back to the original image values.
* use the "Dark area luminance threshold" and "Light area luminance threshold" sliders to include or exclude parts of the image. The corresponding values (here dark = 32.1 and Light = 85) are the two limits below and above which the effect of the mask will be progressively taken into account.  
* Use the "Dark area luminance threshold" and "Light area luminance threshold" sliders to include or exclude parts of the image. The corresponding values are the two limits below and above which the effect of the mask will be progressively taken into account (in this case the dark-area threshold = 32.1 and the light-area threshold = 85).  


* if necessary, use "decay" to adjust the rate of the decay.  
* If necessary, use “Decay strength" to adjust the rate of the decay.  
* try disabling the mask in "Mask and modifications" : "Enable mask" box unchecked.  
* Try disabling the mask in "Mask and modifications" ("Enable mask" box unchecked) to see the effect.  
* with the mask enabled ("Enable mask" box checked ) try to reset the 'Recovery threshold' slider to 1 in "Mask and modifications".  
* With the mask enabled ("Enable mask" box checked) try to reset the "Recovery threshold" slider to 1 in "Mask and modifications".  
* try varying other mask settings as well as the four "recovery"settings.
* Try varying other mask settings as well as the four "recovery"settings.


[[File:mask_recovend.jpg|600px|thumb|center|Recovery]]
[[File:mask_recovend.jpg|600px|thumb|center|Recovery]]


===Blending a mask with the original image===
===Blending a mask with the original image===
Line 1,067: Line 1,066:
====Preparation====
====Preparation====


* We could have used specific tools here to give a heightened impression of relief e.g. CBDL (Contrast by Detail Levels) or a Wavelet pyramid  
* We could have used specific tools here to give a heightened impression of relief e.g. CBDL (Contrast by Detail Levels) or a Wavelet pyramid.
* But for the purposes of this demonstration, we will use a mask with "blend".
* But for the purposes of this demonstration, we will use a mask with "blend".
* The preparation is identical to previous examples with "Scope (color tools)" set to 40 (arbitrary), and "Color and Light" in "Advanced" mode
* The preparation is identical to previous examples with "Scope (color tools)" set to 40 (arbitrary), and Color & Light in "Advanced" mode.


[[File:maskblendprepa1.jpg|600px|thumb|center|Preparation]]
[[File:maskblendprepa1.jpg|600px|thumb|center|Preparation]]


Raw file : [https://drive.google.com/file/d/1GdqejdnbW1kJFNY6y9sdQDlF2rCEGMCu/view?usp=sharing]
Raw file (Creative Common Attribution-share Alike 4.0): [https://drive.google.com/file/d/1GdqejdnbW1kJFNY6y9sdQDlF2rCEGMCu/view?usp=sharing]


====Mask settings what not to do====
====Mask settings: what not to do====


* For the purpose of this demonstration we will use 2 features:
* For the purpose of this demonstration we will use 2 features.
** the LC(H) curve to select the colors  
** The LC(H) curve to select the colors.
** a "Blur Mask" which combines a contrast threshold and a blur function
** A Blur Mask which combines a contrast threshold and a blur function.
* Note the checkbox "FFTW", which although it consumes resources, increases the possibilities and the quality of the results: in the case without FFTW the radius is limited to 100 whereas with FFTW it is increased to 1000.
* Note the checkbox FFTW, which although it consumes resources, increases the quality of the results. Without FFTW the radius is limited to 100 whereas with FFTW it is increased to 1000.


[[File:maskblendshow2.jpg|600px|thumb|center|The mask]]
[[File:maskblendshow2.jpg|600px|thumb|center|The mask]]
Line 1,087: Line 1,086:


* Once again, activate "Enable mask".  
* Once again, activate "Enable mask".  
* Set the value of "Blend" to whatever you like  
* Set the value of Blend to whatever you like.
* Adjust the "Smooth radius" mask if necessary.  
* Adjust the "Smooth radius" mask if necessary.  
* If you have enabled the non-mask settings of "Color and light" (lightness, contrast, etc.), the "Spot structure" slider will have an effect.  
* If you have enabled the non-mask settings of Color & light (lightness, contrast, etc.), the "Spot structure" slider will have an effect.  
* You can see that the image now has a dominant color. This is caused by using the "Blend" function with the LC(H) curve.  
* You can see that the image now has a dominant color. This is caused by using the Blend function with the LC(H) curve.  
** switch the curve to "Linear" mode and you will see that dominant color disappears
** Switch the curve to Linear mode and you will see that the dominant color disappears.
** to overcome this problem avoid combining several mask settings irrespective of whether they use "Blend" or not.  
** To overcome this problem avoid combining several mask settings, irrespective of whether they use Blend or not.  
** if you need to combine these settings, it is advisable, as in the simple mask case above, to create either a second (or several) RT-Spot(s) using the "duplicate", function and setting one to "Blend" and the other without (or with different "Blend" values). You can also use another mask associated with another tool.
** If you need to combine these settings, it is advisable, as in the simple mask case above, to create either a second (or several) RT-spot(s) using the Duplicate function and setting one to Blend and the other without (or with different Blend values). You can also use another mask associated with another tool.


====The right approach====
====The right approach====


As seen above, we need to take a two-step approach, for example by creating 2 spots:
As seen above, we need to take a two-step approach, for example by creating 2 spots.
* the first one to take into account the LCH curve
* The first one to take into account the LC(H) curve.
* the second to act on the structure
* The second to act on the structure.


=====Working on the structure=====
=====Working on the structure=====


There are several mask-type tools (in "Advanced" mode) which allow you to modify the structure:
There are several mask-type tools (in Advanced mode) that allow you to modify the structure:
* "Blur Mask" which includes a contrast threshold and a blur function
* Blur Mask which includes a contrast threshold and a blur function.
* "Structure Mask" which acts directly on the structure.
* Structure Mask which acts directly on the structure.
* For these two tools, the LCH curves must be inactive (no curves), however if you wish, you can associate the L(L) curve with LCH;
* When using these two tools, make sure that the LC(H) curve has not been activated (i.e. no curve).
* "Blur Mask" and "Structure Mask" can be associated with each other
* However if you wish to use the LC(H) curve, you can associate the L(L) curve with it.
* "Local contrast (by wavelet level)" and "Wavelet level selection", can be associated with the L(L) mask curve and generate a local-contrast effect.
* The Blur Mask and Structure Mask tools can also be associated with each other.
* "Local contrast” (by wavelet level) and "Wavelet level selection", can be associated with the L(L) mask curve and generate a local-contrast effect.


Reminder:
Reminder:
* Activate "Enable mask".
* Activate “Enable mask”.
* Set "Blend" to whatever value you like
* Set Blend to whatever value you like.
* Adjust "Smooth radius" mask if necessary
* Adjust "Smooth radius" mask if necessary.


[[File:maskblend2.jpg|600px|thumb|center|Result]]
[[File:maskblend2.jpg|600px|thumb|center|Result]]
Line 1,119: Line 1,119:
===How to use the Common Color Mask and an example of how to blend 2 RT-spots===
===How to use the Common Color Mask and an example of how to blend 2 RT-spots===


This mask does not work exactly like the other Local Adjustment masks. It does not complement a tool, like the mask in "Color and light" for example, but is a tool in its own right. You can use it to change the appearance of an image e.g. contrast, luminance, color, as well as its texture.  
This mask does not work in exactly the same way the other Local Adjustments masks. It does not allow you to modify the behaviour of an existing tool like the mask in Color & light for example, but is a tool in its own right. You can use it to change the appearance of an image e.g. contrast, luminance, color, as well as its texture.  
* It consists of the 3 curves C(C), L(L), LC(H), (or in "Advanced" mode, 3 curves plus "Structure Mask" & "Blur Mask") which will generate differences in the color or structure of the image when compared to the original image.
* It consists of the 3 curves C(C), L(L), LC(H), (or in Advanced mode, 3 curves plus Structure Mask & Blur Mask), which will generate differences in the color or structure of the image when compared to the original image.
* These "differences" are similar to the differences generated by the "Lightness", or "Chrominance" functions in "Color and Light".
* These "differences" are similar to the differences generated by the Lightness, or Chrominance functions in Color & Light.
* The color differences between the mask image and the original image are taken into account by the deltaE (ΔE) and transition parameters.
* The color differences between the mask image and the original image are taken into account by the deltaE (ΔE) and transition parameters.
* Of course you can use it also in association with other tools in the same RT-spot
* Of course you can also use it in conjunction with other tools in the same RT-spot.
* The simple example that follows allows you to understand how it works; it fits with the "philosophy" of Local Adjustments in so far as it makes use of ΔE
* The simple example that follows allows you to understand how it works. It is based on the same ΔE principles as the other tools in Local Adjustments.


====Preparation====
====Preparation====


Repeat the preliminary steps outlined in previous examples and add the tool to the RT-spot.
Repeat the preliminary steps outlined in previous examples and add the tool to the RT-spot.
* "Add tool to current spot...", "Common color mask" - "Standard", and for the purpose of the demonstration, do not open any other tools.  
* "Add tool to current spot" > Common Color Mask > Standard. For the purposes of the demonstration, do not open any other tools.  
* To create the mask, we will simplify the exercise as much as possible by using only 2 curves C(C) and L(L) only take into account the references of the RT-spot  
* To create the mask, we will simplify the exercise as much as possible by using only 2 curves C(C) and L(L) to take into account the references of the RT-spot.
* Note that the 2 sliders "Add/subtract luminance mask " and "Add/subtract chrominance mask" are not set to zero, so that the user is not confused by a lack of response from the system; the two values -10 are arbitrary and low.
* Note that the 2 sliders "Add/subtract luminance mask " and "Add/subtract chrominance mask" are not set to zero, so that the user is not confused by a lack of response from the system; the two values -10 are arbitrary and low.


[[File:common-maskprepa1.jpg|600px|thumb|center|Preparation]]
[[File:common-maskprepa1.jpg|600px|thumb|center|Preparation]]


Raw file:[https://drive.google.com/file/d/1aWvYbW-rDPQaLWoRzbK5HAcz9dU0GHFU/view?usp=sharing]
Raw file (Creative Common Attribution-share Alike 4.0):[https://drive.google.com/file/d/1aWvYbW-rDPQaLWoRzbK5HAcz9dU0GHFU/view?usp=sharing]


====Luminance Mask====
====Luminance Mask====


The curve makes a small change to the luminance.  
The curve makes a small change to the luminance.  
* Notice the position of the top of the curve on the gray transition. The "Luminance" mask matches the reference value of the RT-spot.
* Note the position of the top of the curve on the gray transition. This means that the Luminance mask matches the reference value of the RT-spot.


[[File:common-mask-showL1.jpg|600px|thumb|center|Luminance mask]]
[[File:common-mask-showL1.jpg|600px|thumb|center|Luminance mask]]
Line 1,146: Line 1,146:
====Chrominance Mask====
====Chrominance Mask====


* Notice the position of the top of the curve on the gray transition. The "Chrominance" mask matches the reference of the RT-spot.
* Notice the position of the top of the curve on the gray transition. This means that the Chrominance mask matches the reference value of the RT-spot.


[[File:common-mask-showC1.jpg|600px|thumb|center|Chrominance mask]]
[[File:common-mask-showC1.jpg|600px|thumb|center|Chrominance mask]]
Line 1,152: Line 1,152:
====Preview ΔE====
====Preview ΔE====


From here you can play with the deltaE (ΔE) between "Image + Mask" and "Original Image".
From here you can play with the deltaE (ΔE) between "Image + Mask" and Original Image.
* Try increasing or decreasing the "Scope" (make sure you use the "Common color mask" slider and not the slider in the "Settings" module above).  
* Try increasing or decreasing the Scope (make sure you use the Common Color Mask slider and not the slider in the Settings module above).  
* Try adjusting the parameters in the "Settings" module "Shape detection" : "Threshold ΔE-scope", "ΔE decay", "ab-L balance (ΔE)", "C-H balance (ΔE)"
* Try adjusting the parameters in the Settings "Shape detection" panel: "Threshold ΔE-scope", "ΔE decay", "ab-L balance (ΔE)", "C-H balance (ΔE)".


[[File:common-mask-previewdE1.jpg|600px|thumb|center|Preview deltaE - ΔE]]
[[File:common-mask-previewdE1.jpg|600px|thumb|center|Preview deltaE - ΔE]]
Line 1,160: Line 1,160:
====Show modifications====
====Show modifications====
Go to "Show modifications with mask".
Go to "Show modifications with mask".
* Adjust "Add/subtract luminance mask " and "Add/subtract chrominance mask " (these sliders could also have been called "Opacity")
* Adjust "Add/subtract luminance mask " and "Add/subtract chrominance mask " (these sliders could also have been called "opacity").


[[File:common-mask-modif1.jpg|600px|thumb|center|Show modifications]]
[[File:common-mask-modif1.jpg|600px|thumb|center|Show modifications]]
Line 1,166: Line 1,166:
====Result====
====Result====


You can change:  
You can:  
* "Scope" (the "Common Color Mask" slider which acts on ΔE)  
* Change the Scope (the Common Color Mask slider which acts on ΔE).
* Activate the "Smooth radius" mask, which will try to reduce the artifacts due to the the fact that the mask has been generated by 3 curves - C(C), L(L), LC(H).  
* Activate the "Smooth radius" mask, which will try to reduce the artifacts caused by the fact that the mask has been generated by 3 different curves - C(C), L(L), LC(H).  
* The "Chroma" mask  
* Change the Chroma mask.
* Adjust the "Contrast curve" mask
* Adjust the "Contrast curve" mask.
* Try "Scope (ΔE image mask)" in "Settings: this slider acts on the mask and takes into account the deltaE of the mask compared to the center of the RT-spot. It is different from the "Scope" (the first slider of the "Common Color mask") which acts on the difference between the original image and the mask you have created
* Try "Scope (ΔE image mask)" in Settings: this slider acts on the mask and takes into account the deltaE of the mask compared to the center of the RT-spot. It is different from Scope (the first slider of the Common Color Mask), which acts on the difference between the original image and the mask you have created.


Switch to "Advanced" mode  
Switch to Advanced mode.
* Adjust the "Soft Radius" slider which will reduce any artifacts between the original image and the one obtained after "adding" the mask. The default value is 1 even in "Standard" mode and produces a small variation - even without the mask – which can be seen in "Show modifications".  
* Adjust the Soft Radius slider which will reduce any artifacts arising from differences between the original image and the one obtained after "adding" the mask. The default value is 1 even in Standard mode and produces a small variation - even without the mask – which can be seen in "Show modifications".  
* Try the "Laplacian threshold" mask, and note the difference compared to the "Smooth radius" mask.  
* Try the "Laplacian threshold" mask, and note the difference compared to the "Smooth radius" mask.  
* Try the "Gamma" and "Slopemasks.  
* Try the Gamma and Slope masks.  
* Try to change the structure with one of the tools provided: "Structure Mask ", "Blur Mask ", "Local contrast (by wavelet level)" mask.  
* Try to change the structure with one of the tools provided: Structure Mask, Blur Mask, "Local contrast” (by wavelet level) mask.  
* Try the "Graduated Filter Mask".
* Try the Graduated Filter Mask.


[[File:common-mask1.jpg|600px|thumb|center|Result]]
[[File:common-mask1.jpg|600px|thumb|center|Result]]


Now we are going to enhance the "Common Color Mask" image with the "Merge file" tool in "Color and Light".  
Now we are going to enhance the Common Color Mask image with the "Merge file" tool in Color & Light.  


====Adding a new RT-spot "Color and light" - Advanced mode====
====Adding a new RT-spot Color & Light - Advanced mode====


For demonstration (and not artistic) purposes , we will use 3 of the 21 possible blend modes  
For demonstration (and not artistic) purposes, we will use 3 of the 21 possible blend modes.
* Add a new RT-spot  
* Add a new RT-spot.
* Add a "Color and Light" tool in "Advanced" mode
* Add a Color & Light tool in Advanced mode.
* Set the "Scope (color tools)" correctly (with Preview ΔE)  
* Set the "Scope (color tools)" correctly (using Preview ΔE).
* Choose 3 settings to increase the luminance, contrast and chrominance
* Choose 3 settings to increase the luminance, contrast and chrominance


Line 1,196: Line 1,196:
====Preparing the "merge" ====
====Preparing the "merge" ====


* Choose "Previous spot". We are now going to merge the new RT-spot (Color and Light) with the previous one (Common Color Mask)
* Choose "Previous spot". We are now going to merge the new RT-spot (Color & Light) with the previous one (Common Color Mask).


[[File:common-color-prepa1.jpg|600px|thumb|center|Preparing the merge]]
[[File:common-color-prepa1.jpg|600px|thumb|center|Preparing the merge]]


====First merge using "Normal" blend mode====
====First merge using Normal blend mode====


* Choose the "Normal" blend mode
* Choose the Normal blend mode.
* We arbitrarily choose 3 settings: Merge background = 54.2 (takes into account the deltaE between the 2 layers), Opacity = 54.2 (about 50% for each), Contrast threshold = 12.5 (takes into account the differences between uniform and textured areas).
* We arbitrarily choose 3 settings: “Merge background” = 54.2 (takes into account the deltaE between the 2 layers), Opacity = 54.2 (about 50% for each), Contrast Threshold = 12.5 (takes into account the differences between uniform and textured areas).
* The two identical values of 54.2 are arbitrary and you can choose other values 43, 68, etc.
* The two identical values of 54.2 are arbitrary and you can choose other values 43, 68, etc.


[[File:common-color-normal1.jpg|600px|thumb|center|Merge with 'Normal' blend mode]]
[[File:common-color-normal1.jpg|600px|thumb|center|Merge with Normal blend mode]]


====Second merge using "Soft Light (legacy)" blend mode====
====Second merge using "Soft Light (legacy)" blend mode====
Line 1,214: Line 1,214:
[[File:common-color-softphot1.jpg|600px|thumb|center|Merge using Soft Light (legacy)]]
[[File:common-color-softphot1.jpg|600px|thumb|center|Merge using Soft Light (legacy)]]


====Third merge using "Color Burn" blend mode====
====Third merge using Color Burn blend mode====
* Change the blend mode and choose "Color Burn" (the choice is completely arbitrary).  
* Change the blend mode and choose Color Burn (the choice is completely arbitrary).  
* Note the differences in luminance and chrominance
* Note the differences in luminance and chrominance.


[[File:common-color-colburn1.jpg|600px|thumb|center|Merge using "Color Burn" blend mode]]
[[File:common-color-colburn1.jpg|600px|thumb|center|Merge using "Color Burn" blend mode]]
Line 1,222: Line 1,222:
====Additional information====
====Additional information====


Of course, you can create as many "Common color mask" as you want. Simply duplicate the "mask" and place it close to the previous one with similar settings ...  
Of course, you can create as many Common Color Masks as you want. Simply duplicate the mask and place it close to the previous one and use similar settings.  


Some important points about the mask curves : C(C), L(L), LC(H)  
Some important points about the mask curves C(C), L(L), LC(H).  
The effect of the combined LC (H) curve can be visualised by looking at the spatial representation of the Lch coordinates below. As you move up and down the vertical L axis, there will be a corresponding increase or decrease in the chroma values.
[[File:Basic_Gamut_with_tags.jpg|600px|thumb|left|Gamut]]


* These curves are used to create the mask.
* For each of the curves, the vertical dark-gray/light-gray separation line represents the 3 references of the RT-spot: luminance, chroma and hue.
* For the first curve shown below (with the highest point of the curve on the selection – L in this case), the deltaE selection is improved.
* For the second curve shown below, the hue used by the mask corresponds to the hue reference of the RT-spot (the peak of the curve is on the selection – H in this case). Pulling the curve downwards will progressively mask (or reduce the impact) of whatever adjustment has been applied to the selected hue (or L, or C depending on which of the curves you are using).
* For the third curve shown below, the hue selection for the mask does not match the hue reference of the RT-spot. In this case, pulling the curve downwards will progressively mask whatever adjustment (luminance and chrominance) has been applied to that particular color.


* These curves are used to create the mask
Note that the effect of the combined LC (H) curve can be visualised by referring to the spatial representation of the Lch coordinates i.e. as you move up and down the vertical L axis, there will be a corresponding increase or decrease in the chroma values.  
* For each of the curves, the vertical dark gray/light gray separation line represents the 3 references of the RT-spot: Luminance, Chroma and Hue
* For the first curve shown below (with the highest point of the curve on the selection - in this case L), the deltaE selection is improved.
* For the second curve shown below, the hue used by the mask corresponds to the hue reference of the RT-spot (the peak of the curve is on the selection – in this case H). Pulling the curve downwards will progressively mask (or reduce the impact) of whatever adjustment has been applied to the selected hue (or L, or C depending on which of the curves you are using) .
* For the third curve shown below, the hue selection for the mask does not match the hue reference of the RT-spot. In this case, pulling the curve downwards will progressively mask whatever adjustment (luminance and chrominance) has been applied to the particular color.  


[[File:mask-curve.jpg|600px|thumb|center|Mask selection]]
[[File:mask-curve.jpg|600px|thumb|center|Mask selection]]


* For this demonstration we used an image with two dominant colors: magenta (flower) and green (foliage). Images that have more varied color, luminance and chrominance (e.g. sky, sea, mountains, houses, fields, flowers, portraits ...) would require more elaborate masks.  
* For this demonstration we used an image with two dominant colors: magenta (flower) and green (foliage). Images that have more varied color, luminance and chrominance (e.g. sky, sea, mountains, houses, fields, flowers, portraits etc.) would require more elaborate masks.  
* We stay with the "philosophy" of Local Adjustments, by only relying on the references of the RT-spot. We could of course have used just the curves outlined above but this would have given a completely different result.
* We stay with the "philosophy" of Local Adjustments, by only relying on the references of the RT-spot. We could of course have used just the curves outlined above but this would have given a completely different result.
* Similarly, for the merge we chose the same color range as for the mask. We could have made another choice for the second RT-spot, by positioning it on the foliage but the result of the merge would have been different, with less variation in the flowers.
* Similarly, for the merge we chose the same color range as for the mask. We could have made another choice for the second RT-spot, by positioning it on the foliage but the result of the merge would have been different, with less variation in the flowers.
Line 1,244: Line 1,243:


The portrait of Mairi gives us the opportunity to use several local-adjustment tools. We are going to:
The portrait of Mairi gives us the opportunity to use several local-adjustment tools. We are going to:
* Increase the "Exposure" of the image so that it is less dark.  
* Increase the Exposure of the image to make it lighter.  
* Use "CBDL" to soften the skin and "Clarity" to lighten the face.
* Use CBDL to soften the skin and Clarity to lighten the face.
* Make a "Graduated filter" to open up the shadows of the face on the right-hand side of the image.  
* Make a Graduated Filter to open up the shadows of the face on the right-hand side of the image.  
* Use 3 "Excluding" spots to "exclude" the eyes and lips from the adjustments
* Use 3 Excluding spots to "exclude" the eyes and lips from the adjustments.
* Use an LC(H) mask to "exclude" the hair from the softening adjustments (to avoid losing definition).  
* Use an LC(H) mask to "exclude" the hair from the softening adjustments (to avoid losing definition).  
* Compare the result 'before' and 'after'.  
* Compare the result "before" and "after".  
* Remark: the settings have been given as an indication and are a matter of individual taste
* Remark: the settings have been given as an indication and are a matter of individual taste.


[[File:mairi.jpg|600px|thumb|center|Preparation]]
[[File:mairi.jpg|600px|thumb|center|Preparation]]


Raw file:  [https://drive.google.com/file/d/1m4UBhES2AVe_sJNqMVSz5jA-Qg-s7LHt/view?usp=sharing]
Raw file (Copyright Pat David - Creative Common Attribution-share Alike 4.0):  [https://drive.google.com/file/d/1m4UBhES2AVe_sJNqMVSz5jA-Qg-s7LHt/view?usp=sharing]


====Increasing exposure====
====Increasing exposure====


* Exposure + 0.5
* Exposure + 0.5
* Note: we could have used an RT-spot to limit the exposure increase to a particular area instead of an overall increase in exposure.
* Note: we could have used an RT-spot to limit the exposure increase to a particular area instead of applying an overall increase in exposure.


[[File:mairiexp05.jpg|600px|thumb|center|Exposure increase]]
[[File:mairiexp05.jpg|600px|thumb|center|Exposure increase]]
Line 1,267: Line 1,266:
* Create an RT-spot with a large "Spot size" = 47
* Create an RT-spot with a large "Spot size" = 47
* Make a gradual contrast reduction for levels 0 to 4
* Make a gradual contrast reduction for levels 0 to 4
* Set "Clarity" to 60
* Set Clarity to 60
* Set "Scope" to 40
* Set Scope to 40


[[File:mairi-cbdl_1.jpg|600px|thumb|center|CBDL]]
[[File:mairi-cbdl_1.jpg|600px|thumb|center|CBDL]]
Line 1,274: Line 1,273:
====Graduated Filter====
====Graduated Filter====


* Create another "Color and Light" RT-spot  
* Create another Color & Light RT-spot.
* Graduated filter settings: "Luminance" = -0.6; "Gradient angle" = 71.5
* Graduated Filter settings: Luminance = -0.6; “Gradient angle” = 71.5
* You can also play with the chrominance settings (Advanced mode)
* You can also play with the chrominance settings (Advanced mode).


[[File:mairi-grad1.jpg|600px|thumb|center|Graduated Filter]]
[[File:mairi-grad1.jpg|600px|thumb|center|Graduated Filter]]
Line 1,282: Line 1,281:
====Excluding the eyes and lips====
====Excluding the eyes and lips====


* Create 3 "Excluding" RT-spots on the eyes and lips
* Create 3 Excluding RT-spots on the eyes and lips.
* Adjust the "Scope" (excluding) to obtain the desired result
* Adjust the Scope (excluding) to obtain the desired result.


[[File:mairi-excluding1.jpg|600px|thumb|center|Excluding]]
[[File:mairi-excluding1.jpg|600px|thumb|center|Excluding]]
Line 1,289: Line 1,288:
====Hair exclusion mask====
====Hair exclusion mask====


* Go back to the first RT-spot  
* Go back to the first RT-spot.
* Go to "Mask and modifications"
* Go to "Mask and modifications".
* Select "Show mask"
* Select "Show mask".
* Open the LC(H) curve
* Open the LC(H) curve.
* Identify the color of the skin (the boundary between the light and dark gray areas on the graph)  
* Identify the color of the skin (the boundary between the light and dark gray areas on the graph).
* Lower the curve as shown in the graph (or similar)  
* Lower the curve as shown in the graph (or similar).
* Adjust the "Smooth radius"  mask
* Adjust the "Smooth radius"  mask.
* Adjust the "Gamma", "Slope", "Contrast curve"  mask if necessary
* Adjust the Gamma, Slope, Contrast-curve masks if necessary.


[[File:mairi-mask_1.jpg|600px|thumb|center|Mask]]
[[File:mairi-mask_1.jpg|600px|thumb|center|Mask]]
Line 1,302: Line 1,301:
====Result====
====Result====


* Set the mask to "Show image with modifications"
* Set the mask to "Show image with modifications".
* Check the "Enable mask" checkbox
* Check the "Enable mask" checkbox.


[[File:mairi-fin1.jpg|600px|thumb|center|Result]]
[[File:mairi-fin1.jpg|600px|thumb|center|Result]]
Line 1,311: Line 1,310:
[[File:mairi-befaft1.jpg|600px|thumb|center|Before & After]]
[[File:mairi-befaft1.jpg|600px|thumb|center|Before & After]]


====An alternative - replace CBDL with "Wavelet contrast by level".====
====An alternative - replace CBDL with Wavelets “Contrast by level".====


* The "Wavelet" module is more powerful than CBDL (Contrast By Detail Levels) and may seem more complex given the number of options.  
* The Wavelets module is more powerful than CBDL (Contrast By Detail Levels) and may seem more complex given the number of options.  
* However, it allows you to target the CBDL effect by using the "Attenuation Response" (Damper) and "Offset" sliders. This means that instead of applying the changes linearly to the wavelet decomposition signal, they will be adjusted depending on the value of the signal to avoid amplifying defects such as noise.  
* However, it allows you to target the CBDL effect by using the "Attenuation Response" (Damper) and Offset sliders. This means that instead of applying the changes linearly to the wavelet decomposition signal, they will be adjusted depending on the actual value of the signal to avoid amplifying defects such as noise.  
* The wavelet option also has a "Clarity" function.
* The wavelet option also has a Clarity function.


[[File:mairi-wav_1.jpg|600px|thumb|center|Wavelet contrast by level and Clarity]]
[[File:mairi-wav_1.jpg|600px|thumb|center|Wavelet contrast by level and Clarity]]

Revision as of 10:27, 11 June 2021

Local Adjustments

Introduction

Local editing in RawTherapee is based on RT-spots, which are similar in principle to the U-Point concept originally used in Nikon Capture NX2 and subsequently in the Nik Collection, DxO PhotoLab and Capture NXD. RT-spots use algorithms developed specifically for RawTherapee by Jacques Desmis.
This approach is completely different to the more familiar local editing methods used in applications such as GIMP, Photoshop, etc., which primarily use selection tools such as lassos, magic wands etc., associated with brushes, layers and blend masks. These methods can be time consuming and difficult to use accurately when complex shapes are involved.
An RT-spot consists of either an ellipse or a rectangle with a variable-diameter circle at the center. The shapes have four control points, which can be adjusted independently or symmetrically. The rectangle spot can also be used in full-image mode which automatically sets the control points outside the image preview area. Future developments will provide enhanced shape manipulation.

The RT-spot algorithm uses shape detection based on ΔE (the change in the visual perception of two given colors) to select the parts of the image to be modified inside the ellipse or rectangle. The reference values used for the shape detection algorithm are based on the average of the hue, chroma and luminance values inside the variable-diameter circle. This means that in full-image mode (and also in Normal or Excluding modes) these values and the subsequent shape detection can vary depending on the position of the circle.

The extent to which these modifications are applied can be finely controlled allowing for very precise selections. Further refinement is possible with additional parametric masks but the shape-detection algorithms should be sufficient for the vast majority of local editing requirements. RT-spots can also be used in Excluding mode to prevent the algorithm from influencing certain parts of the image. The modifications that can be carried out are extensive and incorporate most of the functions available in RawTherapee's global adjustment tools along with some additional tools available only in the Local Adjustments tab.

Note: provided the checkbox “Avoid color shift” in the Settings module has not been disabled, the following operations will be carried out on the data before and after any RT Spot is activated.

  • A relative colorimetric correction to keep the data within gamut.
  • A Munsell correction using LUTs to ensure that the data remains linear and avoid hue shifts.

The tools are grouped in the following modules (Tool name - position in pipeline):

Color & Light - 11

Adjust color, lightness, contrast and correct small defects such as red-eye, sensor dust etc. Other functions include a graduated filter, L*a*b* curves and blend modes.

Shadows/Highlights & Tone Equalizer - 6

Adjust shadows & highlights either with the shadows/highlights sliders or with a tone equalizer. Can be used instead of, or in conjunction with the Exposure module. Can also be used as a graduated filter.

Vibrance & Warm/Cool - 5

Adjust vibrance (essentially the same as the global adjustment). Carry out the equivalent of a white-balance adjustment using a CIECAM algorithm.

Log Encoding - 0

Adjust underexposed or high-dynamic-range images using a log-encoded algorithm.

Dynamic Range & Exposure - 10

Modify exposure in L*a*b* space using Laplacian PDE algorithms to take into account deltaE and minimize artifacts. Laplacian operators are used because they are particularly good at detecting fine details but you do not need to understand how they work to use this tool!

Common Color Mask - 12

A tool in its own right. Can be used to adjust the image appearance (chrominance, luminance, contrast) and texture as a function of Scope.

Soft Light & Original Retinex - 7

Apply a Soft-light blend (identical to the global adjustment). Carry out dodge and burn using the original Retinex algorithm.

Blur/Grain & Denoise - 1

Can be used to blur backgrounds, soften skin, add film grain and denoise.

Tone Mapping - 2

Same as the tone mapping tool in the main menu. The main menu tool must be deactivated if this tool is used.

Dehaze & Retinex - 3

Dehaze and Retinex (Advanced mode only). Useful for dehaze, local contrast with high values and simulation of "clarity".

Sharpening - 8

Uses RL deconvolution sharpening. View at 1:1

Local Contrast & Wavelets - 8

  • Local Contrast: basically the same functions as Local Contrast in the Detail tab.
  • Wavelets: based on Wavelet Levels in the Advanced tab with essentially the same features (clarity, contrast, blur, etc., see documentation). Its use in Local Adjustments provides additional possibilities such as the removal of large blemishes, grease stains etc.

Contrast By Detail Levels - 4

Contrast by detail levels. Can be used to remove sensor or lens marks.

Each tool module can be toggled between Basic, Standard & Advanced modes. The default mode can be set in RawTherapee's Preferences window.

The examples in the next section are designed to give an overview of some of the ways the various tools can be used for local adjustments. However, if you prefer to explore the possibilities by yourself, then try setting the “Default complexity for Local Adjustments” in the Preferences module to Basic and uncheck the "Show additional settings" checkbox at the top of the Local Adjustments module. This will give you a simplified yet powerful version of Local Adjustments.

Explore the capabilities of the Color & Light, "Shadows/Highlights & Tone Equalizer" and "Vibrance & Warm/Cool" tools to start with and don't hesitate to try out the additional functionality by manually setting the complexity mode to Standard (in the combobox in the module you are working on).

The Color & Light tool is extremely powerful and includes functions from both the "Color Toning > Color correction regions" module in the main-menu Color tab as well as the L*a*b* curves available in the Exposure tab.

Combining tools in a single spot

Most of the local-adjustment tools can be used together in the same RT-spot. However, combinations of Log Encoding, Tone Mapping and Retinex should be avoided. This is because the output TIFF or JPG may not correspond to the Preview particularly when the Preview has been magnified using the zoom function.

Associating any one of the above tools with the other local-adjustment tools such as Color & Light, does not pose a problem.

If you do wish to use combinations of the 3 tools mentioned above you can simply add another RT-spot in close proximity to the first one.

For example, the first RT-spot could be dedicated to Log Encoding, and the second dedicated to Tone Mapping or Retinex. Other tools can be added to either of the two RT-spots as required.

Getting started

Please note: the screenshots in the following examples are currently being updated to take into account the latest developments. Because of this, some of the slider and module names will be different from the text.

Activating Local Adjustments

  • In the Tab tool bar, select the "hand" icon (Local Adjustments tab).
  • Turn on the Local Adjustments power button (if it is not already activated) and expand the Settings module.
  • Select Add.
    Original

Preparation

Position the RT-spot at the desired location. In this case, we want to increase the saturation of the red flower and reduce the luminance (lightness) without affecting the rest of the image.

  • Move the center of the RT-spot so that it is located on an area representative of what you want to change.
  • Position the 4 delimiters well beyond the flower.
  • Select the Lockable Color Picker and locate 3 colors: a) one on the red flower, b) one on the blue sky, c) one on a green leaf.
  • In the example the 3 colors are:
    • Red flower L=48.6 a=74.4 b=47.0
    • Blue sky : L=68.6 a=-3.1 b=-16.6
    • Green leaf : L=48.3 a=-28.3 b=51.4
Preparation

Raw file (Jacques Desmis - Creative Common Attribution-share Alike 4.0): [1]

Adding the Color & Light tool

In the settings menu, choose "Add tool to current spot".

  • You will see a list of choices: Color & Light, Shadows/Highlights & Tone Equalizer etc. For each RT-spot you can associate one or more tools from the list. The processing order in the pipeline corresponds to the number at the end of the tool description as described in the Introduction: "Log Encoding - 0" is first (if it is activated), "Color & Light -11" is the last. This is also the case for the associated masks.
  • Select Color & Light.
Adding the Color & Light tool

Adjusting luminance (lightness) and chrominance

  • Set Lightness to -70
  • Set Chrominance to 130
  • Review the results.
  • The red flower now has a new color L= 41.3, a = 66.0, b = 50.4
  • The sky is unchanged.
  • The green leaf is unchanged.
Adjusting luminance (lightness) and chrominance

Color Tool Scope and Transition Value

In the Settings module:

  • Observe the effect of moving the "Scope (color tools)" slider.
    • If you reduce the value (default 30) only a part of the reds will be affected.
    • If you increase the value, the sky, then the green leaf, then the whole image will be taken into account (Scope=100).

Leave the Scope value at 100 and in the Settings module select "Show additional settings".

  • Observe the effect of moving the "Transition value" slider:
    • Reduce the value to 5.
    • Increase the value to 100 and see the result.

Previewing the adjustment area using deltaE (ΔE)

You can preview the areas of the image that will be affected by any changes. The preview does not show the changes themselves or the transitions, but allows you to set the scope of any adjustments.

There are two possibilities.

  • Use the Preview ΔE button located in Settings. This will only work properly if you have activated one (and only one) of the color tools in "Add tool to current spot" menu.
  • Use the Preview ΔE option in the "Mask and modifications" menu associated with a particular tool (standard and advanced modes only). In this case the GUI takes into account any adjustments made with the tool and works regardless of the number of activated tools.

You can vary the intensity and color of this preview with "ΔE preview color " in the "Shape detection" section of the Settings module. The preview will also let you see the effect of varying the other sliders in the “Shape detection” section.

Previewing the modifiable area

Viewing the changes

To see the changes:

  • Go to "Mask and modifications" > "Show modifications without mask" (don't forget to select either Standard or Advanced in the Color & Light combobox) .
  • You can see the effects of any changes to luminance, contrast, color and saturation, as well as any changes to the texture or structure of the image.
  • You can also see the effect of the transition settings.
    • "Transition value": percentage of the area that will receive the full effect of any adjustments before dropping off to zero.
    • "Transition decay": the rate with which the zone of influence decreases.
    • "Transition differentiation XY": difference in coverage between abscissa and ordinate.

Try out the following and observe the effect.

  • Change the "Scope (color tools)". Remember that the scope slider acts on deltaE.
  • Transition settings.
  • Tool settings (luminance, chroma, etc.).
Viewing the modified areas

Work on the full image using an Excluding spot

Local adjustments are not limited to local touch-ups. You can also use the Local Adjustments tool to process the full image.

In Settings enable "Show additional settings":

  • Set the "RT-spot shape" to “Full image”
  • This will set the 4 delimiters outside of the preview
  • It will also set the transition to 100 (you can use another value if you wish to generate a gradient, bearing in mind that there are other tools for making gradients). You are now ready to use all the tools in full-image mode.
Working on the complete image - settings

Example: changing the color of all the green leaves, except for one

Changing the color of the leaves

  • You can use the "a" and "b" components of "Lab" in the "Color correction grid ", by choosing Direct (combobox under the grid) and a high value of Strength. Moving the dots on the grid as shown will change the color of all the leaves.
  • You can adjust if necessary with "Scope (color tools)".
  • The other colors in the flower, sky etc., are not modified.
Changing the color of the leaves

Restoring the green color to one of the leaves

  • Add a second RT-spot (Add in the Settings module).
  • Choose "Spot method" = "Excluding spot".
  • Move the RT-spot to the leaf to be changed and expand the spot well beyond the edges of the leaf.
  • Adjust Scope (under the Excluding heading in Settings) until you get the desired effect.
  • If you wish, you can use the Excluding spot in the same way as a normal RT-spot and add tools such as Denoise, Blur, etc. (i.e. it not only “excludes" the effect of the adjacent spot, but it also allows you to use it in the same way as normal spot for the area it encompasses).
Using the Excluding spot

Correcting red-eye and removing sensor defects

3 steps: preparation, RT-spot adjustment, red-eye removal.

Preparation

  • Choose a large area around the eye.
  • Put the RT-spot on the red area of the eye (pupil).
  • Set 4 Lockable Color Pickers so that you can see the changes.
Preparation

Adjusting the RT-spot

  • Add the Color & Light tool.
  • Press the "Preview deltaE" button in Settings.
  • Adjust the RT-spot to obtain the desired level of selection.
    • In this example we have chosen to reduce the spot size to 14.
    • "Scope (color tools)" = 18.
Preview dE

Removing the red color

  • In the Color and Light tool, reduce the chrominance to -100.
  • Observe the result.
    • The pupil of the eye has almost no dominant color anymore.
    • The iris, cornea and facial skin are unchanged.
    • You may need to change the "Transition value" (lower it) and "Transition decay" (increase it) in "Settings" depending on the case.
Eye with red color removed

Removing sensor defects or spots

The principle is the same as above for removing small sensor faults but in this example we will use different tools.

  • Either CBDL (Contrast By Detail Levels),
  • or Wavelet Pyramid2 > “Contrast by level” (Advanced).
  • In both cases, reduce the contrast for the lower levels of decomposition.
  • Adjust "Blur levels" if necessary (Wavelet Pyramid1).
  • Use a low "Transition value" (less than 20) and high "Transition decay" (greater than 15) in the Settings module.
  • The minimum size of the RT-spot for the CBDL and Wavelet Pyramid2 decomposition to function is 32x32 pixels. There are workarounds such as the use of transitions and deltaE to deal with defects smaller than the spot.

Example: removing multiple spots using Wavelet Pyramid2.

  • Looking at the image below, we can see that it is blotchy.
Multiple blotches
  • A possible solution:
    • Activate the tool Local Contrast & Wavelets.
    • Choose Advanced in the first combobox and then Wavelets in the second combobox.
    • Adjust Scope to 20.
    • Go to Pyramid2 and activate "Contrast by level".
    • Set high values of "Attenuation response", Offset and "Chroma levels" (if necessary).
    • Activate the "Contrast by level" curve and reduce the contrast for the lower levels.
Fewer blotches

Dodging and Burning

In many portraits, or photos where light falls directly on the skin, an unpleasant contrast-enhancement phenomenon occurs. Some parts of the skin are slightly overexposed, while others are slightly underexposed.

  • Traditionally this problem is treated with masks and layers and there are numerous tutorials for doing this with the GIMP and Photoshop (c). You could probably use RawTherapee's Local Adjustments masks also.
  • Here we are going to use the Original Retinex concept (based on Ipol research). It was developed in the 1970s and was originally designed for this sort of application and not for the way it has been subsequently used in Rawtherapee and elsewhere. We are going to:
    • Use one or more adjustable-threshold Laplacian functions (see note below).
    • Solve the Poisson equation (PDE - Partial Derivative Equation).
    • Balance the luminance values.

Note: Laplacian operators are used because they are particularly good at detecting fine details and Poisson equations are used to solve the partial differential equation generated by the Laplacian and make the tool usable. But you do not need to understand how they work to use this tool!

There are 3 steps: Preparation, Laplacian settings and preview, Result

Preparation

  • The deltaE adjustment, the Scope (make sure you use the Original Retinex Scope) and the transition adjustment principles are identical to the previous examples and won't be repeated here.
  • The portrait we are going to use has had the eyes masked for confidentiality reasons.
  • Choose "Add tool to current spot" > Soft Light & Original Retinex > Advanced > Original Retinex.
Preparation

Adjusting the Laplacian threshold and viewing the changes

  • Adjust the Strength slider (which takes into account the threshold of the first Laplacian operator).
  • Adjust the "Laplacian threshold deltaE" slider (which takes into account the deltaE of the image to act on a second Laplacian operator). This processing is upstream of the Scope algorithms and can take into account differences in the background.
  • View the modifications by choosing: "Show Fourier process" > "Show modifications without mask".
Show Modifications

Results

Results

A similar algorithm is used in the Dynamic Range & Exposure tool. It can be used to process images with large differences in exposure that are often globally underexposed.


Making a graduated filter based on luminance, chrominance and hue (gradient filter)

Preparation

  • Choose the flower image that was used in the first example.
  • Identify 7 points with the "Lockable color picker".
  • Add the Color & Light tool to the current spot and select “Advanced” mode.
Preparation

Raw file (Creative Common Attribution-share Alike 4.0): [2]

Making a graduated filter

Arbitrarily we have chosen the following settings:

  • Luminance gradient strength = -0.44
  • Chrominance gradient strength = -1.13
  • Hue gradient strength = 2.69
  • Gradient angle = -87.6
  • Scope (color tools) = 30
  • Feather gradient(settings) = 25
Luminance, Chrominance & Hue Gradient

Changing the default settings

  • Try to gradually change "Scope (color tools)" by increasing the value to 70 then 75, 80, 85, 90 and 100.
  • Change "Feather gradient" in the Settings > Transition Gradient module and note the variations.
  • You can also change the values of the gradients (L, C, H, angle) in the Graduated Filter section of the Color & Light tool).
  • If you wish, you can also change the values of Color & Light.
The settings for Transition, Gradient, Luminance, Chrominance, Hue, Scope & Feather

Five ways to change the exposure and lift the shadows

This example is for demonstration purposes only so that we can see the various (non-exhaustive) possibilities for adjusting exposure. The settings are arbitrary.

  • The image is a difficult one with deep shadows and a central area that is almost overexposed.
  • Five possible methods are shown with arbitrary settings:
    • Shadows/Highlights
    • Tone Equalizer
    • TRC (Tone Response Curve)
    • Log Encoding
    • Exposure (PDE algorithms & Exposure)

We could also have used:

  • Contrast curves,
  • or lifted the shadows with "Lightness" (Color and Light),
  • or used a graduated luminance filter.


Preparation

  • Add a spot as shown in the image below.
  • Set the "Scope (color tools)" slider to 50 (this value will be used by the Shadows/Highlights tool when it is added and we will use the separate Scope sliders for each of the Log Encoding and Exposure tools).
  • Try varying this value between 20 and 100
Lifting the shadows - preparation

Raw file (Rawtherapee - Creative Common Attribution-share Alike 4.0): [3]

Using Shadows/Highlights

  • “Add tool to current spot” > "Shadows/Highlights & Tone Equalizer" > "Standard"
  • Select Shadows/Highlights in the combobox.
  • Try changing "Shadows tonal width" and "Highlights".
Lifting the shadows - Shadows Highlights

Using the Tone Equalizer

  • “Add tool to current spot” > "Shadows/Highlights & Tone Equalizer".
  • Select Tone Equalizer in the combobox.
  • Try also sliders 2, 3 et 4.
Lifting the shadows - Tone Equalizer

Using the Tone Response Curve (TRC)

  • “Add tool to current spot” > "Shadows/Highlights & Tone Equalizer".
  • Select TRC.
  • Increase the "Slope" to 150 and then come back to 60.
  • Try reducing and then increasing the gamma and observe the effect.
Lifting the shadows - TRC

Using Log Encoding

  • “Add tool to current spot” > "Log Encoding".
  • Note that the Scope slider in this case is in the Log Encoding tool: set Scope to 50.
  • Click on the Automatic button.
  • Adjust the “Target gray point” (now called “Mean luminance (Yb%)” in the Viewing Conditions panel).
Lifting the shadows – Log Encoding

Using Exposure

  • “Add tool to current spot” > "Dynamic Range & Exposure".
  • Select Standard.
  • Adjust "Exposure compensation ƒ" (a Laplacian and a Fourier transform will be applied).
  • Set the Exposure Tools sliders to Black = -1500, Shadows = 50.
  • By default "Highlight compression" is 20. Vary it to see the effect.
  • Play around with the above settings to get a feeling for how the tool works.
Lifting the shadows - Exposure

Recommendations

For portraits and images with low color contrast:

  • Use the Exposure slider with care because the algorithm (which is similar to the one used in the Exposure tab) is not well adapted to cases such as portraits which have subtle color variations in skin tones. The algorithm was improved recently (July 5, 2020) by the addition of a Laplacian operator to resolve the differences in contrast but it is still not the best solution for these cases.
  • Try using the "Tone equalizer" or "TRC" instead.

If you do use Exposure, then it is recommended (but not mandatory) to change the parameters of "Shape detection" in Settings as follows:

  • Increase "ΔE-scope threshold".
  • Reduce "ΔE decay".
  • Set "ab-L balance (ΔE)" to L.
  • Adjust "Scope (color tools)" if necessary.

High dynamic range images - use Log Encoding or the "PDE" algorithms in the "Dynamic Range & Exposure" tool

Log Encoding and Ciecam02 Tutorial

Log encoding - Ciecam02 - Tutorial - Examples

Chromatic Adaptation Example

The first step is to find an almost mathematically perfect white balance using White Balance > Auto > “Temperature correlation” (same example and settings as in the “Ciecam Advanced tab” tutorial).

Raw file (Rawtherapee - Creative Common Attribution-share Alike 4.0): [4]

White Balance - Temperature correlation
Choose a suitable Local Adjustments setting - Preparation
  • Select the Local Adjustments tab.
  • Add a “Full image” spot.
  • Set some lockable color pickers as shown.
Chromatic Adaptation - Preparation
Select Log Encoding

Choose: "Add tool to current spot" > Log Encoding

Chromatic Adaptation - Log encoding
  • Try changing the position of the center of the RT-spot.
  • Try changing the values of Scope e.g. 40 - 60 - 80 – 100.
  • Observe the results.
  • Note that the image still has a yellow cast.
Modify Chromatic adaptation - cat02
Chromatic Adaptation - Log encoding - Cat02
  • Make the image cooler by moving the “Chromatic adaptation cat02" slider to the left.
  • Reducing the slider value by 10 units corresponds to a 300K drop in illuminant temperature.
  • Try with a value of -23.
High dynamic range image + Ciecam

The image is a difficult one (the same that was used for the CIECAM example in the Advanced tab). It has very marked shadows and strong sunlit backlighting. Use the default RawTherapee settings and position the lockable color pickers as shown so that you can see the changes when processing.

Raw file (Pixls.us - Creative Common Attribution-share Alike 4.0): [5]

Ciecam Lighting Preparation
Using Log Encoding + Ciecam

Create a full-image spot and then "Add tool to current spot" > Log Encoding. For this example, and for comparison with Lift the shadows, the following arbitrary settings are used:

  • Set the value of Scope = 79
  • Complexity = Advanced.
  • Press the Automatic button.
Log encoding
  • Move the RT-spot and observe the effect.
  • Change the Scope settings and observe the effect.
Adjusting the Ciecam settings in the Log Encoding module
  • In the Scene Conditions panel choose Surround = Dim. The image will become lighter.
  • In the Image Adjustments panel, set the Saturation(s) = 30 and Contrast (J) = -10.
  • Observe the effect on the shadows.
Log encoding + Ciecam Saturation (s) - Contrast (J) - Dim

Now open the "All tools" expander.

  • Try Colorfulness (M) instead of Saturation (s).
  • Try Contrast (Q) instead of Contrast (J).
  • Adjust the Lightness.
Log encoding - Dodge and Burn - Ciecam
Preparation

This is another way to Dodge and Burn using Log Encoding and Ciecam. Position an Rt-spot on the face and set 2 "Lockable color pickers" as shown.

Raw file (Copyright - Jean Christophe Frisch - Creative Common Attribution-share Alike 4.0): [6]

Log encoding Dodge and Burn - Preparation
Using Log Encoding in manual mode with Ciecam
  • "Add tool to current spot" > Log Encoding
  • Complexity = Advanced
  • Click on Automatic
  • Slightly increase the White Ev value until you get the desired effect (in this example from 3.0 to 5.0).
  • Slightly increase the Saturation (s).
  • Click on "All tools" and slightly reduce Brightness (Q).
  • Try the other settings e.g. Surround = Dim, Lightness (J), etc.
  • You can also adjust the Scope and move the RT-spot and observe the variations in the result.
Log encoding Dodge and Burn - Preparation

Other Examples

High dynamic range images are one of the recurring problems in image processing. There are already several algorithms that can be used in Rawtherapee to reduce the dynamic range, with more or less success: Dynamic Range Compression, Shadows/Highlights, Tone Equalizer, Tone Response Curve, etc.

  • In this example we are going to use the Log Encoding tool (derived from the darktable filmic module and adapted by A. Griggio for ART). The tool has undergone further adaptation by J. Desmis for use in RawTherapee Local Adjustments.
  • To demonstrate the possibilities of this module, we are going to use it to make a luminance gradient, without using the Graduated Filter in the Log Encoding menu.
  • There are three steps: preparation, automatic settings, adjustments.

Preparation

  • Set the RT-spot so that:
    • The center is at the bottom left corner of the image.
    • The upper right corner is at the limits of the image.
  • Go to "Add tool to current spot" then select Log Encoding (the tool has been deliberately disabled in the screenshot).
Preparation

Raw file (Copyright - Roberto Posadas - Creative Common Attribution-share Alike 4.0): [7]

Automatic settings

  • Press the Automatic button.
  • The image will brighten.
  • Click the Automatic button again to see the settings more clearly.
  • The values Black Ev = -6.7, White Ev = 6.9, indicate a large dynamic range = 13.6 EV.
  • “Source gray point” = 1.2 (slider changed to “Mean luminance (Yb%)” in the Scene Conditions panel in the current interface) .
  • These settings (that you can change) are the result of calculations made upstream in the pipeline.
Automatic

Adjustments

You can now adapt the image to taste:

  • Play with the diagonal gradient by adjusting the "Transition Gradient" in Settings: "Transition value" = 45. You can also adjust "Transition decay" and "Transition differentiation XY" (try it out to see how it affects the result).
  • Modify the way the adjustment is distributed inside the image by setting Scope (Log Encoding) = 50
  • Change the global luminance of the image by setting "Target gray point" = 22.0 (slider changed to “Mean luminance (Yb%)” in the Viewing Conditions panel in the current interface).
Gradient and adjustments

Log Encoding and Highlight Recovery

The use of Log Encoding can sometimes lead to unexpected results. If the image contains highlights that were overexposed during shooting, then they need to be recovered or reconstructed. However, if this is the case, the Log Encoding module will "overwrite" the reconstructed highlights, resulting in unpleasant effects (e.g. unexpected changes in luminosity, hue and saturation). We will use 2 methods to overcome this problem and preserve the highlights.

  • Using a mask and a recovery process.
  • Using excluding spots.

Preparation

Raw file (Pixls.us Jonathan Dumaine - Creative Common Attribution-share Alike 4.0): [8]

PP3 File [9]

Preliminary adjustments

  • Adjust the white balance (Color tab). Without the knowledge of the person who took this image we don't know anything about the lighting conditions. Are they LED or incandescent lamps? How was the foreground lit? In this case:
    • You can either leave the image as is,
    • or use the "Temperature correlation" automatic white balance method.
  • Reconstruct the highlights (Exposure tab). I have used the excellent Color Propagation algorithm designed by Emil Martinec.

Preparation of the RT-spot

  • Choose Rectangle.
  • Position the delimiters outside the preview area.
  • Set the transition to a fairly high value.
  • Position a series of Lockable Color Pickers on the image.
  • Ensure that the L*a*b* values of the Lockable Color Pickers match the actual values by setting Mask and Merge > "Background color/luma mask” = 0 in the Settings module.
Preparation

Apply Log Encoding

  • Add the Log Encoding tool using "Add tool to current spot".
  • Select Advanced (or Standard).
  • Click on the Automatic button.
  • Set Scope to a high value i.e. 80 or more.

Log Encoding will automatically adjust the image and in particular the foreground, but the colors in the previously "reconstructed" highlights in the background will be desaturated and the brightness will be reduced.

Not only that, but the overall image is too saturated and the changes in exposure are badly distributed.

Log encoding

Elaboration of the mask

We will create a different sort of mask compared to what we normally use in RawTherapee. This mask will be used "live" to combine two images processed with and without Log Encoding.

Depending on the settings of "Recovery based on luminance mask":

  • The dark and black areas of the mask will result in a combined image that is as close as possible to the original.
  • The very bright or white areas of the mask will also result in a combined image that is as close as possible to the original.
  • The intermediate area will be modified by the settings of Log Encoding.

In this case I used the LC(H) curve but other images may require the L(L) curve. Note that the C(C) curve has no effect on the "mix" but can be used to improve the selection.

Mask

Partial recovery of highlights with mask

  • Make sure that the mask is enabled i.e. the "Enable mask" box is checked.
  • Open the expander "Recovery based on luminance mask".
  • Set "Recovery threshold". The closer the slider is to "2", the more the dark and very bright areas of the mask will be taken into account and restored to the original image values.
  • Use the "Dark area luminance threshold" and "Light area luminance threshold" sliders to include or exclude parts of the image. The corresponding values (in this case dark = 25.5 and Light = 98.3) are the two limits below and above which the effect of the mask will be progressively taken into account.
  • If necessary, use “Decay strength” to adjust the rate of decay.
Recovery

Highlight Recovery using an Excluding spot

We can also use one of the strong points of Local Adjustments by using Excluding spots. The adjustments are arbitrary.

Excluding spots

Final adjustment with Ciecam16

Once the various parameters have been set, we can refine the result. In this case I have chosen several Ciecam settings (using Ciecam 2016 in this case) to:

  • Increase the contrast.
  • Reduce the saturation, especially for the skin.
  • Change the chromatic adaptation, to make the image a little "colder".

Of course, everything is quite arbitrary and depends on one's perception.

A final remark.

  • The image is particularly noisy and will need to be denoised. However, to keep things simple, I have excluded this from the example.
Ciecam16

Processing a hazy image

We are going to process a very hazy image by first applying the global Haze Removal tool in the Detail tab and then touch up the sky and horizon using Retinex in Local Adjustments.

Original Image

Hazy image

Raw file :(Pixls.us - Creative Common Attribution-share Alike 4.0): [10]

Processing with the Haze Removal tool (Detail tab in the main menu)

We could have used the Dehaze tool in Local Adjustments but when you look at the image there is a lot of haze in the background and the hills so it is better to use a two-step approach.

Hazy image – result with the Haze Removal tool in the main menu (Detail tab)

Additional processing with local Retinex

  • Select "Add tool to current spot" > Dehaze & Retinex > Advanced.
  • Try varying the settings.
  • Adjust the "Transmission map" curve in Advanced Retinex Tools if necessary by increasing the attenuation on the right side of the curve.
  • Now look at the difference in the hills and the sky on the horizon!
Hazy image after using Haze removal + Retinex

Using the Denoise module

There are several ways of using this tool:

  • On selected areas to refine any denoising adjustments carried out with the Noise Reduction module in the Detail tab. In this case keep the Detail tab noise reduction to a minimum.
  • By processing the whole image using the Denoise module in Local Adjustments and excluding parts of the image with an Excluding spot.
  • By using it on its own to reduce noise in low-noise images. For example, to remove noise from the sky or a face.
  • By using it on its own to reduce the noise in a selected area and deliberately leaving the noise in the rest of the image for artistic purposes.

We are going to look at an example using this last case.

The image of the young girl is particularly noisy and has strong chromatic noise.

Denoise preparation

Raw file (Creative Common Attribution-share Alike 4.0): [11]

Zoom 100%

Denoise zoom 100%

Which settings should we use for denoising?

  • The position of the spot and its size are important. We are going to choose a part of the face with strong chromatic noise and use a large “Spot size” for the RT-spot .
  • The choice of the Scope parameter is also important. In this case, where the noise occupies almost the whole color spectrum (red, green, blue, yellow), a high Scope value must be chosen (90 in this case). If on the other hand the image to be processed has mainly luminance noise, then the "usual" Scope value should be chosen, i.e. around 30, to allow the algorithm to differentiate the action according to the colors.
  • There are several differences in the Local Adjustments denoise function compared to the global Noise Reduction module in the Detail tab.
    • You can use a curve to adjust the luminance noise level as a function of the level of detail (from 0 to 6 depending on the position on the abscissa of the curve).
    • A distinction is made depending on the level of detail i.e. if levels 3 and above are greater than 20% of the ordinate of the curve, the luminance noise reduction will be more aggressive.
    • The "white - black" differentiation for luminance is handled by an equalizer, rather than gamma.
    • There is the possibility to distinguish between "Fine chroma" (impulse noise and low chrominance noise for levels 0 to 4) and "Coarse chroma" (packets of noise, blotches for levels 5 and 6) .
    • There is a "red-green/blue -yellow" equalizer which can be useful for low-noise images.
    • There is an extra "Chroma detail recovery" slider using DCT (a Fourier-related discrete cosine transform).
    • There is an added "Luminance & chroma detail threshold (DCT)" slider to differentiate the action based on edges ("Edge detection").
Denoise settings

A complex noise reduction problem: how to differentiate between uniform areas and areas with texture or detail?

Isolating a subject against a background is a common problem in photography. The subject can be an animal, a plant, a person and the background the sky, grass, a forest, a wall etc. The problem is a complex one for noise reduction software because the algorithm usually "ignores" the difference between the subject and the background. This means that removing noise in the background will cause a loss of detail, contrast and color in the subject.

An example using Andy Astbury's harvest mouse image

I chose this image, with the agreement of its author Andy Astbury, because not only is it excellent (the animal stands out very well against a gray background) but it is also slightly noisy. Removing the noise using only the Noise Reduction tool in the Detail tab will inevitably lead to a loss of detail and a reduction in contrast and saturation in the mouse.

Raw file : (Copyright Andy Astbury - Creative Common Attribution-share Alike 4.0) [12]

PP3 file [13] The pp3 file is provided as a guide to the tools and possible settings that can be used in cases like this. They are not necessarily the "right" settings.

Traditionally noise is removed in Rawtherapee using the Noise Reduction module (Detail tab). If we try to remove the luminance and chrominance noise in the background we end up with settings (not shown in the screenshot) in the order of:

  • Luminance slider = 65
  • Chrominance slider - Master = 20

Certainly the background will be perfect, but our little harvest mouse will become dull and washed out. So how can we go about denoising this image?

Method outline:

  • We will use a two-step approach.
    • In the first step we will remove the noise in the details that we want to preserve (the harvest mouse) using the Noise Reduction module in the Detail tab, paying particular attention to its eye and tail. Note that in other images this step may also reduce large noise packets.
    • Because the perception of noise is similar to the principles of color appearance models, it will be more visible on a gray background than on a darker background (especially the chrominance noise). The same principle applies for the brighter parts of the image. It is therefore advisable to adjust the tonal contrast in conjunction with noise reduction. This will enhance the image and reduce the perceived noise at the same time.
    • In the second step, we will treat the noise with some of the tools available in Local Adjustments and in particular, the five tools outlined below:
      • The mask, which will allow us to differentiate between the detailed parts of the image (mouse, vegetation) and the background.
      • The “Denoise hue equalizer” which will allow us to differentiate the denoising between the color of the mouse and the background.
      • The Scope slider (i.e. use deltaE) which allows us to differentiate the action based on differences in color.
      • The "Luminance detail recovery (DCT)" slider (abbreviated to “Luma detail recovery” in the current interface) and the “Luminance - Chroma detail theshold” (abbreviated to “Luma-chro detail threshold” in the current interface) slider in Edge Detection, which uses a noise reduction technique (Fourier) based on the difference between the original image and the image that has been denoised using wavelets.
      • Patch-based denoising (also called non-local means), is another denoising algorithm based on pixel and patch similarity. It allows you to differentiate the denoise between areas with detail and texture (e.g. field mouse, vegetation etc.) and uniform areas (background).
    • Finally we will adjust the saturation, local contrast, etc.

Note that this document is for didactic purposes and the settings are designed to clearly demonstrate the different steps rather than to produce a beautiful image.

First step: noise reduction and tonal contrast adjustment

The image below only shows the tone equalizer settings and not the luminance and chrominance denoise settings that were made in the Noise Reduction module (Detail tab). Lockable Color Pickers have been placed on the eye, the fur, the vegetation, and the tail.

  • Add a new RT-spot and choose "Full image" in settings. Also in the Settings panel, go to "Mask and merge" and set "Background color/luma mask" to 0 (this will make it easier to distinguish the variations in luminance values).
  • Click on "Add tool to current spot" and select Shadows/Highlights & Tone Equalizer in the drop-down menu. Leave the tool in the default Basic mode.
  • Position the center of the RT-spot on the gray background.
  • Adjust the equalizer sliders to get the best compromise, while at the same time adjusting the two sliders in the "Noise Reduction" module (Detail tab). Here I used : luminance = 4, chrominance = 6.5 (Method: Manual > Chrominance-Master).
Noise Reduction + Tone Equalizer
Second step: Local Adjustments, Blur/Grain & Denoise module
  • Click on "Add tool to current spot" and select Blur/Grain & Denoise and then Denoise. Set the tool to Advanced mode.
  • Use the "Luminance denoise" curve.
  • For educational purposes and in order to see the effectiveness of the various tools you can set this curve to maximum and activate Aggressive. You will of course have to bring it back to normal values afterwards before continuing.

Familiarize yourself with each of the 5 tools mentioned above, one by one. For example to see the action of the "Denoise hue equalizer", set Scope to 100, set the slider “Recovery threshold" to 1 in “Recovery based on luminance mask" and leave the 3 other sliders at their default values.

  • Adjust the "Denoise hue equalizer" by increasing the noise level for the background and decreasing it for the mouse.
  • Adjust "Fine chroma" slightly.
  • Review the results.
Luminance Denoise by levels & Denoise hue equalizer

Next:

  • Make a mask (Blur/Grain & Denoise> Denoise > Mask and modifications).

This mask will be used to differentiate the denoise between the background and the rest of the image i.e. the harvest mouse and the vegetation. In this case I used a simple L(L) curve, a gamma adjustment and the contrast curve, but other images may need to use the LC(H) curve, “Structure mask strength”, “Smooth radius”, etc...

Mask
Mask - contrast curve
  • Activate the mask.
  • Expand the "Recovery based on luminance mask" tool.
  • Adjust "Recovery threshold" to reveal detail. Note that this tool is inactive when set to its default value 1.0. As soon as you move the slider, you will see maximum detail and noise which can then be reduced by moving the slider to the right.

For other images it may be necessary to adjust:

  • "Dark area luminance threshold". The denoise is progressively increased from 0% at the threshold setting to 100% at the maximum black value (determined by the mask).
  • "Light area luminance threshold", The denoise is progressively decreased from 100% at the threshold setting to 0% at the maximum white value (determined by the mask). In this example, the adjustment will allow us to denoise the vegetation as a function of luminance.
  • Decay allows you to manage the progressiveness of any changes.
  • The two "Gray area" sliders allow you to reapply noise reduction if necessary in the "protected" mid-tone area of the mask.
Recovery
  • Using Scope: here we are on familiar ground. In "Mask and modifications" you can use the two selections "Show modified areas with mask" and "Show modified areas without mask" to see the effect of Scope. Or you can simply adjust Scope and see the effect. In this image, with "Equalizer hue" disabled and "Recovery based on luminance mask" disabled (“Recovery threshold” set to 1) , the Scope action is sensitive between 50 and 100.
  • Use of the two sliders "Luminance detail recovery" (now labeled as “Luma detail recovery”) and "Luminance & chroma detail threshold" (now labeled as “Luma-chro detail threshold”).
    • Gradually increase "Luma detail recovery".
    • Adjust the "Luma-chro detail threshold"in parallel. You will see the details reappear.
    • 2 algorithms are possible. The first one uses an internal mask and the second one a Laplacian. Each one has its particularities: the Laplacian is more selective, but less progressive.
  • Using patch-based denoise (non-local means).
    • What is patch-based denoise? Contrary to the usual filters that reduce noise by averaging the values of groups of pixels located around a target pixel, non-local means filters average the values of all the pixels in the image and weight them according to their similarity with the target pixel. This type of filtering reduces the loss of detail compared to filters that use local averaging.
Non-local means

To familiarize yourself with this method it is recommended to:

  • Activate "Non-local means only" in Denoise > Mode.
  • Deactivate the mask.
  • Set Scope to 100.

In Advanced mode you have 5 sliders:

  • Strength
  • Detail recovery: allows you to make a preliminary selection between uniform and textured areas. The higher the values, the more the details will be selected.
  • Gamma: allows you to further refine the selection between uniform and textured areas. Lower gamma values will reveal more detail and texture.
  • Maximum patch size: allows you to adapt the size of the "patch" to the size of the objects. In theory, the more noisier the image, the larger this value should be. In practice, you should look for and minimize any artifacts in the transitions between the uniform and textured areas.
  • Maximum radius size: higher values will theoretically give better noise reduction at the expense of increased processing time.
Final Adjustment - Saturation and Local Contrast

Add a new RT-spot, centered on the mouse.

Then add 2 tools.

  • “Add tool to current spot” > Vibrance & Warm/Cool > Basic.
    • Move the Vibrance slider until you get the desired increase in saturation.
  • “Add tool to current spot” > Local Contrast & Wavelets > Wavelets >Advanced.
    • Use "Contrast by level" in Wavelet pyramid 2 , giving priority to the first levels.
Wavelet
Other methods and tools

Other methods can be used for the same purpose.

  • Using Local Adjustments
    • "Denoise based on luminance mask". Uses the same mask as "Recovery based on luminance mask" but increases or decreases the wavelet denoise. It acts prior to denoise (as does the "Denoise hue equalizer") whereas "Recovery based on luminance mask" acts after denoise by comparing the original noisy image and the denoised image.
    • "Equalizer white-black" and "Equalizer blue-yellow red-green"are the equivalent of the "Luminance curve" in "Noise Reduction" and not very efficient here.
    • Guided Filter in Blur/grain & Denoise > Blur & Noise uses the same mask and the same process as "Recovery based on luminance mask" with negative values of the Detail slider.
    • Excluding spots allow you to restore the image to the settings prior to activating the "Full image" RT-spot.
    • Median in Blur/Grain & Denoise > Blur & Noise is not very efficient here.
    • "Blur levels" in Local Contrast & Wavelets > Wavelets > Pyramid1: if you want to blur a part of the image according to the level of detail.
  • Other Rawtherapee methods (not developed here)
    • Noise Reduction: the "Luminance control" and chrominance curves allow some form of selection, but they are not sufficient in this particular case.
    • Wavelet levels noise reduction, which includes a "Denoise hue equalizer" and makes use of local contrast.

Comparison of Denoise tools Comparison of the 3 Rawtherapee noise reduction tools

Summary

Thanks once again to Andy Astbury for this excellent image, which allows us to demonstrate 5 ways of differentiating noise reduction between uniform areas and areas with detail.

  • Denoise hue equalizer
  • Recovery based on luminance mask
  • Scope - deltaE
  • DCT - Edge detection
  • Non-local means

In a difficult image it will probably be necessary to activate all 5 methods to try and find the right balance. The result is a matter of individual taste and is quite subjective.

It also depends on:

  • The background, which is uniform in this example, but may pose problems if it contains detail or texture.
  • The colors, which are well separated here, but will be more difficult to distinguish if they are "mixed".
  • DeltaE, which can be affected by chromatic noise, or when the separation of the colors is less distinct.
  • "Edge detection" which will also be affected by high luminance noise.

A moment of madness - try wavelets!

An example … (don't run away, it isn't as difficult as all that)

Original image, with “Exposure compensation” = +1.5

Amsterdam

Raw file (Rawtherapee - Creative Common Attribution-share Alike 4.0): [14]

The same image with Wavelet level tone mapping

  • Leave all settings at their default values.
  • Enable the Local Contrast & Wavelets tool (Advanced mode), select Wavelets in the combobox just under the “Overall strength” slider (the default is Unsharp Mask) and then select Pyramid2.
  • Set Scope (Wavelets) to 80.
  • Use the settings visible on the screenshot.
  • Of course the appearance is subjective so feel free to change the settings.
  • This version of tone mapping is different from the other algorithms implemented in Rawtherapee (Mantiuk for both Tone mapping and Log Encoding and Fattal for Dynamic Range Compression) and is specific to Rawtherapee Wavelets.
Amsterdam image with wavelet tone mapping

Three ways of increasing texture

For demonstration purposes we will use:

  • Tone Mapping (Mantiuk)
  • Retinex
  • Wavelets

Preparation – original image - Venice

Preparation

Raw file (Copyright Sébastien Guyader - Creative Common Attribution-share Alike 4.0): [15]

Using Tone Mapping

  • Create an elliptical RT-spot as shown then “Add tool to current spot” > Tone Mapping.
  • Note that the option "Normalize luminance" is checked. This ensures that the average and variance of the luminance values are the same as in the original image.
  • Use Advanced mode and adjust "Edge stopping" and Scale.
Tone mapping using the Mantiuk algorithm

Using Retinex

  • Using the same RT-spot as above, turn off the Tone Mapping tool and then “Add tool to current spot” > Dehaze & Retinex > Advanced. Then use the settings in the screenshot.
  • Note that the option "Normalize luminance" is checked. This ensures that the average and variance of the luminance values are the same as in the original image.
  • Note also that you can enable the "Use Fast Fourier Transform".
Retinex

Using Wavelets

  • Using the same RT-spot as above, turn off the Dehaze & Retinex tool and then “Add tool to current spot” > Local Contrast & Wavelets > Advanced > Wavelets > Pyramid2 and then use the settings in the screenshot.
  • Note the use of "Compression by level", the values of "Attenuation response", "Balance threshold" and "Compress residual image".
  • Try "Contrast by level".
  • Also try "Directional contrast",
  • or a combination of these parameters.
Wavelet tone-mapping

Merging layers using blend modes

You can use "Merge file" in the Color & Light tool (Advanced mode) to simulate the effect of merging layers. Each RT-spot can be thought of as a layer and the "Merge file" function allows you to merge up to 2 RT-spots with the original image.

  • The first "layer" is called Original and corresponds (in the same way as an Excluding spot) to the image data prior to any local adjustments being carried out.
  • When you stack RT-spots on top of each other, for example 6:
    • If the current Spot is number 6, "Merge file" will merge the 6th layer, either with the 5th (Previous Spot), or with the Original Image (the original data), or with a color defined in Background depending on the option chosen in the combobox.
    • If the current spot is number 3 out of the 6, then "Merge file" will merge spot 3 either with the 2nd spot (Previous Spot), or with Original (the original data) or with a color defined in Background.
    • For each of these merges you have 21 blend modes inspired by those of Photoshop© (Normal, Difference, Soft light, Overlay, etc.).
    • For each blend mode you can adjust the opacity, deltaE, and a Contrast Threshold (except in the case of Background).
    • The Graduated Filter (Luminance, Chrominance, Hue), which is located in Color & Light, also works with "Merge file".

As an example we will use these features to create a variable blur (of course this isn't the only application).

Preparation

Add an RT-spot as in the previous examples and then add the Blur/Grain & Denoise tool in Advanced mode using "Add tool to current spot".

  • Set the RT-spot to Inverse mode (using the checkbox which will appear when you click on the Blur & Noise expander).
  • Choose Scope = 90 or 100 depending on the desired effect.
  • Set Radius to a high value (2000 or more and check the FFTW option), set Blur mode to Luminance & Chrominance (in the combobox at the bottom of the tool panel). .
Préparation

Raw file (Rawtherapee - Creative Common Attribution-share Alike 4.0): [16]

Adding a second RT-spot

Use "Add tool to current spot" to add the Color & Light tool and set it to Advanced mode.

  • Set "Scope (color tools) " to 100.
Second spot

First merge in Normal blend mode

  • Go to the "Merge file" expander in the Color & Light module.
  • In the combobox choose one of the options in the list that starts with None. The options are:
    • Original Image.
    • Previous Spot, which merges with the previous RT-spot (or the Original Image if there is only one RT-spot).
    • Background, which allows you to merge with a colored background.
  • Then choose the blend mode (under the heading "Merge with Original/Previous/Background") and adjust the settings : "Merge background", Opacity, Contrast Threshold.
  • The other parameters in the Color & Light module can also be used if you wish (e.g. Lightness, Contrast, Saturation etc.).
Blend mode "Normal"

Second merge using the Soft Light blend mode

In the list of merge modes try “Soft Light (legacy)" or a different mode if you wish.

  • Try adjusting the settings (e.g. Opacity, etc.) to see what difference they make.
  • Switch from the Original Image option to Previous Spot and see what difference that makes.
Blend mode "Soft Light (legacy)"

Using a simple mask to improve color selection

Preparation

  • We are going to use an image of the salt mountain in Pammukale (Turkey).
  • It is a difficult image to process, because of the subtle differences in color between the sky and the mountain. Moreover, the mountain contains many irregularities.
  • The preliminary steps are the same as for previous examples. Note the setting of "Scope (color tools)" to 40 which is a compromise but necessary if we are going to process the mountain correctly.
  • For the purposes of this example, we are going to strongly increase the luminance (lightness) and the chrominance of the mountain (this is not an artistic objective) and see if we can avoid affecting the sky in the process.
  • We could have used Excluding spots (or in a future GUI release, a polygon), but for now, we are going to use a simple mask. We could also have used several curves for the mask, or created several masks by duplicating the RT-spot.
  • 2 types of mask are available in Local Adjustments.
    • 1) Those that don't add or subtract the mask from the image. The aim in this case is to improve the quality of the deltaE selection.
    • 2) Those that make use of the resulting differences when they are added to, or subtracted from the image.
    • We are going to use the first case (selection improvement).
Preparation

Raw file (Jacques Desmis - Creative Common Attribution-share Alike 4.0): [17]

Strongly increase Lightness and Chrominance

  • Observe the result: there is color bleed and the sky has been affected by the changes, which is what we wanted to avoid.
Increasing the lightness and chrominance

Creating a simple mask

  • We are going to use only one of the 3 LCH curves (in this case L).
  • Examine the L(L) curve closely. You will see that the point of inflection is located at the transition between the gray areas. This "transition" corresponds to the 3 references of the RT-spot (chroma, luma, hue) and is common to all the curves -- C(C), L(L), LC(H).
  • Avoid using Blend to ensure that only the shape detection is improved.
  • You can also use "Show modifications with mask" in "Mask and modifications".





Show the mask

Fine tuning the result

  • Set "Mask and modifications" to "Show modified image".
  • Activate "Enable mask".
  • If necessary, adjust the "Smooth radius" mask tool.
  • Retouch the "Contrast curve" mask and L(L) curves if necessary.
  • Switch to Advanced mode and try the Gamma, Slope, and Laplacian threshold masks (instead of the "Smooth radius" mask).
  • Certainly it is not perfect, but it is much better -- the goal is to discover how the masks work.

To improve the mask performance, you have 2 solutions:

  • Duplicate the RT-spot: if you duplicate the RT-spot, and place it alongside the previous one, the slight change in the position of the center (references), will allow the second mask to "correct" the "anomalies or incompleteness" of the previous mask. Moreover this option allows you to readjust certain parameters if necessary in the second spot (in this case Lightness & Chrominance) to give a more homogeneous result.
  • Use the mask of another open tool (if of course the tool is equipped with a mask). In this case you keep the same references (luma, chroma, hue) to create the masks and to take into account the deltaE (Scope).

DeltaE considerations:

  • You can disable the core function of Local Adjustments i.e. the Scope function, which takes into account deltaE, if you want to work entirely with masks and ignore Scope. In this case set Scope=100. You can see that the Scope function has been disabled and you will be able to use just the Blend function to combine the mask and the image.
  • When you use the Mask Tools sliders available in "Mask & modifications" (Contrast curve mask, chroma mask, gamma mask, etc.), you must remember that they are sensitive to the specific deltaE settings for the mask i.e. "deltaE Image mask" in the Mask & Merge panel in Settings.
Result

Improved result with "Recovery based on luminance mask"

Normally we use masks in RawTherapee to:

  • Improve detection (without blend).
  • Improve detection and add or subtract the mask to or from the image (with blend).

In this example we will use the light and dark areas of the mask to select the parts of the image that will be modified by the Color & Light settings and then combine them with the unmodified image as follows:

  • The dark and black areas of the mask will remain as close as possible to the original image.
  • The very bright or white areas of the mask will also remain as close as possible to the original image.
  • The intermediate zone will correspond to the settings in the Color & Light tool.

The area between the dark and light areas can be adjusted with the "Recovery based on luminance mask" slider.

Note:

  • To ensure that the L*a*b* values of the Lockable Color Pickers correspond to the real values you need to set : Local Adjustments > Settings > Mask and Merge > "Background color/luma mask” = 0 (slider labeled as “Background color for luminance and color masks” in screenshot).

Image with Color & Light settings - without mask

File pp3; [18]

Color and Light
Mask

Note the use of Blur Mask with "Contrast threshold" and Radius. This increases the gray value on the right-hand part of the salt mountain and reduces the effect of the Color & Light adjustments.

Mask
Recovery of the original image characteristics
  • Make sure that the mask is enabled in "Mask and modifications" and that the "Enable mask" box is checked.
  • Open the "Recovery based on luminance mask" expander.
  • Set the "Recovery threshold": the closer the slider is to the value "2", the more the dark and very bright areas of the mask will be taken into account and brought back to the original image values.
  • Use the "Dark area luminance threshold" and "Light area luminance threshold" sliders to include or exclude parts of the image. The corresponding values are the two limits below and above which the effect of the mask will be progressively taken into account (in this case the dark-area threshold = 32.1 and the light-area threshold = 85).
  • If necessary, use “Decay strength" to adjust the rate of the decay.
  • Try disabling the mask in "Mask and modifications" ("Enable mask" box unchecked) to see the effect.
  • With the mask enabled ("Enable mask" box checked) try to reset the "Recovery threshold" slider to 1 in "Mask and modifications".
  • Try varying other mask settings as well as the four "recovery"settings.
Recovery



Blending a mask with the original image

In this example, we want to increase the impression of perspective (relief) of the Pagodas.

Preparation

  • We could have used specific tools here to give a heightened impression of relief e.g. CBDL (Contrast by Detail Levels) or a Wavelet pyramid.
  • But for the purposes of this demonstration, we will use a mask with "blend".
  • The preparation is identical to previous examples with "Scope (color tools)" set to 40 (arbitrary), and Color & Light in "Advanced" mode.
Preparation

Raw file (Creative Common Attribution-share Alike 4.0): [19]

Mask settings: what not to do

  • For the purpose of this demonstration we will use 2 features.
    • The LC(H) curve to select the colors.
    • A Blur Mask which combines a contrast threshold and a blur function.
  • Note the checkbox FFTW, which although it consumes resources, increases the quality of the results. Without FFTW the radius is limited to 100 whereas with FFTW it is increased to 1000.
The mask
Results
  • Once again, activate "Enable mask".
  • Set the value of Blend to whatever you like.
  • Adjust the "Smooth radius" mask if necessary.
  • If you have enabled the non-mask settings of Color & light (lightness, contrast, etc.), the "Spot structure" slider will have an effect.
  • You can see that the image now has a dominant color. This is caused by using the Blend function with the LC(H) curve.
    • Switch the curve to Linear mode and you will see that the dominant color disappears.
    • To overcome this problem avoid combining several mask settings, irrespective of whether they use Blend or not.
    • If you need to combine these settings, it is advisable, as in the simple mask case above, to create either a second (or several) RT-spot(s) using the Duplicate function and setting one to Blend and the other without (or with different Blend values). You can also use another mask associated with another tool.

The right approach

As seen above, we need to take a two-step approach, for example by creating 2 spots.

  • The first one to take into account the LC(H) curve.
  • The second to act on the structure.
Working on the structure

There are several mask-type tools (in Advanced mode) that allow you to modify the structure:

  • Blur Mask which includes a contrast threshold and a blur function.
  • Structure Mask which acts directly on the structure.
  • When using these two tools, make sure that the LC(H) curve has not been activated (i.e. no curve).
  • However if you wish to use the LC(H) curve, you can associate the L(L) curve with it.
  • The Blur Mask and Structure Mask tools can also be associated with each other.
  • "Local contrast” (by wavelet level) and "Wavelet level selection", can be associated with the L(L) mask curve and generate a local-contrast effect.

Reminder:

  • Activate “Enable mask”.
  • Set Blend to whatever value you like.
  • Adjust "Smooth radius" mask if necessary.
Result

How to use the Common Color Mask and an example of how to blend 2 RT-spots

This mask does not work in exactly the same way the other Local Adjustments masks. It does not allow you to modify the behaviour of an existing tool like the mask in Color & light for example, but is a tool in its own right. You can use it to change the appearance of an image e.g. contrast, luminance, color, as well as its texture.

  • It consists of the 3 curves C(C), L(L), LC(H), (or in Advanced mode, 3 curves plus Structure Mask & Blur Mask), which will generate differences in the color or structure of the image when compared to the original image.
  • These "differences" are similar to the differences generated by the Lightness, or Chrominance functions in Color & Light.
  • The color differences between the mask image and the original image are taken into account by the deltaE (ΔE) and transition parameters.
  • Of course you can also use it in conjunction with other tools in the same RT-spot.
  • The simple example that follows allows you to understand how it works. It is based on the same ΔE principles as the other tools in Local Adjustments.

Preparation

Repeat the preliminary steps outlined in previous examples and add the tool to the RT-spot.

  • "Add tool to current spot" > Common Color Mask > Standard. For the purposes of the demonstration, do not open any other tools.
  • To create the mask, we will simplify the exercise as much as possible by using only 2 curves C(C) and L(L) to take into account the references of the RT-spot.
  • Note that the 2 sliders "Add/subtract luminance mask " and "Add/subtract chrominance mask" are not set to zero, so that the user is not confused by a lack of response from the system; the two values -10 are arbitrary and low.
Preparation

Raw file (Creative Common Attribution-share Alike 4.0):[20]

Luminance Mask

The curve makes a small change to the luminance.

  • Note the position of the top of the curve on the gray transition. This means that the Luminance mask matches the reference value of the RT-spot.
Luminance mask

Chrominance Mask

  • Notice the position of the top of the curve on the gray transition. This means that the Chrominance mask matches the reference value of the RT-spot.
Chrominance mask

Preview ΔE

From here you can play with the deltaE (ΔE) between "Image + Mask" and Original Image.

  • Try increasing or decreasing the Scope (make sure you use the Common Color Mask slider and not the slider in the Settings module above).
  • Try adjusting the parameters in the Settings "Shape detection" panel: "Threshold ΔE-scope", "ΔE decay", "ab-L balance (ΔE)", "C-H balance (ΔE)".
Preview deltaE - ΔE

Show modifications

Go to "Show modifications with mask".

  • Adjust "Add/subtract luminance mask " and "Add/subtract chrominance mask " (these sliders could also have been called "opacity").
Show modifications

Result

You can:

  • Change the Scope (the Common Color Mask slider which acts on ΔE).
  • Activate the "Smooth radius" mask, which will try to reduce the artifacts caused by the fact that the mask has been generated by 3 different curves - C(C), L(L), LC(H).
  • Change the Chroma mask.
  • Adjust the "Contrast curve" mask.
  • Try "Scope (ΔE image mask)" in Settings: this slider acts on the mask and takes into account the deltaE of the mask compared to the center of the RT-spot. It is different from Scope (the first slider of the Common Color Mask), which acts on the difference between the original image and the mask you have created.

Switch to Advanced mode.

  • Adjust the Soft Radius slider which will reduce any artifacts arising from differences between the original image and the one obtained after "adding" the mask. The default value is 1 even in Standard mode and produces a small variation - even without the mask – which can be seen in "Show modifications".
  • Try the "Laplacian threshold" mask, and note the difference compared to the "Smooth radius" mask.
  • Try the Gamma and Slope masks.
  • Try to change the structure with one of the tools provided: Structure Mask, Blur Mask, "Local contrast” (by wavelet level) mask.
  • Try the Graduated Filter Mask.
Result

Now we are going to enhance the Common Color Mask image with the "Merge file" tool in Color & Light.

Adding a new RT-spot Color & Light - Advanced mode

For demonstration (and not artistic) purposes, we will use 3 of the 21 possible blend modes.

  • Add a new RT-spot.
  • Add a Color & Light tool in Advanced mode.
  • Set the "Scope (color tools)" correctly (using Preview ΔE).
  • Choose 3 settings to increase the luminance, contrast and chrominance
Adding an RT-spot

Preparing the "merge"

  • Choose "Previous spot". We are now going to merge the new RT-spot (Color & Light) with the previous one (Common Color Mask).
Preparing the merge

First merge using Normal blend mode

  • Choose the Normal blend mode.
  • We arbitrarily choose 3 settings: “Merge background” = 54.2 (takes into account the deltaE between the 2 layers), Opacity = 54.2 (about 50% for each), Contrast Threshold = 12.5 (takes into account the differences between uniform and textured areas).
  • The two identical values of 54.2 are arbitrary and you can choose other values 43, 68, etc.
Merge with Normal blend mode

Second merge using "Soft Light (legacy)" blend mode

  • Change the blend mode and choose "Soft Light (legacy)".
Merge using Soft Light (legacy)

Third merge using Color Burn blend mode

  • Change the blend mode and choose Color Burn (the choice is completely arbitrary).
  • Note the differences in luminance and chrominance.
Merge using "Color Burn" blend mode

Additional information

Of course, you can create as many Common Color Masks as you want. Simply duplicate the mask and place it close to the previous one and use similar settings.

Some important points about the mask curves C(C), L(L), LC(H).

  • These curves are used to create the mask.
  • For each of the curves, the vertical dark-gray/light-gray separation line represents the 3 references of the RT-spot: luminance, chroma and hue.
  • For the first curve shown below (with the highest point of the curve on the selection – L in this case), the deltaE selection is improved.
  • For the second curve shown below, the hue used by the mask corresponds to the hue reference of the RT-spot (the peak of the curve is on the selection – H in this case). Pulling the curve downwards will progressively mask (or reduce the impact) of whatever adjustment has been applied to the selected hue (or L, or C depending on which of the curves you are using).
  • For the third curve shown below, the hue selection for the mask does not match the hue reference of the RT-spot. In this case, pulling the curve downwards will progressively mask whatever adjustment (luminance and chrominance) has been applied to that particular color.

Note that the effect of the combined LC (H) curve can be visualised by referring to the spatial representation of the Lch coordinates i.e. as you move up and down the vertical L axis, there will be a corresponding increase or decrease in the chroma values.

Mask selection
  • For this demonstration we used an image with two dominant colors: magenta (flower) and green (foliage). Images that have more varied color, luminance and chrominance (e.g. sky, sea, mountains, houses, fields, flowers, portraits etc.) would require more elaborate masks.
  • We stay with the "philosophy" of Local Adjustments, by only relying on the references of the RT-spot. We could of course have used just the curves outlined above but this would have given a completely different result.
  • Similarly, for the merge we chose the same color range as for the mask. We could have made another choice for the second RT-spot, by positioning it on the foliage but the result of the merge would have been different, with less variation in the flowers.

Correcting an underexposed portrait and improving grainy skin (Mairi)

The portrait of Mairi gives us the opportunity to use several local-adjustment tools. We are going to:

  • Increase the Exposure of the image to make it lighter.
  • Use CBDL to soften the skin and Clarity to lighten the face.
  • Make a Graduated Filter to open up the shadows of the face on the right-hand side of the image.
  • Use 3 Excluding spots to "exclude" the eyes and lips from the adjustments.
  • Use an LC(H) mask to "exclude" the hair from the softening adjustments (to avoid losing definition).
  • Compare the result "before" and "after".
  • Remark: the settings have been given as an indication and are a matter of individual taste.
Preparation

Raw file (Copyright Pat David - Creative Common Attribution-share Alike 4.0): [21]

Increasing exposure

  • Exposure + 0.5
  • Note: we could have used an RT-spot to limit the exposure increase to a particular area instead of applying an overall increase in exposure.
Exposure increase

Using CBDL

  • Create an RT-spot with a large "Spot size" = 47
  • Make a gradual contrast reduction for levels 0 to 4
  • Set Clarity to 60
  • Set Scope to 40
CBDL

Graduated Filter

  • Create another Color & Light RT-spot.
  • Graduated Filter settings: Luminance = -0.6; “Gradient angle” = 71.5
  • You can also play with the chrominance settings (Advanced mode).
Graduated Filter

Excluding the eyes and lips

  • Create 3 Excluding RT-spots on the eyes and lips.
  • Adjust the Scope (excluding) to obtain the desired result.
Excluding

Hair exclusion mask

  • Go back to the first RT-spot.
  • Go to "Mask and modifications".
  • Select "Show mask".
  • Open the LC(H) curve.
  • Identify the color of the skin (the boundary between the light and dark gray areas on the graph).
  • Lower the curve as shown in the graph (or similar).
  • Adjust the "Smooth radius" mask.
  • Adjust the Gamma, Slope, Contrast-curve masks if necessary.
Mask

Result

  • Set the mask to "Show image with modifications".
  • Check the "Enable mask" checkbox.
Result

Before and After Comparison

Before & After

An alternative - replace CBDL with Wavelets “Contrast by level".

  • The Wavelets module is more powerful than CBDL (Contrast By Detail Levels) and may seem more complex given the number of options.
  • However, it allows you to target the CBDL effect by using the "Attenuation Response" (Damper) and Offset sliders. This means that instead of applying the changes linearly to the wavelet decomposition signal, they will be adjusted depending on the actual value of the signal to avoid amplifying defects such as noise.
  • The wavelet option also has a Clarity function.
Wavelet contrast by level and Clarity

Using a mask with wavelets (yes it is possible!)

Wavelet mask