[gimp-help-2] Update Animation filters



commit 21d53968c428d6aeac61504cfc0948966fcd4f7d
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date:   Mon Sep 6 20:15:31 2010 +0200

    Update Animation filters
    
    * Rename/move filter screenshots (Playback).
    * Update Playback screenshot.
    * Add stubs for missing filters (Blend, ..., Waves).
    * Add a brief description of the Unoptimize filter.

 images/C/filters/animation/blend.png               |  Bin 0 -> 5516 bytes
 images/C/filters/animation/burn-in.png             |  Bin 0 -> 7481 bytes
 images/C/filters/animation/playback.png            |  Bin 0 -> 4526 bytes
 images/C/filters/animation/rippling.png            |  Bin 0 -> 6567 bytes
 images/C/filters/animation/spinning-globe.png      |  Bin 0 -> 7306 bytes
 images/C/filters/animation/waves.png               |  Bin 0 -> 6680 bytes
 .../C/filters/examples/animation/blend-applied.png |  Bin 0 -> 2984 bytes
 images/C/filters/examples/animation/blend-orig.png |  Bin 0 -> 1072 bytes
 .../filters/examples/animation/burn-in-applied.png |  Bin 0 -> 32521 bytes
 .../C/filters/examples/animation/burn-in-orig.png  |  Bin 0 -> 16211 bytes
 .../filters/examples/animation/spinning-globe.jpg  |  Bin 0 -> 11141 bytes
 .../C/filters/examples/animation/taj-rippling.jpg  |  Bin 0 -> 10120 bytes
 images/C/filters/examples/animation/taj-waves.jpg  |  Bin 0 -> 13580 bytes
 images/C/filters/playback-options.png              |  Bin 3277 -> 0 bytes
 images/C/menus/filters/animation.png               |  Bin 0 -> 11119 bytes
 .../playback.png}                                  |  Bin 3368 -> 3368 bytes
 .../playback.png}                                  |  Bin 16922 -> 16922 bytes
 .../playback.png}                                  |  Bin 4154 -> 4154 bytes
 .../playback.png}                                  |  Bin 43343 -> 43343 bytes
 src/filters/animation.xml                          |   31 +++-
 src/filters/animation/blend.xml                    |  114 ++++++++++++++
 src/filters/animation/burn-in.xml                  |  158 ++++++++++++++++++++
 src/filters/animation/optimize.xml                 |  121 +++++++++------
 src/filters/animation/playback.xml                 |    2 +-
 src/filters/animation/rippling.xml                 |  107 +++++++++++++
 src/filters/animation/spinning-globe.xml           |  134 +++++++++++++++++
 src/filters/animation/waves.xml                    |  115 ++++++++++++++
 27 files changed, 725 insertions(+), 57 deletions(-)
