[gimp-help-2] Rearrange Interpolation docs



commit daf4b276f01c4fe8d82b7f8c6b98e5e445be3c0c
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date:   Tue Jul 21 12:11:48 2009 +0200

    Rearrange Interpolation docs
    
    Move description of interpolation methods from glossary to
    "Transform Tools" (Common Features).

 src/filters/light_effects/perspective-shadow.xml |  115 ++++++++++------------
 src/glossary/glossary.xml                        |   43 +-------
 src/menus/layer/scale.xml                        |   72 ++++++++------
 src/toolbox/tool-transform.xml                   |   63 +++++++++++--
 src/using/preferences/prefs-tool-options.xml     |   67 ++++++++++---
 5 files changed, 208 insertions(+), 152 deletions(-)
---
diff --git a/src/filters/light_effects/perspective-shadow.xml b/src/filters/light_effects/perspective-shadow.xml
index 1814cd0..cd884c7 100644
--- a/src/filters/light_effects/perspective-shadow.xml
+++ b/src/filters/light_effects/perspective-shadow.xml
@@ -1,23 +1,14 @@
 <?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";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2008-02-04 kost: added 'no'
   2007-12-29 MikaS : added 'fr'
   2007-10-06 ude: created 'en','de'
 -->
 <sect2 id="script-fu-perspective-shadow">
-<!--  <sect2info>
-    <revhistory>
-      <revision>
-        <revnumber>$Revision$</revnumber>
-        <date>2007-10-06</date>
-        <authorinitials>ude</authorinitials>
-      </revision>
-    </revhistory>
-  </sect2info>-->
-  <title>
-    <phrase>Perspective</phrase>
-  </title>
+  <title>Perspective</title>
+
   <indexterm>
     <primary>Filters</primary>
     <secondary>Light and Shadow</secondary>
@@ -26,19 +17,15 @@
   <indexterm>
     <primary>Perspective</primary>
   </indexterm>
+
   <sect3>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+    <title>Overview</title>
     <figure>
-      <title>
-        <phrase>
-          Example for the <quote>Perspective</quote> filter
-        </phrase>
-      </title>
+      <title>Example for the <quote>Perspective</quote> filter</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/perspective-shadow-orig.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/perspective-shadow-orig.jpg"/>
         </imageobject>
         <caption>
           <para>Original image</para>
@@ -46,7 +33,8 @@
       </mediaobject>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/examples/perspective-shadow-applied.jpg" format="JPG"/>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/perspective-shadow-applied.jpg"/>
         </imageobject>
         <caption>
           <para><quote>Perspective</quote> applied</para>
@@ -64,26 +52,27 @@
       background to make the shadow visible.
     </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Activate the filter</phrase>
-    </title>
+    <title>Activate the filter</title>
     <para>
       You can access this filter in the image window menu through
-      <menuchoice><guimenu>Filters</guimenu><guisubmenu>Light and Shadow</guisubmenu><guimenuitem>Perspective</guimenuitem></menuchoice>.
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Light and Shadow</guisubmenu>
+        <guimenuitem>Perspective</guimenuitem>
+      </menuchoice>.
     </para>
   </sect3>
+
   <sect3>
-    <title>
-      <phrase>Options</phrase>
-    </title>
+    <title>Options</title>
     <figure>
-      <title>
-        <phrase><quote>Perspective</quote> options</phrase>
-      </title>
+      <title><quote>Perspective</quote> options</title>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/filters/options-light-perspective-shadow.png" format="PNG"/>
+          <imagedata format="PNG"
+            fileref="images/filters/options-light-perspective-shadow.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -101,12 +90,11 @@
             as source of light.
           </para>
           <figure>
-            <title>
-              <phrase><quote>Angle</quote> example</phrase>
-            </title>
+            <title><quote>Angle</quote> example</title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/examples/perspective-shadow-angle15.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/perspective-shadow-angle15.png"/>
               </imageobject>
               <caption>
                 <para>Angle 15°</para>
@@ -114,7 +102,8 @@
             </mediaobject>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/examples/perspective-shadow-default.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/perspective-shadow-default.png"/>
               </imageobject>
               <caption>
                 <para>Angle 45° (default)</para>
@@ -122,7 +111,8 @@
             </mediaobject>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/examples/perspective-shadow-angle105.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/perspective-shadow-angle105.png"/>
               </imageobject>
               <caption>
                 <para>Angle 105° (90° + 15°)</para>
@@ -146,13 +136,11 @@
             of shadow</guilabel> must not exceed the distance of horizon.
           </para>
           <figure>
