GNOME.org
 

[gimp-help-2] Add Color Management to the Image menu

commit 8f8821749d050e88241955e5d65f01382f7d9f97
Author: Elle Stone <ellestone ninedegreesbelow com>
Date:   Sun Apr 2 12:45:12 2017 -0400

    Add Color Management to the Image menu
    
    and also add the Color Management Enabled submenu. The other
    submenus will be added in the near future.

 images/C/menus/image/color-management.png          |  Bin 0 -> 6432 bytes
 ...erceptual-srgb-color-space-enabled-disabled.png |  Bin 0 -> 257367 bytes
 ...inear-precision-mismatched-channel-encoding.png |  Bin 0 -> 263524 bytes
 ...-linear-precision-mismatched-chromaticities.png |  Bin 0 -> 251315 bytes
 ...matched-chromaticities-and-channel-encoding.png |  Bin 0 -> 211022 bytes
 src/menus/image.xml                                |   11 +-
 src/menus/image/color-management.xml               |   83 ++++++++
 src/menus/image/enable-color-management.xml        |  216 ++++++++++++++++++++
 8 files changed, 309 insertions(+), 1 deletions(-)
---
diff --git a/images/C/menus/image/color-management.png b/images/C/menus/image/color-management.png
new file mode 100644
index 0000000..c440b31
Binary files /dev/null and b/images/C/menus/image/color-management.png differ
diff --git 
a/images/C/menus/image/color-management/enable-cm-gimp-built-in-perceptual-srgb-color-space-enabled-disabled.png
 
b/images/C/menus/image/color-management/enable-cm-gimp-built-in-perceptual-srgb-color-space-enabled-disabled.png
new file mode 100644
index 0000000..85d0ebb
Binary files /dev/null and 
b/images/C/menus/image/color-management/enable-cm-gimp-built-in-perceptual-srgb-color-space-enabled-disabled.png
 differ
diff --git a/images/C/menus/image/color-management/enable-cm-linear-precision-mismatched-channel-encoding.png 
b/images/C/menus/image/color-management/enable-cm-linear-precision-mismatched-channel-encoding.png
new file mode 100644
index 0000000..08518b6
Binary files /dev/null and 
b/images/C/menus/image/color-management/enable-cm-linear-precision-mismatched-channel-encoding.png differ
diff --git a/images/C/menus/image/color-management/enable-cm-linear-precision-mismatched-chromaticities.png 
b/images/C/menus/image/color-management/enable-cm-linear-precision-mismatched-chromaticities.png
new file mode 100644
index 0000000..96242a5
Binary files /dev/null and 
b/images/C/menus/image/color-management/enable-cm-linear-precision-mismatched-chromaticities.png differ
diff --git 
a/images/C/menus/image/color-management/enable-cm-mismatched-chromaticities-and-channel-encoding.png 
b/images/C/menus/image/color-management/enable-cm-mismatched-chromaticities-and-channel-encoding.png
new file mode 100644
index 0000000..c276941
Binary files /dev/null and 
b/images/C/menus/image/color-management/enable-cm-mismatched-chromaticities-and-channel-encoding.png differ
diff --git a/src/menus/image.xml b/src/menus/image.xml
index 304e4da..213fd6f 100644
--- a/src/menus/image.xml
+++ b/src/menus/image.xml
@@ -2,6 +2,8 @@
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!--section history:
+  2017-04-02 elle stone: update separators, add files and placeholder
+                         files for the color management menu
   2009-01-24 ude: moved files to new subdir "menus/image/"
   2009-01-19 j.h: added fit-canvas-to-selection.xml
   2007-03-25 re-ordered xi:includes
@@ -13,15 +15,22 @@
   <xi:include href="image/introduction.xml"/>
   <!-- the menu -->
   <xi:include href="image/duplicate.xml"/>
+  <!-- separator -->
   <xi:include href="image/mode.xml"/>
   <xi:include href="image/convert-rgb.xml"/>
   <xi:include href="image/convert-grayscale.xml"/>
   <xi:include href="image/convert-indexed.xml"/>
+  <xi:include href="image/color-management.xml"/>
+  <xi:include href="image/enable-color-management.xml"/><!--
+  <xi:include href="image/assign-color-profile.xml"/>
+  <xi:include href="image/convert-to-color-profile.xml"/>
+  <xi:include href="image/discard-color-profile.xml"/>
+  <xi:include href="image/save-color-profile-to-file.xml"/>-->
+  <!-- separator -->
   <xi:include href="image/transform.xml"/>
   <xi:include href="image/transform-flip.xml"/>
   <xi:include href="image/transform-rotate.xml"/>
   <xi:include href="image/transform-guillotine.xml"/>
-  <!-- separator -->
   <xi:include href="image/canvas-size.xml"/>
   <xi:include href="image/fit-canvas-to-layers.xml"/>
   <xi:include href="image/fit-canvas-to-selection.xml"/>
