[gimp-help-2] Add Convert to Color Profile to Color Management menu



commit 5dc56155eeb08b11213d8d3507729e79f67bd226
Author: Elle Stone <ellestone ninedegreesbelow com>
Date:   Tue Apr 4 13:04:40 2017 -0400

    Add Convert to Color Profile to Color Management menu
    
    and make some minor changes to image/assign-color-profile.xml and
    image/color-management.xml.

 .../C/menus/image/color-management/convert-1.png   |  Bin 0 -> 20291 bytes
 .../C/menus/image/color-management/convert-2.png   |  Bin 0 -> 31534 bytes
 .../C/menus/image/color-management/convert-3.png   |  Bin 0 -> 25945 bytes
 .../C/menus/image/color-management/convert-4.png   |  Bin 0 -> 71521 bytes
 .../C/menus/image/color-management/convert-5.png   |  Bin 0 -> 78985 bytes
 .../C/menus/image/color-management/convert-6.png   |  Bin 0 -> 33045 bytes
 .../C/menus/image/color-management/convert-7.png   |  Bin 0 -> 34771 bytes
 .../color-management/convert-before-after.png      |  Bin 0 -> 212542 bytes
 src/menus/image.xml                                |    1 +
 src/menus/image/assign-color-profile.xml           |   42 ++--
 src/menus/image/color-management.xml               |   27 ++-
 src/menus/image/convert-to-color-profile.xml       |  225 ++++++++++++++++++++
 12 files changed, 268 insertions(+), 27 deletions(-)
---
diff --git a/images/C/menus/image/color-management/convert-1.png 
b/images/C/menus/image/color-management/convert-1.png
new file mode 100644
index 0000000..f5bf5f6
Binary files /dev/null and b/images/C/menus/image/color-management/convert-1.png differ
diff --git a/images/C/menus/image/color-management/convert-2.png 
b/images/C/menus/image/color-management/convert-2.png
new file mode 100644
index 0000000..1932c0f
Binary files /dev/null and b/images/C/menus/image/color-management/convert-2.png differ
diff --git a/images/C/menus/image/color-management/convert-3.png 
b/images/C/menus/image/color-management/convert-3.png
new file mode 100644
index 0000000..2169b38
Binary files /dev/null and b/images/C/menus/image/color-management/convert-3.png differ
diff --git a/images/C/menus/image/color-management/convert-4.png 
b/images/C/menus/image/color-management/convert-4.png
new file mode 100644
index 0000000..e3952b9
Binary files /dev/null and b/images/C/menus/image/color-management/convert-4.png differ
diff --git a/images/C/menus/image/color-management/convert-5.png 
b/images/C/menus/image/color-management/convert-5.png
new file mode 100644
index 0000000..ff6d28a
Binary files /dev/null and b/images/C/menus/image/color-management/convert-5.png differ
diff --git a/images/C/menus/image/color-management/convert-6.png 
b/images/C/menus/image/color-management/convert-6.png
new file mode 100644
index 0000000..d8709c8
Binary files /dev/null and b/images/C/menus/image/color-management/convert-6.png differ
diff --git a/images/C/menus/image/color-management/convert-7.png 
b/images/C/menus/image/color-management/convert-7.png
new file mode 100644
index 0000000..115797a
Binary files /dev/null and b/images/C/menus/image/color-management/convert-7.png differ
diff --git a/images/C/menus/image/color-management/convert-before-after.png 
b/images/C/menus/image/color-management/convert-before-after.png
new file mode 100644
index 0000000..233fbb6
Binary files /dev/null and b/images/C/menus/image/color-management/convert-before-after.png differ
diff --git a/src/menus/image.xml b/src/menus/image.xml
index b62505f..8091d1b 100644
--- a/src/menus/image.xml
+++ b/src/menus/image.xml
@@ -24,6 +24,7 @@
   <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"/>
   <!-- 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 c63227c..db73be6 100644
--- a/src/menus/image/assign-color-profile.xml
+++ b/src/menus/image/assign-color-profile.xml
@@ -2,7 +2,7 @@
 <!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:
+  2017-04-03 elle stone: add assign-color-profile.xml
 -->
 <sect2 id="gimp-image-assign-color-profile">
   <title>Assign Color Profile</title>
@@ -21,7 +21,7 @@
   </indexterm>
 
   <para>The <guimenuitem>Assign Color Profile</guimenuitem> allows you to
-  assign an ICC profile to an image.</para>
+  assign a new ICC profile to an image.</para>
 
   <sect3>
     <title>Activating the command</title>
