[gimp-help-2] Add basic docs on the new Color Temperature filter

[Alexandre Prokoudine <aprokoudine src gnome org>]

commit 5079c2a055d6c2e92665b76f7ebc9688814ef664
Author: Alexandre Prokoudine <alexandre prokoudine gmail com>
Date:   Tue Jan 31 01:17:10 2017 +0300

    Add basic docs on the new Color Temperature filter

 .../examples/color-taj-color-temperature.jpg       |  Bin 0 -> 35344 bytes
 .../C/menus/colors/color-temperature-presets.png   |  Bin 0 -> 60197 bytes
 images/C/menus/colors/color-temperature.png        |  Bin 0 -> 38111 bytes
 src/menus/colors.xml                               |    1 +
 src/menus/colors/color-temperature.xml             |  100 ++++++++++++++++++++
 5 files changed, 101 insertions(+), 0 deletions(-)
---
diff --git a/images/C/filters/examples/color-taj-color-temperature.jpg 
b/images/C/filters/examples/color-taj-color-temperature.jpg
new file mode 100644
index 0000000..8e49c7b
Binary files /dev/null and b/images/C/filters/examples/color-taj-color-temperature.jpg differ
diff --git a/images/C/menus/colors/color-temperature-presets.png 
b/images/C/menus/colors/color-temperature-presets.png
new file mode 100644
index 0000000..406eb08
Binary files /dev/null and b/images/C/menus/colors/color-temperature-presets.png differ
diff --git a/images/C/menus/colors/color-temperature.png b/images/C/menus/colors/color-temperature.png
new file mode 100644
index 0000000..7c5ad3a
Binary files /dev/null and b/images/C/menus/colors/color-temperature.png differ
diff --git a/src/menus/colors.xml b/src/menus/colors.xml
index d492862..bd4da3a 100644
--- a/src/menus/colors.xml
+++ b/src/menus/colors.xml
@@ -60,6 +60,7 @@
   <xi:include href="colors/filters.xml"/>
   <xi:include href="colors/colorify.xml"/>
   <xi:include href="colors/colortoalpha.xml"/>
+  <xi:include href="colors/color-temperature.xml"/>
   <xi:include href="colors/filterpack.xml"/>
   <xi:include href="colors/hot.xml"/>
   <xi:include href="colors/max_rgb.xml"/>
diff --git a/src/menus/colors/color-temperature.xml b/src/menus/colors/color-temperature.xml
new file mode 100644
index 0000000..98f6050
--- /dev/null
+++ b/src/menus/colors/color-temperature.xml
@@ -0,0 +1,100 @@
+<?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";>
+
+<sect2 id="plug-in-color-temperature">
+  <title>Color Temperature</title>
+
+  <indexterm>
+    <primary>Colors</primary>
+    <secondary>Color Temperature</secondary>
+  </indexterm>
+  <indexterm>
+    <primary>Color Temperature</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Example for the <quote>Color Temperature</quote> filter</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Original image, with color temperature estimated at 5,000K</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/color-taj-color-temperature.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Modified image, with color temperature changed to 6,500K</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      The Color Temperature filter allows adjusting color temperature of the 
+      light source in an image in Kelvin.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Activate the filter</title>
+    <para>
+      You can find this command through
+      <menuchoice>
+        <guimenu>Colors</guimenu>
+        <guimenuitem>Color Temperature…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Color Temperature</quote> options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/menus/colors/color-temperature.png" format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Original temperature</term>
+        <listitem>
+          <para>
+            This is the estimated original color temperature of the light 
+            source in Kelvin.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Intended temperature</term>
+        <listitem>
+          <para>
+            This is the desired color temperature of the light source in 
+            Kelvin.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <para>
+        Both original temperature and intended temperature can be set via 
+        presets. To access presets menu, click a button with a triangle icon 
+        to the right from either of the two options.
+    </para>
+    <figure>
+      <title>Color temperature presets</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/menus/colors/color-temperature-presets.png" format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+  </sect3>
+</sect2>