diff --git a/src/menus/image/color-management.xml b/src/menus/image/color-management.xml
new file mode 100644
index 0000000..be62353
--- /dev/null
+++ b/src/menus/image/color-management.xml
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!-- section history:
+  2017-04-01 elle stone: color management moved out of Mode.
+                         color management submenus added to this page,
+                         but most of the submenus are commented out as the
+                         required xml files are not yet ready (pending).
+-->
+<sect2 id="gimp-image-color-management">
+  <title>Color Management</title>
+
+  <indexterm>
+    <primary>Color Management</primary>
+    <secondary>Submenu</secondary>
+  </indexterm>
+  <indexterm>
+    <primary>Image</primary>
+    <secondary>Color Management</secondary>
+    <tertiary>Menu</tertiary>
+  </indexterm>
+
+  <figure>
+    <title>
+      The <quote>Color Management</quote> submenu of the <quote>Image</quote> menu
+    </title>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/menus/image/color-management.png" format="PNG"/>
+      </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.
+  </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>Color Management</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3>
+    <title>The Contents of the <quote>Color Management</quote> Submenu</title>
+    <itemizedlist>
+      <listitem>
+        <para>
+          <link linkend="gimp-image-enable-color-management">Enable Color Management</link>
+        </para>
+      </listitem>
+<!--      <listitem>
+        <para>
+          <link linkend="gimp-image-assign-color-profile">Assign Color Profile</link>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <link linkend="gimp-image-convert-to-color-profile">Convert to Color Profile</link>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <link linkend="gimp-image-discard-color-profile">Discard Color Profile</link>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <link linkend="gimp-image-save-color-profile-to-file">Save Color Profile to File</link>
+        </para>
+      </listitem>-->
+    </itemizedlist>
+  </sect3>
+</sect2>
diff --git a/src/menus/image/enable-color-management.xml b/src/menus/image/enable-color-management.xml
new file mode 100644
index 0000000..2132f2f
--- /dev/null
+++ b/src/menus/image/enable-color-management.xml
@@ -0,0 +1,216 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!-- section history:
+  2017-04-01 elle stone: add enable-color-management.xml
+-->
+<sect2 id="gimp-image-enable-color-management">
+  <title>Enable Color Management</title>
+
+  <indexterm>
+    <primary>Image</primary>
+    <secondary>Color Management</secondary>
+    <tertiary>Enable Color Management</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Color Management</primary>
+    <secondary>Enable Color Management</secondary>
+  </indexterm>
+  <indexterm>
+    <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>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>
+
+  <sect3>
+    <title>Activating the command</title>
+    <itemizedlist>
+      <listitem>
+        <para>
+          You can access this command from the image menu bar through
+          <menuchoice>
+            <guimenu>Image</guimenu>
+            <guisubmenu>Color Management</guisubmenu>
+            <guimenuitem>Enable Color Management</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3>
+      <title>What does GIMP do when Enable Color Management is unchecked?
+      </title>
+      <para>When you uncheck the option to Enable Color Management, 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>
+        <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>
+      </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>
+    <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>
+        <itemizedlist>
+          <listitem><para>What GIMP Precision channel encoding &mdash;
+          Linear light or Perceptual gamma (sRGB) &mdash; the image was in
+          before the Enable Color Management 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>
+        </itemizedlist>
+      </listitem>
+    </orderedlist>
+  </sect3>
+
+  <sect3>
+    <title>Four screenshots showing examples of correct and incorrect image
+    appearances after unchecking Enable Color Management</title>
+    <para>In all four 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 last three screenshots, 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:</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 1 above, the image is already in one of GIMP's
+    built-in sRGB color spaces, 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>
+    <para>In screenshot 2 below, the channel encoding matches, but the
+    chromaticities do not match:</para>
+    <mediaobject>
+      <imageobject>
+        <imagedata 
fileref="images/menus/image/color-management/enable-cm-linear-precision-mismatched-chromaticities.png" 
format="PNG"/>
+      </imageobject>
+    </mediaobject>
+    <para>In screenshot 2 above, 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.</para>
+    <para>In screenshot 3 below, the chromaticities match, but the channel
+    encoding does not match:</para>
+    <mediaobject>
+      <imageobject>
+        <imagedata 
fileref="images/menus/image/color-management/enable-cm-linear-precision-mismatched-channel-encoding.png" 
format="PNG"/>
+      </imageobject>
+    </mediaobject>
+    <para>In screenshot 3 above, the sRGB-elle-V4-srgbtrc.icc chromaticities
+    match the chromaticities of the GIMP built-in linear sRGB profile, but the
+    sRGB-elle-V4-srgbtrc.icc profile channel encoding doesn't match the current
+    GIMP linear channel encoding. So after unchecking Enable Color
+    Management, the colors are correct but the tonality is wrong.</para>
+    <para>In screenshot 4 below, both the channel encoding and chromaticities
+    are mismatched:</para>
+    <mediaobject>
+      <imageobject>
+        <imagedata 
fileref="images/menus/image/color-management/enable-cm-mismatched-chromaticities-and-channel-encoding.png" 
format="PNG"/>
+      </imageobject>
+    </mediaobject>
+    <para>In Screenshot 4 above, the channel encoding of the original
+    LargeRGB-elle-V4-g10.icc profile is linear, but GIMP is using the
+    Perceptual gamma (sRGB) encoding. Also the LargeRGB-elle-V4-g10.icc
+    chromaticities don't match the GIMP built-in sRGB chromaticities.
+    So after unchecking Enable Color Management, the tonality is
+    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>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]