@@ -58,7 +58,7 @@
       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 the GIMP built-in
+      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>
@@ -91,8 +91,11 @@
           </imageobject>
         </mediaobject>
 
+    </listitem>
+
+    <listitem>
     <para>Under <guilabel>Current Color Profile</guilabel> is a description
-    of the currently assigned color profile, in this case the GIMP built-in
+    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>
@@ -100,16 +103,10 @@
     <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 the
-    currently assigned profile.</para>
-    <para>Between <guilabel>Assign</guilabel> and
-    <guilabel>Profile details</guilabel> is a drop-down box that allows
-    you to pick a new profile.</para>
-    </listitem>
-
-    <listitem>
-      <para>The next screenshot shows example profile descriptions as
-      revealed by clicking on the "+" icons:</para>
+    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"/>
@@ -118,12 +115,11 @@
     </listitem>
 
     <listitem>
-      <para>Clicking in the drop-down box between <guilabel>Assign</guilabel> and
-    <guilabel>Profile details</guilabel> allows
-    you to pick a new profile box brings up a
-      list of profiles that you've accessed recently, and at the bottom of
-      the list is an option to
-      <guilabel>Select color profile from disk...</guilabel>:</para>
+    <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"/>
@@ -150,6 +146,12 @@
             <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>
 
     <listitem><para>As shown in the screenshot below, the left and center
diff --git a/src/menus/image/color-management.xml b/src/menus/image/color-management.xml
index 9c11d0a..7222969 100644
--- a/src/menus/image/color-management.xml
+++ b/src/menus/image/color-management.xml
@@ -22,7 +22,8 @@
 
   <figure>
     <title>
-      The <quote>Color Management</quote> submenu of the <quote>Image</quote> menu
+      The <quote>Color Management</quote> submenu of the <quote>Image</quote>
+      menu
     </title>
     <mediaobject>
       <imageobject>
@@ -31,16 +32,20 @@
     </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.
+    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 Submenu</title>
+    <title>Activating the <guimenuitem>Color Management</guimenuitem>
+    Submenu</title>
     <itemizedlist>
       <listitem>
         <para>
-          You can access this submenu from the image menubar through
+          You can access the <guimenuitem>Color Management</guimenuitem>
+          submenu from the image menubar through
           <menuchoice>
             <guimenu>Image</guimenu>
             <guimenuitem>Color Management</guimenuitem>
@@ -55,12 +60,20 @@
     <itemizedlist>
       <listitem>
         <para>
-          <link linkend="gimp-image-enable-color-management">Enable Color Management</link>
+          <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>
+          <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>
     </itemizedlist>
diff --git a/src/menus/image/convert-to-color-profile.xml b/src/menus/image/convert-to-color-profile.xml
new file mode 100644
index 0000000..6e72df8
--- /dev/null
+++ b/src/menus/image/convert-to-color-profile.xml
@@ -0,0 +1,225 @@
+<?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-04 elle stone: add convert-to-color-profile.xml
+-->
+<sect2 id="gimp-image-convert-to-color-profile">
+  <title>Convert to Color Profile</title>
+
+  <indexterm>
+    <primary>Image</primary>
+    <secondary>Color Management</secondary>
+    <tertiary>Convert to Color Profile</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Color Management</primary>
+    <secondary>Convert to Color Profile</secondary>
+  </indexterm>
+  <indexterm>
+    <primary>Convert to Color Profile</primary>
+  </indexterm>
+
+  <para>
+    The <guimenuitem>Convert to Color Profile</guimenuitem> allows you to
+    convert an image from its currently assigned ICC profile to another
+    ICC profile.
+  </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>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>
+    <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>
+    </orderedlist>
+  </sect3>
+
+  <sect3>
+    <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>
+
+    <orderedlist>
+
+    <listitem>
+    <para>Select
+    "Image/Color Management/Convert to Color Profile" 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>
+        <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>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/menus/image/color-management/convert-3.png" format="PNG"/>
+          </imageobject>
+        </mediaobject>
+    </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>
+        <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>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/menus/image/color-management/convert-5.png" format="PNG"/>
+          </imageobject>
+        </mediaobject>
+    </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>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/menus/image/color-management/convert-6.png" format="PNG"/>
+          </imageobject>
+        </mediaobject>
+    </listitem>
+
+
+    <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>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/menus/image/color-management/convert-before-after.png" format="PNG"/>
+          </imageobject>
+        </mediaobject>
+    </listitem>
+    </orderedlist>
+
+  </sect3>
+
+</sect2>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]