[gimp-help-2] Add documentation for Assign Color Profile
- From: Elle Stone <ellestone src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Add documentation for Assign Color Profile
- Date: Mon, 3 Apr 2017 20:34:20 +0000 (UTC)
commit 93e6562a57dde4c74a386fe0717f4e4f7d719b9c
Author: Elle Stone <ellestone ninedegreesbelow com>
Date: Mon Apr 3 16:34:24 2017 -0400
Add documentation for Assign Color Profile
and add entries to image.xml and color-management.xml
images/C/menus/image/color-management/assign-1.png | Bin 0 -> 16396 bytes
images/C/menus/image/color-management/assign-2.png | Bin 0 -> 28561 bytes
images/C/menus/image/color-management/assign-3.png | Bin 0 -> 29333 bytes
images/C/menus/image/color-management/assign-4.png | Bin 0 -> 147889 bytes
images/C/menus/image/color-management/assign-5.png | Bin 0 -> 325607 bytes
images/C/menus/image/color-management/assign-6.png | Bin 0 -> 40973 bytes
.../image/color-management/assign-before-after.png | Bin 0 -> 253703 bytes
src/menus/image.xml | 5 +-
src/menus/image/assign-color-profile.xml | 196 ++++++++++++++++++++
src/menus/image/color-management.xml | 17 +--
10 files changed, 198 insertions(+), 20 deletions(-)
---
diff --git a/images/C/menus/image/color-management/assign-1.png
b/images/C/menus/image/color-management/assign-1.png
new file mode 100644
index 0000000..58e9693
Binary files /dev/null and b/images/C/menus/image/color-management/assign-1.png differ
diff --git a/images/C/menus/image/color-management/assign-2.png
b/images/C/menus/image/color-management/assign-2.png
new file mode 100644
index 0000000..25a2765
Binary files /dev/null and b/images/C/menus/image/color-management/assign-2.png differ
diff --git a/images/C/menus/image/color-management/assign-3.png
b/images/C/menus/image/color-management/assign-3.png
new file mode 100644
index 0000000..d62e95a
Binary files /dev/null and b/images/C/menus/image/color-management/assign-3.png differ
diff --git a/images/C/menus/image/color-management/assign-4.png
b/images/C/menus/image/color-management/assign-4.png
new file mode 100644
index 0000000..e13be26
Binary files /dev/null and b/images/C/menus/image/color-management/assign-4.png differ
diff --git a/images/C/menus/image/color-management/assign-5.png
b/images/C/menus/image/color-management/assign-5.png
new file mode 100644
index 0000000..526d6ab
Binary files /dev/null and b/images/C/menus/image/color-management/assign-5.png differ
diff --git a/images/C/menus/image/color-management/assign-6.png
b/images/C/menus/image/color-management/assign-6.png
new file mode 100644
index 0000000..4ef65f1
Binary files /dev/null and b/images/C/menus/image/color-management/assign-6.png differ
diff --git a/images/C/menus/image/color-management/assign-before-after.png
b/images/C/menus/image/color-management/assign-before-after.png
new file mode 100644
index 0000000..d9b6a02
Binary files /dev/null and b/images/C/menus/image/color-management/assign-before-after.png differ
diff --git a/src/menus/image.xml b/src/menus/image.xml
index 60cbb5a..b62505f 100644
--- a/src/menus/image.xml
+++ b/src/menus/image.xml
@@ -22,11 +22,8 @@
<xi:include href="image/convert-indexed.xml"/>
<xi:include href="image/precision.xml"/>
<xi:include href="image/color-management.xml"/>
- <xi:include href="image/enable-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"/>
diff --git a/src/menus/image/assign-color-profile.xml b/src/menus/image/assign-color-profile.xml
new file mode 100644
index 0000000..c63227c
--- /dev/null
+++ b/src/menus/image/assign-color-profile.xml
@@ -0,0 +1,196 @@
+<?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-assign-color-profile">
+ <title>Assign Color Profile</title>
+
+ <indexterm>
+ <primary>Image</primary>
+ <secondary>Color Management</secondary>
+ <tertiary>Assign Color Profile</tertiary>
+ </indexterm>
+ <indexterm>
+ <primary>Color Management</primary>
+ <secondary>Assign Color Profile</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Assign Color Profile</primary>
+ </indexterm>
+
+ <para>The <guimenuitem>Assign Color Profile</guimenuitem> allows you to
+ assign an ICC profile to an 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>Assign Color Profile</guimenuitem>
+ </menuchoice>.
+ </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>
+ <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 the GIMP 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>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
+ "Image/Color Management/Assign Color Profile" 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>
+
+ <para>Under <guilabel>Current Color Profile</guilabel> is a description
+ of the currently assigned color profile, in this case the GIMP 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 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>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/menus/image/color-management/assign-2.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </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>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/menus/image/color-management/assign-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/assign-4.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </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>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/menus/image/color-management/assign-5.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </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>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/menus/image/color-management/assign-6.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+
+ <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>
+ </orderedlist>
+ </sect3>
+
+</sect2>
diff --git a/src/menus/image/color-management.xml b/src/menus/image/color-management.xml
index be62353..9c11d0a 100644
--- a/src/menus/image/color-management.xml
+++ b/src/menus/image/color-management.xml
@@ -58,26 +58,11 @@
<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>
+ <link linkend="gimp-image-assign-color-profile">Assign 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>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]