[gimp-help] Add Little Planet filter



commit 41b7cdf6a13e26b169e6cfb99ed938d4b3807673
Author: Julien Hardelin <jhardlin orange fr>
Date:   Mon Feb 18 18:33:41 2019 +0100

    Add Little Planet filter

 .../filters/examples/map/little_planet-default.jpg | Bin 0 -> 20852 bytes
 .../C/filters/examples/map/little_planet-equal.jpg | Bin 0 -> 11719 bytes
 .../C/filters/examples/map/little_planet-flip.jpg  | Bin 0 -> 15625 bytes
 .../filters/examples/map/little_planet-origin.jpg  | Bin 0 -> 31582 bytes
 .../filters/examples/map/little_planet-result.jpg  | Bin 0 -> 5531 bytes
 images/C/filters/map/little_planet-dialog.png      | Bin 0 -> 24534 bytes
 src/filters/map.xml                                |   5 +-
 src/filters/map/fractal-trace.xml                  |   2 +-
 src/filters/map/little-planet.xml                  | 256 +++++++++++++++++++++
 9 files changed, 259 insertions(+), 4 deletions(-)
---
diff --git a/images/C/filters/examples/map/little_planet-default.jpg 
b/images/C/filters/examples/map/little_planet-default.jpg
new file mode 100644
index 000000000..fc699152d
Binary files /dev/null and b/images/C/filters/examples/map/little_planet-default.jpg differ
diff --git a/images/C/filters/examples/map/little_planet-equal.jpg 
b/images/C/filters/examples/map/little_planet-equal.jpg
new file mode 100644
index 000000000..6ad8d0a00
Binary files /dev/null and b/images/C/filters/examples/map/little_planet-equal.jpg differ
diff --git a/images/C/filters/examples/map/little_planet-flip.jpg 
b/images/C/filters/examples/map/little_planet-flip.jpg
new file mode 100644
index 000000000..82ba591ed
Binary files /dev/null and b/images/C/filters/examples/map/little_planet-flip.jpg differ
diff --git a/images/C/filters/examples/map/little_planet-origin.jpg 
b/images/C/filters/examples/map/little_planet-origin.jpg
new file mode 100644
index 000000000..4459c1c15
Binary files /dev/null and b/images/C/filters/examples/map/little_planet-origin.jpg differ
diff --git a/images/C/filters/examples/map/little_planet-result.jpg 
b/images/C/filters/examples/map/little_planet-result.jpg
new file mode 100644
index 000000000..f5b20a55e
Binary files /dev/null and b/images/C/filters/examples/map/little_planet-result.jpg differ
diff --git a/images/C/filters/map/little_planet-dialog.png b/images/C/filters/map/little_planet-dialog.png
new file mode 100644
index 000000000..2497bdfd5
Binary files /dev/null and b/images/C/filters/map/little_planet-dialog.png differ
diff --git a/src/filters/map.xml b/src/filters/map.xml
index bc2267894..fac36a081 100644
--- a/src/filters/map.xml
+++ b/src/filters/map.xml
@@ -2,10 +2,8 @@
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-09-07 AntI: added 'es'
+  2019-02-18 j.h: add little-planet.xml
   2007-08-08 ude: moved Van Gogh (LIC) to artistic filters
-  2007-05-06 KoSt: added 'no'
-  2006-12-12 lexa: added german translation
   2005-10-05 created by julien hardelin
 -->
 <sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="filters-map">
@@ -15,6 +13,7 @@
   <xi:include href="map/displace.xml"/>
   <xi:include href="map/fractal-trace.xml"/>
   <xi:include href="map/illusion.xml"/>
+  <xi:include href="map/little-planet.xml"/>
   <xi:include href="map/make-seamless.xml"/>
   <xi:include href="map/map-object.xml"/>
   <xi:include href="map/papertile.xml"/>
