[gimp-help-2] Enhance Distort filter source files
- From: Ulf-D. Ehlert <ulfehlert src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Enhance Distort filter source files
- Date: Mon, 17 May 2010 18:42:02 +0000 (UTC)
commit b03087cde9e2e4400f31dcc56e83ca3c260c00c9
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date: Mon May 17 20:34:53 2010 +0200
Enhance Distort filter source files
Mostly formal changes like removing duplicate menu entries,
replacing <itemizedlist>s with <variablelist>s.
src/filters/distort/IWarp.xml | 362 ++++++++++++++++---------------
src/filters/distort/curve_bend.xml | 60 +++---
src/filters/distort/emboss.xml | 57 +++--
src/filters/distort/lens-distortion.xml | 3 +-
src/filters/distort/mosaic.xml | 230 ++++++++++----------
src/filters/distort/newsprint.xml | 97 ++++----
src/filters/distort/pagecurl.xml | 10 +-
src/filters/distort/polarcoords.xml | 10 +-
src/filters/distort/ripple.xml | 6 +-
src/filters/distort/shift.xml | 10 +-
src/filters/distort/video.xml | 2 +-
src/filters/distort/vpropagate.xml | 6 +-
src/filters/distort/waves.xml | 55 ++---
src/filters/distort/whirlpinch.xml | 35 ++--
src/filters/distort/wind.xml | 136 +++++++-----
15 files changed, 553 insertions(+), 526 deletions(-)
---
diff --git a/src/filters/distort/IWarp.xml b/src/filters/distort/IWarp.xml
index ddd16dd..b85531c 100644
--- a/src/filters/distort/IWarp.xml
+++ b/src/filters/distort/IWarp.xml
@@ -6,7 +6,7 @@
2007-08-13 Added Spanish translation by AntI
2007-04-24 KoSt: added 'no'
2005-12-07 replaced <simplesect> by <sect3> by lexa
- 050904 de added by axel.wernicke
+ 2005-09-04 de added by axel.wernicke
-->
<sect2 id="plug-in-iwarp">
<title>IWarp</title>
@@ -74,176 +74,194 @@
The first tab contains general options. The second tab holds animation
options.
</para>
- <variablelist>
- <varlistentry>
- <term>Settings</term>
- <listitem>
- <figure>
- <title><quote>IWarp</quote> filter options (Settings tab)</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/distort/iwarp-options-1.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- The Settings tab allows you to set parameters which will affect
- the preview you are working on. So, you can apply different deform
- modes to different parts of the preview.
- </para>
- <variablelist>
- <varlistentry>
- <term>Preview</term>
- <listitem>
- <para>
- Here, the Preview is your work space: You click on the
- Preview and drag mouse pointer. The underlying part of image
- will be deformed according to the settings you have chosen.
- If your work is not convenient, press the
- <emphasis>Reset</emphasis> button.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Deform Mode</term>
- <listitem>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Move</guilabel>: Allows you to
- <emphasis>stretch</emphasis> parts of the image.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Remove</guilabel>: This remove the distortion
- where you drag the mouse pointer, partially or
- completely. This allows you to avoid pressing Reset
- button, working on the whole image. Be careful when
- working on an animation: this option will affect one
- frame only.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Grow</guilabel>: This option inflates the
- pointed pattern.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Shrink</guilabel>: Self explanatory.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Swirl CCW </guilabel>: Create a vortex counter
- clockwise.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Swirl CW </guilabel>: Create a vortex clockwise.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Deform Radius</term>
- <listitem>
- <para>
- Defines the radius, in pixels (5-100), of the filter action
- circle around the pixel pointed by the mouse.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Deform Amount</term>
- <listitem>
- <para>
- Sets how much out of shape your image will be put (0.0-1.0).
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Bilinear</term>
- <listitem>
- <para>
- This option smooths the IWarp effect.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- Adaptive Supersample
- </term>
- <listitem>
- <para>
- This option renders a better image at the cost of increased
- calculation.
- </para>
- <para><guilabel>Max Depth</guilabel>: this value limits the maximum
- sampling iterations performed on each pixel.
- </para>
- <para><guilabel>Threshold</guilabel>: when the value difference
- between a pixel and the adjacent ones exceeds this threshold
- a new sampling iteration is performed on the pixel.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Animate</term>
- <listitem>
- <figure>
- <title><quote>IWarp</quote> filter options (Animation tab)</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/distort/iwarp-options-2.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- This tab allows to generate several intermediate images between
- the original image and the final deformation of this image. You
- can play this animation thanks to the
- <link linkend="plug-in-animationplay">Playback</link> plug-in.
- </para>
- <variablelist>
- <varlistentry>
- <term>Number of Frames</term>
- <listitem>
- <para>
- That's the number of images in your animation (2-100). These
- frames are stored as layers attached to your image. Use the
- XCF format when saving it.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Reverse</term>
- <listitem>
- <para>
- This option plays the animation backwards.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Ping-Pong</term>
- <listitem>
- <para>
- When the animation ends one way, it goes backwards.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- </variablelist>
+
+ <sect4>
+ <title>Settings</title>
+ <figure>
+ <title><quote>IWarp</quote> filter options (Settings tab)</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/distort/iwarp-options-1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ The Settings tab allows you to set parameters which will affect
+ the preview you are working on. So, you can apply different deform
+ modes to different parts of the preview.
+ </para>
+
+ <variablelist>
+ <varlistentry>
+ <term>Preview</term>
+ <listitem>
+ <para>
+ Here, the Preview is your work space: You click on the
+ Preview and drag mouse pointer. The underlying part of image
+ will be deformed according to the settings you have chosen.
+ If your work is not convenient, press the
+ <emphasis>Reset</emphasis> button.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Deform Mode</term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Move</guilabel></term>
+ <listitem>
+ <para>
+ Allows you to <emphasis>stretch</emphasis> parts of the
+ image.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Remove</guilabel></term>
+ <listitem>
+ <para>
+ This remove the distortion where you drag the mouse
+ pointer, partially or completely. This allows you to avoid
+ pressing Reset button, working on the whole image. Be
+ careful when working on an animation: this option will
+ affect one frame only.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Grow</guilabel></term>
+ <listitem>
+ <para>
+ This option inflates the pointed pattern.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Shrink</guilabel></term>
+ <listitem>
+ <para>Self explanatory.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Swirl CCW</guilabel></term>
+ <listitem>
+ <para>Create a vortex counter clockwise.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Swirl CW</guilabel></term>
+ <listitem>
+ <para>Create a vortex clockwise.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Deform radius</term>
+ <listitem>
+ <para>
+ Defines the radius, in pixels (5-100), of the filter action
+ circle around the pixel pointed by the mouse.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Deform amount</term>
+ <listitem>
+ <para>
+ Sets how much out of shape your image will be put (0.0-1.0).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Bilinear</term>
+ <listitem>
+ <para>
+ This option smooths the IWarp effect.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Adaptive supersample</term>
+ <listitem>
+ <para>
+ This option renders a better image at the cost of increased
+ calculation.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Max Depth</guilabel></term>
+ <listitem>
+ <para>
+ This value limits the maximum sampling iterations
+ performed on each pixel.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Threshold</guilabel></term>
+ <listitem>
+ <para>
+ When the value difference between a pixel and the adjacent
+ ones exceeds this threshold a new sampling iteration is
+ performed on the pixel.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
+
+ <sect4>
+ <title>Animate</title>
+ <figure>
+ <title><quote>IWarp</quote> filter options (Animation tab)</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/distort/iwarp-options-2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ This tab allows to generate several intermediate images between
+ the original image and the final deformation of this image. You
+ can play this animation thanks to the
+ <link linkend="plug-in-animationplay">Playback</link> plug-in.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Number of frames</term>
+ <listitem>
+ <para>
+ That's the number of images in your animation (2-100). These
+ frames are stored as layers attached to your image. Use the
+ XCF format when saving it.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Reverse</term>
+ <listitem>
+ <para>
+ This option plays the animation backwards.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Ping pong</term>
+ <listitem>
+ <para>
+ When the animation ends one way, it goes backwards.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect4>
</sect3>
</sect2>
diff --git a/src/filters/distort/curve_bend.xml b/src/filters/distort/curve_bend.xml
index 44ade9f..6728f94 100644
--- a/src/filters/distort/curve_bend.xml
+++ b/src/filters/distort/curve_bend.xml
@@ -82,7 +82,7 @@
</para>
<variablelist>
<varlistentry>
- <term>Preview Once</term>
+ <term>Preview once</term>
<listitem>
<para>
This button allows you to update the preview each time you
@@ -96,7 +96,7 @@
<para>
With this option, preview is changed in real time. This
needs much calculation and may lengthen work. It is
- particularly evident when using "Rotation".
+ particularly evident when using <quote>Rotation</quote>.
</para>
</listitem>
</varlistentry>
@@ -115,12 +115,13 @@
counter-clockwise). 0 is default setting: The curve will be
applied from the upper border and/or from the lower. Set to
90, it will be applied from left border and/or from the
- right one.
+ right one.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Smoothing and Antialiasing</term>
+ <term>Smoothing</term>
+ <term>Antialiasing</term>
<listitem>
<para>
The distort process may create hard and stepped borders.
@@ -129,7 +130,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Work on Copy</term>
+ <term>Work on copy</term>
<listitem>
<para>
This option creates a new layer called
@@ -144,7 +145,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Modify Curve</term>
+ <term>Modify Curves</term>
<listitem>
<para>
In this grid, you have a marked horizontal line, with a node at
@@ -155,14 +156,15 @@
</para>
<para>
You can have only two curves on the grid, one for the so named
- "upper" border and the other for the so named "lower" border. You
- can activate one of them by checking the
- <emphasis>Upper</emphasis> or <emphasis>Lower</emphasis> radio
- button.
+ <quote>upper</quote> border and the other for the so named
+ <quote>lower</quote> border. You can activate one of them by
+ checking the <guilabel>Upper</guilabel> or
+ <guilabel>Lower</guilabel> radio button.
</para>
<para>
- If you use the <emphasis>Curve Type Free</emphasis> option, the
- curve you draw will replace the active curve.
+ If you use the <guilabel>Free</guilabel> <emphasis>Curve
+ Type</emphasis> option, the curve you draw will replace the active
+ curve.
</para>
</listitem>
</varlistentry>
@@ -171,14 +173,14 @@
<listitem>
<para>
There you can select whether the active curve must be applied to
- the <emphasis>Superior (or left)</emphasis> or the
- <emphasis>Inferior (or right)</emphasis> border, according to the
+ the <guilabel>Upper</guilabel> or the <guilabel>Lower</guilabel>
+ border, according to the
rotation.
</para>
<caution>
<para>
Remember that the curve border depends on the rotation. For
- example, with <emphasis>Rotate</emphasis> = 90° the upper curve
+ example, with <guilabel>Rotate</guilabel> = 90° the upper curve
will actually be applied to the left border.
</para>
</caution>
@@ -188,11 +190,11 @@
<term>Curve Type</term>
<listitem>
<para>
- With the <emphasis>Smooth</emphasis>, you get automatically a well
+ With the <guilabel>Smooth</guilabel>, you get automatically a well
rounded curve when you drag a node.
</para>
<para>
- The <emphasis>Free</emphasis> option allows you to draw a curve
+ The <guilabel>Free</guilabel> option allows you to draw a curve
freely. It will replace the active curve.
</para>
</listitem>
@@ -204,50 +206,40 @@
<varlistentry>
<term>Copy</term>
<listitem>
- <para>
- Copy the active curve to the other border.
- </para>
+ <para>Copy the active curve to the other border.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mirror</term>
<listitem>
- <para>
- Mirror the active curve to the other border.
- </para>
+ <para>Mirror the active curve to the other border.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Swap</term>
<listitem>
<para>
- Swap the <quote>superior</quote> and
- <quote>inferior</quote> curves.
+ Swap the <guilabel>Upper</guilabel> and
+ <guilabel>Lower</guilabel> curves.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Reset</term>
<listitem>
- <para>
- Reset the active curve.
- </para>
+ <para>Reset the active curve.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Open</term>
<listitem>
- <para>
- Load the curve from a file.
- </para>
+ <para>Load the curve from a file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Save</term>
<listitem>
- <para>
- Save the curve to a file.
- </para>
+ <para>Save the curve to a file.</para>
</listitem>
</varlistentry>
</variablelist>
diff --git a/src/filters/distort/emboss.xml b/src/filters/distort/emboss.xml
index 39833df..0704991 100644
--- a/src/filters/distort/emboss.xml
+++ b/src/filters/distort/emboss.xml
@@ -44,13 +44,13 @@
</mediaobject>
</figure>
<para>
- You can use it only with RGB images. If your image is grayscale, it
- will be grayed out in the menu.
+ This filter stamps and carves the active layer or selection, giving it
+ relief with bumps and hollows. Bright areas are raised and dark ones are
+ carved. You can vary the lighting.
</para>
<para>
- It stamps and carves the active layer or selection, giving it relief
- with bumps and hollows. Bright areas are raised and dark ones are
- carved. You can vary the lighting.
+ You can use the filter only with RGB images. If your image is grayscale,
+ it will be grayed out in the menu.
</para>
</sect3>
@@ -84,32 +84,42 @@
<para>
All your setting changes will appear in the Preview without
affecting the image until you click on <guilabel>OK</guilabel>.
- Don't keep <emphasis>Do Preview</emphasis> checked if your
- computer is too much slow.
+ Don't keep <guilabel>Preview</guilabel> checked if your computer
+ is too slow.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Function</term>
<listitem>
- <para>
- <guilabel>Bumpmap</guilabel>: Relief is smooth and colors are
- preserved.
- </para>
- <para>
- <guilabel>Emboss</guilabel>: It turns your image to grayscale
- and relief is more marked, looking like metal.
- </para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Bumpmap</guilabel></term>
+ <listitem>
+ <para>
+ Relief is smooth and colors are preserved.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Emboss</guilabel></term>
+ <listitem>
+ <para>
+ It turns your image to grayscale and relief is more marked,
+ looking like metal.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term>Azimuth</term>
<listitem>
<para>
- <guilabel>Azimuth</guilabel>: This is about lighting
- according to the points of the compass (0 - 360). If you
- suppose South is at the top of your image, then East (0°) is
- on the left. Increasing value goes counter-clockwise.
+ This is about lighting according to the points of the compass (0 -
+ 360). If you suppose South is at the top of your image, then East
+ (0°) is on the left. Increasing value goes counter-clockwise.
</para>
</listitem>
</varlistentry>
@@ -117,9 +127,8 @@
<term>Elevation</term>
<listitem>
<para>
- <guilabel>Elevation</guilabel>: That's height from
- horizon (0°), in principle up to zenith (90°), but here up
- to the opposite horizon (180°).
+ That's height from horizon (0°), in principle up to zenith (90°),
+ but here up to the opposite horizon (180°).
</para>
</listitem>
</varlistentry>
@@ -127,8 +136,8 @@
<term>Depth</term>
<listitem>
<para>
- <guilabel>Depth</guilabel> Seems to be the distance of the
- light source. Light decreases when value increases.
+ Seems to be the distance of the light source. Light decreases when
+ value increases.
</para>
</listitem>
</varlistentry>
diff --git a/src/filters/distort/lens-distortion.xml b/src/filters/distort/lens-distortion.xml
index dd02980..2f37175 100644
--- a/src/filters/distort/lens-distortion.xml
+++ b/src/filters/distort/lens-distortion.xml
@@ -249,7 +249,8 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>X shift; Y shift</term>
+ <term>X shift</term>
+ <term>Y shift</term>
<listitem>
<para>
These two options specify the shift of the image produced by not
diff --git a/src/filters/distort/mosaic.xml b/src/filters/distort/mosaic.xml
index 0b2c956..c78242d 100644
--- a/src/filters/distort/mosaic.xml
+++ b/src/filters/distort/mosaic.xml
@@ -76,159 +76,155 @@
<varlistentry>
<term>Preview</term>
<listitem>
+ <!-- changed 2010-05-17 ude: looks like just the opposite is true...
+ Note that the preview displays the whole image, even if the final
+ result will concern a selection.
+ -->
<para>
All your setting changes will appear in the Preview without
affecting the image until you click on <guilabel>OK</guilabel>.
- Note that the preview displays the whole image, even if the
- final result will concern a selection. Don't keep
- <emphasis>Do Preview</emphasis> checked if your computer is too
- much slow.
+ Note that the preview displays only a part of the whole image if
+ the filter is applied to an selection. Don't keep
+ <guilabel>Preview</guilabel> checked if your computer is too slow.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Options</term>
+ <term>Tiling primitives</term>
<listitem>
+ <para>
+ This option is self-understanding:
+ </para>
<variablelist>
<varlistentry>
- <term>Antialiasing</term>
- <listitem>
- <para>
- This option reduces the stepped aspect that may have
- borders.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Color Averaging</term>
+ <term><guilabel>Squares</guilabel></term>
<listitem>
- <para>
- When this option is unchecked, the image drawing can be
- recognized inside tiles. When checked, the colors inside
- tiles are averaged into a single color.
- </para>
+ <para>4 edges</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Allows Tile Splitting</term>
+ <term><guilabel>Hexagons</guilabel></term>
<listitem>
- <para>
- This option splits tiles in areas with many colors, and
- so allows a better color gradation and more details in
- these areas.
- </para>
+ <para>6 edges (hexa = 6)</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Pitted Surfaces</term>
+ <term><guilabel>Octagons & squares</guilabel></term>
<listitem>
- <para>
- With this option tile surface looks pitted.
- </para>
+ <!--TODO: check: it looks like "squares" is a lie-->
+ <para>8 or 4 edges (octa = 8)</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>FG/BG Lighting</term>
+ <term><guilabel>Triangles</guilabel></term>
<listitem>
- <para>
- When this option is checked, tiles are lit by the
- foreground color of the toolbox, and shadow is colored by
- the background color. Joins have the background color.
- </para>
+ <para>3 edges (tri = 3)</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
- <term>Parameter setting</term>
+ <term>Tile size</term>
<listitem>
- <variablelist>
- <varlistentry>
- <term>Tile Size</term>
- <listitem>
- <para>
- Slider and input box allow you to set the size of tile
- surface.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Tile Height</term>
- <listitem>
- <para>
- That's ledge, relief of tiles. Value is width of the lit
- border in pixels.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Tile Spacing</term>
- <listitem>
- <para>
- That's width of the join between tiles.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Tile Neatness</term>
- <listitem>
- <para>
- When set to 1, most of tiles have the same size. With 0
- value, size is determined at random and this may lead to
- shape variation.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Light Direction</term>
- <listitem>
- <para>
- By default light comes from the upper left corner
- (135°). You can change this direction from 0 to 360
- (counter clockwise).
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Color Variation</term>
- <listitem>
- <para><guilabel>Color Variation</guilabel>: Each tile has only one
- color. So, the number of colors is reduced, compared to the
- original image. Here, you can increase the number of colors,
- a little.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
+ <para>
+ Slider and input box allow you to set the size of tile
+ surface.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Tile height</term>
+ <listitem>
+ <para>
+ That's ledge, relief of tiles. Value is width of the lit
+ border in pixels.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Tile spacing</term>
+ <listitem>
+ <para>
+ That's width of the join between tiles.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Tile neatness</term>
+ <listitem>
+ <para>
+ When set to 1, most of tiles have the same size. With 0
+ value, size is determined at random and this may lead to
+ shape variation.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Light direction</term>
+ <listitem>
+ <para>
+ By default light comes from the upper left corner
+ (135°). You can change this direction from 0 to 360
+ (counter clockwise).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Color variation</term>
+ <listitem>
+ <para>
+ Each tile has only one color. So the number of colors is reduced,
+ compared to the original image. Here you can increase the number
+ of colors a little.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Antialiasing</term>
+ <listitem>
+ <para>
+ This option reduces the stepped aspect that may have
+ borders.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Color averaging</term>
+ <listitem>
+ <para>
+ When this option is unchecked, the image drawing can be
+ recognized inside tiles. When checked, the colors inside
+ tiles are averaged into a single color.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Allow tile splitting</term>
+ <listitem>
+ <para>
+ This option splits tiles in areas with many colors, and
+ so allows a better color gradation and more details in
+ these areas.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Pitted surfaces</term>
+ <listitem>
+ <para>
+ With this option tile surface looks pitted.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Tile Primitives</term>
+ <term>FG/BG lighting</term>
<listitem>
<para>
- This options are self-understanding:
+ When this option is checked, tiles are lit by the
+ foreground color of the toolbox, and shadow is colored by
+ the background color. Joins have the background color.
</para>
- <!--TODO: itemizedlist ==> variablelist-->
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Squares</guilabel>
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Hexagons</guilabel>: (hexa = 6)
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Octagons and Squares</guilabel>: (octa = 8)
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Triangles</guilabel>: (tri = 3)
- </para>
- </listitem>
- </itemizedlist>
</listitem>
</varlistentry>
</variablelist>
diff --git a/src/filters/distort/newsprint.xml b/src/filters/distort/newsprint.xml
index 89c3fee..5e502d4 100644
--- a/src/filters/distort/newsprint.xml
+++ b/src/filters/distort/newsprint.xml
@@ -72,10 +72,10 @@
<para>
Obviously, a large cell size results in a heavy loss in resolution! The
spots in the cells typically start off as circles, and grow to be
- diamond shaped. This change in shape is controlled by a <guilabel>spot
- function</guilabel>. By using different spot functions, the evolution
- in the shape of the spots as the cell goes from fully black to fully
- white may be controlled.
+ diamond shaped. This change in shape is controlled by a
+ <guilabel>Spot function</guilabel>. By using different spot
+ functions, the evolution in the shape of the spots as the cell goes from
+ fully black to fully white may be controlled.
</para>
</sect3>
@@ -106,13 +106,16 @@
<varlistentry>
<term>Preview</term>
<listitem>
+ <!-- changed 2010-05-17 ude: looks like just the opposite is true...
+ Note that the preview displays the whole image, even if the final
+ result will concern a selection.
+ -->
<para>
All your setting changes will appear in the Preview without
affecting the image until you click on <guilabel>OK</guilabel>.
- Note that the preview displays the whole image, even if the
- final result will concern a selection. Don't keep
- <emphasis>Do Preview</emphasis> checked if your computer is too
- much slow.
+ Note that the preview displays only a part of the whole image if
+ the filter is applied to an selection. Don't keep
+ <guilabel>Preview</guilabel> checked if your computer is too slow.
</para>
</listitem>
</varlistentry>
@@ -128,9 +131,8 @@
<term>Input SPI</term>
<listitem>
<para>
- <guilabel>Input SPI</guilabel>
- : Resolution of the original input image, in Samples Per
- Inch (SPI). This is automatically initialised to the input
+ Resolution of the original input image, in Samples Per Inch
+ (SPI). This is automatically initialised to the input
image's resolution.
</para>
</listitem>
@@ -138,16 +140,17 @@
<varlistentry>
<term>Output LPI</term>
<listitem>
- <para><guilabel>Output LPI</guilabel>: Desired output
- resolution, in Lines Per Inch (LPI).
+ <para>
+ Desired output resolution, in Lines Per Inch (LPI).
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Cell Size</term>
+ <term>Cell size</term>
<listitem>
- <para><guilabel>Cell Size</guilabel>: Resulting cell size, in
- pixels. Most often you will want to set this directly.
+ <para>
+ Resulting cell size, in pixels. Most often you will want to
+ set this directly.
</para>
</listitem>
</varlistentry>
@@ -161,61 +164,59 @@
<varlistentry>
<term>Separate To RGB, CMYK, Intensity</term>
<listitem>
- <para><guilabel>Separate To RGB, CMYK, Intensity</guilabel>:
- Select which colorspace you
- wish to operate in. In <emphasis>RGB</emphasis> mode, no
- colorspace conversion is performed. In
- <emphasis>CMYK</emphasis>, the image is first
+ <para>
+ Select which colorspace you wish to operate in. In
+ <emphasis>RGB</emphasis> mode, no colorspace conversion is
+ performed. In <emphasis>CMYK</emphasis>, the image is first
internally converted to CMYK, then each color channel is
- separately halftoned, before finally being
- recombined back to an RGB image.
- In <emphasis>Intensity</emphasis> mode, the
- image is internally converted to grayscale,
- halftoned, then the result used as the alpha channel
- for the input image. This is good for special
- effects, but requires a little experimentation to
- achieve best results. Hint: try CMYK if you don't know
- which to go for initially.
+ separately halftoned, before finally being recombined back
+ to an RGB image. In <emphasis>Intensity</emphasis> mode,
+ the image is internally converted to grayscale, halftoned,
+ then the result used as the alpha channel for the input
+ image. This is good for special effects, but requires a
+ little experimentation to achieve best results. Hint: try
+ CMYK if you don't know which to go for initially.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Black Pullout (%)</term>
+ <term>Black pullout (%)</term>
<listitem>
- <para><guilabel>Black Pullout (%)</guilabel> When doing
- RGB->CMYK conversion, how much K (black) should be used?
+ <para>
+ When doing RGB->CMYK conversion, how much K (black)
+ should be used?
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Lock Channels</term>
+ <term>Lock channels</term>
<listitem>
- <para><guilabel>Lock Channels</guilabel>: Make channel
- modifications apply to all channels.
+ <para>
+ Make channel modifications apply to all channels.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Factory Defaults</term>
<listitem>
- <para><guilabel>Factory Defaults</guilabel>: Restore the
- default settings which should give pleasing results.
+ <para>
+ Restore the default settings which should give pleasing
+ results.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Angle</term>
<listitem>
- <para><guilabel>Angle</guilabel>: Cell grid angle for this
- channel.
- </para>
+ <para>Cell grid angle for this channel.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Spot Function</term>
+ <term>Spot function</term>
<listitem>
- <para><guilabel>Spot Function</guilabel>: Spot function to
- be used for this channel (see preview in blue cell-boxes).
+ <para>
+ Spot function to be used for this channel (see preview in
+ blue cell-boxes).
</para>
</listitem>
</varlistentry>
@@ -238,10 +239,10 @@
<varlistentry>
<term>Oversample</term>
<listitem>
- <para><guilabel>Oversample</guilabel>: Number of subpixels to
- sample to produce each output pixel. Set to 1 to disable
- this feature. Warning: large numbers here will lead to
- very long filter runtimes!
+ <para>
+ Number of subpixels to sample to produce each output pixel.
+ Set to 1 to disable this feature. Warning: large numbers
+ here will lead to very long filter runtimes!
</para>
</listitem>
</varlistentry>
diff --git a/src/filters/distort/pagecurl.xml b/src/filters/distort/pagecurl.xml
index afe8eb4..c89c6f7 100644
--- a/src/filters/distort/pagecurl.xml
+++ b/src/filters/distort/pagecurl.xml
@@ -94,7 +94,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Shadow under curl</term>
+ <term>Shade under curl</term>
<listitem>
<para>
This is the shadow inside the cornet.
@@ -102,15 +102,17 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Use current gradient instead of FG/FB-color</term>
+ <term>Foreground / background colors</term>
+ <term>Current gradient</term>
+ <term>Current gradient (reversed)</term>
<listitem>
<para>
- This color refers to the outer face of the cornet.
+ This option refers to the outer face of the cornet.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Curl Opacity</term>
+ <term>Opacity</term>
<listitem>
<para>
Refers to the visibility of the layer part underlying the cornet.
diff --git a/src/filters/distort/polarcoords.xml b/src/filters/distort/polarcoords.xml
index 7e8b43f..8b3640d 100644
--- a/src/filters/distort/polarcoords.xml
+++ b/src/filters/distort/polarcoords.xml
@@ -81,7 +81,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Circle Depth in Percent</term>
+ <term>Circle depth in percent</term>
<listitem>
<para>
Slider and input box allow you to set the "circularity" of the
@@ -90,7 +90,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Offset Angle</term>
+ <term>Offset angle</term>
<listitem>
<para>
This option controls the angle the drawing will start from
@@ -99,7 +99,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Map Backwards</term>
+ <term>Map backwards</term>
<listitem>
<para>
When this option is checked, the drawing will start from the
@@ -108,7 +108,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Map from Top</term>
+ <term>Map from top</term>
<listitem>
<para>
If unchecked, the mapping will put the bottom row in the middle
@@ -118,7 +118,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>To Polar</term>
+ <term>To polar</term>
<listitem>
<para>
If unchecked, the image will be circularly mapped into a rectangle
diff --git a/src/filters/distort/ripple.xml b/src/filters/distort/ripple.xml
index ac9b117..1d02bd6 100644
--- a/src/filters/distort/ripple.xml
+++ b/src/filters/distort/ripple.xml
@@ -86,7 +86,7 @@
<listitem>
<variablelist>
<varlistentry>
- <term>Antialiasing</term>
+ <term><guilabel>Antialiasing</guilabel></term>
<listitem>
<para>
This improves the scaled look the image borders may have.
@@ -94,7 +94,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Retain Tileability</term>
+ <term><guilabel>Retain tileability</guilabel></term>
<listitem>
<para>
This preserves the seamless properties if your image is a tile pattern.
@@ -150,7 +150,7 @@
<term>Wave Type</term>
<listitem>
<para>
- These options are self-explanatory
+ Choose how the wave should look like:
</para>
<itemizedlist>
<listitem>
diff --git a/src/filters/distort/shift.xml b/src/filters/distort/shift.xml
index a23384d..1535a27 100644
--- a/src/filters/distort/shift.xml
+++ b/src/filters/distort/shift.xml
@@ -81,16 +81,14 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>These options are self-explanatory:</term>
+ <term>Shift horizontally</term>
+ <term>Shift vertically</term>
<listitem>
<para>
- <guilabel>Shift Horizontally</guilabel>
+ This option sets the dimension where pixels are moved.
</para>
<para>
- <guilabel>Shift vertically</guilabel>
- </para>
- <para>
- <guilabel>Shift Amount</guilabel>
+ Pixels going out one side will come back on the other side.
</para>
</listitem>
</varlistentry>
diff --git a/src/filters/distort/video.xml b/src/filters/distort/video.xml
index e1c84fe..aff76d0 100644
--- a/src/filters/distort/video.xml
+++ b/src/filters/distort/video.xml
@@ -79,7 +79,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>RGB Pattern Type</term>
+ <term>Video Pattern</term>
<listitem>
<para>
It would be rather difficult to describe what each pattern
diff --git a/src/filters/distort/vpropagate.xml b/src/filters/distort/vpropagate.xml
index 34ee80c..37bc043 100644
--- a/src/filters/distort/vpropagate.xml
+++ b/src/filters/distort/vpropagate.xml
@@ -312,7 +312,11 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Propagating direction</term>
+ <!--Propagating direction-->
+ <term>To left</term>
+ <term>To top</term>
+ <term>To right</term>
+ <term>To bottom</term>
<listitem>
<para>
You can select one or more directions.
diff --git a/src/filters/distort/waves.xml b/src/filters/distort/waves.xml
index c890068..86666c5 100644
--- a/src/filters/distort/waves.xml
+++ b/src/filters/distort/waves.xml
@@ -71,64 +71,59 @@
<para>
All your setting changes will appear in the Preview without
affecting the image until you click on <guilabel>OK</guilabel>.
- Don't keep <emphasis>Do Preview</emphasis> checked if your
- computer is too much slow.
+ Don't keep <guilabel>Preview</guilabel> checked if your computer
+ is too slow.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Modes</term>
+ <term>Mode</term>
<listitem>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Smear</guilabel>: Because of the waves, areas are
- rendered empty on sides. The adjacent pixels will spread to
- fill them.
- </para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Smear</guilabel></term>
+ <listitem>
+ <para>
+ Because of the waves, areas are rendered empty on sides. The
+ adjacent pixels will spread to fill them.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Blacken</guilabel></term>
+ <listitem>
+ <para>
+ The empty areas will be filled by black color.
+ </para>
</listitem>
- <listitem>
- <para>
- <guilabel>Blacken</guilabel>: The empty areas will be filled
- by black color.
- </para>
- </listitem>
- </itemizedlist>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term>Reflective</term>
<listitem>
<para>
- <guilabel>Reflective</guilabel>: Waves bounce on sides and
- interfere with the arriving ones.
+ Waves bounce on sides and interfere with the arriving ones.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Amplitude</term>
<listitem>
- <para>
- <guilabel>Amplitude</guilabel>: Varies the height of waves.
- </para>
+ <para>Varies the height of waves.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Phase</term>
<listitem>
- <para>
- <guilabel>Phase</guilabel>: This command shifts the top of
- waves.
- </para>
+ <para>This command shifts the top of waves.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Wavelength</term>
<listitem>
- <para>
- <guilabel>Wavelength</guilabel>: Varies the distance between
- the top of waves.
- </para>
+ <para>Varies the distance between the top of waves.</para>
</listitem>
</varlistentry>
</variablelist>
diff --git a/src/filters/distort/whirlpinch.xml b/src/filters/distort/whirlpinch.xml
index b905326..3efcedf 100644
--- a/src/filters/distort/whirlpinch.xml
+++ b/src/filters/distort/whirlpinch.xml
@@ -45,8 +45,9 @@
<quote>Whirl and Pinch</quote> distorts your image in a concentric way.
</para>
<para>
- <quote>Whirl and Pinch</quote> distorts the image much like the little
- whirlpool that appears when you empty your bath.
+ <quote>Whirl</quote> (applying a non-zero
+ <guilabel>Whirl angle</guilabel>) distorts the image much like the
+ little whirlpool that appears when you empty your bath.
</para>
<para>
<quote>Pinch</quote>, with a nil rotation, can be compared to
@@ -132,22 +133,20 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Whirl Angle</term>
+ <term>Whirl angle</term>
<listitem>
<para>
- <guilabel>Whirl Angle</guilabel>: Clockwise or counter
- clockwise (-360 to +360). Controls how many degrees the
- affected part of the image is rotated.
+ Clockwise or counter clockwise (-360 to +360). Controls how many
+ degrees the affected part of the image is rotated.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Pinch Amount</term>
+ <term>Pinch amount</term>
<listitem>
<para>
- <guilabel>Pinch Amount</guilabel>: Whirlpool depth(-1 to
- +1). Determines how strongly the affected part of the
- image is pinched.
+ Whirlpool depth(-1 to +1). Determines how strongly the affected
+ part of the image is pinched.
</para>
</listitem>
</varlistentry>
@@ -155,15 +154,13 @@
<term>Radius</term>
<listitem>
<para>
- <guilabel>Radius</guilabel>: Whirlpool width (0.0-2.0).
- Determines how much of the image is affected by the
- distortion. If you set <parameter>Radius</parameter> to
- 2, the entire image will be affected. If you set
- <parameter>Radius</parameter> to 1, half the image will
- be affected. If <parameter>Radius</parameter> is set to 0,
- nothing will be
- affected (think of it as the radius in a circle with 0 in
- the center and 1 halfway out).
+ Whirlpool width (0.0-2.0). Determines how much of the image is
+ affected by the distortion. If you set
+ <parameter>Radius</parameter> to 2, the entire image will be
+ affected. If you set <parameter>Radius</parameter> to 1, half the
+ image will be affected. If <parameter>Radius</parameter> is set to
+ 0, nothing will be affected (think of it as the radius in a circle
+ with 0 in the center and 1 halfway out).
</para>
</listitem>
</varlistentry>
diff --git a/src/filters/distort/wind.xml b/src/filters/distort/wind.xml
index fb4aecb..bf3bc07 100644
--- a/src/filters/distort/wind.xml
+++ b/src/filters/distort/wind.xml
@@ -115,83 +115,98 @@
<varlistentry>
<term>Style</term>
<listitem>
- <itemizedlist>
- <listitem>
- <para><guilabel>Wind</guilabel>: This option is the most
- suggestive of a moving effect. Trails are thin.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Blast</guilabel>: This option tries to suggest a
- blast due to an explosion. Trails are thick.
- </para>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/filters/examples/blast1.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Wind</guilabel></term>
+ <listitem>
+ <para>
+ This option is the most suggestive of a moving effect.
+ Trails are thin.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Blast</guilabel></term>
+ <listitem>
+ <para>
+ This option tries to suggest a blast due to an explosion.
+ Trails are thick.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/blast1.png"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term>Direction</term>
<listitem>
<para>
- You can select the direction, <emphasis>Left</emphasis> or
- <emphasis>Right</emphasis>, from which the wind comes.
+ You can select the direction, <guilabel>Left</guilabel> or
+ <guilabel>Right</guilabel>, from which the wind comes.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Edge Affected</term>
<listitem>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Leading</guilabel>: Trails will start from the
- front border, falling on the object itself. It suggests that
- a violent wind is pulling color out.
- </para>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/examples/wind2.png"/>
- </imageobject>
- </mediaobject>
- </listitem>
- <listitem>
- <para>
- <guilabel>Trailing</guilabel>: Trails start from the back
- border of the object.
- </para>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/examples/wind1.png"/>
- </imageobject>
- </mediaobject>
- </listitem>
- <listitem>
- <para>
- <guilabel>Both</guilabel>: Combines both effects.
- </para>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/examples/wind3.png"/>
- </imageobject>
- </mediaobject>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Leading</guilabel></term>
+ <listitem>
+ <para>
+ Trails will start from the front border, falling on the
+ object itself. It suggests that a violent wind is pulling
+ color out.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/wind2.png"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Trailing</guilabel></term>
+ <listitem>
+ <para>
+ Trails start from the back border of the object.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/wind1.png"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Both</guilabel></term>
+ <listitem>
+ <para>Combines both effects.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/wind3.png"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term>Threshold</term>
<listitem>
<para>
- <guilabel>Threshold</guilabel>: The threshold to detect
- borders. The higher it is, the fewer borders will be detected.
+ The threshold to detect borders. The higher it is, the fewer
+ borders will be detected.
</para>
</listitem>
</varlistentry>
@@ -199,8 +214,7 @@
<term>Strength</term>
<listitem>
<para>
- <guilabel>Strength</guilabel>: Higher values increase the
- strength of the effect.
+ Higher values increase the strength of the effect.
</para>
</listitem>
</varlistentry>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
