GNOME.org
 

[gimp-help-2] Add Discard Color Profile and Save Color Profile to File

commit 2e0d800d54143d8b8f8849c228eab27fbb01754b
Author: Elle Stone <ellestone ninedegreesbelow com>
Date:   Wed Apr 5 17:17:17 2017 -0400

    Add Discard Color Profile and Save Color Profile to File
    
    and tidy up some of the other Color Management menu options.

 .../image/color-management/save-profile-1.png      |  Bin 0 -> 103481 bytes
 .../image/color-management/save-profile-2.png      |  Bin 0 -> 114390 bytes
 .../image/color-management/save-profile-3.png      |  Bin 0 -> 158400 bytes
 src/menus/image.xml                                |    2 +
 src/menus/image/assign-color-profile.xml           |    2 +-
 src/menus/image/color-management.xml               |   19 +++-
 src/menus/image/convert-to-color-profile.xml       |   14 ++-
 src/menus/image/discard-color-profile.xml          |   82 ++++++++++++++
 src/menus/image/enable-color-management.xml        |   35 +++---
 src/menus/image/save-color-profile-to-file.xml     |  115 ++++++++++++++++++++
 10 files changed, 240 insertions(+), 29 deletions(-)
---
diff --git a/images/C/menus/image/color-management/save-profile-1.png 
b/images/C/menus/image/color-management/save-profile-1.png
new file mode 100644
index 0000000..fa620d7
Binary files /dev/null and b/images/C/menus/image/color-management/save-profile-1.png differ
diff --git a/images/C/menus/image/color-management/save-profile-2.png 
b/images/C/menus/image/color-management/save-profile-2.png
new file mode 100644
index 0000000..64146b1
Binary files /dev/null and b/images/C/menus/image/color-management/save-profile-2.png differ
diff --git a/images/C/menus/image/color-management/save-profile-3.png 
b/images/C/menus/image/color-management/save-profile-3.png
new file mode 100644
index 0000000..f03ac34
Binary files /dev/null and b/images/C/menus/image/color-management/save-profile-3.png differ
diff --git a/src/menus/image.xml b/src/menus/image.xml
index 8091d1b..b79d46f 100644
--- a/src/menus/image.xml
+++ b/src/menus/image.xml
@@ -25,6 +25,8 @@
   <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"/>
diff --git a/src/menus/image/assign-color-profile.xml b/src/menus/image/assign-color-profile.xml
index db73be6..12e20ef 100644
--- a/src/menus/image/assign-color-profile.xml
+++ b/src/menus/image/assign-color-profile.xml
@@ -81,7 +81,7 @@
 
     <listitem>
     <para>Accessing
-    "Image/Color Management/Assign Color Profile" brings up the
+    <quote>Image/Color Management/Assign Color Profile</quote> brings up the
     <guimenuitem>Assign ICC Color Profile</guimenuitem> dialog shown
     below:</para>
 
diff --git a/src/menus/image/color-management.xml b/src/menus/image/color-management.xml
index 7222969..8bde459 100644
--- a/src/menus/image/color-management.xml
+++ b/src/menus/image/color-management.xml
@@ -3,9 +3,7 @@
                        "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).
+  2017-05-05 elle stone: remaining submenus added to this page
 -->
 <sect2 id="gimp-image-color-management">
   <title>Color Management</title>
@@ -44,8 +42,7 @@
     <itemizedlist>
       <listitem>
         <para>
-          You can access the <guimenuitem>Color Management</guimenuitem>
-          submenu from the image menubar through
+          You can access this command from the image menu bar through
           <menuchoice>
             <guimenu>Image</guimenu>
             <guimenuitem>Color Management</guimenuitem>
@@ -76,6 +73,18 @@
            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/convert-to-color-profile.xml b/src/menus/image/convert-to-color-profile.xml
index 6e72df8..8b5edc7 100644
--- a/src/menus/image/convert-to-color-profile.xml
+++ b/src/menus/image/convert-to-color-profile.xml
@@ -72,8 +72,8 @@
 
     <listitem>
     <para>Select