diff --git a/src/filters/map/fractal-trace.xml b/src/filters/map/fractal-trace.xml
index df13048f9..8b605b2b8 100644
--- a/src/filters/map/fractal-trace.xml
+++ b/src/filters/map/fractal-trace.xml
@@ -67,7 +67,7 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/map/fractal_trace-options.png"/>
+            fileref="images/filters/map/fractal_trace-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
diff --git a/src/filters/map/little-planet.xml b/src/filters/map/little-planet.xml
new file mode 100644
index 000000000..41a39a7df
--- /dev/null
+++ b/src/filters/map/little-planet.xml
@@ -0,0 +1,256 @@
+<?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-02-14 j.h: create. Inverse Transform option to review
+-->
+
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-little-planet">
+  <title>Little Planet</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Map</secondary>
+    <tertiary>Little Planet</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Little Planet</primary>
+  </indexterm>
+  
+  <sect3>
+    <title>Overview</title>
+    <para>
+      This filter converts a panorama into a small planet. All images don't fit 
+      this filter.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Activate the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Map</guisubmenu>
+        <guimenuitem>Little Planet…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Little Planet</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/map/little_planet-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <title>Options</title>
+      <varlistentry>
+        <term>Presets, Preview, Split view</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Pan</term>
+        <listitem>
+          <para>
+            Horizontal camera panning. If <quote>Inverse transform</quote> option 
+            is checked, the <quote>pan</quote> option moves line of sight 
+            horizontally. Else, it works as <quote>Spin</quote> option.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Tilt</term>
+        <listitem>
+          <para>
+            Vertical camera panning. Moves line of sight upwards/downwards.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Spin</term>
+        <listitem>
+          <para>
+            Spin angle around camera axis. Rotates planet around line of sight.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Zoom</term>
+        <listitem>
+          <para>
+            Zoom level. Zooms planet in/out.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <!--I don't understand this option; simply copied the UI pop up help-->
+        <term>Inverse transform</term>
+        <listitem>
+          <para>
+            Do the inverse mapping; useful for touching up zenith, nadir or other 
+            parts of panorama.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Resampling method</term>
+        <listitem>
+          <para>
+            Interpolation methods are described in 
+            <xi:include href="../about-common-features.xml"/>
+          </para>
+          <para>
+            <quote>Cubic</quote> may give better result.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Use the selection as input/Use the entire layer as input</term>
+        <listitem>
+          <para>
+            If a selection exists, the filter will use it. Else, the entire layer 
+            will be used.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+  <sect3>
+    <title>Using Little Planet filter</title>
+    <para>
+      The ideal image is a 360° panorama, with an blue empty sky occupying the 
+      upper half of the image and a horizontal horizon. Your image rarely 
+      satisfies these conditions, especially if you cut your panorama off a 
+      larger image. The Little Planet filter brings left and right image sides 
+      together, and creates an unwanted sharp limit if sides are different. An 
+      uneven horizon gives an irregular circle. Usually, you will have to prepare 
+      your panorama before using filter.
+    </para>
+    <figure>
+      <title>Original Images</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/map/little_planet-origin.jpg"/>
+        </imageobject>
+        <caption>
+          <para>
+            Original panorama
+          </para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/map/little_planet-default.jpg"/>
+        </imageobject>
+        <caption>
+          <para>
+            Filter applied directly with default options
+          </para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <procedure>
+      <step>
+        <para>
+          Wipe sky: with Color Picker, darker blue to toolbox foreground and 
+          lighter blue to toolbox background. Rectangular selection of sky 
+          including a small part of horizon. In the selection, draw a Gradient 
+          from top to bottom.
+        </para>
+      </step>
+      <step>
+        <para>
+          Select the left border of the image.
+        </para>
+      </step>
+      <step>
+        <para>
+          Copy the selection and Paste it as New layer.
+        </para>
+      </step>
+      <step>
+        <para>
+          <keycap>Q</keycap> shortcut to open the Align tool. 
+        </para>
+      </step>
+      <step>
+        <para>
+          Click on new layer (superimposed on selection area): new layer limits 
+          appear. Align new layer to image right side.
+        </para>
+      </step>
+      <step>
+        <para>
+          Select>None.
+        </para>
+      </step>
+      <step>
+        <para>
+          Flip new layer horizontally.
+        </para>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="JPG"
+              fileref="images/filters/examples/map/little_planet-flip.jpg"/>
+          </imageobject>
+          <caption>
+            <para>
+              New layer aligned to image right side and flipped: left and right 
+              image sides are now the same. Sky wiped out. Horizon horizontalized.
+            </para>
+          </caption>
+        </mediaobject>
+      </step>
+      <step>
+        <para>
+          Add a black Layer Mask to new layer.
+        </para>
+      </step>
+      <step>
+        <para>
+          Apply a black-to-white gradient to layer mask.
+        </para>
+      </step>
+      <step>
+        <para>
+          Apply Little planet filter.
+        </para>
+      </step>
+    </procedure>
+    <figure>
+      <title>Results</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/map/little_planet-equal.jpg"/>
+        </imageobject>
+        <caption>
+          <para>
+            Prepared image
+          </para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/map/little_planet-result.jpg"/>
+        </imageobject>
+        <caption>
+          <para>
+            Filter applied
+          </para>
+        </caption>
+      </mediaobject>
+    </figure>
+  </sect3>
+</sect2>
\ No newline at end of file


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