GNOME.org
 

[gimp-help] Add artistic/simple-linear-clustering.xml

commit 46d495f879e3c6df764fca3830fe00b8f6b48e35
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sat Jan 26 08:04:38 2019 +0100

    Add artistic/simple-linear-clustering.xml

 images/C/filters/artistic/slic-dialog.png          | Bin 0 -> 20894 bytes
 .../examples/artistic/slic-ex-compact20.jpg        | Bin 0 -> 36472 bytes
 .../examples/artistic/slic-ex-compact40.jpg        | Bin 0 -> 29890 bytes
 .../filters/examples/artistic/slic-ex-default.jpg  | Bin 0 -> 13829 bytes
 .../C/filters/examples/artistic/slic-ex-iter15.jpg | Bin 0 -> 16826 bytes
 .../C/filters/examples/artistic/slic-ex-orig.jpg   | Bin 0 -> 15172 bytes
 .../examples/artistic/slic-ex-regions16.jpg        | Bin 0 -> 14770 bytes
 src/filters/artistic.xml                           |  12 +-
 src/filters/artistic/simple-linear-clustering.xml  | 173 +++++++++++++++++++++
 9 files changed, 182 insertions(+), 3 deletions(-)
---
diff --git a/images/C/filters/artistic/slic-dialog.png b/images/C/filters/artistic/slic-dialog.png
new file mode 100644
index 000000000..53cf606f3
Binary files /dev/null and b/images/C/filters/artistic/slic-dialog.png differ
diff --git a/images/C/filters/examples/artistic/slic-ex-compact20.jpg 
b/images/C/filters/examples/artistic/slic-ex-compact20.jpg
new file mode 100644
index 000000000..617aafe8f
Binary files /dev/null and b/images/C/filters/examples/artistic/slic-ex-compact20.jpg differ
diff --git a/images/C/filters/examples/artistic/slic-ex-compact40.jpg 
b/images/C/filters/examples/artistic/slic-ex-compact40.jpg
new file mode 100644
index 000000000..0fde45013
Binary files /dev/null and b/images/C/filters/examples/artistic/slic-ex-compact40.jpg differ
diff --git a/images/C/filters/examples/artistic/slic-ex-default.jpg 
b/images/C/filters/examples/artistic/slic-ex-default.jpg
new file mode 100644
index 000000000..68c166225
Binary files /dev/null and b/images/C/filters/examples/artistic/slic-ex-default.jpg differ
diff --git a/images/C/filters/examples/artistic/slic-ex-iter15.jpg 
b/images/C/filters/examples/artistic/slic-ex-iter15.jpg
new file mode 100644
index 000000000..354fccaad
Binary files /dev/null and b/images/C/filters/examples/artistic/slic-ex-iter15.jpg differ
diff --git a/images/C/filters/examples/artistic/slic-ex-orig.jpg 
b/images/C/filters/examples/artistic/slic-ex-orig.jpg
new file mode 100644
index 000000000..64ad9f287
Binary files /dev/null and b/images/C/filters/examples/artistic/slic-ex-orig.jpg differ
diff --git a/images/C/filters/examples/artistic/slic-ex-regions16.jpg 
b/images/C/filters/examples/artistic/slic-ex-regions16.jpg
new file mode 100644
index 000000000..85076705d
Binary files /dev/null and b/images/C/filters/examples/artistic/slic-ex-regions16.jpg differ
diff --git a/src/filters/artistic.xml b/src/filters/artistic.xml
index 4c7d2c973..7aa819958 100644
--- a/src/filters/artistic.xml
+++ b/src/filters/artistic.xml
@@ -12,13 +12,19 @@
   <xi:include href="artistic/introduction.xml"/>
   <xi:include href="artistic/applycanvas.xml"/>
   <xi:include href="artistic/cartoon.xml"/>
-  <xi:include href="artistic/clothify.xml"/>
   <xi:include href="artistic/cubism.xml"/>