---
diff --git a/images/C/filters/animation/blend.png b/images/C/filters/animation/blend.png
new file mode 100644
index 0000000..114e7a1
Binary files /dev/null and b/images/C/filters/animation/blend.png differ
diff --git a/images/C/filters/animation/burn-in.png b/images/C/filters/animation/burn-in.png
new file mode 100644
index 0000000..0943a76
Binary files /dev/null and b/images/C/filters/animation/burn-in.png differ
diff --git a/images/C/filters/animation/playback.png b/images/C/filters/animation/playback.png
new file mode 100644
index 0000000..bcae35f
Binary files /dev/null and b/images/C/filters/animation/playback.png differ
diff --git a/images/C/filters/animation/rippling.png b/images/C/filters/animation/rippling.png
new file mode 100644
index 0000000..adbaae9
Binary files /dev/null and b/images/C/filters/animation/rippling.png differ
diff --git a/images/C/filters/animation/spinning-globe.png b/images/C/filters/animation/spinning-globe.png
new file mode 100644
index 0000000..12fdcbc
Binary files /dev/null and b/images/C/filters/animation/spinning-globe.png differ
diff --git a/images/C/filters/animation/waves.png b/images/C/filters/animation/waves.png
new file mode 100644
index 0000000..d677f8b
Binary files /dev/null and b/images/C/filters/animation/waves.png differ
diff --git a/images/C/filters/examples/animation/blend-applied.png b/images/C/filters/examples/animation/blend-applied.png
new file mode 100644
index 0000000..9a6d331
Binary files /dev/null and b/images/C/filters/examples/animation/blend-applied.png differ
diff --git a/images/C/filters/examples/animation/blend-orig.png b/images/C/filters/examples/animation/blend-orig.png
new file mode 100644
index 0000000..b39e7a6
Binary files /dev/null and b/images/C/filters/examples/animation/blend-orig.png differ
diff --git a/images/C/filters/examples/animation/burn-in-applied.png b/images/C/filters/examples/animation/burn-in-applied.png
new file mode 100644
index 0000000..da8f047
Binary files /dev/null and b/images/C/filters/examples/animation/burn-in-applied.png differ
diff --git a/images/C/filters/examples/animation/burn-in-orig.png b/images/C/filters/examples/animation/burn-in-orig.png
new file mode 100644
index 0000000..9b3bb72
Binary files /dev/null and b/images/C/filters/examples/animation/burn-in-orig.png differ
diff --git a/images/C/filters/examples/animation/spinning-globe.jpg b/images/C/filters/examples/animation/spinning-globe.jpg
new file mode 100644
index 0000000..af4b99a
Binary files /dev/null and b/images/C/filters/examples/animation/spinning-globe.jpg differ
diff --git a/images/C/filters/examples/animation/taj-rippling.jpg b/images/C/filters/examples/animation/taj-rippling.jpg
new file mode 100644
index 0000000..deacc5d
Binary files /dev/null and b/images/C/filters/examples/animation/taj-rippling.jpg differ
diff --git a/images/C/filters/examples/animation/taj-waves.jpg b/images/C/filters/examples/animation/taj-waves.jpg
new file mode 100644
index 0000000..14f6e84
Binary files /dev/null and b/images/C/filters/examples/animation/taj-waves.jpg differ
diff --git a/images/C/menus/filters/animation.png b/images/C/menus/filters/animation.png
new file mode 100644
index 0000000..82d5fb7
Binary files /dev/null and b/images/C/menus/filters/animation.png differ
diff --git a/images/fr/filters/playback-options.png b/images/fr/filters/animation/playback.png
similarity index 100%
rename from images/fr/filters/playback-options.png
rename to images/fr/filters/animation/playback.png
diff --git a/images/it/filters/playback-options.png b/images/it/filters/animation/playback.png
similarity index 100%
rename from images/it/filters/playback-options.png
rename to images/it/filters/animation/playback.png
diff --git a/images/ja/filters/playback-options.png b/images/ja/filters/animation/playback.png
similarity index 100%
rename from images/ja/filters/playback-options.png
rename to images/ja/filters/animation/playback.png
diff --git a/images/nn/filters/playback-options.png b/images/nn/filters/animation/playback.png
similarity index 100%
rename from images/nn/filters/playback-options.png
rename to images/nn/filters/animation/playback.png
diff --git a/src/filters/animation.xml b/src/filters/animation.xml
index cf02363..4551cf2 100644
--- a/src/filters/animation.xml
+++ b/src/filters/animation.xml
@@ -16,12 +16,31 @@
     <tertiary>Introduction</tertiary>
   </indexterm>
 
-  <para>
-    These are animation helpers, which let you view and optimize your
-    animations (by reducing their size). We gathered
-    <quote>Optimize (Difference)</quote> and <quote>Optimize (GIF)</quote>
-    filters together, because they are not much different.
-  </para>
+  <sect2 id="filters-animation-introduction">
+    <title>Introduction</title>
+    <figure>
+      <title>The Animation filters menu</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata  format="PNG"
+            fileref="images/menus/filters/animation.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <para>
+      These are animation helpers, which let you view and optimize your
+      animations (by reducing their size). We gathered <quote>Optimize
+      (Difference)</quote> and <quote>Optimize (GIF)</quote> filters together,
+      because they are not much different.
+    </para>
+  </sect2>
+
+  <xi:include href="animation/blend.xml"/>
+  <xi:include href="animation/burn-in.xml"/>
+  <xi:include href="animation/rippling.xml"/>
+  <xi:include href="animation/spinning-globe.xml"/>
+  <xi:include href="animation/waves.xml"/>
+  <!-- -->
   <xi:include href="animation/optimize.xml"/>
   <xi:include href="animation/playback.xml"/>
 </sect1>