-    "Image/Color Management/Convert to Color Profile" to bring up the
-    <guimenuitem>Convert to ICC Color Profile</guimenuitem> dialog:</para>
+    <quote>Image/Color Management/Convert to Color Profile</quote> to bring up
+    the <guimenuitem>Convert to ICC Color Profile</guimenuitem> dialog:</para>
 
         <mediaobject>
           <imageobject>
@@ -181,14 +181,16 @@
             <imagedata fileref="images/menus/image/color-management/convert-7.png" format="PNG"/>
           </imageobject>
         </mediaobject>
-    <para>Selecting the desired conversion options requires two decisions:</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>Relative Colorimetric
+            </guilabel></para></listitem>
             <listitem><para><guilabel>Saturation</guilabel></para></listitem>
             <listitem><para><guilabel>Absolute</guilabel></para></listitem>
           </itemizedlist>
@@ -205,7 +207,9 @@
           </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>-->
+    <!--<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
diff --git a/src/menus/image/discard-color-profile.xml b/src/menus/image/discard-color-profile.xml
new file mode 100644
index 0000000..fc96aa0
--- /dev/null
+++ b/src/menus/image/discard-color-profile.xml
@@ -0,0 +1,82 @@
+<?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:
+-->
+<sect2 id="gimp-image-discard-color-profile">
+  <title>Discard Color Profile</title>
+
+  <indexterm>
+    <primary>Image</primary>
+    <secondary>Color Management</secondary>
+    <tertiary>Discard Color Profile</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Color Management</primary>
+    <secondary>Discard Color Profile</secondary>
+  </indexterm>
+  <indexterm>
+    <primary>Discard Color Profile</primary>
+  </indexterm>
+  <para>
+    <guimenuitem>Discard Color Profile</guimenuitem> discards the image's
+    currently assigned ICC profile, and instead assigns GIMP's
+    built-in sRGB profile.
+  </para>
+
+    <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>
+
+  <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>Discard Color Profile</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>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>
+
+  <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><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>
+
+</sect2>
diff --git a/src/menus/image/enable-color-management.xml b/src/menus/image/enable-color-management.xml
index 2132f2f..4e8125f 100644
--- a/src/menus/image/enable-color-management.xml
+++ b/src/menus/image/enable-color-management.xml
@@ -115,42 +115,41 @@
   </sect3>
 
   <sect3>
-    <title>Four screenshots showing examples of correct and incorrect image
+    <title>Two 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
+    <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 last three screenshots, after unchecking Enable Color
+    <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:</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
+    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>
-    <para>In screenshot 2 below, the channel encoding matches, but the
-    chromaticities do not match:</para>
+    color managed:</para>
     <mediaobject>
       <imageobject>
-        <imagedata 
fileref="images/menus/image/color-management/enable-cm-linear-precision-mismatched-chromaticities.png" 
format="PNG"/>
+        <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 above, the channel encoding of the original profile
+
+    <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.</para>
+    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>
+<!--
     <para>In screenshot 3 below, the chromaticities match, but the channel
     encoding does not match:</para>
     <mediaobject>
@@ -175,7 +174,7 @@
     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>
+    wrong (it's too dark) and the colors are wrong.</para>-->
   </sect3>
 
   <sect3>
diff --git a/src/menus/image/save-color-profile-to-file.xml b/src/menus/image/save-color-profile-to-file.xml
new file mode 100644
index 0000000..82d719d
--- /dev/null
+++ b/src/menus/image/save-color-profile-to-file.xml
@@ -0,0 +1,115 @@
+<?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:
+-->
+<sect2 id="gimp-image-save-color-profile-to-file">
+  <title>Save Color Profile to File</title>
+
+  <indexterm>
+    <primary>Image</primary>
+    <secondary>Color Management</secondary>
+    <tertiary>Save Color Profile to File</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Color Management</primary>
+    <secondary>Save Color Profile to File</secondary>
+  </indexterm>
+  <indexterm>
+    <primary>Save Color Profile to File</primary>
+  </indexterm>
+
+  <para>
+    <guimenuitem>Save Color Profile to File</guimenuitem> allows you to save
+    to disk a copy of the ICC profile that's assigned to your image.
+  </para>
+
+  <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>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>
+
+  </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>
+
+    <orderedlist>
+
+    <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>
+    <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>
+
+    <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>
+
+  </sect3>
+</sect2>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]