-            <title>
-              <phrase><quote>Distance of horizon</quote> example
-              </phrase>
-            </title>
+            <title><quote>Distance of horizon</quote> example</title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/examples/perspective-shadow-distance.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/perspective-shadow-distance.png"/>
               </imageobject>
               <caption>
                 <para>
@@ -186,12 +174,11 @@
             horizon</guilabel> - you can't go beyond the horizon.
           </para>
           <figure>
-            <title>
-              <phrase><quote>Length of Shadow</quote> example</phrase>
-            </title>
+            <title><quote>Length of Shadow</quote> example</title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/examples/perspective-shadow-default.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/perspective-shadow-default.png"/>
               </imageobject>
               <caption>
                 <para>Length = 1.0 (default)</para>
@@ -199,7 +186,8 @@
             </mediaobject>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/examples/perspective-shadow-length15.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/perspective-shadow-length15.png"/>
               </imageobject>
               <caption>
                 <para>Length = 1.5</para>
@@ -212,17 +200,17 @@
         <term>Blur radius</term>
         <listitem>
           <para>
-            After creating the shadow, a <link linkend="plug-in-gauss">Gaussian blur</link> with the specified
+            After creating the shadow, a
+            <link linkend="plug-in-gauss">Gaussian blur</link> with the specified
             radius is applied to the shadow layer, resulting in the realistic
             appearance of the shadow.
           </para>
           <figure>
-            <title>
-              <phrase>Blur example</phrase>
-            </title>
+            <title>Blur example</title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/examples/perspective-shadow-default.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/perspective-shadow-default.png"/>
               </imageobject>
               <caption>
                 <para>Blur radius = 3 (default)</para>
@@ -230,7 +218,8 @@
             </mediaobject>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/examples/perspective-shadow-noblur.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/perspective-shadow-noblur.png"/>
               </imageobject>
               <caption>
                 <para>Without blur (blur radius = 0)</para>
@@ -257,7 +246,8 @@
             the shadow (see <xref linkend="gimp-layer-properties"/>). It
             defaults to 80%, but you may select any other value from 0 (full
             transparency) to 100 (full opacity) here. After applying the
-            filter to an image you can change the opacity in the <link linkend="gimp-layer-dialog">layers dialog</link>.
+            filter to an image you can change the opacity in the
+            <link linkend="gimp-layer-dialog">layers dialog</link>.
           </para>
         </listitem>
       </varlistentry>
@@ -265,8 +255,9 @@
         <term>Interpolation</term>
         <listitem>
           <para>
-            This drop-down list lets you choose the method of <link linkend="glossary-interpolation">interpolation</link> used when
-            the shadow layer is transformed, for example rotated by the
+            This drop-down list lets you choose the method of
+            <link linkend="glossary-interpolation">interpolation</link> used
+            when the shadow layer is transformed, for example rotated by the
             specified angle. Using <guilabel>None</guilabel> will usually
             result in aliasing, using any interpolation method may change the
             color of the shadow in some areas. <guilabel>Linear</guilabel> is
@@ -292,7 +283,8 @@
             </title>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/examples/perspective-shadow-resize.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/perspective-shadow-resize.png"/>
               </imageobject>
               <caption>
                 <para>Allow resizing</para>
@@ -300,7 +292,8 @@
             </mediaobject>
             <mediaobject>
               <imageobject>
-                <imagedata fileref="images/filters/examples/perspective-shadow-noresize.png" format="PNG"/>
+                <imagedata format="PNG"
+                  fileref="images/filters/examples/perspective-shadow-noresize.png"/>
               </imageobject>
               <caption>
                 <para>Don't allow resizing</para>
diff --git a/src/glossary/glossary.xml b/src/glossary/glossary.xml
index 2fa0e58..cde5842 100644
--- a/src/glossary/glossary.xml
+++ b/src/glossary/glossary.xml
@@ -1131,46 +1131,15 @@
         pixels in the transformed image. <acronym>GIMP</acronym> offers
         three interpolation methods, which differ in quality and speed. In
         general, the better the quality, the more time the interpolation
-        takes. The methods are:
+        takes (see
+        <link linkend="gimp-tool-interpolation-methods">Interpolation
+        methods</link>).
       </para>