-  <xi:include href="artistic/GIMPressionist.xml"/>
+  <!--<xi:include href="artistic/glasstile.xml"/>-->
   <xi:include href="artistic/oilify.xml"/>
   <xi:include href="artistic/photocopy.xml"/>
-  <xi:include href="artistic/predator.xml"/>
+  <xi:include href="artistic/simple-linear-clustering.xml"/>
   <xi:include href="artistic/softglow.xml"/>
+  <!--<xi:include href="artistic/waterpixel.xml"/>-->
+    <!--<xi:include href="artistic/cartoon-legacy.xml"/>-->
+  <xi:include href="artistic/clothify.xml"/>
+  <xi:include href="artistic/GIMPressionist.xml"/>
+  <!--<xi:include href="artistic/oilify-legacy.xml"/>-->
+  <xi:include href="artistic/predator.xml"/>
+  <!--<xi:include href="artistic/softglow-legacy.xml"/>-->
   <xi:include href="artistic/vangogh-lic.xml"/>
   <xi:include href="artistic/weave.xml"/>
 </sect1>
diff --git a/src/filters/artistic/simple-linear-clustering.xml 
b/src/filters/artistic/simple-linear-clustering.xml
new file mode 100644
index 000000000..64fd68894
--- /dev/null
+++ b/src/filters/artistic/simple-linear-clustering.xml
@@ -0,0 +1,173 @@
+<?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-24 j.h create
+-->
+
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-slic">
+  <title>Simple Linear Iterative Clustering (SLIC)</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Artistic</secondary>
+    <tertiary>Simple Linear Iterative Clustering</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Simple Linear Iterative Clustering</primary>
+  </indexterm>
+  
+  <sect3>
+    <title>Overview</title>
+    <para>
+      This filter creates superpixels based on k-means clustering.
+    </para>
+    <para>
+      <emphasis>Superpixels</emphasis> are small cluster of pixels that share 
+      similar properties. Superpixels simplifies images with a great number of 
+      pixels making them more easy to be treated in many domains (computer 
+      vision, pattern recognition and machine intelligence). GIMP's aim is more 
+      humble: create a posterization effect.
+    </para>
+    <para>
+      <emphasis>k-means clustering</emphasis> is one of the most used algorithms 
+      to create superpixels. Superpixel color is the mean of pixels color in 
+      the corresponding region.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Artistic</guisubmenu>
+        <guimenuitem>Simple Linear Iterative Clustering…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Simple Linear Iterative Clustering</quote> options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/artistic/slic-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>Regions size</term>
+        <listitem>
+          <para>
+            Increasing regions size collects more pixels, and so superpixels size 
+            increases also.
+          </para>
+          <figure>
+            <title><quote>Regions size</quote> example</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                fileref="images/filters/examples/artistic/slic-ex-regions16.jpg"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Regions size = 16
+                </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/artistic/slic-ex-default.jpg"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Regions size = 32
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Compactness</term>
+        <listitem>
+          <para>
+            Superpixels borders may be irregular. Increasing this option gives 
+            superpixels more regular border.
+          </para>
+          <figure>
+            <title><quote>Compactness</quote> example</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                fileref="images/filters/examples/artistic/slic-ex-compact20.jpg"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Compactness = 20
+                </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                fileref="images/filters/examples/artistic/slic-ex-compact40.jpg"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Compactness = 40: look at the dome.
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Iterations</term>
+        <listitem>
+          <para>
+            How many times filter is repeated. Increasing this value gives more 
+            details.
+          </para>
+          <figure>
+            <title><quote>Regions size</quote> example</title>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/artistic/slic-ex-default.jpg"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Iterations = 1 (default)
+                </para>
+              </caption>
+            </mediaobject>
+            <mediaobject>
+              <imageobject>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/artistic/slic-ex-iter15.jpg"/>
+              </imageobject>
+              <caption>
+                <para>
+                  Iterations = 15
+                </para>
+              </caption>
+            </mediaobject>
+          </figure>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
\ No newline at end of file
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]