GNOME.org
 

[gimp-help] Add dashboard.xml; add ref in glossary.xml; adds on in channel-mixer, mono-mixer, extract-component

commit 10a4550ee3a220074ce0b6b9f54c03068f28aead
Author: Julien Hardelin <jhardlin orange fr>
Date:   Tue Jul 2 15:07:35 2019 +0200

    Add dashboard.xml; add ref in glossary.xml; adds on in channel-mixer, mono-mixer, extract-component

 images/C/dialogs/dashboard-dialog.png              | Bin 0 -> 30975 bytes
 .../colors/components/extract_component-dialog.png | Bin 0 -> 20078 bytes
 .../colors/components/extract_component-ex.png     | Bin 0 -> 24327 bytes
 .../menus/colors/components/mono_mixer-dialog.png  | Bin 0 -> 27630 bytes
 images/C/menus/colors/components/mono_mixer-ex.png | Bin 0 -> 22899 bytes
 src/dialogs/dashboard.xml                          |  69 ++++++++++++
 src/dialogs/dialogs-misc.xml                       |   3 +-
 src/glossary/glossary.xml                          |   5 +
 src/menus/colors/components/channel-mixer.xml      |   2 +-
 src/menus/colors/components/extract-component.xml  | 118 ++++++++++++++++++++-
 src/menus/colors/components/mono-mixer.xml         | 109 ++++++++++++++++++-
 11 files changed, 299 insertions(+), 7 deletions(-)
---
diff --git a/images/C/dialogs/dashboard-dialog.png b/images/C/dialogs/dashboard-dialog.png
new file mode 100644
index 000000000..3480a0963
Binary files /dev/null and b/images/C/dialogs/dashboard-dialog.png differ
diff --git a/images/C/menus/colors/components/extract_component-dialog.png 
b/images/C/menus/colors/components/extract_component-dialog.png
new file mode 100644
index 000000000..22936f736
Binary files /dev/null and b/images/C/menus/colors/components/extract_component-dialog.png differ
diff --git a/images/C/menus/colors/components/extract_component-ex.png 
b/images/C/menus/colors/components/extract_component-ex.png
new file mode 100644
index 000000000..5b62a6b50
Binary files /dev/null and b/images/C/menus/colors/components/extract_component-ex.png differ
diff --git a/images/C/menus/colors/components/mono_mixer-dialog.png 
b/images/C/menus/colors/components/mono_mixer-dialog.png
new file mode 100644
index 000000000..c85b45d8f
Binary files /dev/null and b/images/C/menus/colors/components/mono_mixer-dialog.png differ
diff --git a/images/C/menus/colors/components/mono_mixer-ex.png 
b/images/C/menus/colors/components/mono_mixer-ex.png
new file mode 100644
index 000000000..97da0b63f
Binary files /dev/null and b/images/C/menus/colors/components/mono_mixer-ex.png differ
diff --git a/src/dialogs/dashboard.xml b/src/dialogs/dashboard.xml
new file mode 100644
index 000000000..95b4cb7aa
--- /dev/null
+++ b/src/dialogs/dashboard.xml
@@ -0,0 +1,69 @@
+<?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:
+  2019-07-01 j.h: create
+-->
+<sect2 id="gimp-dashboard-dialog">
+  <title>Dashboard</title>
+
+  <indexterm>
+    <primary>Dashboard</primary>
+  </indexterm>
+
+  <para>
+    This Dashboard helps to monitor GIMP resources (Cache, Swap, CPU, Memory) , 
+    allowing you to make more educated decisions about various configuration 
+    options. It is also used by developers.
+  </para>
+
+  <sect3>
+    <title>Activating the Dialog</title>
+    <para>
+      The <quote>Dashboard</quote> dialog is a dockable dialog; see the
+      section <xref linkend="gimp-concepts-docks"/> for help on manipulating
+      it.
+    </para>
+    <para>
+      You can access it:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          from an image menu:
+          <menuchoice>
+            <guimenu>Windows</guimenu>
+            <guisubmenu>Dockable Dialogs</guisubmenu>
+            <guimenuitem>Dashboard</guimenuitem>
+          </menuchoice>;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          from the Tab menu in any dockable dialog by clicking on
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject><imagedata format="PNG"
+                fileref="images/dialogs/stock-menu-left-12.png"/>
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon> and selecting
+          <menuchoice>
+            <guimenu>Add Tab</guimenu>
+            <guimenuitem>Dashboard</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+    
+    <figure>
+      <title><quote>Dashboard</quote> Dialog window</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/dialogs/dashboard-dialog.png" 
+format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+  </sect3>
+</sect2>
\ No newline at end of file
diff --git a/src/dialogs/dialogs-misc.xml b/src/dialogs/dialogs-misc.xml
index 946cd45ad..d43176048 100644
--- a/src/dialogs/dialogs-misc.xml
+++ b/src/dialogs/dialogs-misc.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2017-05-06 j.h: add symmetry-painting
+  2019-07-01 j.h: add dashboard
 -->
 <sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-dialogs-misc">
   <title>Misc. Dialogs</title>
