[gimp-help] Add dashboard.xml; add ref in glossary.xml; adds on in channel-mixer, mono-mixer, extract-component
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help] Add dashboard.xml; add ref in glossary.xml; adds on in channel-mixer, mono-mixer, extract-component
- Date: Tue, 2 Jul 2019 13:08:05 +0000 (UTC)
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]