-      <!--TODO: these details should better go to
-          src/toolbox/tool-transform.xml (transform tools - common features-->
-      <itemizedlist>
-        <listitem>
-          <para>
-            <emphasis>None</emphasis> (sometimes called <quote>Nearest
-            Neighbor</quote>): The color of each pixel is copied from its
-            closest neighboring pixel in the original image. This often
-            results in aliasing (the <quote>stair-step</quote> effect) and a
-            coarse image, but it is the fastest method.
-          </para>
-        </listitem>
-        <listitem>
-          <para>
-            <emphasis>Linear</emphasis> (sometimes called
-            <quote>Bilinear</quote>): The color of each pixel is computed as
-            the average color of the four closest pixels in the original
-            image. This gives a satisfactory result for most images and is a
-            good compromise between speed and quality.
-          </para>
-        </listitem>
-        <listitem>
-          <para>
-            <emphasis>Cubic</emphasis> (sometimes called
-            <quote>Bicubic</quote>): The color of each pixel is computed as
-            the average color of the eight closest pixels in the original
-            image. This usually gives the best result, but it naturally takes
-            more time.
-          </para>
-        </listitem>
-      </itemizedlist>
-      <para><acronym>GIMP</acronym> uses interpolation when you
+      <para>
+        <acronym>GIMP</acronym> uses interpolation when you
         <link linkend="gimp-image-scale">Scale</link> an image,
         <link linkend="gimp-layer-scale">Scale</link> a layer, and when you
-        <link linkend="gimp-tools-transform">Transform</link> an image. You
-        can also set the default interpolation method in the
-        <link linkend="gimp-prefs-tool-options">Tools Options Preferences</link>
-        dialog.
+        <link linkend="gimp-tools-transform">Transform</link> an image.
       </para>
     </glossdef>
   </glossentry>
diff --git a/src/menus/layer/scale.xml b/src/menus/layer/scale.xml
index 4104737..ae789f0 100644
--- a/src/menus/layer/scale.xml
+++ b/src/menus/layer/scale.xml
@@ -125,36 +125,48 @@
             <varlistentry>
               <term>Interpolation</term>
               <listitem>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>None</guilabel>:
-                      No interpolation is used. Pixels are simply enlarged
-                      or removed, as they are when zooming. This method is
-                      low in quality, but very fast.
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Linear</guilabel>:
-                      This method is a good compromise between speed and
-                      quality.
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Cubic</guilabel>:
-                      This method takes a lot of time, but it produces the
-                      best results.
-                    </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Sinc (Lanczos-3)</guilabel>:
-                      The Lanczos (pronounce <quote>lanzosh</quote>) method
-                      uses the
-                      Sinc<footnote><para>Sinus cardinalis</para></footnote>
-                      mathematical function to perform a high quality
-                      interpolation.
-                    </para>
-                  </listitem>
-                </itemizedlist>
+                <variablelist>
+                  <varlistentry>
+                    <term>None</term>
+                    <listitem>
+                      <para>
+                        No interpolation is used. Pixels are simply enlarged
+                        or removed, as they are when zooming. This method is
+                        low in quality, but very fast.
+                      </para>
+                    </listitem>
+                  </varlistentry>
+                  <varlistentry>
+                    <term>Linear</term>
+                    <listitem>
+                      <para>
+                        This method is a good compromise between speed and
+                        quality.
+                      </para>
+                    </listitem>
+                  </varlistentry>
+                  <varlistentry>
+                    <term>Cubic</term>
+                    <listitem>
+                      <para>
+                        This method takes a lot of time, but it produces the
+                        best results.
+                      </para>
+                    </listitem>
+                  </varlistentry>
+                  <varlistentry>
+                    <term>Sinc (Lanczos3)</term>
+                    <listitem>
+                      <para>
+                        The Lanczos (pronounce <quote>lanzosh</quote>) method
+                        uses the
+                        Sinc<footnote><para>Sinus cardinalis</para></footnote>
+                        mathematical function to perform a high quality
+                        interpolation.
+                      </para>
+                    </listitem>
+                  </varlistentry>
+                </variablelist>
               </listitem>
             </varlistentry>
           </variablelist>
diff --git a/src/toolbox/tool-transform.xml b/src/toolbox/tool-transform.xml
index e6d18b9..d82b818 100644
--- a/src/toolbox/tool-transform.xml
+++ b/src/toolbox/tool-transform.xml
@@ -2,7 +2,8 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history
-  2009 04-08 j.h: made some explanations clearer, I hope
+  2009-07-20 ude: moved interpolation options here (from glossary)
+  2009-04-08 j.h: made some explanations clearer, I hope
   2009-03-17 j.h: updated to v2.6. Added Opacity
   2008-02-26 kost: updated 'no' v2.4
   2007-06-10 kost: added 'no'
@@ -123,15 +124,63 @@
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
+      <varlistentry id="gimp-tool-interpolation-methods">
         <term>Interpolation</term>
         <listitem>
           <para>
-            The <guilabel>Interpolation</guilabel> drop-down list lets
-            you choose the quality of the transformation. For more
-            information about the different methods that can be employed,
-            see the glossary entry
-            <link linkend="glossary-interpolation">Interpolation</link>.
+            This drop-down list lets you choose the method and thus the
+            quality of the transformation:
+          </para>
+          <variablelist>
+            <varlistentry>
+              <term>None</term>
+              <listitem>
+                <para>
+                  The color of each pixel is copied from its closest
+                  neighboring pixel in the original image. This often results
+                  in aliasing (the <quote>stair-step</quote> effect) and a
+                  coarse image, but it is the fastest method. Sometimes this
+                  method is called <quote>Nearest Neighbor</quote>.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>Linear</term>
+              <listitem>
+                <para>
+                  The color of each pixel is computed as the average color of
+                  the four closest pixels in the original image. This gives a
+                  satisfactory result for most images and is a good compromise
+                  between speed and quality. Sometimes this method is called
+                  <quote>Bilinear</quote>.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>Cubic</term>
+              <listitem>
+                <para>
+                  The color of each pixel is computed as the average color of
+                  the eight closest pixels in the original image. This usually
+                  gives the best result, but it naturally takes more time.
+                  Sometimes this method is called <quote>Bicubic</quote>.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>Sinc (Lanczos3)</term>
+              <listitem>
+                <para>
+                  The Lanczos3 method uses the Sinc mathematical function and
+                  performs a high quality interpolation.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
+          <para>
+            You can set the default interpolation method in the
+            <link linkend="gimp-prefs-tool-options">Tools Options
+            Preferences</link> dialog.
           </para>
         </listitem>
       </varlistentry>
diff --git a/src/using/preferences/prefs-tool-options.xml b/src/using/preferences/prefs-tool-options.xml
index d453d02..e59a523 100644
--- a/src/using/preferences/prefs-tool-options.xml
+++ b/src/using/preferences/prefs-tool-options.xml
@@ -1,5 +1,6 @@
 <?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";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!--  section history:
   2008-04-14 Mr.Dust : added 'ko'
   2007-03-23 KoSt: added 'no'
@@ -8,6 +9,7 @@
 -->
 <sect2 id="gimp-prefs-tool-options">
   <title>Tool Options</title>
+
   <indexterm>
     <primary>Dialogs</primary>
     <secondary>Preferences</secondary>
@@ -22,7 +24,8 @@
     <title>Tool Options Preferences</title>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/preferences/prefs-tool-options.png" format="PNG"/>
+        <imagedata format="PNG"
+          fileref="images/preferences/prefs-tool-options.png"/>
       </imageobject>
       <caption>
         <para>
@@ -92,22 +95,52 @@
         <listitem>
           <para>
             When you scale something, each pixel in the result is calculated
-            by interpolating several pixels in the source. This option
-            determines the default interpolation method: it can always be
-            changed, though, in the Tool Options dialog. There are three
-            choices:
-          </para>
-          <para><emphasis>None</emphasis> is fastest, but quite crude: you should
-            only consider using it if your machine is very seriously
-            speed-impaired.
-          </para>
-          <para><emphasis>Linear</emphasis> is the default, and is good
-            enough for most purposes.
-          </para>
-          <para><emphasis>Cubic</emphasis> is the best (although
-            it can actually look worse than Linear for some types of
-            images), but also the slowest.
+            by <link linkend="glossary-interpolation">interpolating</link>
+            several pixels in the source. This option determines the default
+            interpolation method: it can always be changed, though, in the
+            Tool Options dialog.
           </para>
+          <variablelist>
+            <para>There are four choices:</para>
+            <varlistentry>
+              <term>None</term>
+              <listitem>
+                <para>
+                  This is the fastest method, but it's quite crude: you should
+                  only consider using it if your machine is very seriously
+                  speed-impaired.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>Linear</term>
+              <listitem>
+                <para>
+                  This used to be the default, and is good enough for most
+                  purposes.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>Cubic</term>
+              <listitem>
+                <para>
+                  This is the best choice (although it can actually look worse
+                  than Linear for some types of images), but also the slowest.
+                  Since <acronym>GIMP</acronym> 2.6, this method is the
+                  default.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>Sinc (Lanczos3)</term>
+              <listitem>
+                <para>
+                  This method performs a high quality interpolation.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
         </listitem>
       </varlistentry>
     </variablelist>



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