@@ -11,6 +11,7 @@
   <xi:include href="tool-preset-editor.xml"/>
   <xi:include href="device-status-dialog.xml"/>
   <xi:include href="error-console.xml"/>
+  <xi:include href="dashboard.xml"/>
   <xi:include href="save-file-dialog.xml"/>
   <xi:include href="export-file-dialog.xml"/>
   <xi:include href="sample-points.xml"/>
diff --git a/src/glossary/glossary.xml b/src/glossary/glossary.xml
index 49b00f2d1..95fde6c40 100644
--- a/src/glossary/glossary.xml
+++ b/src/glossary/glossary.xml
@@ -2477,6 +2477,11 @@ fileref="images/dialogs/examples/layer-groups-pass-through-ex6.png"/>
         ordinary image layer if the file is opened in
         <acronym>GIMP</acronym> 1.2.
       </para>
+      <para>
+        Documentation about XCF format can be found at 
+          <ulink 
+url="https://gitlab.gnome.org/GNOME/gimp/blob/master/devel-docs/xcf.txt"/>.
+      </para>
     </glossdef>
   </glossentry>
 
diff --git a/src/menus/colors/components/channel-mixer.xml b/src/menus/colors/components/channel-mixer.xml
index 8badb381d..fb48b66bc 100644
--- a/src/menus/colors/components/channel-mixer.xml
+++ b/src/menus/colors/components/channel-mixer.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:
-  
+  Obsolete in GIMP-2.10: TODO
 -->
 <sect2 id="gimp-filter-channel-mixer">
   <title>Channel Mixer</title>
diff --git a/src/menus/colors/components/extract-component.xml 
b/src/menus/colors/components/extract-component.xml
index daa6c377d..dd825ca74 100644
--- a/src/menus/colors/components/extract-component.xml
+++ b/src/menus/colors/components/extract-component.xml
@@ -2,10 +2,122 @@
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
           "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!--section history:
-  2018-06-08 j.h Created empty
+  2019-07-01 j.h: Using to be completed
 -->
 
 <sect2 id="gimp-filter-component-extract">
   <title>Extract Component</title>
