[gimp-help-2] Modify indentations and such for Color Management items
- From: Elle Stone <ellestone src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Modify indentations and such for Color Management items
- Date: Thu, 6 Apr 2017 17:11:07 +0000 (UTC)
commit f7a2c7e118d6c7d33ce38958ba716bbdd6a00729
Author: Elle Stone <ellestone ninedegreesbelow com>
Date: Thu Apr 6 13:11:53 2017 -0400
Modify indentations and such for Color Management items
in the Image menu, and also Precision, Convert to Grayscale, etc.
src/menus/colors/desaturate/desaturate.xml | 295 ++++++++++------
src/menus/image.xml | 5 +
src/menus/image/assign-color-profile.xml | 287 ++++++++++------
src/menus/image/color-management.xml | 16 +-
src/menus/image/convert-grayscale.xml | 76 +++--
src/menus/image/convert-to-color-profile.xml | 355 ++++++++++++-------
src/menus/image/discard-color-profile.xml | 53 ++--
src/menus/image/enable-color-management.xml | 324 +++++++++++-------
src/menus/image/mode.xml | 4 -
src/menus/image/precision.xml | 435 +++++++++++++++---------
src/menus/image/save-color-profile-to-file.xml | 100 +++---
11 files changed, 1206 insertions(+), 744 deletions(-)
---
diff --git a/src/menus/colors/desaturate/desaturate.xml b/src/menus/colors/desaturate/desaturate.xml
index 6c2c194..93589a2 100644
--- a/src/menus/colors/desaturate/desaturate.xml
+++ b/src/menus/colors/desaturate/desaturate.xml
@@ -293,126 +293,197 @@
converting from color to black and white:</title>
<orderedlist>
<listitem>
- <para>The degree and direction from which the various ways to convert
- an image to black and white diverge from a straight Luminance conversion
- to black and white depends on:</para>
- <itemizedlist>
- <listitem><para>The conversion method you choose.</para></listitem>
- <listitem><para>The RGB color space in which the conversion is done.
- </para></listitem>
- <listitem><para>How saturated the colors in the original image happen to
- be, with more saturated starting colors (such as the red globe and the
- bright yellow sunflower) producing greater amounts of deviation from a
- straight Luminance conversion.</para></listitem>
- <listitem><para>The hues (for example yellows vs reds) of the various
- saturated colors in an image also make a difference.</para></listitem>
- <listitem><para>Being the maximum of the RGB channel values for each
- pixel, an HSV Value conversion to black and white is always lighter than
- the original color image, and also lighter than all the other ways to
- convert to black and white.</para></listitem>
- </itemizedlist>
- </listitem>
- <listitem>
- <para>Comparing the red globe to the yellow sunflower:</para>
+ <para>
+ The degree and direction from which the various ways to convert
+ an image to black and white diverge from a straight Luminance conversion
+ to black and white depends on:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ The conversion method you choose.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The RGB color space in which the conversion is done.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ How saturated the colors in the original image happen to
+ be, with more saturated starting colors (such as the red globe and the
+ bright yellow sunflower) producing greater amounts of deviation from a
+ straight Luminance conversion.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The hues (for example yellows vs reds) of the various
+ saturated colors in an image also make a difference.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Being the maximum of the RGB channel values for each
+ pixel, an HSV Value conversion to black and white is always lighter than
+ the original color image, and also lighter than all the other ways to
+ convert to black and white.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>
+ Comparing the red globe to the yellow sunflower:
+ </para>
<itemizedlist>
- <listitem><para>For the red globe Lightness (HSL) produces a result very
- similar to Luminance, and Luma produces a conversion that is much darker.
- </para></listitem>
- <listitem><para>For the sunflower, Luma produces a result very similar to
- Luminance, and Lightness (HSL) produces a conversion that is much darker.
- </para></listitem>
- <listitem><para>Notice that the less saturated parts of each image look
- more or less the same, regardless of which method is chosen for converting
- from color to black and white.
- </para></listitem>
- </itemizedlist>
+ <listitem>
+ <para>
+ For the red globe Lightness (HSL) produces a result very
+ similar to Luminance, and Luma produces a conversion that is much darker.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ For the sunflower, Luma produces a result very similar to
+ Luminance, and Lightness (HSL) produces a conversion that is much darker.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Notice that the less saturated parts of each image look
+ more or less the same, regardless of which method is chosen for converting
+ from color to black and white.
+ </para>
+ </listitem>
+ </itemizedlist>
</listitem>
</orderedlist>
</sect3>
<sect3>
- <title>More information about the five options for
- converting from color to black and white:</title>
- <orderedlist>
- <listitem id="More-information-about-Luminance">
- <para><emphasis>More information about Luminance:</emphasis></para>
- <itemizedlist>
- <listitem><para>"Luminance" is the only physically meaningful way to
- convert a color image to black and white, as the resulting black and
- white image has the same relative luminance (reflects the same
- percentage of light from the various shades of gray) as the colors in
- the original color image.</para></listitem>
- <listitem><para>Luminance must be calculated using linearized RGB
- values.</para></listitem>
- <listitem><para>For convenience we say "Luminance", but what we really
- mean is "Relative Luminance". For more information, see
- <ulink url="https://en.wikipedia.org/wiki/Relative_luminance";>Relative
- Luminance</ulink> and
- <ulink url="https://en.wikipedia.org/wiki/CIE_1931_color_space#Meaning_of_X.2C_Y.2C_and_Z";>
- CIE 1931 [XYZ] color space</ulink>.</para></listitem>
- <listitem>
- <para>GIMP 2.10 uses hard-coded sRGB values to do Luminance
- conversions to black and white. "Future GIMP" will support correct
- conversions for images in other color spaces.</para>
+ <title>More information about the five options for
+ converting from color to black and white:</title>
+ <orderedlist>
+ <listitem id="More-information-about-Luminance">
+ <para><emphasis>More information about Luminance:</emphasis></para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ "Luminance" is the only physically meaningful way to
+ convert a color image to black and white, as the resulting black and
+ white image has the same relative luminance (reflects the same
+ percentage of light from the various shades of gray) as the colors in
+ the original color image.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Luminance must be calculated using linearized RGB values.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ For convenience we say "Luminance", but what we really
+ mean is "Relative Luminance". For more information, see
+ <ulink url="https://en.wikipedia.org/wiki/Relative_luminance";>Relative
+ Luminance</ulink> and
+ <ulink url="https://en.wikipedia.org/wiki/CIE_1931_color_space#Meaning_of_X.2C_Y.2C_and_Z";>
+ CIE 1931 [XYZ] color space</ulink>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ GIMP 2.10 uses hard-coded sRGB values to do Luminance
+ conversions to black and white. "Future GIMP" will support correct
+ conversions for images in other color spaces.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem id="More-information-about-Luma">
+ <para>
+ <emphasis>More information about Luma:</emphasis>
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ "Luma" is what you get if you use the formula for
+ Luminance on RGB values that haven't been properly linearized. Luma
+ corresponds to GIMP 2.8's "Luminosity" method of converting to black and
+ white.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Compared to GIMP 2.8, GIMP 2.10's "Luma" option uses
+ slightly different multipliers. Unlike the GIMP 2.8 multipliers, the
+ GIMP 2.10 multipliers have been properly Bradford-adapted from D65 to
+ D50, which is required for use in an ICC profile color-managed editing
+ application (at least until the next version of the ICC specs is
+ released and people figure out how to deal with the new freedom to use
+ non-D50 reference white points).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ GIMP 2.10 uses hard-coded sRGB values to do Luma
+ conversions to black and white. "Future GIMP" will support correct
+ conversions for images in other color spaces.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem id="More-information-about-Lightness-Average-and-Value">
+ <para>
+ <emphasis>More information about Lightness, Average, and Value:
+ </emphasis>
+ </para>
+ <para>
+ The "Lightness (HSL)", "Average (HSI Intensity)", and "Value (HSV)"
+ ways to to convert a color image to black and white use color space models
+ that were invented for fast processing on consumer-grade computers from the
+ 1990s. For details see
+ <ulink url="https://en.wikipedia.org/wiki/HSL_and_HSV";>HSV and HSV</ulink>,
+ paying particular attention to the section on
+ <ulink url="https://en.wikipedia.org/wiki/HSL_and_HSV";>Disadvantages
+ </ulink>.
+ </para>
</listitem>
- </itemizedlist>
- </listitem>
- <listitem id="More-information-about-Luma">
- <para><emphasis>More information about Luma:</emphasis></para>
- <itemizedlist>
- <listitem><para>"Luma" is what you get if you use the formula for
- Luminance on RGB values that haven't been properly linearized. Luma
- corresponds to GIMP 2.8's "Luminosity" method of converting to black and
- white.</para></listitem>
- <listitem><para>Compared to GIMP 2.8, GIMP 2.10's "Luma" option uses
- slightly different multipliers. Unlike the GIMP 2.8 multipliers, the
- GIMP 2.10 multipliers have been properly Bradford-adapted from D65 to
- D50, which is required for use in an ICC profile color-managed editing
- application (at least until the next version of the ICC specs is
- released and people figure out how to deal with the new freedom to use
- non-D50 reference white points).</para></listitem>
<listitem>
- <para>GIMP 2.10 uses hard-coded sRGB values to do Luma
- conversions to black and white. "Future GIMP" will support correct
- conversions for images in other color spaces.</para>
- </listitem>
- </itemizedlist>
- </listitem>
- <listitem id="More-information-about-Lightness-Average-and-Value">
- <para><emphasis>More information about Lightness, Average, and Value:
- </emphasis></para>
- <para>The "Lightness (HSL)", "Average (HSI Intensity)", and "Value (HSV)"
- ways to to convert a color image to black and white use color space models
- that were invented for fast processing on consumer-grade computers from the
- 1990s. For details see
- <ulink url="https://en.wikipedia.org/wiki/HSL_and_HSV";>HSV and HSV</ulink>,
- paying particular attention to the section on
- <ulink url="https://en.wikipedia.org/wiki/HSL_and_HSV";>Disadvantages
- </ulink>.</para>
- </listitem>
- <listitem>
- <para><emphasis>In case you are wondering why LAB Lightness</emphasis> is
- not among the options
- for converting an RGB image to black and white, a properly calculated
- conversion from RGB to LAB Lightness, and then back to RGB, produces exactly
- the same result as the Luminance conversion to black and white. Here is why:
- </para>
- <itemizedlist>
- <listitem><para>In the XYZ color space, Y is Luminance. So if you
- convert a color RGB image to XYZ, the "Y" of XYZ is the same number as
- the R=G=B values that you get when you calculate RGB Luminance.</para></listitem>
- <listitem><para>LAB is a perceptually uniform transform of XYZ. If you
- convert from RGB to XYZ and then to LAB, and set A=B=0.0 (or 0.5 for
- image editors that put the midpoint of the A and B axes as 0.5 instead
- of at 0.0), and then convert back to XYZ, the X and Z values will
- change, but Y will not change.</para></listitem>
- </itemizedlist>
- <para>Tutorials that produce anything other than Relative Luminance when
- converting an RGB image to black and white using LAB Lightness, very sadly
- are trading on various mathematical mistakes in the conversion routines.
- </para>
- </listitem>
- </orderedlist>
+ <para>
+ <emphasis>In case you are wondering why LAB Lightness</emphasis> is
+ not among the options
+ for converting an RGB image to black and white, a properly calculated
+ conversion from RGB to LAB Lightness, and then back to RGB, produces exactly
+ the same result as the Luminance conversion to black and white. Here is why:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ In the XYZ color space, Y is Luminance. So if you
+ convert a color RGB image to XYZ, the "Y" of XYZ is the same number as
+ the R=G=B values that you get when you calculate RGB Luminance.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ LAB is a perceptually uniform transform of XYZ. If you
+ convert from RGB to XYZ and then to LAB, and set A=B=0.0 (or 0.5 for
+ image editors that put the midpoint of the A and B axes as 0.5 instead
+ of at 0.0), and then convert back to XYZ, the X and Z values will
+ change, but Y will not change.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Tutorials that produce anything other than Relative Luminance when
+ converting an RGB image to black and white using LAB Lightness, very sadly
+ are trading on various mathematical mistakes in the conversion routines.
+ </para>
+ </listitem>
+ </orderedlist>
</sect3>
</sect2>
diff --git a/src/menus/image.xml b/src/menus/image.xml
index b79d46f..139b16c 100644
--- a/src/menus/image.xml
+++ b/src/menus/image.xml
@@ -12,6 +12,11 @@
<sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-image-menu">
<title>The <quote>Image</quote> Menu</title>
+ <indexterm>
+ <primary>Image window</primary>
+ <secondary>Menus</secondary>
+ </indexterm>
+
<xi:include href="image/introduction.xml"/>
<!-- the menu -->
<xi:include href="image/duplicate.xml"/>
diff --git a/src/menus/image/assign-color-profile.xml b/src/menus/image/assign-color-profile.xml
index 12e20ef..9a5b948 100644
--- a/src/menus/image/assign-color-profile.xml
+++ b/src/menus/image/assign-color-profile.xml
@@ -20,178 +20,237 @@
<primary>Assign Color Profile</primary>
</indexterm>
- <para>The <guimenuitem>Assign Color Profile</guimenuitem> allows you to
- assign a new ICC profile to an image.</para>
+ <para>
+ The <guimenuitem>Assign Color Profile</guimenuitem> allows you to
+ assign a new ICC profile to an image.
+ </para>
<sect3>
<title>Activating the command</title>
- <itemizedlist>
+ <para>
+ You can access this command from the image menu bar through
+ <menuchoice>
+ <guimenu>Image</guimenu>
+ <guisubmenu>Color Management</guisubmenu>
+ <guimenuitem>Assign Color Profile</guimenuitem>
+ </menuchoice>.
+ </para>
+ </sect3>
+
+ <sect3>
+ <title>Use Notes for <guimenuitem>Assign Color Profile</guimenuitem></title>
+ <para>
+ When importing an image from disk, sometimes you might want to
+ assign a new ICC profile to the image:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ The image might not have an embedded ICC profile, in
+ which case GIMP will automatically assign one of GIMP's built-in sRGB
+ profiles:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ If the image really is an sRGB image, then no
+ further action is required.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If the image is not an sRGB image, then use
+ <guimenuitem>Assign Color Profile</guimenuitem> to assign the
+ correct ICC profile from disk.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
<listitem>
<para>
- You can access this command from the image menu bar through
- <menuchoice>
- <guimenu>Image</guimenu>
- <guisubmenu>Color Management</guisubmenu>
- <guimenuitem>Assign Color Profile</guimenuitem>
- </menuchoice>.
+ The image might have an embedded ICC profile, but maybe
+ it's not the right profile for the image, or maybe it's just not the
+ profile you want assigned to the image. Use
+ <guimenuitem>Assign Color Profile</guimenuitem> to assign another
+ profile from disk.
</para>
</listitem>
- </itemizedlist>
- <para>When importing an image from disk, sometimes you might want to
- assign a new ICC profile to the image:</para>
- <orderedlist>
- <listitem><para>The image might not have an embedded ICC profile, in
- which case GIMP will automatically assign one of GIMP's built-in sRGB
- profiles:</para>
- <itemizedlist>
- <listitem><para>If the image really is an sRGB image, then no
- further action is required.</para></listitem>
- <listitem><para>If the image is not an sRGB image, then use
- <guimenuitem>Assign Color Profile</guimenuitem> to assign the
- correct ICC profile from disk.</para></listitem>
- </itemizedlist>
+ <listitem>
+ <para>
+ The image might have an embedded sRGB profile, but you
+ want to assign a GIMP built-in sRGB profile in place of the embedded
+ sRGB profile. Or conversely, maybe the image is in GIMP's built-in
+ sRGB color space, but you want to assign an sRGB profile from
+ disk.
+ </para>
</listitem>
- <listitem><para>The image might have an embedded ICC profile, but maybe
- it's not the right profile for the image, or maybe it's just not the
- profile you want assigned to the image. Use
- <guimenuitem>Assign Color Profile</guimenuitem> to assign another
- profile from disk.</para></listitem>
- <listitem><para>The image might have an embedded sRGB profile, but you
- want to assign a GIMP built-in sRGB profile in place of the embedded
- sRGB profile. Or conversely, maybe the image is in GIMP's built-in
- sRGB color space, but you want to assign an sRGB profile from
- disk.</para></listitem>
</orderedlist>
</sect3>
<sect3>
<title>An example with screenshots showing how to use
<guimenuitem>Assign Color Profile</guimenuitem></title>
- <para>Let's say you just imported an image file that you know should be
- in the AdobeRGB1998 color space. But for any number of possible reasons
- the image doesn't have an embedded ICC profile.</para>
+ <para>
+ Let's say you just imported an image file that you know should be
+ in the AdobeRGB1998 color space. But for any number of possible reasons
+ the image doesn't have an embedded ICC profile.
+ </para>
- <para>In cases where the image doesn't have an embedded ICC profile,
- GIMP will automatically assign a built-in sRGB profile. So your
- AdobeRGB1998 image won't show correct colors until you assign an
- AdobeRGB1998-compatible ICC profile from disk. The screenshots below
- show the procedure:</para>
+ <para>
+ In cases where the image doesn't have an embedded ICC profile,
+ GIMP will automatically assign a built-in sRGB profile. So your
+ AdobeRGB1998 image won't show correct colors until you assign an
+ AdobeRGB1998-compatible ICC profile from disk. The screenshots below
+ show the procedure:
+ </para>
<orderedlist>
-
- <listitem>
- <para>Accessing
- <quote>Image/Color Management/Assign Color Profile</quote> brings up the
- <guimenuitem>Assign ICC Color Profile</guimenuitem> dialog shown
- below:</para>
-
+ <listitem>
+ <para>
+ Accessing
+ <quote>Image/Color Management/Assign Color Profile</quote> brings up the
+ <guimenuitem>Assign ICC Color Profile</guimenuitem> dialog shown
+ below:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/assign-1.png" format="PNG"/>
</imageobject>
</mediaobject>
+ </listitem>
- </listitem>
-
- <listitem>
- <para>Under <guilabel>Current Color Profile</guilabel> is a description
- of the currently assigned color profile, in this case GIMP's built-in
- sRGB profile. Clicking on the "+" icon next to the description of the
- currently assigned profile displays the contents of various information
- tags in the assigned ICC profile.</para>
- <para>Clicking on the "+" icons next to the words
- <guilabel>Profile details</guilabel> displays the contents of various
- information tags in the ICC profile that you pick to be assigned to
- the image. Until you've actually picked a new profile, the
- profile in the <guilabel>Assign</guilabel> box defaults to a GIMP
- built-in sRGB profile.</para>
- <para>The screenshot below shows example profile descriptions
- revealed by clicking on the "+" icons:</para>
+ <listitem>
+ <para>
+ Under <guilabel>Current Color Profile</guilabel> is a description
+ of the currently assigned color profile, in this case GIMP's built-in
+ sRGB profile. Clicking on the "+" icon next to the description of the
+ currently assigned profile displays the contents of various information
+ tags in the assigned ICC profile.
+ </para>
+ <para>
+ Clicking on the "+" icons next to the words
+ <guilabel>Profile details</guilabel> displays the contents of various
+ information tags in the ICC profile that you pick to be assigned to
+ the image. Until you've actually picked a new profile, the
+ profile in the <guilabel>Assign</guilabel> box defaults to a GIMP
+ built-in sRGB profile.
+ </para>
+ <para>
+ The screenshot below shows example profile descriptions
+ revealed by clicking on the "+" icons:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/assign-2.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
+ </listitem>
- <listitem>
- <para>Between <guilabel>Assign</guilabel> and
- <guilabel>Profile details</guilabel> is a drop-down box that allows
- you to pick a new profile. Clicking in the drop-down box brings up a list
- of recently used profiles (if any). At the bottom of the list is an option
- to <guilabel>Select color profile from disk...</guilabel>:</para>
+ <listitem>
+ <para>
+ Between <guilabel>Assign</guilabel> and
+ <guilabel>Profile details</guilabel> is a drop-down box that allows
+ you to pick a new profile. Clicking in the drop-down box brings up a list
+ of recently used profiles (if any). At the bottom of the list is an option
+ to <guilabel>Select color profile from disk...</guilabel>:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/assign-3.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
+ </listitem>
- <listitem>
- <para>Clicking on <guilabel>Select color profile from disk...</guilabel>
- brings up the <guimenuitem>Select Destination Profile</guimenuitem>
- dialog for navigating to the disk location of the profile that you want
- to select from disk. The box has three panels:</para>
- <orderedlist>
- <listitem><para>The panel on the left allows you to navigate your
- on-disk folder structure to the folder of your choice.</para></listitem>
- <listitem><para>The center panel initially shows another list of
- recently used profiles.</para></listitem>
- <listitem><para>If you click on one of the recently used profiles,
- the right panel will show informational tags that are embedded in
- the selected profile.</para></listitem>
- </orderedlist>
+ <listitem>
+ <para>
+ Clicking on <guilabel>Select color profile from disk...</guilabel>
+ brings up the <guimenuitem>Select Destination Profile</guimenuitem>
+ dialog for navigating to the disk location of the profile that you want
+ to select from disk. The box has three panels:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ The panel on the left allows you to navigate your
+ on-disk folder structure to the folder of your choice.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The center panel initially shows another list of
+ recently used profiles.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If you click on one of the recently used profiles,
+ the right panel will show informational tags that are embedded in
+ the selected profile.
+ </para>
+ </listitem>
+ </orderedlist>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/assign-4.png" format="PNG"/>
</imageobject>
</mediaobject>
- <para>If the profile you want to select is shown in the list of
- recently used profiles, the profile can be directly selected from
- the list of recently used profiles by clicking on the
- <guilabel>Open</guilabel> button in the lower right corner. However, as
- the desired profile isn't in the list of recently used profile,
- the next step is to navigate to the profile's location on disk.</para>
- </listitem>
+ <para>
+ If the profile you want to select is shown in the list of
+ recently used profiles, the profile can be directly selected from
+ the list of recently used profiles by clicking on the
+ <guilabel>Open</guilabel> button in the lower right corner. However, as
+ the desired profile isn't in the list of recently used profile,
+ the next step is to navigate to the profile's location on disk.
+ </para>
+ </listitem>
- <listitem><para>As shown in the screenshot below, the left and center
- panels of the <guimenuitem>Select Destination Profile</guimenuitem>
- dialog allow you to navigate to where your ICC profiles are stored on
- disk, and then pick an appropriate ICC color profile (in this example,
- an AdobeRGB1998-compatible profile), and the right panel displays
- informational tags embedded in the selected profile.
- Click on the <guilabel>Open</guilabel> button to assign the selected
- profile to your image.</para>
+ <listitem>
+ <para>
+ As shown in the screenshot below, the left and center
+ panels of the <guimenuitem>Select Destination Profile</guimenuitem>
+ dialog allow you to navigate to where your ICC profiles are stored on
+ disk, and then pick an appropriate ICC color profile (in this example,
+ an AdobeRGB1998-compatible profile), and the right panel displays
+ informational tags embedded in the selected profile.
+ Click on the <guilabel>Open</guilabel> button to assign the selected
+ profile to your image.
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/assign-5.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
+ </listitem>
- <listitem><para>Clicking on the <guilabel>Open</guilabel> button
- returns you to the <guimenuitem>Assign ICC Color Profile</guimenuitem>
- dialog, allowing you a chance to either assign the selected profile or
- else pick a new profile. Once you are sure you've picked the right
- profile, click on the <guilabel>Assign</guilabel> button
- (lower right corner), and the selected profile will be assigned to
- the image:</para>
+ <listitem>
+ <para>
+ Clicking on the <guilabel>Open</guilabel> button
+ returns you to the <guimenuitem>Assign ICC Color Profile</guimenuitem>
+ dialog, allowing you a chance to either assign the selected profile or
+ else pick a new profile. Once you are sure you've picked the right
+ profile, click on the <guilabel>Assign</guilabel> button
+ (lower right corner), and the selected profile will be assigned to
+ the image:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/assign-6.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
+ </listitem>
- <listitem><para>And now the image has been assigned an
- AdobeRGB1998-compatible ICC profile, and the colors are correctly
- displayed:</para>
+ <listitem>
+ <para>
+ And now the image has been assigned an
+ AdobeRGB1998-compatible ICC profile, and the colors are correctly
+ displayed:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/assign-before-after.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
+ </listitem>
</orderedlist>
</sect3>
diff --git a/src/menus/image/color-management.xml b/src/menus/image/color-management.xml
index 8bde459..7c70f78 100644
--- a/src/menus/image/color-management.xml
+++ b/src/menus/image/color-management.xml
@@ -17,6 +17,12 @@
<secondary>Color Management</secondary>
<tertiary>Menu</tertiary>
</indexterm>
+ <para>
+ The <guimenuitem>Color Management</guimenuitem> submenu contains commands
+ which let you change the ICC color profile associated with an image
+ and also let you save the associated ICC color profile to disk. There are
+ five options in the Color Management submenu.
+ </para>
<figure>
<title>
@@ -29,18 +35,10 @@
</imageobject>
</mediaobject>
</figure>
- <para>
- The <guimenuitem>Color Management</guimenuitem> submenu contains commands
- which let you change the ICC color profile associated with an image
- and also let you save the associated ICC color profile to disk. There are
- five options in the Color Management submenu.
- </para>
<sect3>
<title>Activating the <guimenuitem>Color Management</guimenuitem>
Submenu</title>
- <itemizedlist>
- <listitem>
<para>
You can access this command from the image menu bar through
<menuchoice>
@@ -48,8 +46,6 @@
<guimenuitem>Color Management</guimenuitem>
</menuchoice>.
</para>
- </listitem>
- </itemizedlist>
</sect3>
<sect3>
diff --git a/src/menus/image/convert-grayscale.xml b/src/menus/image/convert-grayscale.xml
index ed1547e..4e22548 100644
--- a/src/menus/image/convert-grayscale.xml
+++ b/src/menus/image/convert-grayscale.xml
@@ -3,9 +3,8 @@
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
2017-04-01 elle stone: update contents for GIMP 2.10
- 2007-03-08 alex falappa: added it translation
- 2005/10/25 created from image-mode.xml by axel.wernicke
-->
+
<sect2 id="gimp-image-convert-grayscale">
<title>Grayscale mode</title>
@@ -30,47 +29,54 @@
black to white.
</para>
<para>
- The number of availabe tonal steps between black and white depends on the
- image precision:</para>
- <orderedlist>
- <listitem>
- <para>At integer precision:</para>
- <orderedlist>
- <listitem><para>An 8-bit integer grayscale image provides 255
- available tonal steps from 0 (black) to 255 (white).</para></listitem>
- <listitem><para>A 16-bit integer grayscale image provides 65535
- available tonal steps from 0 (black) to 65535 (white).</para></listitem>
- <listitem><para>A 32-bit integer grayscale image theoretically will
- provide 4294967295 tonal steps from 0 (black) to 4294967295 (white).
- But as high bit depth GIMP 2.10 does all internal processing at 32-bit
- floating point precision, the actual number of steps will be no more
- than the number of tonal steps available in a 32-bit floating point
- image.</para></listitem>
- </orderedlist>
+ The number of available tonal steps between black and white depends on the
+ image precision:
+ </para>
+ <para>
+ At integer precision:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ An 8-bit integer grayscale image provides 255 available tonal steps
+ from 0 (black) to 255 (white).
+ </para>
</listitem>
<listitem>
- <para>At floating point precision the available number of tonal steps in a
- grayscale image depends on the specified bit depth
- (8-bit, 16-bit, or 32-bit) and the type of floating point that is
- requested by the program (see
- <ulink url="https://en.wikipedia.org/wiki/Floating_point";>
- Floating-point arithmetic</ulink> for details).</para>
+ <para>
+ A 16-bit integer grayscale image provides 65535 available tonal
+ steps from 0 (black) to 65535 (white).
+ </para>
</listitem>
- </orderedlist>
+ <listitem>
+ <para>
+ A 32-bit integer grayscale image theoretically will
+ provide 4294967295 tonal steps from 0 (black) to 4294967295 (white).
+ But as high bit depth GIMP 2.10 does all internal processing at
+ 32-bit floating point precision, the actual number of steps will be
+ no more than the number of tonal steps available in a 32-bit
+ floating point image.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <para>
+ At floating point precision: the available number of tonal steps in a
+ grayscale image depends on the specified bit depth (8-bit, 16-bit, or
+ 32-bit) and the type of floating point that is requested by the program
+ (see <ulink url="https://en.wikipedia.org/wiki/Floating_point";>
+ Floating-point arithmetic</ulink> for details).
+ </para>
<sect3>
<title>Activating the Command</title>
- <itemizedlist>
- <listitem>
<para>
You can access this command from the image menubar through
- <menuchoice>
- <guimenu>Image</guimenu>
- <guisubmenu>Mode</guisubmenu>
- <guimenuitem>Grayscale</guimenuitem>
- </menuchoice>.
+ <menuchoice>
+ <guimenu>Image</guimenu>
+ <guisubmenu>Mode</guisubmenu>
+ <guimenuitem>Grayscale</guimenuitem>
+ </menuchoice>.
</para>
- </listitem>
- </itemizedlist>
</sect3>
</sect2>
diff --git a/src/menus/image/convert-to-color-profile.xml b/src/menus/image/convert-to-color-profile.xml
index 8b5edc7..99dc127 100644
--- a/src/menus/image/convert-to-color-profile.xml
+++ b/src/menus/image/convert-to-color-profile.xml
@@ -28,8 +28,6 @@
<sect3>
<title>Activating the command</title>
- <itemizedlist>
- <listitem>
<para>
You can access this command from the image menu bar through
<menuchoice>
@@ -38,24 +36,42 @@
<guimenuitem>Convert to Color Profile</guimenuitem>
</menuchoice>.
</para>
- </listitem>
- </itemizedlist>
- <para>In an ICC profile color managed editing application such as GIMP,
- every image has an assigned ICC color profile that (among other things)
- tells the Color Management System (in GIMP's case
- <ulink url="http://www.littlecms.com/";>Little CMS</ulink>) what color
- space to use when sending the image to the screen.</para>
- <para>Sometimes it's convenient or necessary to convert an image from
- its currently assigned ICC color profile to another ICC color profile.
- For example:</para>
+
+ </sect3>
+
+ <sect3>
+ <title>Use Notes for <guimenuitem>Convert to Color Profile</guimenuitem></title>
+ <para>
+ In an ICC profile color managed editing application such as GIMP,
+ every image has an assigned ICC color profile that (among other things)
+ tells the Color Management System (in GIMP's case
+ <ulink url="http://www.littlecms.com/";>Little CMS</ulink>) what color
+ space to use when sending the image to the screen.
+ </para>
+ <para>
+ Sometimes it's convenient or necessary to convert an image from
+ its currently assigned ICC color profile to another ICC color profile.
+ For example:
+ </para>
<orderedlist>
- <listitem><para>Perhaps you want to convert the image from some other
- color space to GIMP's built-in sRGB color space.</para></listitem>
- <listitem><para>Perhaps you want to convert the image to a printer
- profile before sending it out to a printing establishment.
- </para></listitem>
- <listitem><para>Perhaps the currently assigned color space is not the
- right color space for the editing task at hand.</para></listitem>
+ <listitem>
+ <para>
+ Perhaps you want to convert the image from some other
+ color space to GIMP's built-in sRGB color space.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Perhaps you want to convert the image to a printer
+ profile before sending it out to a printing establishment.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Perhaps the currently assigned color space is not the
+ right color space for the editing task at hand.
+ </para>
+ </listitem>
</orderedlist>
</sect3>
@@ -63,165 +79,238 @@
<title>An example with screenshots showing how to use
<guimenuitem>Convert to Color Profile</guimenuitem></title>
- <para>Let's say you have just finished editing an image. You edited the
- image in GIMP's built-in sRGB color space and now you want to convert a
- flattened copy of the image to a printer profile before sending it
- off to be printed. The screenshots below show the procedure:</para>
+ <para>
+ Let's say you have just finished editing an image. You edited the
+ image in GIMP's built-in sRGB color space and now you want to convert a
+ flattened copy of the image to a printer profile before sending it
+ off to be printed. The screenshots below show the procedure:
+ </para>
<orderedlist>
-
- <listitem>
- <para>Select
- <quote>Image/Color Management/Convert to Color Profile</quote> to bring up
- the <guimenuitem>Convert to ICC Color Profile</guimenuitem> dialog:</para>
-
+ <listitem>
+ <para>
+ Select <quote>Image/Color Management/Convert to Color Profile</quote>
+ to bring up the
+ <guimenuitem>Convert to ICC Color Profile</guimenuitem> dialog:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/convert-1.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
-
- <listitem>
- <para>Under <guilabel>Current Color Profile</guilabel> is a description
- of the currently assigned color profile, in this case GIMP's built-in
- sRGB profile. Clicking on the "+" icon next to the description of the
- currently assigned profile displays the contents of various information
- tags in the assigned ICC profile.</para>
- <para>Clicking on the "+" icons next to the words
- <guilabel>Profile details</guilabel> displays the contents of various
- information tags in the ICC profile that you pick as the profile to which
- the image will be converted. Until you've actually picked a new profile,
- the profile in the <guilabel>Convert to</guilabel> box defaults to a GIMP
- built-in sRGB profile.</para>
- <para>The screenshot below shows example profile descriptions
- revealed by clicking on the "+" icons:</para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Under <guilabel>Current Color Profile</guilabel> is a description
+ of the currently assigned color profile, in this case GIMP's built-in
+ sRGB profile. Clicking on the "+" icon next to the description of the
+ currently assigned profile displays the contents of various information
+ tags in the assigned ICC profile.
+ </para>
+ <para>
+ Clicking on the "+" icons next to the words
+ <guilabel>Profile details</guilabel> displays the contents of various
+ information tags in the ICC profile that you pick as the profile to which
+ the image will be converted. Until you've actually picked a new profile,
+ the profile in the <guilabel>Convert to</guilabel> box defaults to a GIMP
+ built-in sRGB profile.
+ </para>
+ <para>
+ The screenshot below shows example profile descriptions
+ revealed by clicking on the "+" icons:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/convert-2.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
-
- <listitem>
- <para>Between <guilabel>Convert to</guilabel> and
- <guilabel>Profile details</guilabel> is a drop-down box that allows
- you to pick a new profile. Clicking in the drop-down box brings up a list
- of recently used profiles (if any). At the bottom of the list is an option
- to <guilabel>Select color profile from disk...</guilabel>:</para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Between <guilabel>Convert to</guilabel> and
+ <guilabel>Profile details</guilabel> is a drop-down box that allows
+ you to pick a new profile. Clicking in the drop-down box brings up a list
+ of recently used profiles (if any). At the bottom of the list is an option
+ to <guilabel>Select color profile from disk...</guilabel>:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/convert-3.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
+ </listitem>
- <listitem>
- <para>Clicking on <guilabel>Select color profile from disk...</guilabel>
- brings up the <guimenuitem>Select Destination Profile</guimenuitem>
- dialog for navigating to the disk location of the profile that you want
- to select from disk. The box has three panels:</para>
- <orderedlist>
- <listitem><para>The panel on the left allows you to navigate your
- on-disk folder structure to the folder of your choice.</para></listitem>
- <listitem><para>The center panel initially shows another list of
- recently used profiles.</para></listitem>
- <listitem><para>If you click on one of the recently used profiles,
- the right panel will show informational tags that are embedded in
- the selected profile.</para></listitem>
- </orderedlist>
+ <listitem>
+ <para>
+ Clicking on <guilabel>Select color profile from disk...</guilabel>
+ brings up the <guimenuitem>Select Destination Profile</guimenuitem>
+ dialog for navigating to the disk location of the profile that you want
+ to select from disk. The box has three panels:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ The panel on the left allows you to navigate your
+ on-disk folder structure to the folder of your choice.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The center panel initially shows another list of
+ recently used profiles.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If you click on one of the recently used profiles,
+ the right panel will show informational tags that are embedded in
+ the selected profile.
+ </para>
+ </listitem>
+ </orderedlist>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/convert-4.png" format="PNG"/>
</imageobject>
</mediaobject>
- <para>As the desired profile is shown in the list of
- recently used profiles, the profile can be directly selected from
- the list of recently used profiles by clicking on the
- <guilabel>Open</guilabel> button in the lower right corner. Or as shown in
- the next screenshot,it can be selected by navigating to the profile's
- location on disk.</para>
- <note><para>"Destination profile" is the technical
- term for the profile to which you want to convert your image. Similarly,
- "source profile" refers to the current ICC color space (the color
- space the image is already in, before you convert it to the destination
- profile).</para></note>
- </listitem>
-
- <listitem><para>As shown in the screenshot below, the left and center
- panels of the <guimenuitem>Select Destination Profile</guimenuitem>
- dialog allow you to navigate to where your ICC profiles are stored on
- disk, and then pick the desired destination ICC color profile, and the
- right panel displays informational tags embedded in the selected profile.
- Click on the <guilabel>Open</guilabel> button to select the
- "Destination Profile".</para>
+ <para>
+ As the desired profile is shown in the list of
+ recently used profiles, the profile can be directly selected from
+ the list of recently used profiles by clicking on the
+ <guilabel>Open</guilabel> button in the lower right corner. Or as shown in
+ the next screenshot,it can be selected by navigating to the profile's
+ location on disk.
+ </para>
+ <note>
+ <para>
+ "Destination profile" is the technical
+ term for the profile to which you want to convert your image. Similarly,
+ "source profile" refers to the current ICC color space (the color
+ space the image is already in, before you convert it to the destination
+ profile).
+ </para>
+ </note>
+ </listitem>
+
+ <listitem>
+ <para>
+ As shown in the screenshot below, the left and center
+ panels of the <guimenuitem>Select Destination Profile</guimenuitem>
+ dialog allow you to navigate to where your ICC profiles are stored on
+ disk, and then pick the desired destination ICC color profile, and the
+ right panel displays informational tags embedded in the selected profile.
+ Click on the <guilabel>Open</guilabel> button to select the
+ "Destination Profile".
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/convert-5.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
+ </listitem>
- <listitem><para>Clicking on the <guilabel>Open</guilabel> button
- returns you to the <guimenuitem>Convert to ICC Color Profile</guimenuitem>
- dialog, allowing you a chance to either convert to the selected profile or
- else pick a new profile:</para>
+ <listitem>
+ <para>
+ Clicking on the <guilabel>Open</guilabel> button
+ returns you to the <guimenuitem>Convert to ICC Color Profile</guimenuitem>
+ dialog, allowing you a chance to either convert to the selected profile or
+ else pick a new profile:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/convert-6.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
-
+ </listitem>
- <listitem><para>Once you are sure you've picked the right
- profile, the next step is to select the desired conversion options:</para>
+ <listitem>
+ <para>
+ Once you are sure you've picked the right
+ profile, the next step is to select the desired conversion options:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/convert-7.png" format="PNG"/>
</imageobject>
</mediaobject>
- <para>Selecting the desired conversion options requires two decisions:
- </para>
- <orderedlist>
- <listitem><para>Choose a rendering intent from the
- <guilabel>Rendering Intent</guilabel> drop-down box. The ICC profile
- rendering intents are:</para>
- <itemizedlist>
- <listitem><para><guilabel>Perceptual</guilabel></para></listitem>
- <listitem><para><guilabel>Relative Colorimetric
- </guilabel></para></listitem>
- <listitem><para><guilabel>Saturation</guilabel></para></listitem>
- <listitem><para><guilabel>Absolute</guilabel></para></listitem>
- </itemizedlist>
- </listitem>
-
- <listitem><para>Decide whether to use black point compensation:</para>
- <itemizedlist>
- <listitem><para>To use black point compensation, the
- <guilabel>Black Point Compensation</guilabel> box should be
- checked.</para></listitem>
- <listitem><para>To not use black point compensation, the
- <guilabel>Black Point Compensation</guilabel> box should be
- unchecked.</para></listitem>
- </itemizedlist>
- </listitem>
- </orderedlist>
- <!--<para>For information about choosing a rendering intent and whether
- to use black point compensation, see (page not yet written, should go
- in the Color Management section of the documentation).</para>-->
- </listitem>
-
- <listitem><para>When you've picked the desired conversion options, click
- on the Convert button in the lower right corner, and the image will be
- converted to the selected destination profile, in the current example,
- an RGB printer profile:</para>
+ <para>
+ Selecting the desired conversion options requires two decisions:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Choose a rendering intent from the
+ <guilabel>Rendering Intent</guilabel> drop-down box. The ICC profile
+ rendering intents are:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Perceptual</guilabel>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Relative Colorimetric</guilabel>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Saturation</guilabel>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Absolute</guilabel>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
+ <para>
+ Decide whether to use black point compensation:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ To use black point compensation, the
+ <guilabel>Black Point Compensation</guilabel> box should be
+ checked.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ To not use black point compensation, the
+ <guilabel>Black Point Compensation</guilabel> box should be
+ unchecked.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </orderedlist>
+ <!--<para>
+ For information about choosing a rendering intent and whether
+ to use black point compensation, see (page not yet written, should go
+ in the Color Management section of the documentation).
+ </para>-->
+ </listitem>
+
+ <listitem>
+ <para>
+ When you've picked the desired conversion options, click
+ on the <guilabel>Convert</guilabel> button in the lower right corner, and the image will be
+ converted to the selected destination profile, in the current example,
+ an RGB printer profile:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/convert-before-after.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
+ </listitem>
</orderedlist>
</sect3>
diff --git a/src/menus/image/discard-color-profile.xml b/src/menus/image/discard-color-profile.xml
index fc96aa0..c569a70 100644
--- a/src/menus/image/discard-color-profile.xml
+++ b/src/menus/image/discard-color-profile.xml
@@ -32,8 +32,6 @@
<sect3>
<title>Activating the command</title>
- <itemizedlist>
- <listitem>
<para>
You can access this command from the image menu bar through
<menuchoice>
@@ -42,8 +40,6 @@
<guimenuitem>Discard Color Profile</guimenuitem>
</menuchoice>.
</para>
- </listitem>
- </itemizedlist>
<mediaobject>
<imageobject>
@@ -55,27 +51,40 @@
<sect3>
- <title>Use Notes for <guimenuitem>Discard Color Profile</guimenuitem></title>
-
- <para>If you discard the image's color profile:</para>
- <orderedlist>
- <listitem><para>The image's <emphasis>appearance</emphasis> will change
- (unless the image is already in an ICC profile color space that has the
- same colorants and channel encoding as the newly-assigned GIMP sRGB
- color space).</para></listitem>
+ <title>Use Notes for <guimenuitem>Discard Color Profile</guimenuitem></title>
- <listitem><para>The image's <emphasis>channel values</emphasis> are not
- changed by discarding the currently assigned profile and instead assigning
- GIMP's built-in sRGB profile.</para></listitem>
- </orderedlist>
+ <para>
+ If you discard the image's color profile:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ The image's <emphasis>appearance</emphasis> will change
+ (unless the image is already in an ICC profile color space that has the
+ same colorants and channel encoding as the newly-assigned GIMP sRGB
+ color space).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The image's <emphasis>channel values</emphasis> are not
+ changed by discarding the currently assigned profile and instead assigning
+ GIMP's built-in sRGB profile.
+ </para>
+ </listitem>
+ </orderedlist>
- <para>Discarding the image's currently assigned profile is useful if
- you wish to export an image to disk without an embedded ICC profile.</para>
+ <para>
+ Discarding the image's currently assigned profile is useful if
+ you wish to export an image to disk without an embedded ICC profile.
+ </para>
- <para><guimenuitem>Discard Color Profile</guimenuitem> can only be used
- if the ICC color profile assigned to the image is not a GIMP built-in
- sRGB profile. GIMP's built-in sRGB profiles are not embedded in images
- that are exported to disk.</para>
+ <para>
+ <guimenuitem>Discard Color Profile</guimenuitem> can only be used
+ if the ICC color profile assigned to the image is not a GIMP built-in
+ sRGB profile. GIMP's built-in sRGB profiles are not embedded in images
+ that are exported to disk.
+ </para>
</sect3>
diff --git a/src/menus/image/enable-color-management.xml b/src/menus/image/enable-color-management.xml
index 4e8125f..90b4203 100644
--- a/src/menus/image/enable-color-management.xml
+++ b/src/menus/image/enable-color-management.xml
@@ -20,22 +20,27 @@
<primary>Enable Color Management</primary>
</indexterm>
- <para>If unchecked, <guimenuitem>Enable Color Management</guimenuitem>
- assigns a GIMP built-in sRGB color space to your image.</para>
+ <para>
+ If unchecked, <guimenuitem>Enable Color Management</guimenuitem>
+ assigns a GIMP built-in sRGB color space to your image.
+ </para>
- <para>Also, if you've elected to
- display the image's assigned ICC color profile on the title or status bar,
- unchecking Enable Color Management prints
- the phrase "not color managed" to the title or status bar in place
- of the previously assigned color profile.</para>
+ <para>
+ Also, if you've elected to
+ display the image's assigned ICC color profile on the title or status bar,
+ unchecking Enable Color Management prints
+ the phrase "not color managed" to the title or status bar in place
+ of the previously assigned color profile.
+ </para>
- <note><para>Enable Color Management is checked by default. It's best to leave
- this option checked.</para></note>
+ <note>
+ <para>Enable Color Management is checked by default. It's best to leave
+ this option checked.
+ </para>
+ </note>
<sect3>
<title>Activating the command</title>
- <itemizedlist>
- <listitem>
<para>
You can access this command from the image menu bar through
<menuchoice>
@@ -44,111 +49,231 @@
<guimenuitem>Enable Color Management</guimenuitem>
</menuchoice>.
</para>
- </listitem>
- </itemizedlist>
</sect3>
+
+ <sect3>
+ <title>
+ Use Notes regarding unchecking
+ <guimenuitem>Enable Color Management</guimenuitem>
+ </title>
+ <para>
+ The best possible advice is to <emphasis role="bold">never uncheck <guimenuitem>Enable Color
Management</guimenuitem></emphasis>.
+ </para>
+ </sect3>
+<!-- <para>
+ If your image is already in one of GIMP's built-in sRGB color spaces,
+ unchecking Enable Color Management makes no difference whatsoever in your
+ editing results or in the appearance of your image.
+ </para>
+ <para>
+ If your image is not already in one of GIMP's built-in sRGB color
+ spaces, then the only time unchecking Enable Color Management won't change
+ your image's appearance is if the ICC profile assigned to your image has:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ The same channel encoding as the channel encoding that
+ GIMP happens to be using at the time you uncheck Enable Color Management.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The same chromaticities as the chromaticities of the
+ built-in GIMP sRGB profiles.
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ In the above case unchecking Enable Color Management is the
+ functional equivalent of assigning the built-in sRGB profile to your image,
+ except that simply assigning the built-in sRGB profile to your image
+ doesn't produce a misleading status or title bar message that the image is
+ "not color managed".
+ </para>
+ </sect3>-->
+
<sect3>
- <title>What does GIMP do when Enable Color Management is unchecked?
+ <title>
+ What does GIMP do when
+ <guimenuitem>Enable Color Management</guimenuitem> is unchecked?
</title>
- <para>When you uncheck the option to Enable Color Management, GIMP does
- two things:</para>
+ <para>
+ When you uncheck the option to
+ <guimenuitem>Enable Color Management</guimenuitem>, GIMP does
+ two things:
+ </para>
<orderedlist>
- <listitem><para>Whatever ICC profile is currently assigned to the image
- file is at least temporarily stored (pending subsequent editing,
- Precision, and Color Management actions), but isn't used.
- And then a built-in GIMP profile is assigned in place of the previously
- assigned ICC profile:</para>
- <itemizedlist>
- <listitem><para>If the image is at Perceptual gamma (sRGB) precision,
- the ICC profile "GIMP built-in sRGB" is assigned.</para></listitem>
- <listitem><para>If the image is at Linear light precision, the ICC
- profile "GIMP built-in Linear sRGB" is assigned.</para></listitem>
- </itemizedlist>
- <para>You can confirm that one of GIMP's built-in sRGB color spaces has
- been assigned by checking "Image/Image Properties/Color Profile".</para>
+ <listitem>
+ <para>
+ Whatever ICC profile is currently assigned to the image
+ file is at least temporarily stored (pending subsequent editing,
+ Precision, and Color Management actions), but isn't used.
+ And then a built-in GIMP profile is assigned in place of the previously
+ assigned ICC profile:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>If the image is at Perceptual gamma (sRGB) precision,
+ the ICC profile "GIMP built-in sRGB" is assigned.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If the image is at Linear light precision, the ICC
+ profile "GIMP built-in Linear sRGB" is assigned.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ You can confirm that one of GIMP's built-in sRGB color spaces has
+ been assigned by checking "Image/Image Properties/Color Profile".
+ </para>
</listitem>
- <listitem><para>If you have set up the title or status bar to show the
+ <listitem>
+ <para>
+ If you have set up the title or status bar to show the
image's color space, then the title or status bar will display a message
that the image is "not color managed". <emphasis>In reality the image is
still color managed</emphasis>, but now the image is color managed
"as if" it were in one of GIMP's built-in sRGB color spaces instead of
- whatever color space it's actually in.</para></listitem>
+ whatever color space it's actually in.
+ </para>
+ </listitem>
</orderedlist>
</sect3>
<sect3>
- <title>When Enable Color Management is unchecked, what happens to the image
- and the image appearance?</title>
- <note><para>Assigning a new profile to an image doesn't change the image's
- actual channel values. Assigning a new ICC profile only changes the meaning
- of the channel values, which means the image appearance will change (unless
- the original and new profile are functionally equivalent).</para> </note>
- <para>When Enable Color Management is unchecked, GIMP assigns one of GIMP's
- built-in sRGB profiles to the image. Assigning a new ICC profile to an image
- doesn't change the image's channel values, but it does more or less
- drastically change the image's appearance:</para>
+ <title>
+ When <guimenuitem>Enable Color Management</guimenuitem>
+ is unchecked, what happens to the image
+ and the image appearance?
+ </title>
+ <note>
+ <para>
+ Assigning a new profile to an image doesn't change the image's
+ actual channel values. Assigning a new ICC profile only changes the meaning
+ of the channel values, which means the image appearance will change (unless
+ the original and new profile are functionally equivalent).
+ </para>
+ </note>
+ <para>
+ When <guimenuitem>Enable Color Management</guimenuitem> is unchecked,
+ GIMP assigns one of GIMP's
+ built-in sRGB profiles to the image. Assigning a new ICC profile to an image
+ doesn't change the image's channel values, but it does more or less
+ drastically change the image's appearance:
+ </para>
<orderedlist>
- <listitem><para>If the image was already in one of GIMP's built-in color
- spaces (or if the assigned ICC profile is a profile that is functionally
- equivalent to the assigned GIMP built-in sRGB profile) then the image's
- appearance will not change.</para></listitem>
- <listitem><para>If the image was not already in one of GIMP's built-in
- color spaces (and is not in a color space that is functionally
- equivalent to the assigned GIMP built-in sRGB profile),
- the image's appearance will change more
- or less drastically depending on three things:</para>
+ <listitem>
+ <para>If the image was already in one of GIMP's built-in color
+ spaces (or if the assigned ICC profile is a profile that is functionally
+ equivalent to the assigned GIMP built-in sRGB profile) then the image's
+ appearance will not change.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If the image was not already in one of GIMP's built-in
+ color spaces (and is not in a color space that is functionally
+ equivalent to the assigned GIMP built-in sRGB profile),
+ the image's appearance will change more
+ or less drastically depending on three things:
+ </para>
<itemizedlist>
- <listitem><para>What GIMP Precision channel encoding —
- Linear light or Perceptual gamma (sRGB) — the image was in
- before the Enable Color Management box was unchecked.</para>
+ <listitem>
+ <para>
+ What GIMP Precision channel encoding —
+ Linear light or Perceptual gamma (sRGB) — the image was in
+ before the <guimenuitem>Enable Color Management</guimenuitem> box was unchecked.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ How far the image's originally assigned ICC profile's
+ channel encoding ("TRC") is from the GIMP Precision channel encoding.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ How far the image's originally assigned ICC profile's
+ Red, Green, and Blue chromaticities are from GIMP's built-in sRGB
+ chromaticities.
+ </para>
</listitem>
- <listitem><para>How far the image's originally assigned ICC profile's
- channel encoding ("TRC") is from the GIMP Precision channel encoding.
- </para></listitem>
- <listitem><para>How far the image's originally assigned ICC profile's
- Red, Green, and Blue chromaticities are from GIMP's built-in sRGB
- chromaticities.</para></listitem>
</itemizedlist>
</listitem>
</orderedlist>
</sect3>
<sect3>
- <title>Two screenshots showing examples of correct and incorrect image
- appearances after unchecking Enable Color Management</title>
- <para>In both screenshots shown below, the image is color
- managed: An ICC profile is assigned to the image, and that profile is being
- used to send the image colors to the screen.</para>
- <para>But in the second screenshot, after unchecking Enable Color
- Management, one of GIMP's built-in sRGB profiles has been incorrectly
- assigned to the image, so the colors look wrong.</para>
- <para>In screenshot 1 below, the image is already in a GIMP built-in sRGB
- color space. So unchecking Enable Color Management
- makes no difference in the appearance of the image. In this
- particular case unchecking Enable Color Management actually makes
- no difference at all, except that if you've elected to show the
- image's assigned ICC profile in the title or status bar, then instead
- of showing the assigned ICC profile, the title or status bar will
- show the words "not color managed". But in reality the image is still
- color managed:</para>
+ <title>
+ Two screenshots showing examples of correct and incorrect image
+ appearances after unchecking
+ <guimenuitem>Enable Color Management</guimenuitem>
+ </title>
+ <para>
+ In both screenshots shown below, the image is color
+ managed: An ICC profile is assigned to the image, and that profile is being
+ used to send the image colors to the screen.
+ </para>
+ <para>
+ But in the second screenshot, after unchecking Enable Color
+ Management, one of GIMP's built-in sRGB profiles has been incorrectly
+ assigned to the image, so the colors look wrong.
+ </para>
+ <para>
+ In screenshot 1 below, the image is already in a GIMP built-in sRGB
+ color space. So unchecking <guimenuitem>Enable Color Management</guimenuitem>
+ makes no difference in the appearance of the image. In this
+ particular case unchecking <guimenuitem>Enable Color Management</guimenuitem> actually makes
+ no difference at all, except that if you've elected to show the
+ image's assigned ICC profile in the title or status bar, then instead
+ of showing the assigned ICC profile, the title or status bar will
+ show the words "not color managed". But in reality the image is still
+ color managed:
+ </para>
<mediaobject>
<imageobject>
<imagedata
fileref="images/menus/image/color-management/enable-cm-gimp-built-in-perceptual-srgb-color-space-enabled-disabled.png"
format="PNG"/>
</imageobject>
</mediaobject>
- <para>In screenshot 2 below, the channel encoding of the original profile
- matches the GIMP channel encoding (both are linear), but the
- LargeRGB-elle-V4-g10.icc profile chromaticities don't match the GIMP built-in
- sRGB chromaticities. So after unchecking Enable Color Management, the tonality
- is correct but the colors are wrong. The image is still color managed,
- but it's color managed using the wrong ICC profile:</para>
+ <para>
+ In screenshot 2 below, the channel encoding of the original profile
+ matches the GIMP channel encoding (both are linear), but the
+ LargeRGB-elle-V4-g10.icc profile chromaticities don't match the GIMP built-in
+ sRGB chromaticities. So after unchecking
+ <guimenuitem>Enable Color Management</guimenuitem>, the tonality
+ is correct but the colors are wrong. The image is still color managed,
+ but it's color managed using the wrong ICC profile:
+ </para>
<mediaobject>
<imageobject>
<imagedata
fileref="images/menus/image/color-management/enable-cm-linear-precision-mismatched-chromaticities.png"
format="PNG"/>
</imageobject>
</mediaobject>
+ <caution>
+ <para>
+ If your image's originally assigned ICC profile doesn't have the same
+ channel encoding and chromaticities as the GIMP built-in sRGB profile, and
+ you uncheck and then immediately change your mind
+ and recheck <guimenuitem>Enable Color Management</guimenuitem>,
+ the originally assigned ICC profile
+ will be reassigned to your image and your image channel values will be
+ unchanged.
+ </para>
+ <para>
+ Otherwise, whether or not you can recover the originally
+ assigned ICC profile and correct colors for your image depends on what
+ else you've done between the unchecking and rechecking of
+ <guimenuitem>Enable Color Management</guimenuitem>.
+ </para>
+ <para>
+ Again, the best possible advice is to <emphasis role="bold">never uncheck <guimenuitem>Enable Color
Management</guimenuitem></emphasis>.
+ </para>
+ </caution>
<!--
<para>In screenshot 3 below, the chromaticities match, but the channel
encoding does not match:</para>
@@ -177,39 +302,4 @@
wrong (it's too dark) and the colors are wrong.</para>-->
</sect3>
- <sect3>
- <title>Cautions regarding unchecking Enable Color Management</title>
- <para>If your image is already in one of GIMP's built-in sRGB color spaces,
- unchecking Enable Color Management makes no difference whatsoever in your
- editing results or in the appearance of your image.</para>
- <para>If your image is not already in one of GIMP's built-in sRGB color
- spaces, then the only time unchecking Enable Color Management won't change
- your image's appearance is if the ICC profile assigned to your image has:
- </para>
- <orderedlist>
- <listitem><para>The same channel encoding as the channel encoding that
- GIMP happens to be using at the time you uncheck Enable Color Management.
- </para></listitem>
- <listitem><para>The same chromaticities as the chromaticities of the
- built-in GIMP sRGB profiles.</para></listitem>
- </orderedlist>
- <para>In the above case unchecking Enable Color Management is the
- functional equivalent of assigning the built-in sRGB profile to your image,
- except that simply assigning the built-in sRGB profile to your image
- doesn't produce a misleading status or title bar message that the image is
- "not color managed".</para>
- <para>If your image's originally assigned ICC profile doesn't have the same
- channel encoding and chromaticities as the GIMP built-in sRGB profile, and
- you uncheck Enable Color Management and then immediately change your mind
- and recheck Enable Color Management, the originally assigned ICC profile
- will be reassigned to your image and your image channel values will be
- unchanged.</para>
- <para>Otherwise, whether or not you can recover the originally
- assigned ICC profile and correct colors for your image depends on what
- else you've done between the unchecking and rechecking of Enable Color
- Management.</para>
- <para>The best possible advice is to never uncheck Enable Color
- Management.</para>
- </sect3>
-
</sect2>
diff --git a/src/menus/image/mode.xml b/src/menus/image/mode.xml
index a2d35e0..d4d0c87 100644
--- a/src/menus/image/mode.xml
+++ b/src/menus/image/mode.xml
@@ -37,8 +37,6 @@
<sect3>
<title>Activating the Submenu</title>
- <itemizedlist>
- <listitem>
<para>
You can access this submenu from the image menubar through
<menuchoice>
@@ -46,8 +44,6 @@
<guimenuitem>Mode</guimenuitem>
</menuchoice>.
</para>
- </listitem>
- </itemizedlist>
</sect3>
<sect3>
diff --git a/src/menus/image/precision.xml b/src/menus/image/precision.xml
index 345a1f1..58e90a6 100644
--- a/src/menus/image/precision.xml
+++ b/src/menus/image/precision.xml
@@ -15,6 +15,13 @@
<primary>Precision</primary>
</indexterm>
+ <para>
+ The <guimenuitem>Precision</guimenuitem> submenu contains commands which
+ let you change the precision of the image. The Precision options affect
+ the precision and channel encoding used for storing the image in RAM during
+ processing.
+ </para>
+
<figure>
<title>
The <quote>Precision</quote> submenu of the <quote>Image</quote> menu
@@ -25,191 +32,315 @@
</imageobject>
</mediaobject>
</figure>
- <para>The <guimenuitem>Precision</guimenuitem> submenu contains commands which
- let you change the precision of the image. The Precision options affect
- the precision and channel encoding used for storing the image in RAM during
- processing.</para>
<sect3>
<title>Activating the Submenu</title>
- <itemizedlist>
- <listitem>
- <para>
- You can access this submenu from the image menubar through
- <menuchoice>
- <guimenu>Image</guimenu>
- <guimenuitem>Precision</guimenuitem>
- </menuchoice>.
- </para>
- </listitem>
- </itemizedlist>
+ <para>
+ You can access this submenu from the image menubar through
+ <menuchoice>
+ <guimenu>Image</guimenu>
+ <guimenuitem>Precision</guimenuitem>
+ </menuchoice>.
+ </para>
</sect3>
<sect3>
<title>The Contents of the <quote>Precision</quote> Submenu</title>
- <para>The Precision Menu is divided into two parts: precision and channel
- encoding.</para>
+ <variablelist>
+ <para>
+ The Precision Menu is divided into two parts: precision and channel
+ encoding.
+ </para>
- <para>The precision at which image data is stored is a function of the
- bit depth (8-bit vs 16-bit vs 32-bit) and whether the data is stored as
- integer data or floating point data. The Precision menu offers
- the following precision options:</para>
- <orderedlist>
- <listitem><para>Integer precision options:</para>
- <orderedlist>
- <listitem><para><guimenuitem>8-bit integer</guimenuitem>
- </para></listitem>
- <listitem><para><guimenuitem>16-bit integer</guimenuitem>
- </para></listitem>
- <listitem><para><guimenuitem>32-bit integer</guimenuitem>
- </para></listitem>
- </orderedlist>
- </listitem>
- <listitem><para>Floating point precision options:</para>
- <orderedlist>
- <listitem><para><guimenuitem>16-bit floating point</guimenuitem>
- </para></listitem>
- <listitem><para><guimenuitem>32-bit floating point</guimenuitem>
- </para></listitem>
- </orderedlist>
- </listitem>
- </orderedlist>
+ <varlistentry>
+ <term>Precision options</term>
+ <listitem>
+ <para>
+ The precision at which image data is stored is a function of the
+ bit depth (8-bit vs 16-bit vs 32-bit) and whether the data is
+ stored as integer data or floating point data. The Precision menu
+ offers the following precision options:
+ </para>
+ <orderedlist>
+ <listitem>
+ <itemizedlist>
+ <title>Integer Precision Options</title>
+ <listitem>
+ <para>
+ <guimenuitem>8-bit integer</guimenuitem>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guimenuitem>16-bit integer</guimenuitem>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guimenuitem>32-bit integer</guimenuitem>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <itemizedlist>
+ <title>Floating point precision options</title>
+ <listitem>
+ <para>
+ <guimenuitem>16-bit floating point</guimenuitem>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guimenuitem>32-bit floating point</guimenuitem>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ </varlistentry>
- <para>The Precision menu also allows you to choose a
- <link linkend="glossary-channel-encoding">channel encoding</link> for the
- image data. Currently there are two choices:</para>
- <orderedlist>
- <listitem><para><guimenuitem>Perceptual gamma (sRGB)</guimenuitem>,
- which encodes the channel data using the approximately perceptually
- uniform sRGB TRC.</para></listitem>
- <listitem><para><guimenuitem>Linear light</guimenuitem>, which encodes the
- channel data using the linear gamma TRC.</para></listitem>
- </orderedlist>
+ <varlistentry>
+ <term>Channel Encoding Options</term>
+ <listitem>
+ <para>
+ The Precision menu also allows you to choose a
+ <link linkend="glossary-channel-encoding">channel encoding</link>
+ for the image data. Currently there are two choices:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guimenuitem>Perceptual gamma (sRGB)</guimenuitem>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guimenuitem>Linear light</guimenuitem>, which encodes the
+ channel data using the linear gamma TRC.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</sect3>
<sect3>
<title>Choosing the image precision and channel encoding</title>
<note>
- <para>Regardless of which options you choose in the Precision menu,
- in high bit depth GIMP 2.10 all internal processing is done at 32-bit
- floating point precision, and most editing operations are done using
- Linear light channel encoding.</para>
+ <para>
+ Regardless of which options you choose in the Precision menu,
+ in high bit depth GIMP 2.10 all internal processing is done at 32-bit
+ floating point precision, and most editing operations are done using
+ Linear light channel encoding.
+ </para>
</note>
- <para><emphasis>Which Precision options should you choose?</emphasis>
- In a nutshell:</para>
+ <para><emphasis role="bold">Which Precision options should you
+ choose?</emphasis> In a nutshell:</para>
<orderedlist>
- <listitem><para>To take full advantage of GIMP's internal 32-bit
- floating point processing, choose 32-bit floating point precision and
- also choose the Linear light channel encoding.</para></listitem>
- <listitem><para>If you are editing on a machine with limited RAM,
- or if you are editing very large images and layer stacks, consider
- using 16-bit floating point or integer precision.</para></listitem>
- <listitem><para>If you want to take advantage of high bit depth image
- editing but you don't want to deal with floating point channel values,
- then use 16-bit integer precision.</para></listitem>
- <listitem><para>On a very low-spec machine with not very much RAM,
- consider using 8-bit integer precision, in which case also choose
- the Perceptual gamma (sRGB) channel encoding (at 8-bit precision,
- if you choose the Linear light channel encoding your image will have
- horribly posterized shadows).</para></listitem>
+ <listitem>
+ <para>
+ To take full advantage of GIMP's internal 32-bit
+ floating point processing, choose 32-bit floating point precision and
+ also choose the Linear light channel encoding.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If you are editing on a machine with limited RAM,
+ or if you are editing very large images and layer stacks, consider
+ using 16-bit floating point or integer precision.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If you want to take advantage of high bit depth image
+ editing but you don't want to deal with floating point channel values,
+ then use 16-bit integer precision.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ When soft proofing an image, switch to Perceptual gamma
+ (sRGB) channel encoding to avoid certain problems with soft
+ proofing a linear gamma image using Little CMS.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ On a very low-spec machine with not very much RAM,
+ consider using 8-bit integer precision, in which case also choose
+ the Perceptual gamma (sRGB) channel encoding (at 8-bit precision,
+ if you choose the Linear light channel encoding your image will have
+ horribly posterized shadows).
+ </para>
+ </listitem>
</orderedlist>
</sect3>
<sect3>
<title>More information about the Precision options</title>
<orderedlist>
- <listitem><para><emphasis>Choosing the bit depth
- (8-bits vs 16-bits vs 32-bits):</emphasis></para>
+ <listitem>
+ <para>
+ <emphasis role="bold">Choosing the bit depth
+ (8-bits vs 16-bits vs 32-bits):</emphasis>
+ </para>
<itemizedlist>
- <listitem><para>The bit depth of an image sets limits on how much
- precision is available when processing your image files. All things
- being equal, higher bit depths provide more precision.</para></listitem>
- <listitem><para>The bit depth of an image file partially determines how
- much RAM is required for processing. The higher the bit depth, the more
- RAM is required to store data during image processing. Other relevant
- factors include the size of the image layers and the number of layers
- in the layer stack.</para></listitem>
+ <listitem>
+ <para>
+ The bit depth of an image sets limits on how much
+ precision is available when processing your image files. All things
+ being equal, higher bit depths provide more precision.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The bit depth of an image file partially determines how
+ much RAM is required for processing. The higher the bit depth, the more
+ RAM is required to store data during image processing. Other relevant
+ factors include the size of the image layers and the number of layers
+ in the layer stack.
+ </para>
+ </listitem>
</itemizedlist>
</listitem>
- <listitem><para><emphasis>Choosing between integer and floating point
- precision:</emphasis></para>
+ <listitem>
+ <para>
+ <emphasis role="bold">Choosing between integer and
+ floating point precision:</emphasis>
+ </para>
<itemizedlist>
- <listitem><para>Floating point precision is required for taking full
- advantage of high bit depth GIMP's internal 32-bit floating point
- processing. Floating point precision allows for the generation and
- use of channel values that fall outside the
- <link linkend="glossary-display-referred">display-referred range</link>
- from 0.0 ("display black") to 1.0 ("display white"), thus making
- possible very useful editing possibilities such as unbounded ICC
- profile conversions and
- <link linkend="glossary-high-dynamic-range">High Dynamic Range</link>
- <link linkend="glossary-scene-referred">scene-referred</link>
- editing operations.</para>
+ <listitem>
+ <para>
+ Floating point precision is required for taking full
+ advantage of high bit depth GIMP's internal 32-bit floating point
+ processing. Floating point precision allows for the generation and
+ use of channel values that fall outside the
+ <link linkend="glossary-display-referred">display-referred range</link>
+ from 0.0 ("display black") to 1.0 ("display white"), thus making
+ possible very useful editing possibilities such as unbounded ICC
+ profile conversions and
+ <link linkend="glossary-high-dynamic-range">High Dynamic Range</link>
+ <link linkend="glossary-scene-referred">scene-referred</link>
+ editing operations.
+ </para>
</listitem>
- <listitem><para>Unlike floating point precision, integer precision
- cannot store channel values outside the display range. So choosing an
- integer precision from the Precision menu means that all floating
- point channel values produced during processing are clipped to fit
- within the equivalent floating point range between 0.0 and 1.0
- inclusively:</para>
+ <listitem>
+ <para>
+ Unlike floating point precision, integer precision
+ cannot store channel values outside the display range. So choosing an
+ integer precision from the Precision menu means that all floating
+ point channel values produced during processing are clipped to fit
+ within the equivalent floating point range between 0.0 and 1.0
+ inclusively:
+ </para>
<itemizedlist>
- <listitem><para>8-bit integer values are clipped to the range
- 0-255.</para></listitem>
- <listitem><para>16-bit integer values are clipped to the range
- 0-65535.</para></listitem>
- <listitem><para>32-bit integer values are clipped to the range
- 0-4294967295.</para></listitem>
+ <listitem>
+ <para>
+ 8-bit integer values are clipped to the range 0-255.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 16-bit integer values are clipped to the range 0-65535.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 32-bit integer values are clipped to the range 0-4294967295.
+ </para>
+ </listitem>
</itemizedlist>
</listitem>
- <listitem><para>At any given bit depth, all things being equal
- integer precision is more precise than floating point precision.
- So 16-bit integer precision is more precise than 16-bit floating point
- precision, and 32-bit integer precision is more precise than 32-bit
- floating point precision. However, in GIMP you don't get more
- precision by choosing 32-bit integer over 32-bit floating point:
- GIMP still does all internal processing using 32-bit floating point
- precision even if you choose 32-bit integer precision in the
- Precision menu. Remember, the Precision menu choices only determine
- how the image information is held in RAM.</para></listitem>
- <listitem><para>At any given bit depth, integer and floating point
- precision use approximately the same amount of RAM for internal
- calculations during image processing, and also require about the
- same amount of disk space when saving an image file to disk.
- </para></listitem>
+ <listitem>
+ <para>
+ At any given bit depth, all things being equal
+ integer precision is more precise than floating point precision.
+ So 16-bit integer precision is more precise than 16-bit floating point
+ precision, and 32-bit integer precision is more precise than 32-bit
+ floating point precision. However, in GIMP you don't get more
+ precision by choosing 32-bit integer over 32-bit floating point:
+ GIMP still does all internal processing using 32-bit floating point
+ precision even if you choose 32-bit integer precision in the
+ Precision menu. Remember, the Precision menu choices only determine
+ how the image information is held in RAM.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ At any given bit depth, integer and floating point
+ precision use approximately the same amount of RAM for internal
+ calculations during image processing, and also require about the
+ same amount of disk space when saving an image file to disk.
+ </para>
+ </listitem>
</itemizedlist>
</listitem>
- <listitem><para><emphasis>Choosing between Linear light and
- Perceptual gamma (sRGB) channel encoding:</emphasis></para>
+ <listitem>
+ <para>
+ <emphasis role="bold">Choosing between Linear light and Perceptual
+ gamma (sRGB) channel encoding:</emphasis>
+ </para>
<itemizedlist>
- <listitem><para>At 8-bit precision, if you choose the Linear light
- channel encoding your image will have horribly posterized shadows.
- So don't use Linear light unless you also choose a higher bit depth.
- </para></listitem>
- <listitem> <para>Other than the fact that Linear light channel
- encoding is not being suitable for 8-bit editing, from a user
- perspective the channel encoding you choose in the Precision menu
- won't have much affect on your workflow:</para>
- <itemizedlist>
- <listitem><para>Currently if you choose "Linear light", then
- linear gamma channel values are displayed in the "pixel" values
- when using the the Color Picker Tool, Sample Points, and
- Pointer dialogs. If you choose "Perceptual gamma", then
- perceptually uniform (sRGB) channel values are displayed
- instead.</para></listitem>
- <listitem><para>Currently the channel encoding that you choose
- makes a difference in the wrong colors that you might see if you
- uncheck <link linkend="gimp-image-enable-color-management">
- Image/Color Management/Enable Color Management</link> and
- your image isn't already in one of the GIMP built-in sRGB color
- spaces (but with either channel encoding choice, the colors are
- still wrong).</para></listitem>
- <listitem><para>The only other way (that I know of) in which the
- channel encoding chosen in the Precision menu might affect your
- workflow has to do with results of using the "Gamma hack" found
- in the Advanced Color Options.</para></listitem>
- </itemizedlist>
- </listitem>
- </itemizedlist>
+ <listitem>
+ <para>
+ At 8-bit precision, if you choose the Linear light channel
+ encoding your image will have horribly posterized shadows.
+ So don't use Linear light unless you also choose a higher bit
+ depth.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ When soft proofing, currently the gamut check will not return
+ correct results if the image is at Linear light precision.
+ So change to Perceptual gamma (sRGB) before
+ activating soft proofing.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Other than the fact that Linear light channel encoding is not
+ suitable for 8-bit editing or for soft proofing, from a user
+ perspective the channel encoding you choose in the
+ Precision menu won't have much
+ affect on your workflow:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Currently if you choose "Linear light", then linear gamma
+ channel values are displayed in the "pixel" values when
+ using the the Color Picker Tool, Sample Points, and
+ Pointer dialogs. If you choose "Perceptual gamma", then
+ perceptually uniform (sRGB) channel values are displayed
+ instead.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Currently the channel encoding that you choose makes a
+ difference in the wrong colors that you might see if you
+ uncheck <link linkend="gimp-image-enable-color-management">
+ Image/Color Management/Enable Color Management</link> and
+ your image isn't already in one of the GIMP built-in sRGB
+ color spaces (but with either channel encoding choice, the
+ colors are still wrong).
+ </para>
+ </listitem>
+ <listitem>
+ <para>The only other way (that I know of) in which the
+ channel encoding chosen in the Precision menu might affect your
+ workflow has to do with results of using the "Gamma hack" found
+ in the Advanced Color Options.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
</listitem>
</orderedlist>
</sect3>
diff --git a/src/menus/image/save-color-profile-to-file.xml b/src/menus/image/save-color-profile-to-file.xml
index 82d719d..6710447 100644
--- a/src/menus/image/save-color-profile-to-file.xml
+++ b/src/menus/image/save-color-profile-to-file.xml
@@ -27,8 +27,6 @@
<sect3>
<title>Activating the command</title>
- <itemizedlist>
- <listitem>
<para>
You can access this command from the image menu bar through
<menuchoice>
@@ -37,79 +35,91 @@
<guimenuitem>Save Color Profile to File</guimenuitem>
</menuchoice>.
</para>
- </listitem>
- </itemizedlist>
-
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management.png" format="PNG"/>
</imageobject>
</mediaobject>
-
</sect3>
<sect3>
<title>Use Notes for <guimenuitem>Save Color Profile to File</guimenuitem>
</title>
- <para><guimenuitem>Save Color Profile to File</guimenuitem> is useful
- whenever you want an on-disk copy of whatever ICC profile is assigned
- your image.</para>
- <para><guimenuitem>Save Color Profile to File</guimenuitem> can even be
- used to make an on-disk copy of GIMP's built-in sRGB profile.</para>
-
+ <para>
+ <guimenuitem>Save Color Profile to File</guimenuitem> is useful
+ whenever you want an on-disk copy of whatever ICC profile is assigned
+ your image.
+ </para>
+ <para>
+ <guimenuitem>Save Color Profile to File</guimenuitem> can even be
+ used to make an on-disk copy of GIMP's built-in sRGB profile.
+ </para>
</sect3>
<sect3>
<title>An example with screenshots showing how to use
<guimenuitem>Save Color Profile to File</guimenuitem></title>
- <para>Let's say you want to save a copy of the GIMP built-in sRGB
- profile to disk.</para>
+ <para>
+ Let's say you want to save a copy of the GIMP built-in sRGB
+ profile to disk.
+ </para>
<orderedlist>
-
- <listitem>
- <para>Open an image that has a GIMP built-in sRGB profile assigned:</para>
+ <listitem>
+ <para>
+ Open an image that has a GIMP built-in sRGB profile assigned:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/save-profile-1.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
+ </listitem>
- <listitem>
- <para>Click on <quote>Image/Color Management/Save Profile to
- File</quote>:</para>
+ <listitem>
+ <para>
+ Click on <quote>Image/Color Management/Save Profile to
+ File</quote>:
+ </para>
<mediaobject>
<imageobject>
- <imagedata fileref="images/menus/image/color-management/save-profile-2.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- <para>The "Save Color Profile" dialog is divided into three panels.
- Use the left and center panel to navigate to where you want to save the
- profile.</para>
- <para>When you save a copy of the profile to disk, it's perfectly OK to
- change the suggested file name (some programs, and especially command
- line utilities, don't work as easily with file names that include spaces).
- If you change the file name, it's a good idea to use either ".icc" or
- ".icm" as the file extension (some programs won't recognize an ICC
- profile that uses some other file extension).</para>
- <para>When you've chosen a location and typed in a file name, click on
- the "Save" button in the lower right corner to save a copy of the
- profile to disk.</para>
- </listitem>
+ <imagedata fileref="images/menus/image/color-management/save-profile-2.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ <para>
+ The "Save Color Profile" dialog is divided into three panels.
+ Use the left and center panel to navigate to where you want to save the
+ profile.
+ </para>
+ <para>
+ When you save a copy of the profile to disk, it's perfectly OK to
+ change the suggested file name (some programs, and especially command
+ line utilities, don't work as easily with file names that include spaces).
+ If you change the file name, it's a good idea to use either ".icc" or
+ ".icm" as the file extension (some programs won't recognize an ICC
+ profile that uses some other file extension).
+ </para>
+ <para>
+ When you've chosen a location and typed in a file name, click on
+ the "Save" button in the lower right corner to save a copy of the
+ profile to disk.
+ </para>
+ </listitem>
- <listitem>
- <para>You can even save over the top of an existing ICC profile, in which
- case the box on the right side of the dialog will display some
- informational tags, which hopefully will help you decide whether you
- really want to write over the top of the existing ICC profile:</para>
+ <listitem>
+ <para>
+ You can even save over the top of an existing ICC profile, in which
+ case the box on the right side of the dialog will display some
+ informational tags, which hopefully will help you decide whether you
+ really want to write over the top of the existing ICC profile:
+ </para>
<mediaobject>
<imageobject>
<imagedata fileref="images/menus/image/color-management/save-profile-3.png" format="PNG"/>
</imageobject>
</mediaobject>
- </listitem>
- </orderedlist>
-
+ </listitem>
+ </orderedlist>
</sect3>
+
</sect2>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
