[gimp-help] Updates in menu/colors
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help] Updates in menu/colors
- Date: Fri, 21 Sep 2018 05:59:54 +0000 (UTC)
commit 052af4001484d4bbae667e819bcc2cf1adf0bdee
Author: Julien Hardelin <jhardlin orange fr>
Date: Fri Sep 21 07:58:52 2018 +0200
Updates in menu/colors
.directory | 6 -
images/C/menus/colors.png | Bin 6164 -> 29325 bytes
.../C/menus/colors/brightness-contrast-dialog.png | Bin 0 -> 20794 bytes
images/C/menus/colors/color-balance-dialog.png | Bin 0 -> 30047 bytes
.../C/menus/colors/color-temperature-presets.png | Bin 59083 -> 0 bytes
images/C/menus/colors/color-temperature.png | Bin 24520 -> 18895 bytes
images/C/menus/colors/curves-dialog.png | Bin 0 -> 30947 bytes
images/C/menus/colors/exposure-dialog.png | Bin 0 -> 15741 bytes
images/C/menus/colors/hue-chroma-dialog.png | Bin 0 -> 20189 bytes
images/C/menus/colors/hue-saturation-dialog.png | Bin 0 -> 29759 bytes
images/C/menus/colors/levels-dialog.png | Bin 0 -> 35643 bytes
images/C/menus/colors/preset-widget.png | Bin 0 -> 2656 bytes
images/C/menus/colors/preview+split.png | Bin 0 -> 3483 bytes
images/C/menus/colors/saturation-dialog.png | Bin 0 -> 14492 bytes
.../C/menus/colors/shadows-highlights-dialog.png | Bin 0 -> 33067 bytes
images/C/toolbox/tool-options-curves.png | Bin 0 -> 5468 bytes
images/C/toolbox/tool-options-levels.png | Bin 5546 -> 4363 bytes
images/C/toolbox/tools-brightness.png | Bin 17850 -> 0 bytes
images/C/toolbox/tools-color-balance.png | Bin 23792 -> 0 bytes
images/C/toolbox/tools-curves.png | Bin 25927 -> 0 bytes
images/C/toolbox/tools-hue-sat.png | Bin 26041 -> 0 bytes
images/C/toolbox/tools-levels.png | Bin 26291 -> 0 bytes
src/menus/colors/auto/color-enhance-legacy.xml | 17 +--
src/menus/colors/auto/equalize.xml | 38 ++---
src/menus/colors/brightness-contrast.xml | 84 +++--------
src/menus/colors/color-balance.xml | 87 ++---------
src/menus/colors/color-temperature.xml | 12 +-
src/menus/colors/curves.xml | 101 +++++--------
src/menus/colors/exposure.xml | 82 ++++++++++-
src/menus/colors/hue-chroma.xml | 90 +++++++++++-
src/menus/colors/hue-saturation.xml | 103 +++----------
src/menus/colors/introduction.xml | 76 ++++++++++
src/menus/colors/levels.xml | 114 +++++----------
src/menus/colors/saturation.xml | 69 ++++++++-
src/menus/colors/shadows-highlights.xml | 161 ++++++++++++++++++++-
src/menus/colors/threshold.xml | 9 --
36 files changed, 623 insertions(+), 426 deletions(-)
---
diff --git a/images/C/menus/colors.png b/images/C/menus/colors.png
index decb0a1d4..325c62aeb 100644
Binary files a/images/C/menus/colors.png and b/images/C/menus/colors.png differ
diff --git a/images/C/menus/colors/brightness-contrast-dialog.png
b/images/C/menus/colors/brightness-contrast-dialog.png
new file mode 100644
index 000000000..5e431a520
Binary files /dev/null and b/images/C/menus/colors/brightness-contrast-dialog.png differ
diff --git a/images/C/menus/colors/color-balance-dialog.png b/images/C/menus/colors/color-balance-dialog.png
new file mode 100644
index 000000000..f68a8d34b
Binary files /dev/null and b/images/C/menus/colors/color-balance-dialog.png differ
diff --git a/images/C/menus/colors/color-temperature.png b/images/C/menus/colors/color-temperature.png
index 89cec81b5..cb03dd0a1 100644
Binary files a/images/C/menus/colors/color-temperature.png and b/images/C/menus/colors/color-temperature.png
differ
diff --git a/images/C/menus/colors/curves-dialog.png b/images/C/menus/colors/curves-dialog.png
new file mode 100644
index 000000000..b3adab1bf
Binary files /dev/null and b/images/C/menus/colors/curves-dialog.png differ
diff --git a/images/C/menus/colors/exposure-dialog.png b/images/C/menus/colors/exposure-dialog.png
new file mode 100644
index 000000000..b20b3d90f
Binary files /dev/null and b/images/C/menus/colors/exposure-dialog.png differ
diff --git a/images/C/menus/colors/hue-chroma-dialog.png b/images/C/menus/colors/hue-chroma-dialog.png
new file mode 100644
index 000000000..c19d7e123
Binary files /dev/null and b/images/C/menus/colors/hue-chroma-dialog.png differ
diff --git a/images/C/menus/colors/hue-saturation-dialog.png b/images/C/menus/colors/hue-saturation-dialog.png
new file mode 100644
index 000000000..9897a9e74
Binary files /dev/null and b/images/C/menus/colors/hue-saturation-dialog.png differ
diff --git a/images/C/menus/colors/levels-dialog.png b/images/C/menus/colors/levels-dialog.png
new file mode 100644
index 000000000..170da2bba
Binary files /dev/null and b/images/C/menus/colors/levels-dialog.png differ
diff --git a/images/C/menus/colors/preset-widget.png b/images/C/menus/colors/preset-widget.png
new file mode 100644
index 000000000..e82ec2d9b
Binary files /dev/null and b/images/C/menus/colors/preset-widget.png differ
diff --git a/images/C/menus/colors/preview+split.png b/images/C/menus/colors/preview+split.png
new file mode 100644
index 000000000..75e621e80
Binary files /dev/null and b/images/C/menus/colors/preview+split.png differ
diff --git a/images/C/menus/colors/saturation-dialog.png b/images/C/menus/colors/saturation-dialog.png
new file mode 100644
index 000000000..375104be0
Binary files /dev/null and b/images/C/menus/colors/saturation-dialog.png differ
diff --git a/images/C/menus/colors/shadows-highlights-dialog.png
b/images/C/menus/colors/shadows-highlights-dialog.png
new file mode 100644
index 000000000..e3d80c7da
Binary files /dev/null and b/images/C/menus/colors/shadows-highlights-dialog.png differ
diff --git a/images/C/toolbox/tool-options-curves.png b/images/C/toolbox/tool-options-curves.png
new file mode 100644
index 000000000..9134066f9
Binary files /dev/null and b/images/C/toolbox/tool-options-curves.png differ
diff --git a/images/C/toolbox/tool-options-levels.png b/images/C/toolbox/tool-options-levels.png
index a7edcbf37..e8d33b593 100644
Binary files a/images/C/toolbox/tool-options-levels.png and b/images/C/toolbox/tool-options-levels.png differ
diff --git a/src/menus/colors/auto/color-enhance-legacy.xml b/src/menus/colors/auto/color-enhance-legacy.xml
index c4e0c8e8c..7e9411a79 100644
--- a/src/menus/colors/auto/color-enhance-legacy.xml
+++ b/src/menus/colors/auto/color-enhance-legacy.xml
@@ -2,12 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2008-12-29 j.h: rev. v2.6. No change
- 2007-10-17 ude: moved here from menus/plug-in-color-enhance.xml ('en','de')
- 2007-06-09 Added Spanish translation by AntI
- 2007-02-22 KoSt: added no
- 2006-09-05 text rewritten by scb; example added by j.h
- 2005-11-11 split of from layer-colors.xml by axel.wernicke
+
-->
<!--This is the legacy Color Enhance-->
<sect2 id="plug-in-color-enhance">
@@ -44,7 +39,7 @@ except that it
<menuchoice>
<guimenu>Colors</guimenu>
<guisubmenu>Auto</guisubmenu>
- <guimenuitem>Color Enhance</guimenuitem>
+ <guimenuitem>Color Enhance (legacy)</guimenuitem>
</menuchoice>.
</para>
</listitem>
@@ -52,9 +47,9 @@ except that it
</sect3>
<sect3>
- <title><quote>Color Enhance</quote> example</title>
+ <title><quote>Color Enhance (legacy)</quote> example</title>
<figure>
- <title><quote>Color Enhance</quote> example (Original image)</title>
+ <title>Original image</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
@@ -70,7 +65,7 @@ except that it
</figure>
<figure>
<title>
- <quote>Color Enhance</quote> example (Image after the command)
+ Command applied
</title>
<mediaobject>
<imageobject>
@@ -80,7 +75,7 @@ except that it
<caption>
<para>
The active layer and its Red, Green and Blue histograms after
- <quote>Color Enhance</quote>. The result may not always be
+ <quote>Color Enhance (legacy)</quote>. The result may not always be
what you expect.
</para>
</caption>
diff --git a/src/menus/colors/auto/equalize.xml b/src/menus/colors/auto/equalize.xml
index d23453daf..65788638f 100644
--- a/src/menus/colors/auto/equalize.xml
+++ b/src/menus/colors/auto/equalize.xml
@@ -2,12 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2008-12-29 j.h: rev v2.6. No change
- 2007-10-17 ude: moved here from menus/layer-equalize.xml ('en','de')
- 2007-06-07 Added Spanish translation by AntI
- 2007-02-22 KoSt: added no
- 2006-09-02 example added by j.h
- 2005-11-11 split of from layer-colors.xml by axel.wernicke
+
-->
<!-- id is still used by GIMP, do not change! -->
<sect2 id="gimp-layer-equalize">
@@ -39,26 +34,14 @@
<sect3>
<title>Activate the Command</title>
- <itemizedlist>
- <listitem>
- <para>
- You can access this command from the image menubar through
- <menuchoice>
- <guimenu>Colors</guimenu>
- <guisubmenu>Auto</guisubmenu>
- <guimenuitem>Equalize</guimenuitem>
- </menuchoice>
- </para>
- </listitem>
- <listitem>
- <para>
- or by using the keyboard shortcut
- <keycombo>
- <keycap>Shift</keycap><keycap>Page Down</keycap>
- </keycombo>.
- </para>
- </listitem>
- </itemizedlist>
+ <para>
+ You can access this command from the image menubar through
+ <menuchoice>
+ <guimenu>Colors</guimenu>
+ <guisubmenu>Auto</guisubmenu>
+ <guimenuitem>Equalize</guimenuitem>
+ </menuchoice>
+ </para>
</sect3>
<sect3>
@@ -92,10 +75,11 @@
</para>
<para>
Histogram stretching creates gaps between pixel columns giving it
- a striped look.
+ a striped look: colors that occur frequently are stretched.
</para>
</caption>
</mediaobject>
</figure>
</sect3>
+
</sect2>
diff --git a/src/menus/colors/brightness-contrast.xml b/src/menus/colors/brightness-contrast.xml
index eb0108a43..9c475af2e 100755
--- a/src/menus/colors/brightness-contrast.xml
+++ b/src/menus/colors/brightness-contrast.xml
@@ -2,13 +2,8 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2009-03-11 j.h: revised for v2.6. Added Presets
- 2008-01-16 j.h updated "en;fr" to v2.4
- 2007-06-06 kost: added 'no'
- 2007-04-15 Added Spanish translation by AntI
- 2006-02-04 fr revised by j.h
- 2005-08-07 de reviewed and restructured by axel.wernicke
- 2005-05-31 en revised Bill Skaggs
+ 2009-03-11 Added Presets
+ 2005-08-07 restructured by axel.wernicke
-->
<sect2 id="gimp-tool-brightness-contrast">
<title>Brightness-Contrast</title>
@@ -37,36 +32,35 @@
<guilabel>OK</guilabel> button on the dialog, or hit the
<keycap>Return</keycap> key on your keyboard.
</para>
+ <note>
+ <para>
+ Before GIMP-2.10, Brightness-Contrast did not work on indexed layers.
+ This is possible now.
+ </para>
+ </note>
<sect3>
<title>Activating the Tool</title>
- <para>
- You can get to the Brightness-Contrast tool in two ways:
- </para>
<itemizedlist>
+ <para>You can get to this tool in two ways:</para>
<listitem>
<para>
- In the image-menu through:
- <menuchoice>
- <guimenu>Tools</guimenu>
- <guisubmenu>Color Tools</guisubmenu>
- <guimenuitem>Brightness-Contrast…</guimenuitem>
- </menuchoice> or
+ In the image menu through
<menuchoice>
<guimenu>Colors</guimenu>
<guimenuitem>Brightness-Contrast…</guimenuitem>
- </menuchoice>,
+ </menuchoice>.
</para>
</listitem>
<listitem>
<para>
- by clicking the tool icon:
+ By clicking on the tool icon
<guiicon>
<inlinegraphic
- fileref="images/toolbox/stock-tool-brightness-contrast-22.png"/>
+ fileref="images/toolbox/stock-tool-levels-22.png"/>
</guiicon>
- in Toolbox, provided that you have installed color tools in Toolbox.
- For this, please refer to <xref linkend="gimp-prefs-toolbox"/>.
+ in the toolbox if this tool has been installed there. For this, please
+ refer to <xref linkend="gimp-prefs-toolbox"/>.
</para>
</listitem>
</itemizedlist>
@@ -78,7 +72,9 @@
<title>Brightness-Contrast options dialog</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/tools-brightness.png" format="PNG"/>
+ <imagedata
+fileref="images/menus/colors/brightness-contrast-dialog.png"
+format="PNG"/>
</imageobject>
</mediaobject>
</figure>
@@ -87,42 +83,10 @@
<term>Presets</term>
<listitem>
<para>
- You can save the color settings of your image by clicking the
- <guibutton>Add settings to favourites</guibutton> button
- <guiicon>
- <inlinegraphic fileref="images/toolbox/save-color-settings.png"/>
- </guiicon>
- </para>
- <para>
- The
- <guiicon>
- <inlinegraphic fileref="images/toolbox/presets-menu-icon.png"/>
- </guiicon>
- button opens a menu:
- </para>
- <figure>
- <title>Preset Menu</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/presets-menu.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- which lets you <guilabel>Import Settings from File</guilabel> or
- <guilabel>Export Settings to File</guilabel>,
- and gives you access to the Manage Save Settings dialog:
+ <quote>Presets</quote> are a common feature for
+ several Colors command. You can find its description in
+ <xref linkend="gimp-colors-introduction"/>.
</para>
- <figure>
- <title>Manage saved Settings Dialog</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/manage-saved-settings.png"/>
- </imageobject>
- </mediaobject>
- </figure>
</listitem>
</varlistentry>
<varlistentry>
@@ -154,11 +118,11 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Preview</term>
+ <term>Preview and Split view</term>
<listitem>
<para>
- The Preview checkbox enables the rendering of all changes to
- the brightness and contrast on the canvas for immediate evaluation.
+ These are common features described in
+ <xref linkend="gimp-colors-introduction"/>.
</para>
</listitem>
</varlistentry>
diff --git a/src/menus/colors/color-balance.xml b/src/menus/colors/color-balance.xml
index eeb1714d8..49e275549 100755
--- a/src/menus/colors/color-balance.xml
+++ b/src/menus/colors/color-balance.xml
@@ -12,10 +12,6 @@
-->
<sect2 id="gimp-tool-color-balance">
<title>Color Balance</title>
- <indexterm>
- <primary>Tools</primary>
- <secondary>Color Balance</secondary>
- </indexterm>
<indexterm>
<primary>Color</primary>
<secondary>Color Balance</secondary>
@@ -31,35 +27,12 @@
<sect3>
<title>Activating the Tool</title>
<para>
- You can get to the Color balance tool in several ways :
+ You can get to the Color balance through:
+ <menuchoice>
+ <guimenu>Colors</guimenu>
+ <guimenuitem>Color Balance…</guimenuitem>
+ </menuchoice>,
</para>
- <itemizedlist>
- <listitem>
- <para>
- In the image-menu through:
- <menuchoice>
- <guimenu>Tools</guimenu>
- <guisubmenu>Color Tools</guisubmenu>
- <guimenuitem>Color Balance…</guimenuitem>
- </menuchoice>, or
- <menuchoice>
- <guimenu>Colors</guimenu>
- <guimenuitem>Color Balance…</guimenuitem>
- </menuchoice>,
- </para>
- </listitem>
- <listitem>
- <para>
- by clicking the tool icon:
- <guiicon>
- <inlinegraphic
- fileref="images/toolbox/stock-tool-color-balance-22.png"/>
- </guiicon>
- in Toolbox, provided that you have installed color tools in Toolbox.
- For this, please refer to <xref linkend="gimp-prefs-toolbox"/>.
- </para>
- </listitem>
- </itemizedlist>
</sect3>
<sect3>
@@ -68,7 +41,8 @@
<title>Color Balance options</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/tools-color-balance.png" format="PNG"/>
+ <imagedata fileref="images/menus/colors/color-balance-dialog.png"
+format="PNG"/>
</imageobject>
</mediaobject>
</figure>
@@ -77,42 +51,10 @@
<term>Presets</term>
<listitem>
<para>
- You can save the color settings of your image by clicking the
- <guibutton>Add settings to favourites</guibutton> button
- <guiicon>
- <inlinegraphic fileref="images/toolbox/save-color-settings.png"/>
- </guiicon>
- </para>
- <para>
- The
- <guiicon>
- <inlinegraphic fileref="images/toolbox/presets-menu-icon.png"/>
- </guiicon>
- button opens a menu:
+ <quote>Presets</quote> are a common feature for
+ several Colors command. You can find its description in
+ <xref linkend="gimp-colors-introduction"/>.
</para>
- <figure>
- <title>Preset Menu</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/presets-menu.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- which lets you <guilabel>Import Settings from File</guilabel> or
- <guilabel>Export Settings to File</guilabel>,
- and gives you access to the Manage Save Settings dialog:
- </para>
- <figure>
- <title>Manage saved Settings Dialog</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/manage-saved-settings.png"/>
- </imageobject>
- </mediaobject>
- </figure>
</listitem>
</varlistentry>
<varlistentry>
@@ -158,13 +100,12 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Preview</term>
+ <term>Preview and Split view</term>
<listitem>
<para>
- The Preview checkbox toggles dynamic image updating. If this
- option is on, any change made to the RGB levels are immediately
- seen on the active selection or layer.
- </para>
+ These are common features described in
+ <xref linkend="gimp-colors-introduction"/>.
+ </para>
</listitem>
</varlistentry>
</variablelist>
diff --git a/src/menus/colors/color-temperature.xml b/src/menus/colors/color-temperature.xml
index 1e5b97950..5dbb2e3bc 100644
--- a/src/menus/colors/color-temperature.xml
+++ b/src/menus/colors/color-temperature.xml
@@ -38,7 +38,9 @@
</figure>
<para>
The Color Temperature filter allows adjusting color temperature of the
- light source in an image in Kelvin.
+ light source in an image in Kelvin. It can be used to correct the bluish
+ cast in overcast photos, or even (to some extent) the red cast in photos
+ taken under incandescent light with the camera set to daylight.
</para>
</sect3>
@@ -69,7 +71,13 @@
<listitem>
<para>
This is the estimated original color temperature of the light
- source in Kelvin.
+ source in Kelvin. You can change it because the image doesn't
+ necessarily encode that information correctly or at all
+ (and you might or might not have measured it). In addition there's
+ often a mix of light sources (a window, a fill-in flash, a pile of
+ burning organic fair-trade bamboo wood harvested under a full
+ moon)... But above all else you can get interesting creative
+ effects by changing it
</para>
</listitem>
</varlistentry>
diff --git a/src/menus/colors/curves.xml b/src/menus/colors/curves.xml
index dc5bef7b7..efadb591b 100755
--- a/src/menus/colors/curves.xml
+++ b/src/menus/colors/curves.xml
@@ -2,15 +2,9 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2009-03-11 j.h: revised for v2.6. Added Presets
- 2008-02-03 ude: updated 'de'
- 2008-01-23 j.h updated 'en;fr' to v2.4
- 2007-06-06 kost: added 'no'
+ 2018-06-20 j.h small updates to v2.10.2
+ 2009-03-11 Added Presets
2007-05-20 lexa: enhanced docbook compliance
- 2007-04-15 Added Spanish translation by AntI
- 2005-12-07 replaced <simplesect> by <sect3> by lexa
- 2005-12-01 informalfigure replaced by figure by lexa
- 2005-08-08 de reviewed by axel.wernicke
-->
<sect2 id="gimp-tool-curves">
<title>Curves</title>
@@ -33,11 +27,11 @@
<sect3>
<title>Activating the Tool</title>
- <para>You can get to this tool in several ways:</para>
+ <para>You can get to this tool in two ways:</para>
<itemizedlist>
<listitem>
<para>
- In the image menu or in the main menu through
+ In the image menu through
<menuchoice>
<guimenu>Colors</guimenu>
<guimenuitem>Curves…</guimenuitem>
@@ -64,7 +58,7 @@
<title>The <quote>Curves</quote> dialog</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/tools-curves.png" format="PNG"/>
+ <imagedata fileref="images/menus/colors/curves-dialog.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>
@@ -73,42 +67,10 @@
<term>Presets</term>
<listitem>
<para>
- You can save the color settings of your image by clicking the
- <guibutton>Add settings to favourites</guibutton> button
- <guiicon>
- <inlinegraphic fileref="images/toolbox/save-color-settings.png"/>
- </guiicon>
+ <quote>Presets</quote> are a common feature for
+ several Colors command. You can find its description in
+ <xref linkend="gimp-colors-introduction"/>.
</para>
- <para>
- The
- <guiicon>
- <inlinegraphic fileref="images/toolbox/presets-menu-icon.png"/>
- </guiicon>
- button opens a menu:
- </para>
- <figure>
- <title>Preset Menu</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/presets-menu.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- which lets you <guilabel>Import Settings from File</guilabel> or
- <guilabel>Export Settings to File</guilabel>,
- and gives you access to the Manage Save Settings dialog:
- </para>
- <figure>
- <title>Manage saved Settings Dialog</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/manage-saved-settings.png"/>
- </imageobject>
- </mediaobject>
- </figure>
</listitem>
</varlistentry>
<varlistentry>
@@ -162,6 +124,17 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>Adjust curves in linear light and Adjust curves perceptually</term>
+ <listitem>
+ <para>
+ These new buttons in GIMP-2.10 allow you to switch between linear
+ and perceptual (non-linear) modes.
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term>Linear and Logarithmic buttons</term>
<listitem>
@@ -281,41 +254,35 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Preview</term>
+ <term>Preview and Split view</term>
<listitem>
<para>
- The Preview button makes all changes to the levels dynamically so
- that the new level settings can be viewed immediately.
+ These are common features described in
+ <xref linkend="gimp-colors-introduction"/>.
</para>
</listitem>
</varlistentry>
</variablelist>
<variablelist>
<title>Tool Options dialog</title>
+ <para>
+ <figure>
+ <title><quote>Levels</quote> tool options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/tool-options-curves.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </para>
<para>
Although this tool is not present in the Toolbox by default (For this,
please refer to <xref linkend="gimp-prefs-toolbox"/> if you want to add
it), nevertheless it has a Tool Option Dialog under the Toolbox. These
options are described here:
</para>
- <varlistentry>
- <term>Histogram Scale</term>
- <listitem>
- <para>
- These two options have the same action as the Logarithmic
- <guiicon>
- <inlinegraphic
- fileref="images/dialogs/stock-histogram-logarithmic-16.png"/>
- </guiicon>
- and Linear
- <guiicon>
- <inlinegraphic
- fileref="images/dialogs/stock-histogram-linear-16.png"/>
- </guiicon>
- buttons in the Curves dialog.
- </para>
- </listitem>
- </varlistentry>
+
<varlistentry>
<term>Sample Average</term>
<listitem>
diff --git a/src/menus/colors/exposure.xml b/src/menus/colors/exposure.xml
index 355e33a18..f86abfdb4 100644
--- a/src/menus/colors/exposure.xml
+++ b/src/menus/colors/exposure.xml
@@ -2,10 +2,88 @@
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!--section history:
- 2018-06-08 j.h Created empty
+ 2018-09-18 j.h Created
-->
<sect2 id="gimp-filter-exposure">
<title>Exposure</title>
- <para>TODO</para>
+
+ <indexterm>
+ <primary>Colors</primary>
+ <secondary>Exposure</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Exposure</primary>
+ </indexterm>
+
+ <para>
+ This filter is used for lightning shadows and midtones of an image without
+ blowing the highlights. A detailed tutorial can be found at
+ <ulink url="https://www.gimp.org/tutorials/Tone_Mapping_Using_GIMP_Levels"/>
+ </para>
+
+ <sect3>
+ <title>Activating the Command</title>
+ <para>
+ You can get to the Exposure dialog through:
+ <menuchoice>
+ <guimenu>Colors</guimenu>
+ <guimenuitem>Exposure…</guimenuitem>
+ </menuchoice>
+ </para>
+ </sect3>
+
+ <sect3>
+ <title>Options</title>
+ <figure>
+ <title>Exposure Options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/menus/colors/exposure-dialog.png"
+format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <variablelist>
+ <varlistentry>
+ <term>Presets</term>
+ <listitem>
+ <para>
+ <quote>Presets</quote>> are a common feature for
+ several Colors command. You can find its description in
+ <xref linkend="gimp-colors-introduction"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Black level</term>
+ <listitem>
+ <para>
+ This option is used to dispense with "useless" shadows and
+ highlight information.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Exposure</term>
+ <listitem>
+ <para>
+ This option is used to add one or more stops of exposure
+ compensation to the image.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Preview and Split view</term>
+ <listitem>
+ <para>
+ These are common features described in
+ <xref linkend="gimp-colors-introduction"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+
</sect2>
\ No newline at end of file
diff --git a/src/menus/colors/hue-chroma.xml b/src/menus/colors/hue-chroma.xml
index fb81c0d24..e2eaed3c8 100644
--- a/src/menus/colors/hue-chroma.xml
+++ b/src/menus/colors/hue-chroma.xml
@@ -2,10 +2,96 @@
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!--section history:
- 2018-06-08 j.h Created empty
+ 2018-09-17 j.h Created
-->
<sect2 id="gimp-filter-hue-chroma">
<title>Hue Chroma</title>
- <para>TODO</para>
+
+ <indexterm>
+ <primary>Colors</primary>
+ <secondary>Hue-Chroma</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Hue-Chroma</primary>
+ </indexterm>
+
+ <para>
+ The Hue-Chroma filter is another way to modify saturation. Clear
+ explanations about chroma and saturation can be found at
+<ulink url="https://ninedegreesbelow.com/photography/changing-saturation-using-lch-chroma.html"/> .
+ </para>
+
+ <sect3>
+ <title>Activating the Command</title>
+ <para>
+ You can get to the Hue-chroma dialog through:
+ <menuchoice>
+ <guimenu>Colors</guimenu>
+ <guimenuitem>Hue-Chroma…</guimenuitem>
+ </menuchoice>
+ </para>
+ </sect3>
+
+ <sect3>
+ <title>Options</title>
+ <figure>
+ <title>Hue-Chroma Options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/menus/colors/hue-chroma-dialog.png"
+format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <variablelist>
+ <varlistentry>
+ <term>Presets</term>
+ <listitem>
+ <para>
+ <quote>Presets</quote> are a common feature for
+ several Colors command. You can find its description in
+ <xref linkend="gimp-colors-introduction"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Hue</term>
+ <listitem>
+ <para>
+ The slider and the small arrow buttons allow you to select a hue in
+ the color circle (-180°, 180°).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Chroma</term>
+ <listitem>
+ <para>
+ <quote>Chroma</quote> is the purity of the color. Moving this
+ slider makes colors more or less pure.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Lightness</term>
+ <listitem>
+ <para>
+ This slider and the small arrow buttons allow you to select a value
+ (luminosity): -100, 100.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Preview and Split view</term>
+ <listitem>
+ <para>
+ These are common features described in
+ <xref linkend="gimp-colors-introduction"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+
</sect2>
\ No newline at end of file
diff --git a/src/menus/colors/hue-saturation.xml b/src/menus/colors/hue-saturation.xml
index 412fe2fd9..013394673 100755
--- a/src/menus/colors/hue-saturation.xml
+++ b/src/menus/colors/hue-saturation.xml
@@ -2,70 +2,39 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2009-03-11 j.h: revised for v2.6. Added Presets
- 2008-01-18 ude: updated 'de'
- 2008-01-14 j.h: updated to v2.4. Overlap option added
- 2007-06-06 kost: added 'no'
- 2007-04-15 Added Spanish translation by AntI
- 2006-02-10 en;fr revised by j.h
- 2005-12-06 replaced simplesect by sect3 by lexa
- 2005-12-06 replaced informalfigure by figure by lexa
- 050807 de restructured and reviewed by axel.wernicke
+ 2009-03-11 j.h: Added Presets
+ 2008-01-14 j.h: Overlap option added
-->
<sect2 id="gimp-tool-hue-saturation">
<title>Hue-Saturation</title>
- <indexterm>
- <primary>Tools</primary>
- <secondary>Hue-Saturation</secondary>
- </indexterm>
<indexterm>
<primary>Hue-Saturation</primary>
</indexterm>
<para>
- The Hue-Saturation tool is used to adjust hue, saturation and lightness
+ The Hue-Saturation command is used to adjust hue, saturation and lightness
levels on a range of color weights for the selected area or active layer.
</para>
<sect3>
- <title>Activating the Tool</title>
- <para>You can get to the Hue-Saturation tool in two ways :</para>
- <itemizedlist>
- <listitem>
- <para>
- In the image-menu through:
- <menuchoice>
- <guimenu>Tools</guimenu>
- <guisubmenu>Color Tools</guisubmenu>
- <guimenuitem>Hue-Saturation…</guimenuitem>
- </menuchoice>, or
- <menuchoice>
- <guimenu>Colors</guimenu>
- <guimenuitem>Hue-Saturation…</guimenuitem>
- </menuchoice>
- </para>
- </listitem>
- <listitem>
- <para>
- By clicking the tool icon:
- <guiicon>
- <inlinegraphic
- fileref="images/toolbox/stock-tool-hue-saturation-22.png"/>
- </guiicon>
- in Toolbox, provided that you have installed color tools in Toolbox.
- For this, please refer to <xref linkend="gimp-prefs-toolbox"/>.
- </para>
- </listitem>
- </itemizedlist>
+ <title>Activating the command</title>
+ <para>
+ You can get to the Hue-Saturation command through:
+ <menuchoice>
+ <guimenu>Colors</guimenu>
+ <guimenuitem>Hue-Saturation…</guimenuitem>
+ </menuchoice>
+ </para>
</sect3>
<sect3>
<title>Options</title>
<figure>
- <title>Hue-Saturation tool options</title>
+ <title>Hue-Saturation Options</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/tools-hue-sat.png" format="PNG"/>
+ <imagedata fileref="images/menus/colors/hue-saturation-dialog.png"
+format="PNG"/>
</imageobject>
</mediaobject>
</figure>
@@ -74,42 +43,10 @@
<term>Presets</term>
<listitem>
<para>
- You can save the color settings of your image by clicking the
- <guibutton>Add settings to favourites</guibutton> button
- <guiicon>
- <inlinegraphic fileref="images/toolbox/save-color-settings.png"/>
- </guiicon>
- </para>
- <para>
- The
- <guiicon>
- <inlinegraphic fileref="images/toolbox/presets-menu-icon.png"/>
- </guiicon>
- button opens a menu:
- </para>
- <figure>
- <title>Preset Menu</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/presets-menu.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- which lets you <guilabel>Import Settings from File</guilabel> or
- <guilabel>Export Settings to File</guilabel>,
- and gives you access to the Manage Save Settings dialog:
+ <quote>Presets</quote> are a common feature for
+ several Colors command. You can find its description in
+ <xref linkend="gimp-colors-introduction"/>.
</para>
- <figure>
- <title>Manage saved Settings Dialog</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/manage-saved-settings.png"/>
- </imageobject>
- </mediaobject>
- </figure>
</listitem>
</varlistentry>
<varlistentry>
@@ -229,11 +166,11 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Preview</term>
+ <term>Preview and Split view</term>
<listitem>
<para>
- The Preview button makes all changes dynamically so that they can
- be viewed straight away.
+ These are common features described in
+ <xref linkend="gimp-colors-introduction"/>.
</para>
</listitem>
</varlistentry>
diff --git a/src/menus/colors/introduction.xml b/src/menus/colors/introduction.xml
index 939479cd1..f1d8cb2d5 100644
--- a/src/menus/colors/introduction.xml
+++ b/src/menus/colors/introduction.xml
@@ -21,4 +21,80 @@
which contains commands that affect the color of the image.
</para>
<xi:include href="../about-plugin-menuitems.xml"/>
+
+ <sect3>
+ <title>Colors Common Features</title>
+ <variablelist>
+ <varlistentry>
+ <term>Presets</term>
+ <listitem>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/menus/colors/preset-widget.png"/>
+ </imageobject>
+ </mediaobject>
+ <para>
+ The
+ <guiicon>
+ <inlinegraphic fileref="images/toolbox/presets-menu-icon.png"/>
+ </guiicon>
+ button opens a menu:
+ </para>
+ <figure>
+ <title>Preset Menu</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/presets-menu.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ which lets you <guilabel>Import Settings from File</guilabel> or
+ <guilabel>Export Settings to File</guilabel>,
+ and gives you access to the Manage Save Settings dialog:
+ </para>
+ <figure>
+ <title>Manage saved Settings Dialog</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/toolbox/manage-saved-settings.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Preview and Split view</term>
+ <listitem>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/menus/colors/preview+split.png"/>
+ </imageobject>
+ </mediaobject>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Preview</guilabel>: this option is checked by default
+ and displays changes directly on canvas.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Split view</guilabel>: if this option is checked, the
+ image window is divided in two parts. Changes appear in the
+ left part and the right part remains unchanged for comparison.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </sect3>
+
</sect2>
diff --git a/src/menus/colors/levels.xml b/src/menus/colors/levels.xml
index cc66c2ca9..03d69654c 100755
--- a/src/menus/colors/levels.xml
+++ b/src/menus/colors/levels.xml
@@ -2,14 +2,8 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history
- 2009-03-11 j.h: revised for v2.6. Added Presets
- 2008-01-17 j.h: updated to v2.4 and enhanced 'en;fr'
- 2007-06-06 kost: added 'no'
- 2007-04-15 Added Spanish translation by AntI
- 2006-02-10 en;fr revised by j.h
- 2005-12-06 replaced simplesect by sect3 by lexa
- 2005-12-06 replaced imformalfigure by figure by lexa
- 2005-08-07 de reviewed by axel.wernicke
+ 2018-06-20 j.h small updates to v2.10.2
+ 2009-03-11 j.h: Added Presets
-->
<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-tool-levels">
<title>Levels</title>
@@ -49,16 +43,7 @@
<sect3>
<title>Activating the Tool</title>
<itemizedlist>
- <para>You can get to this tools in several ways:</para>
- <listitem>
- <para>
- In the image menu through
- <menuchoice>
- <guimenu>Colors</guimenu>
- <guimenuitem>Levels…</guimenuitem>
- </menuchoice>.
- </para>
- </listitem>
+ <para>You can get to this tools in two ways:</para>
<listitem>
<para>
In the image menu through
@@ -88,7 +73,8 @@
<title>Level tool options</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/toolbox/tools-levels.png" format="PNG"/>
+ <imagedata fileref="images/menus/colors/levels-dialog.png"
+format="PNG"/>
</imageobject>
</mediaobject>
</figure>
@@ -97,42 +83,10 @@
<term>Presets</term>
<listitem>
<para>
- You can save the color settings of your image by clicking the
- <guibutton>Add settings to favourites</guibutton> button
- <guiicon>
- <inlinegraphic fileref="images/toolbox/save-color-settings.png"/>
- </guiicon>
- </para>
- <para>
- The
- <guiicon>
- <inlinegraphic fileref="images/toolbox/presets-menu-icon.png"/>
- </guiicon>
- button opens a menu:
+ <quote>Presets</quote> are a common feature for
+ several Colors command. You can find its description in
+ <xref linkend="gimp-colors-introduction"/>.
</para>
- <figure>
- <title>Preset Menu</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/presets-menu.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- which lets you <guilabel>Import Settings from File</guilabel> or
- <guilabel>Export Settings to File</guilabel>,
- and gives you access to the Manage Save Settings dialog:
- </para>
- <figure>
- <title>Manage saved Settings Dialog</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/toolbox/manage-saved-settings.png"/>
- </imageobject>
- </mediaobject>
- </figure>
</listitem>
</varlistentry>
<varlistentry>
@@ -168,14 +122,29 @@
</listitem>
<listitem>
<para>
- <guilabel>Initialize channel</guilabel> cancels changes to
- the selected channel.
+ <guilabel>Reset channel</guilabel> restores the original
+ setting for the selected channel.
</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>Four new buttons with GIMP-2.10</term>
+ <listitem>
+ <para>
+ With the two left buttons, you can switch between linear and
+ perceptual (non-linear) modes, depending on which you need.
+ </para>
+ <para>
+ With the two right buttons, you can switch between Linear and
+ Logarithmic histogram.
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term>Input Levels</term>
<listitem>
@@ -498,11 +467,11 @@
</varlistentry>
<varlistentry>
- <term>Preview</term>
+ <term>Preview and Split view</term>
<listitem>
<para>
- The Preview button makes all changes to the levels dynamically so
- that the new level settings can be viewed straight away.
+ These are common features described in
+ <xref linkend="gimp-colors-introduction"/>.
</para>
</listitem>
</varlistentry>
@@ -526,34 +495,17 @@
<para>
Although this tool is not present in the Toolbox by default (please
refer to <xref linkend="gimp-prefs-toolbox"/> if you want to add it),
- nevertheless it has a Tool Option Dialog under the Toolbox. These
- options are described here:
+ nevertheless it has a Tool Option Dialog under the Toolbox.
</para>
- <varlistentry>
- <term>Histogram Scale</term>
- <listitem>
- <para>
- These two options have the same action as the Logarithmic
- <guiicon>
- <inlinegraphic
- fileref="images/dialogs/stock-histogram-logarithmic-16.png"/>
- </guiicon>
- and Linear
- <guiicon>
- <inlinegraphic
- fileref="images/dialogs/stock-histogram-linear-16.png"/>
- </guiicon>
- buttons in the Levels dialog.
- </para>
- </listitem>
- </varlistentry>
+
<varlistentry>
<term>Sample Average</term>
<listitem>
<para>
This slider sets the <quote>radius</quote> of the color-picking
- area. This area appears as a more or less enlarged square when
- you maintain the click on a pixel.
+ area to get the averaged color value from nearby pixels. This area
+ appears as a more or less enlarged square when you maintain the
+ click on a pixel.
</para>
</listitem>
</varlistentry>
diff --git a/src/menus/colors/saturation.xml b/src/menus/colors/saturation.xml
index 2f2c6dfc4..b8b06dc66 100644
--- a/src/menus/colors/saturation.xml
+++ b/src/menus/colors/saturation.xml
@@ -7,5 +7,72 @@
<sect2 id="gimp-filter-saturation">
<title>Saturation</title>
- <para>TODO</para>
+
+ <indexterm>
+ <primary>Colors</primary>
+ <secondary>Saturation</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Saturation</primary>
+ </indexterm>
+
+ <para>
+ Another way to modify saturation. Clear explanations about chroma and
+ saturation can be found at
+<ulink url="https://ninedegreesbelow.com/photography/changing-saturation-using-lch-chroma.html"/>
+ </para>
+
+ <sect3>
+ <title>Activating the Command</title>
+ <para>
+ You can get to the Saturation dialog through:
+ <menuchoice>
+ <guimenu>Colors</guimenu>
+ <guimenuitem>Saturation…</guimenuitem>
+ </menuchoice>
+ </para>
+ </sect3>
+
+ <sect3>
+ <title>Options</title>
+ <figure>
+ <title>Saturation Options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/menus/colors/saturation-dialog.png"
+format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <variablelist>
+ <varlistentry>
+ <term>Presets</term>
+ <listitem>
+ <para>
+ <quote>Presets</quote> are a common feature for
+ several Colors command. You can find its description in
+ <xref linkend="gimp-colors-introduction"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Scale</term>
+ <listitem>
+ <para>
+ This option gives more or less saturation.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Preview and Split view</term>
+ <listitem>
+ <para>
+ These are common features described in
+ <xref linkend="gimp-colors-introduction"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+
</sect2>
\ No newline at end of file
diff --git a/src/menus/colors/shadows-highlights.xml b/src/menus/colors/shadows-highlights.xml
index cb8e2f04b..9b9a3ccaa 100644
--- a/src/menus/colors/shadows-highlights.xml
+++ b/src/menus/colors/shadows-highlights.xml
@@ -2,10 +2,167 @@
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!--section history:
- 2018-06-08 j.h Created empty
+ 2018-09-18 j.h Created
-->
<sect2 id="gimp-filter-shadows-highlights">
<title>Shadows-Highlights</title>
- <para>TODO</para>
+
+ <indexterm>
+ <primary>Colors</primary>
+ <secondary>Shadows and Highlights</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Shadows and Highlights</primary>
+ </indexterm>
+
+ <para>
+ This filter allows adjusting shadows and highlights in the image
+ separately. The implementation closely follow its counterpart in the
+ Darktable photography software
+<ulink url="https://www.darktable.org/usermanual/en/modules.html#shadows_and_highlights";>Shadows and
Highlights</ulink>.
+ </para>
+
+ <sect3>
+ <title>Activating the Command</title>
+ <para>
+ You can get to the Shadows and Highlights dialog through:
+ <menuchoice>
+ <guimenu>Colors</guimenu>
+ <guimenuitem>Shadows and Highlights…</guimenuitem>
+ </menuchoice>
+ </para>
+ </sect3>
+
+ <sect3>
+ <title>Options</title>
+ <figure>
+ <title>Shadows and Highlights Options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+fileref="images/menus/colors/shadows-highlights-dialog.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <variablelist>
+ <varlistentry>
+ <term>Presets</term>
+ <listitem>
+ <para>
+ <quote>Presets</quote> are a common feature for
+ several Colors command. You can find its description in
+ <xref linkend="gimp-colors-introduction"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!--This description closely follows the Darktable manual-->
+ <varlistentry>
+ <term>Three options groups:</term>
+ <listitem>
+ <para>
+ <emphasis role= "bold">Shadows</emphasis>: options for shadows:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Shadows</guilabel>: This slider controls the effect on
+ shadows; positive values will lighten up shadows while negative
+ values will darken them.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Shadows color adjustment</guilabel>: This slider
+ controls the color saturation adjustment made to shadows; high
+ values cause saturation enhancements on lightened shadows; low
+ values cause desaturation on lightened shadows. It is normally
+ safe to leave this at its default of 100%. This gives a natural
+ saturation boost on shadows – similar to the one you would also
+ expect in nature if shadows would receive more light.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <para>
+ <emphasis role= "bold">Highlights</emphasis>: options for
+ highlights:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Highlights</guilabel>: This slider controls the effect
+ on highlights; negative values will darken highlights while
+ positive values will lighten them up.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Highlights color adjustment</guilabel>: This slider
+ controls the color saturation adjustment made to highlights;
+ high values cause saturation enhancements on darkened
+ highlights; low values cause desaturation on darkened
+ highlights. Often highlights do not contain enough color
+ information to give convincing colors when darkened. You might
+ need to play a bit with this parameter in order to find the best
+ fitting value depending on your specific image; but be aware
+ that sometimes results still might not be fully satisfying.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <para>
+ <emphasis role= "bold">Common</emphasis>: options common to shadows
+ and highlights:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>White point adjustment</guilabel>: By default the
+ algorithm of this modules leaves black point and white point
+ untouched. In some cases an image might contain tonal
+ variations beyond the white point, i.e. above a luminance value
+ of 100. A negative shift in the white point adjustment slider
+ allows to bring these values down into the proper range so that
+ further details in the highlights get visible.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Radius</guilabel>: This slider controls the radius of
+ the involved blurring filter. Higher values give softer
+ transitions between shadows and highlights but might introduce
+ halos. Lower values will reduce the size of halos but may lead
+ to an artificial look.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Compress</guilabel>: This slider controls how strong
+ the effect extends to mid-tones; high values reduce the effect
+ to the extreme shadows and highlights; low values cause strong
+ adjustments also to mid-tones. You normally only need to touch
+ this parameter if you want to limit the effects to the extreme
+ shadows and highlights; increase the value in this case. At 100%
+ this module has no visible effect any longer as only absolute
+ black and absolute white are affected.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Preview and Split view</term>
+ <listitem>
+ <para>
+ These are common features described in
+ <xref linkend="gimp-colors-introduction"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+
</sect2>
\ No newline at end of file
diff --git a/src/menus/colors/threshold.xml b/src/menus/colors/threshold.xml
index 8d6709dd9..538c0f2bd 100755
--- a/src/menus/colors/threshold.xml
+++ b/src/menus/colors/threshold.xml
@@ -54,15 +54,6 @@
</menuchoice>,
</para>
</listitem>
- <listitem>
- <para>
- or through
- <menuchoice>
- <guimenu>Colors</guimenu>
- <guimenuitem>Threshold…</guimenuitem>
- </menuchoice>,
- </para>
- </listitem>
<listitem>
<para>
or by clicking on the
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
