[gimp-help] Update generic filters. Add Distance Map and GEGL graph filters



commit f3ae502adb7fee4271dbe86bfd9467ae9ff93534
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Jan 20 18:45:20 2019 +0100

    Update generic filters. Add Distance Map and GEGL graph filters

 .../C/filters/examples/generic/dist_map-high-2.png | Bin 0 -> 11881 bytes
 .../C/filters/examples/generic/dist_map-low-0.png  | Bin 0 -> 3960 bytes
 .../C/filters/examples/generic/dist_map-low-1.png  | Bin 0 -> 8957 bytes
 .../C/filters/examples/generic/dist_map-low-2.png  | Bin 0 -> 13239 bytes
 .../C/filters/examples/generic/dist_map-low-3.png  | Bin 0 -> 16303 bytes
 .../examples/generic/dist_map-nonormalize.png      | Bin 0 -> 6270 bytes
 .../C/filters/examples/generic/dist_map-orig.png   | Bin 0 -> 3334 bytes
 images/C/filters/generic/dist_map-dialog.png       | Bin 0 -> 31871 bytes
 images/C/filters/generic/gegl_graph-dialog.png     | Bin 0 -> 20670 bytes
 src/filters/generic.xml                            |   2 +
 src/filters/generic/convol-matrix.xml              |   8 +-
 src/filters/generic/distance-map.xml               | 212 +++++++++++++++++++++
 src/filters/generic/gegl-graph.xml                 |  51 +++++
 src/filters/generic/introduction.xml               |  10 +
 14 files changed, 276 insertions(+), 7 deletions(-)
---
diff --git a/images/C/filters/examples/generic/dist_map-high-2.png 
b/images/C/filters/examples/generic/dist_map-high-2.png
new file mode 100644
index 000000000..f275634b8
Binary files /dev/null and b/images/C/filters/examples/generic/dist_map-high-2.png differ
diff --git a/images/C/filters/examples/generic/dist_map-low-0.png 
b/images/C/filters/examples/generic/dist_map-low-0.png
new file mode 100644
index 000000000..043dbdaf4
Binary files /dev/null and b/images/C/filters/examples/generic/dist_map-low-0.png differ
diff --git a/images/C/filters/examples/generic/dist_map-low-1.png 
b/images/C/filters/examples/generic/dist_map-low-1.png
new file mode 100644
index 000000000..69a36be84
Binary files /dev/null and b/images/C/filters/examples/generic/dist_map-low-1.png differ
diff --git a/images/C/filters/examples/generic/dist_map-low-2.png 
b/images/C/filters/examples/generic/dist_map-low-2.png
new file mode 100644
index 000000000..17576f365
Binary files /dev/null and b/images/C/filters/examples/generic/dist_map-low-2.png differ
diff --git a/images/C/filters/examples/generic/dist_map-low-3.png 
b/images/C/filters/examples/generic/dist_map-low-3.png
new file mode 100644
index 000000000..f9095f2a3
Binary files /dev/null and b/images/C/filters/examples/generic/dist_map-low-3.png differ
diff --git a/images/C/filters/examples/generic/dist_map-nonormalize.png 
b/images/C/filters/examples/generic/dist_map-nonormalize.png
new file mode 100644
index 000000000..f30cfdc5a
Binary files /dev/null and b/images/C/filters/examples/generic/dist_map-nonormalize.png differ
diff --git a/images/C/filters/examples/generic/dist_map-orig.png 
b/images/C/filters/examples/generic/dist_map-orig.png
new file mode 100644
index 000000000..2a385d52d
Binary files /dev/null and b/images/C/filters/examples/generic/dist_map-orig.png differ
diff --git a/images/C/filters/generic/dist_map-dialog.png b/images/C/filters/generic/dist_map-dialog.png
new file mode 100644
index 000000000..c66ade565
Binary files /dev/null and b/images/C/filters/generic/dist_map-dialog.png differ
diff --git a/images/C/filters/generic/gegl_graph-dialog.png b/images/C/filters/generic/gegl_graph-dialog.png
new file mode 100644
index 000000000..d67d822d1
Binary files /dev/null and b/images/C/filters/generic/gegl_graph-dialog.png differ
diff --git a/src/filters/generic.xml b/src/filters/generic.xml
index 7a3073758..c65a2dad7 100644
--- a/src/filters/generic.xml
+++ b/src/filters/generic.xml
@@ -8,6 +8,8 @@
 
   <xi:include href="generic/introduction.xml"/>
   <xi:include href="generic/convol-matrix.xml"/>
+  <xi:include href="generic/distance-map.xml"/>
+  <xi:include href="generic/gegl-graph.xml"/>
   <xi:include href="generic/dilate.xml"/>
   <xi:include href="generic/erode.xml"/>
 </sect1>
