GNOME.org
 

[gnome-color-manager] Explain how to use the ICC profiles on other systems

commit d5b519b90a03a3782d78a42dcfee7a786826699a
Author: Richard Hughes <richard hughsie com>
Date:   Mon Apr 16 15:22:42 2012 +0100

    Explain how to use the ICC profiles on other systems

 Makefile.am                         |    1 +
 configure.ac                        |    2 +
 contrib/gnome-color-manager.spec.in |    2 +-
 help/C/color-import-linux.page      |   31 +++++++++++
 help/C/color-import-osx.page        |   29 +++++++++++
 help/C/color-import-windows.page    |   94 +++++++++++++++++++++++++++++++++++
 help/C/gnome-help.its               |   14 +++++
 help/C/legal.xml                    |    5 ++
 help/Makefile.am                    |   15 ++++++
 9 files changed, 192 insertions(+), 1 deletions(-)
---
diff --git a/Makefile.am b/Makefile.am
index 9e11132..cb774eb 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,6 +1,7 @@
 SUBDIRS =						\
 	src						\
 	data						\
+	help						\
 	man						\
 	po						\
 	tools
diff --git a/configure.ac b/configure.ac
index 38035f8..ab4ca76 100644
--- a/configure.ac
+++ b/configure.ac
@@ -17,6 +17,7 @@ AC_PROG_RANLIB
 LT_INIT
 AM_PROG_CC_C_O
 IT_PROG_INTLTOOL([0.35.0])
+YELP_HELP_INIT
 
 GNOME_COMPILE_WARNINGS(error)
 GNOME_DOC_INIT
@@ -231,6 +232,7 @@ data/tests/Makefile
 data/targets/Makefile
 data/figures/Makefile
 data/ti1/Makefile
+help/Makefile
 man/Makefile
 po/Makefile.in
 src/Makefile
diff --git a/contrib/gnome-color-manager.spec.in b/contrib/gnome-color-manager.spec.in
index 1e3395a..c599ecd 100644
--- a/contrib/gnome-color-manager.spec.in
+++ b/contrib/gnome-color-manager.spec.in
@@ -14,7 +14,7 @@ Requires:  gnome-icon-theme
 Requires:  shared-mime-info
 Requires:  shared-color-profiles
 Requires:  dconf
-Requires:  GConf2 >= 2.31.1
+Requires:  yelp
 
 BuildRequires: gtk3-devel >= 3.0.0
 BuildRequires: scrollkeeper
