[gimp-help-2] Rearrange Interpolation docs
- From: Ulf-D. Ehlert <ulfehlert src gnome org>
- To: svn-commits-list gnome org
- Subject: [gimp-help-2] Rearrange Interpolation docs
- Date: Tue, 21 Jul 2009 10:26:41 +0000 (UTC)
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]