diff --git a/src/filters/animation/blend.xml b/src/filters/animation/blend.xml
new file mode 100644
index 0000000..087df33
--- /dev/null
+++ b/src/filters/animation/blend.xml
@@ -0,0 +1,114 @@
+<?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";>
+
+<sect2 id="script-fu-blend-anim">
+  <title>Blend</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Animation</secondary>
+    <tertiary>Blend</tertiary>
+  </indexterm>
+  <indexterm><primary>Blend</primary></indexterm>
+
+  <sect3>
+    <title>Overview</title>
+
+    <figure>
+      <title>
+        Example for the <quote>Blend</quote> filter: original image
+      </title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/animation/blend-orig.png"/>
+        </imageobject>
+        <caption>
+          <para>4 frames of 5 frames (white background layer omitted)</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <figure>
+      <title>
+        Example for the <quote>Blend</quote> filter: filter applied
+      </title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/animation/blend-applied.png" />
+        </imageobject>
+        <caption>
+          <para>First 8 (of 16) frames</para>
+        </caption>
+      </mediaobject>
+    </figure>
+
+    <para>
+      <!--
+        Describe what the filter does, which algorithms it uses.
+        Give the user an idea what to use the filter for
+       -->
+    </para>
+  </sect3>
+
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Animation</guisubmenu>
+        <guimenuitem>Blend</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <para>
+      <!--
+        Describe how the filter options are organized in general.
+        This part is optional, but helps if the filter options dialog is a bit
+        more complex e.g. has some tabs etc.
+       -->
+    </para>
+    <figure>
+      <title><quote>Blend</quote> options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/animation/blend.png" />
+        </imageobject>
+      </mediaobject>
+    </figure>
+
+    <variablelist>
+      <varlistentry>
+        <term>Intermediate frames</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Max. blur radius</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Looped</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
diff --git a/src/filters/animation/burn-in.xml b/src/filters/animation/burn-in.xml
new file mode 100644
index 0000000..7fb4ae1
--- /dev/null
+++ b/src/filters/animation/burn-in.xml
@@ -0,0 +1,158 @@
+<?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";>
+
+<sect2 id="script-fu-burn-in-anim">
+  <title>Burn-In</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Animation</secondary>
+    <tertiary>Burn-In</tertiary>
+  </indexterm>
+  <indexterm><primary>Burn-In</primary></indexterm>
+
+  <sect3>
+    <title>Overview</title>
+
+    <figure>
+      <title>
+        Example for the <quote>Burn-In</quote> filter: original image
+      </title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/animation/burn-in-orig.png" />
+        </imageobject>
+        <caption>
+          <para>
+            Opaque background layer and foreground layer with transparency
+          </para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <figure>
+      <title>
+        Example for the <quote>Burn-In</quote> filter: filter applied
+      </title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/animation/burn-in-applied.png" />
+        </imageobject>
+        <caption>
+          <para>
+            Resulting image with 8 frames (depending on size and speed)
+          </para>
+        </caption>
+      </mediaobject>
+    </figure>
+
+    <para>
+      <!--
+        Describe what the filter does, which algorithms it uses.
+        Give the user an idea what to use the filter for
+       -->
+    </para>
+  </sect3>
+
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Animation</guisubmenu>
+        <guimenuitem>Burn-In</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <para>
+      <!--
+        Describe how the filter options are organized in general.
+        This part is optional, but helps if the filter options dialog is a bit
+        more complex e.g. has some tabs etc.
+       -->
+    </para>
+    <figure>
+      <title><quote>Burn-In</quote> options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/animation/burn-in.png" />
+        </imageobject>
+      </mediaobject>
+    </figure>
+
+    <variablelist>
+      <varlistentry>
+        <term>Glow color</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Fadeout</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Fadeout width</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Corona width</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>After glow</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Add glowing</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Prepare for GIF</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Speed (pixels/frame)</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
diff --git a/src/filters/animation/optimize.xml b/src/filters/animation/optimize.xml
index 38861a4..6f32ff8 100644
--- a/src/filters/animation/optimize.xml
+++ b/src/filters/animation/optimize.xml
@@ -8,10 +8,10 @@
   2007-01-05 lexa: added de translation
   2006-12-27 created by j.h
 -->
-<sect2 id="plug-in-animationoptimize">
+<sect2 id="plug-in-optimize">
   <title>Optimize</title>
 
-  <anchor id="plug-in-optimize" xreflabel="Optimize Animation"/>
+  <anchor id="plug-in-animationoptimize" xreflabel="Optimize (for GIF)"/>
   <anchor id="plug-in-animationoptimize-diff"
     xreflabel="Optimize (Difference)"/>
   <indexterm>
@@ -26,54 +26,6 @@
 
   <sect3>
     <title>Overview</title>