diff --git a/help/C/color-import-linux.page b/help/C/color-import-linux.page
new file mode 100644
index 0000000..8af5416
--- /dev/null
+++ b/help/C/color-import-linux.page
@@ -0,0 +1,31 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="color-import-linux">
+
+  <info>
+    <link type="guide" xref="color#problems"/>
+    <link type="seealso" xref="color-whatisprofile"/>
+    <link type="seealso" xref="color-gettingprofiles"/>
+    <desc>How to import an existing ICC profile using a Linux system.</desc>
+    <credit type="author">
+      <name>Richard Hughes</name>
+      <email>richard hughsie com</email>
+    </credit>
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Installing an ICC profile on Linux</title>
+  <p>
+    If you have <cmd>gnome-color-manager</cmd> or <cmd>colord-kde</cmd>
+    installed then just double click the <file>.icc</file> profile
+    and click <gui>Import</gui>.
+    You can then assign the new profile to an existing device using the
+    <guiseq><gui>System Settings</gui><gui>Color</gui></guiseq> panel.
+  </p>
+  <p>
+    Profile calibration curves are automatically loaded at login, or can
+    be loaded for all users at at startup if the <gui>Set for all
+    users</gui> button is clicked.
+  </p>
+
+</page>
diff --git a/help/C/color-import-osx.page b/help/C/color-import-osx.page
new file mode 100644
index 0000000..3efc51d
--- /dev/null
+++ b/help/C/color-import-osx.page
@@ -0,0 +1,29 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="color-import-osx">
+
+  <info>
+    <link type="guide" xref="color#problems"/>
+    <link type="seealso" xref="color-whatisprofile"/>
+    <link type="seealso" xref="color-gettingprofiles"/>
+    <desc>How to import an existing ICC profile using an OS X system.</desc>
+    <credit type="author">
+      <name>Richard Hughes</name>
+      <email>richard hughsie com</email>
+    </credit>
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Installing an ICC profile on Apple OS X</title>
+  <p>
+    Apple OS X supports a similar scheme to Linux, in that profiles can
+    be installed system-wide or specific to the user.
+    System wide profiles are stored in <file>/Library/ColorSync/Profiles</file>
+    and user-specific profiles are stored in <file>~/Library/ColorSync/Profiles</file>.
+  </p>
+  <p>
+    Use the <guiseq><gui>System Preferences</gui><gui>Displays</gui><gui>Color</gui></guiseq>
+    tool to import the file and assign the profile to the correct device.
+  </p>
+
+</page>
diff --git a/help/C/color-import-windows.page b/help/C/color-import-windows.page
new file mode 100644
index 0000000..c369176
--- /dev/null
+++ b/help/C/color-import-windows.page
@@ -0,0 +1,94 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="color-import-windows">
+
+  <info>
+    <link type="guide" xref="color#problems"/>
+    <link type="seealso" xref="color-whatisprofile"/>
+    <link type="seealso" xref="color-gettingprofiles"/>
+    <desc>How to import an existing ICC profile using a Windows system.</desc>
+    <credit type="author">
+      <name>Richard Hughes</name>
+      <email>richard hughsie com</email>
+    </credit>
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Installing an ICC profile on Microsoft Windows</title>
+  <p>
+    The method for assigning the profile to a device and also using the
+    embedded calibration curves is different for each version of
+    Microsoft Windows.
+  </p>
+  <section id="xp">
+    <title>Windows XP</title>
+    <p>
+    Right click on the profile in Windows Explorer and click <gui>Install profile</gui>.
+    This copies the profile to the correct directory automatically.
+    </p>
+    <p>
+      Then open <guiseq><gui>Control Center</gui><gui>Color</gui></guiseq>
+      and add the profile to the device.
+    </p>
+    <note style="warning">
+      <p>
+        If you are replacing an existing profile in Windows XP, the
+        above shortcut does not work.
+        The profiles must be manually copied to
+        <file>C:\Windows\system32\spool\drivers\color</file> for the
+        original profile to be replaced.
+      </p>
+    </note>
+    <p>
+      Windows XP requires a program to be run at startup to copy the
+      profile calibration curves into the video card.
+      This can be done using <app>Adobe Gamma</app>, <app>LUT Loader</app>
+      or by using the free <app href="https://www.microsoft.com/download/en/details.aspx?displaylang=en&amp;id=12714";>
+      Microsoft Color Control Panel Applet</app>.
+      Using the latter adds a new <gui>Color</gui> item to the control
+      panel and allows the calibration curves from default profile to be
+      easily set at each startup.
+    </p>
+  </section>
+
+  <section id="vista">
+    <title>Windows Vista</title>
+    <p>
+      Microsoft Windows Vista mistakenly removes calibration curves from
+      the video LUT after logon, after suspend, and when the UAC screen
+      appears.
+      This means you may have to manually reload the ICC profile
+      calibration curves.
+      If you are using profiles with embedded calibration curves you have
+      to be very careful the calibration state has not been cleared.
+    </p>
+  </section>
+
+  <section id="7">
+    <title>Windows 7</title>
+    <p>
+      Windows 7 supports a similar scheme to Linux, in that profiles can
+      be installed system-wide or specific to the user.
+      They are however stored in the same place.
+      Right click on the profile in Windows Explorer and click <gui>Install profile</gui>
+      or copy the .icc profile to <file>C:\Windows\system32\spool\drivers\color</file>.
+    </p>
+    <p>
+      Open <guiseq><gui>Control Center</gui><gui>Color Management</gui></guiseq>
+      and then add the profile to the system by clicking the
+      <gui>Add</gui> button.
+      Click on the <gui>Advanced</gui> tab and look for <gui>Display Calibration</gui>.
+      Calibration curve loading is enabled by the <gui>Use Windows display
+      calibration</gui> checkbox but it is not sensitive.
+      This can be enabled by clicking on <gui>Change system defaults</gui>
+      and then returning to the <gui>Advanced</gui> tab and then clicking
+      the checkbox.
+    </p>
+    <p>
+      Close the dialog and click <gui>Reload current calibrations</gui> to
+      set the gamma ramps.
+      The profile calibration curves should now be set for every boot.
+    </p>
+  </section>
+
+</page>
diff --git a/help/C/gnome-help.its b/help/C/gnome-help.its
new file mode 100644
index 0000000..75dfa6f
--- /dev/null
+++ b/help/C/gnome-help.its
@@ -0,0 +1,14 @@
+<its:rules xmlns:its="http://www.w3.org/2005/11/its";
+           xmlns:mal="http://projectmallard.org/1.0/";
+           version="1.0">
+  <!--
+  It's common to use a gui element alone as a title for a terms item, or
+  as the only text in a list item. Make it so translators don't have to
+  deal with this extra markup.
+  -->
+  <its:withinTextRule
+      selector="//mal:gui[
+                (parent::mal:title or parent::mal:p) and
+                not(preceding-sibling::node() or following-sibling::node())]"
+      withinText="no"/>
+</its:rules>
diff --git a/help/C/legal.xml b/help/C/legal.xml
new file mode 100644
index 0000000..cb5d83f
--- /dev/null
+++ b/help/C/legal.xml
@@ -0,0 +1,5 @@
+<license xmlns="http://projectmallard.org/1.0/";
+         href="http://creativecommons.org/licenses/by-sa/3.0/";>
+  <p>This work is licensed under a <link href="http://creativecommons.org/licenses/by-sa/3.0/";>Creative
+  Commons Attribution-ShareAlike 3.0 Unported License</link>.</p>
+</license>
diff --git a/help/Makefile.am b/help/Makefile.am
new file mode 100644
index 0000000..7b37c0d
--- /dev/null
+++ b/help/Makefile.am
@@ -0,0 +1,15 @@
+ YELP_HELP_RULES@
+
+EXTRA_DIST = C/gnome-help.its
+
+HELP_ID = gnome-color-manager
+
+HELP_LINGUAS = 
+
+HELP_MEDIA = 
+
+HELP_FILES = \
+	legal.xml			\
+	color-import-linux.page		\
+	color-import-windows.page	\
+	color-import-osx.page
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]