diff --git a/src/filters/generic/convol-matrix.xml b/src/filters/generic/convol-matrix.xml
index f3086f334..76facbedc 100644
--- a/src/filters/generic/convol-matrix.xml
+++ b/src/filters/generic/convol-matrix.xml
@@ -2,13 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2008-12-09 ude: moved "activate filter" paras to separate sect3
-  2008-06-01 j.h: adopted 'de' example.
-  2007-08-23 AntI: added 'es'
-  2007-04-17 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  2005-08-30 de replaced informalfigure by axel.wernicke
-  2005-09-01 de added by axel.wernicke
+  2019-01-14 j.h: update to v2.10
 -->
 <sect2 id="gimp-filter-convolution-matrix">
   <title>Convolution Matrix</title>
diff --git a/src/filters/generic/distance-map.xml b/src/filters/generic/distance-map.xml
new file mode 100644
index 000000000..8a059940e
--- /dev/null
+++ b/src/filters/generic/distance-map.xml
@@ -0,0 +1,212 @@
+<?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-01-15 j.h create
+-->
+
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-distance-map">
+  <title>Distance Map</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Generic</secondary>
+    <tertiary>Distance Map</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Distance Map</primary>
+  </indexterm>
+  
+  <sect3>
+    <title>Overview</title>
+    <para>
+      Each pixel in the image is replaced with a gray value dependent on the 
+      distance to the nearest obstacle pixel, generally a boundary pixel. 
+      Different methods can be used to calculate the distance.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Generic</guisubmenu>
+        <guimenuitem>Distance Map…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Distance Map</quote> options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/generic/dist_map-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Presets, Preview, Split view</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Metric</term>
+        <listitem>
+          <para>
+            <quote>Metric</quote> is a topology term. Three methods are 
+            available:
+            <itemizedlist>
+              <listitem>
+                <para>
+                  <guilabel>Euclidean</guilabel> default: the distance is a line.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <guilabel>Manhattan</guilabel>
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <guilabel>Chebyshev</guilabel>
+                </para>
+              </listitem>
+            </itemizedlist>
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Threshold low</term>
+        <listitem>
+          <para>
+            Default is 0. Increasing this value selects higher lightness pixels
+          </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata format="PNG"
+                fileref="images/filters/examples/generic/dist_map-orig.png"/>
+            </imageobject>
+            <caption>
+              <para>
+                Original image for examples. Threshold low will be progressively 
+                increased. Lightness: dark red = 0.070; bright red = 0.223; green 
+                = 0.133
+              </para>
+            </caption>
+          </mediaobject>
+           <figure>
+            <title><quote>Threshold low</quote> example</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/generic/dist_map-low-0.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Threshold low = 0: only border distances are visible.
+               </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/generic/dist_map-low-1.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Threshold low = 0.070: <quote>dark red</quote> circle appears.
+                </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/generic/dist_map-low-2.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Threshold low = 0.133: <quote>green</quote> circle appears.
+                </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/generic/dist_map-low-3.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Threshold low = 0.223: <quote>bright red</quote> red circle 
+                  appears.
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Threshold high</term>
+        <listitem>
+          <para>
+            Default is 100. Decreasing this value makes result lighter.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Grayscale Averaging</term>
+        <listitem>
+          <para>
+            Number of computations for grayscale averaging.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Normalize</term>
+        <listitem>
+          <para>
+            This option is checked by default. If you uncheck it, no blur is 
+            created.
+          </para>
+          <figure>
+            <title><quote>Normalize</quote> example</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/generic/dist_map-low-3.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Normalize option checked.
+               </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+            fileref="images/filters/examples/generic/dist_map-nonormalize.png"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Normalize option unchecked.
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+  <sect3>
+    <title>Using Distance Map filter</title>
+    <para>
+      Searching  for an example using Distance map filter in image processing...
+    </para>
+  </sect3>
+</sect2>
\ No newline at end of file
diff --git a/src/filters/generic/gegl-graph.xml b/src/filters/generic/gegl-graph.xml
new file mode 100644
index 000000000..e8d51107e
--- /dev/null
+++ b/src/filters/generic/gegl-graph.xml
@@ -0,0 +1,51 @@
+<?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-01-15 j.h create
+-->
+
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-gegl">
+  <title>GEGL graph</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Generic</secondary>
+    <tertiary>GEGL graph</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>GEGL graph</primary>
+  </indexterm>
+  
+  <sect3>
+    <title>Overview</title>
+    <para>
+      Not working.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Generic</guisubmenu>
+        <guimenuitem>GEGL graph…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Distance Map</quote> options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/generic/gegl_graph-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+  </sect3>
+</sect2>
\ No newline at end of file
diff --git a/src/filters/generic/introduction.xml b/src/filters/generic/introduction.xml
index fd7c56952..4ed486c67 100644
--- a/src/filters/generic/introduction.xml
+++ b/src/filters/generic/introduction.xml
@@ -23,6 +23,16 @@
         Matrix</link> filter which lets you build custom filters.
       </para>
     </listitem>
+    <listitem>
+      <para>
+        The <link linkend="gimp-filter-distance-map">Distance Map</link> filter.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        The <link linkend="gimp-filter-gegl">GEGL graph</link> filter.
+      </para>
+    </listitem>
     <listitem>
       <para>
         The <link linkend="plug-in-dilate">Dilate</link> filter.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]