-    <figure>
-      <title>Example for the Optimize animation filters</title>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="PNG"
-            fileref="images/filters/examples/optimize-orig.png"/>
-        </imageobject>
-        <caption>
-          <para>
-            In this animation, the red ball goes downwards and past vertical
-            bars. File size is 600 Kb.
-          </para>
-        </caption>
-      </mediaobject>
-      <informalfigure>
-        <mediaobject>
-          <imageobject>
-            <imagedata format="PNG"
-              fileref="images/filters/examples/optimize-diff.png"/>
-          </imageobject>
-          <caption>
-            <para>
-              <emphasis>Optimize (Difference)</emphasis>:
-              File size moved to 153 Kb. Layers held only the part the
-              background which will be used to remove the trace of the red
-              ball. The common part of layers is transparent.
-            </para>
-          </caption>
-        </mediaobject>
-      </informalfigure>
-      <informalfigure>
-        <mediaobject>
-          <imageobject>
-            <imagedata fileref="images/filters/examples/optimize-gif.png" format="PNG"/>
-          </imageobject>
-          <caption>
-            <para>
-              <emphasis>Optimize (GIF)</emphasis>:
-              File size moved to 154 Kb, a bit bigger in the present
-              example, but layer size has been reduced. Layers held only a
-              rectangular selection which includes the part of the background
-              which will be used to remove the trace of the red ball. The
-              common part of layers is transparent.
-            </para>
-          </caption>
-        </mediaobject>
-      </informalfigure>
-    </figure>
     <para>
       An animation can contain several layers and so its size can be
       important. This is annoying for a Web page. The Optimize filters let you
@@ -112,6 +64,75 @@
           </menuchoice>
         </para>
       </listitem>
+      <listitem>
+        <para>
+          <menuchoice>
+            <guimenu>Filters</guimenu>
+            <guisubmenu>Animation</guisubmenu>
+            <guimenuitem>Unptimize</guimenuitem>
+          </menuchoice>
+        </para>
+      </listitem>
     </itemizedlist>
   </sect3>
+
+  <sect3>
+    <title>Example for the Optimize animation filters</title>
+
+    <informalfigure>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/optimize-orig.png"/>
+        </imageobject>
+        <caption><para>Original image</para></caption>
+      </mediaobject>
+    </informalfigure>
+    <para>
+      In this animation, the red ball goes downwards and past vertical bars.
+      File size is 600 Kb.
+    </para>
+
+    <informalfigure>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/optimize-diff.png"/>
+        </imageobject>
+        <caption><para>Optimize (Difference)</para></caption>
+      </mediaobject>
+    </informalfigure>
+    <para>
+      File size moved to 153 Kb. Layers held only the part the background
+      which will be used to remove the trace of the red ball. The common part
+      of layers is transparent.
+    </para>
+
+    <informalfigure>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/examples/optimize-gif.png"/>
+        </imageobject>
+      <caption><para>Optimize (GIF)</para></caption>
+      </mediaobject>
+    </informalfigure>
+    <para>
+      File size moved to 154 Kb, a bit bigger in the present example, but
+      layer size has been reduced. Layers held only a rectangular selection
+      which includes the part of the background which will be used to remove
+      the trace of the red ball. The common part of layers is transparent.
+    </para>
+  </sect3>
+
+  <sect3 id="plug-in-animationunoptimize">
+    <title>Unoptimize</title>
+    <para>
+      The <quote>Unoptimize</quote> filter removes any optimizations on a
+      layer-based animation. You may need this command if you want to edit the
+      animation and it's not possible or not useful to
+      <link linkend="gimp-concepts-undo">undo</link> any changes and start
+      editing from the original image.
+    </para>
+  </sect3>
 </sect2>
diff --git a/src/filters/animation/playback.xml b/src/filters/animation/playback.xml
index 986942b..b64006a 100644
--- a/src/filters/animation/playback.xml
+++ b/src/filters/animation/playback.xml
@@ -53,7 +53,7 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/playback-options.png"/>
+            fileref="images/filters/animation/playback.png"/>
         </imageobject>
       </mediaobject>
     </figure>