-  <para>TODO</para>
-</sect2>
\ No newline at end of file
+  
+  <indexterm>
+    <primary>Colors</primary>
+    <secondary>Components</secondary>
+    <tertiary>Extract Component</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Extract Component</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Extract Component applied</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/menus/taj_orig_2.png" format="PNG"/>
+        </imageobject>
+        <caption>
+          <para>Original image</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/menus/colors/components/extract_component-ex.png"/>
+        </imageobject>
+        <caption>
+          <para>
+            Command <quote>Extract Component</quote> applied with default 
+            options.
+          </para>
+        </caption>
+      </mediaobject>
+    </figure>
+  </sect3>
+
+  <sect3>
+    <title>Activate the command</title>
+    <itemizedlist>
+      <listitem>
+        <para>
+          You can find this command in the image window menu under
+          <menuchoice>
+            <guimenu>Colors</guimenu>
+            <guisubmenu>Components</guisubmenu>
+            <guimenuitem>Extract Component…</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Extract Component</quote> command options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+        fileref="images/menus/colors/components/extract_component-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term><guilabel>Presets</guilabel>, <guilabel>Preview</guilabel>, 
+          <guilabel>Split view</guilabel></term>
+        <listitem>
+          <para>
+            These options are common to GEGL-based filters. Please refer to 
+            <xref linkend="gimp-filters-common"/>.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><guilabel>Component</guilabel></term>
+        <listitem>
+          <para>
+            Component to extract. Default is RGB Red: all layer pixels that 
+            have the red component in their color will be extracted to create 
+            gray pixels; gray pixel value is that of the red channel (e.g a 
+            153;70;17 RGB pixel will give a 153;153;153 gray pixel).
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><guilabel>Invert</guilabel></term>
+        <listitem>
+          <para>
+            Invert the extracted component.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><guilabel>Linear input</guilabel></term>
+        <listitem>
+          <para>
+            Use linear input instead of gamma corrected.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+  
+  <sect3>
+    <title>Using Extract Component</title>
+    <para>
+      What can we do with that?
+    </para>
+  </sect3>
+  
+</sect2>
+
diff --git a/src/menus/colors/components/mono-mixer.xml b/src/menus/colors/components/mono-mixer.xml
index 255023846..e1f9d18d8 100644
--- a/src/menus/colors/components/mono-mixer.xml
+++ b/src/menus/colors/components/mono-mixer.xml
@@ -2,10 +2,115 @@
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
           "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!--section history:
-  2018-06-08 j.h Created empty
+  2019-07-01 j.h: Using to be completed
 -->
 
 <sect2 id="gimp-filter-mono-mixer">
   <title>Mono Mixer</title>
-  <para>TODO</para>
+  
+  <indexterm>
+    <primary>Colors</primary>
+    <secondary>Components</secondary>
+    <tertiary>Mono-mixer</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Mono-mixer</primary>
+  </indexterm>
+  
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Mono-mixer applied</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/menus/taj_orig_2.png" format="PNG"/>
+        </imageobject>
+        <caption>
+          <para>Original image</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/menus/colors/components/mono_mixer-ex.png"/>
+        </imageobject>
+        <caption>
+          <para>
+            Command <quote>Mono-mixer</quote> applied with default options.
+          </para>
+        </caption>
+      </mediaobject>
+    </figure>
+  </sect3>
+  
+  <sect3>
+    <title>Activate the command</title>
+    <itemizedlist>
+      <listitem>
+        <para>
+          You can find this command in the image window menu under
+          <menuchoice>
+            <guimenu>Colors</guimenu>
+            <guisubmenu>Components</guisubmenu>
+            <guimenuitem>Mono Mixer…</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+  
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Mono Mixer</quote> command options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/menus/colors/components/mono_mixer-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term><guilabel>Presets</guilabel>, <guilabel>Preview</guilabel>, 
+          <guilabel>Split view</guilabel></term>
+        <listitem>
+          <para>
+            These options are common to GEGL-based filters. Please refer to 
+            <xref linkend="gimp-filters-common"/>.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><guilabel>Preserve luminosity</guilabel></term>
+        <listitem>
+          <para>
+            Calculations may result in too high values and an image too much
+            clear. This option lessens luminosities of the color channels
+            while keeping a good visual ratio between them. So, you can change
+            the relative weight of the colors without changing the overall
+            luminosity.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><guilabel>Red Channel Multiplier</guilabel></term>
+        <term><guilabel>Green Channel Multiplier</guilabel></term>
+        <term><guilabel>Blue Channel Multiplier</guilabel></term>
+        <listitem>
+          <para>
+            Coefficient applied to each channel. Values range from -5.000 to 
+            5.000. As default values are equal in the three channels, image is 
+            grayed out.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+  <sect3>
+    <title>Using Channel Mixer</title>
+    <para>
+      TODO
+    </para>
+  </sect3>
 </sect2>
\ No newline at end of file
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]