diff --git a/src/filters/animation/rippling.xml b/src/filters/animation/rippling.xml
new file mode 100644
index 0000000..5f272a3
--- /dev/null
+++ b/src/filters/animation/rippling.xml
@@ -0,0 +1,107 @@
+<?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";>
+
+<sect2 id="script-fu-ripply-anim">
+  <title>Rippling</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Animation</secondary>
+    <tertiary>Rippling</tertiary>
+  </indexterm>
+  <indexterm><primary>Rippling</primary></indexterm>
+
+  <sect3>
+    <title>Overview</title>
+
+    <figure>
+      <title>Example for the <quote>Rippling</quote> filter</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg" />
+        </imageobject>
+        <caption>
+          <para>Original image</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/animation/taj-rippling.jpg" />
+        </imageobject>
+        <caption>
+          <para>A <quote>Rippled</quote> frame</para>
+        </caption>
+      </mediaobject>
+    </figure>
+
+    <para>
+      <!--
+        Describe what the filter does, which algorithms it uses.
+        Give the user an idea what to use the filter for
+       -->
+    </para>
+  </sect3>
+
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Animation</guisubmenu>
+        <guimenuitem>Rippling</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <para>
+      <!--
+        Describe how the filter options are organized in general.
+        This part is optional, but helps if the filter options dialog is a bit
+        more complex e.g. has some tabs etc.
+       -->
+    </para>
+    <figure>
+      <title><quote>Rippling</quote> options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/animation/rippling.png" />
+        </imageobject>
+      </mediaobject>
+    </figure>
+
+    <variablelist>
+      <varlistentry>
+        <term>Rippling strength</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Number of frames</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Edge behavior</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
diff --git a/src/filters/animation/spinning-globe.xml b/src/filters/animation/spinning-globe.xml
new file mode 100644
index 0000000..88f5140
--- /dev/null
+++ b/src/filters/animation/spinning-globe.xml
@@ -0,0 +1,134 @@
+<?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";>
+
+<sect2 id="script-fu-spinning-globe">
+  <title>Spinning Globe</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Animation</secondary>
+    <tertiary>Spinning Globe</tertiary>
+  </indexterm>
+  <indexterm><primary>Spinning Globe</primary></indexterm>
+
+  <sect3>
+    <title>Overview</title>
+
+    <figure>
+      <title>
+        Example for the <quote>Spinning Globe</quote> filter: original image
+      </title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg" />
+        </imageobject>
+        <caption>
+          <para>Original image</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <figure>
+      <title>
+        Example for the <quote>Spinning Globe</quote> filter: filter applied
+      </title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/animation/spinning-globe.jpg"/>
+        </imageobject>
+        <caption>
+          <para>
+            3 (of 10) <quote>Spinning Globe</quote> frames (on a white
+            background)
+          </para>
+        </caption>
+      </mediaobject>
+    </figure>
+
+    <para>
+      <!--
+        Describe what the filter does, which algorithms it uses.
+        Give the user an idea what to use the filter for
+       -->
+    </para>
+  </sect3>
+
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Animation</guisubmenu>
+        <guimenuitem>Spinning Globe</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <para>
+      <!--
+        Describe how the filter options are organized in general.
+        This part is optional, but helps if the filter options dialog is a bit
+        more complex e.g. has some tabs etc.
+       -->
+    </para>
+    <figure>
+      <title><quote>Spinning Globe</quote> options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/animation/spinning-globe.png" />
+        </imageobject>
+      </mediaobject>
+    </figure>
+
+    <variablelist>
+      <varlistentry>
+        <term>Frames</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Turn from left to right</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Transparent background</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <!--Index to n colors (0 = remain RGB)-->
+      <varlistentry>
+        <term>Index to n colors</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Work on copy</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
diff --git a/src/filters/animation/waves.xml b/src/filters/animation/waves.xml
new file mode 100644
index 0000000..52ba6de
--- /dev/null
+++ b/src/filters/animation/waves.xml
@@ -0,0 +1,115 @@
+<?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";>
+
+<sect2 id="script-fu-waves-anim">
+  <title>Waves</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Animation</secondary>
+    <tertiary>Waves</tertiary>
+  </indexterm>
+  <indexterm><primary>Waves</primary></indexterm>
+
+  <sect3>
+    <title>Overview</title>
+
+    <figure>
+      <title>Example for the <quote>Waves</quote> filter</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg" />
+        </imageobject>
+        <caption>
+          <para>Original image</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/animation/taj-waves.jpg" />
+        </imageobject>
+        <caption>
+          <para>A <quote>Wave</quote> frame</para>
+        </caption>
+      </mediaobject>
+    </figure>
+
+    <para>
+      <!--
+        Describe what the filter does, which algorithms it uses.
+        Give the user an idea what to use the filter for
+       -->
+    </para>
+  </sect3>
+
+
+  <sect3>
+    <title>Activating the filter</title>
+    <para>
+      This filter is found in the image window menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Animation</guisubmenu>
+        <guimenuitem>Waves</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <para>
+      <!--
+        Describe how the filter options are organized in general.
+        This part is optional, but helps if the filter options dialog is a bit
+        more complex e.g. has some tabs etc.
+       -->
+    </para>
+    <figure>
+      <title><quote>Waves</quote> options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/animation/waves.png" />
+        </imageobject>
+      </mediaobject>
+    </figure>
+
+    <variablelist>
+      <varlistentry>
+        <term>Amplitude</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Wavelength</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Number of frames</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Invert direction</term>
+        <listitem>
+          <para>
+            TODO
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>



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