[gimp-help-2] Minor changes to Map filters
- From: Ulf-D. Ehlert <ulfehlert src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Minor changes to Map filters
- Date: Mon, 19 Jul 2010 18:36:29 +0000 (UTC)
commit 20d6c02df83cd20d03b1f8cdd2efb9ea75d35f01
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date: Mon Jul 19 19:08:23 2010 +0200
Minor changes to Map filters
Also, replace a Warp example image with a new one that uses a grayscale
map, as proposed in the text.
images/C/filters/examples/example-map-warp7.png | Bin 5837 -> 3050 bytes
src/filters/map/bumpmap.xml | 65 ++++---
src/filters/map/displace.xml | 73 ++++---
src/filters/map/fractal-trace.xml | 8 +-
src/filters/map/illusion.xml | 12 +-
src/filters/map/map-object.xml | 242 +++++++++++++----------
src/filters/map/papertile.xml | 183 ++++++++++--------
src/filters/map/smalltiles.xml | 78 ++++----
src/filters/map/tile.xml | 18 +-
src/filters/map/warp.xml | 184 ++++++++++-------
10 files changed, 496 insertions(+), 367 deletions(-)
---
diff --git a/images/C/filters/examples/example-map-warp7.png b/images/C/filters/examples/example-map-warp7.png
index 50d6c3b..95f8b0c 100644
Binary files a/images/C/filters/examples/example-map-warp7.png and b/images/C/filters/examples/example-map-warp7.png differ
diff --git a/src/filters/map/bumpmap.xml b/src/filters/map/bumpmap.xml
index e180c77..b398106 100644
--- a/src/filters/map/bumpmap.xml
+++ b/src/filters/map/bumpmap.xml
@@ -82,13 +82,13 @@
<term>Preview</term>
<listitem>
<para>
- Parameter setting results are interactively displayed in preview.
- Scroll bars allow you to move around the image.
+ If checked, parameter setting results are interactively displayed
+ in preview. Scroll bars allow you to move around the image.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Bump Map</term>
+ <term>Bump map</term>
<listitem>
<para>
This drop-down list allows you to select the image that will be
@@ -99,32 +99,38 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Map Type</term>
+ <term>Map type</term>
<listitem>
<para>
This option allows you to define the method that will be used
when creating the map image:
</para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Linear</guilabel>: bump height is a direct
- function of luminosity.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Sinusoidal</guilabel>: bump height
- is a sinusoidal function of luminosity.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Spheric</guilabel>: bump height is
- a spheric function of luminosity.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Linear</guilabel></term>
+ <listitem>
+ <para>
+ Bump height is a direct function of luminosity.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Sinusoidal</guilabel></term>
+ <listitem>
+ <para>
+ Bump height is a sinusoidal function of luminosity.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Spheric</guilabel></term>
+ <listitem>
+ <para>
+ Bump height is a spheric function of luminosity.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
@@ -137,7 +143,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Invert bump-map</term>
+ <term>Invert bumpmap</term>
<listitem>
<para>
Bright pixels default to bumps and dark pixels to hollows. You can
@@ -146,7 +152,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Tile bump-map</term>
+ <term>Tile bumpmap</term>
<listitem>
<para>
If you check this option, there will be no relief break if
@@ -184,7 +190,8 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>X/Y offsets</term>
+ <term>X offset</term>
+ <term>Y offset</term>
<listitem>
<para>
With this slider, you can adjust the map image position
@@ -194,7 +201,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Sea Level</term>
+ <term>Waterlevel</term>
<listitem>
<para>
If your image has transparent areas, they will be treated like
@@ -202,7 +209,7 @@
slider, you can reduce hollows as if sea level was raising. This
hollows will disappear when sea level value reaches 255. If the
Invert bump-map option is checked, transparent areas will be
- treated as bright areas, and then Sea Level slider will plane
+ treated as bright areas, and then Waterlevel slider will plane
bumps down.
</para>
</listitem>
diff --git a/src/filters/map/displace.xml b/src/filters/map/displace.xml
index 37cdd71..e423d73 100644
--- a/src/filters/map/displace.xml
+++ b/src/filters/map/displace.xml
@@ -1,7 +1,8 @@
<?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:
- 2007-10-14 KoSt: updatet no to v2.4
+ 2007-10-14 KoSt: updated no to v2.4
2007-09-06 AntI: added 'es'
2007-08-19 alex falappa: new sections for 2.4 and torough review
2007-08-07 alex falappa: ude's fix to 'it', polar mode
@@ -114,10 +115,10 @@
<listitem>
<para>
You can choose working in
- <link linkend="plug-in-displace-cartesian">cartesian</link>
+ <link linkend="plug-in-displace-cartesian">Cartesian</link>
coordinates, where pixels are displaced in X or Y direction, or
working in
- <link linkend="plug-in-displace-polar">polar</link> coordinates,
+ <link linkend="plug-in-displace-polar">Polar</link> coordinates,
where the image is pinched and whirled by displacing pixels in
radial or tangent direction.
</para>
@@ -133,27 +134,36 @@
These options allows you to set displacement behaviour on active
layer or selection edges:
</para>
- <itemizedlist>
- <listitem>
- <para><guilabel>Wrap</guilabel>:
- With this option, what disappears on one edge reappears on
- the opposite edge.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Smear</guilabel>:
- With this option, pixels vacated by displacement are
- replaced with pixels stretched from the adjacent part of the
- image.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Black</guilabel>:
- With this option, pixels vacated by displacement are replaced
- with black.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Wrap</guilabel></term>
+ <listitem>
+ <para>
+ With this option, what disappears on one edge reappears on
+ the opposite edge.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Smear</guilabel></term>
+ <listitem>
+ <para>
+ With this option, pixels vacated by displacement are
+ replaced with pixels stretched from the adjacent part of the
+ image.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Black</guilabel></term>
+ <listitem>
+ <para>
+ With this option, pixels vacated by displacement are
+ replaced with black.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
</variablelist>
@@ -164,8 +174,8 @@
<title>Displace filter options (Cartesian)</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/options-map-displace-cartesian.png"
- format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/options-map-displace-cartesian.png"/>
</imageobject>
<caption>
<para>Displacement Mode: Cartesian</para>
@@ -185,7 +195,8 @@
</para>
<variablelist>
<varlistentry>
- <term>X/Y Displacements</term>
+ <term>X displacement</term>
+ <term>Y displacement</term>
<listitem>
<para>
If the respective option is activated, image pixels
@@ -243,8 +254,8 @@
<title>Displace filter options (Polar)</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/options-map-displace-polar.png"
- format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/options-map-displace-polar.png"/>
</imageobject>
<caption>
<para>Displacement Mode: Polar</para>
@@ -265,7 +276,7 @@
</para>
<para>
For the values and the displacement map see above
- (<quote>X/Y Displacements</quote>).
+ (<quote>X/Y displacement</quote>).
</para>
<para>
The displacement is independent from the polar distance, all
diff --git a/src/filters/map/fractal-trace.xml b/src/filters/map/fractal-trace.xml
index a935ed4..a060e6e 100644
--- a/src/filters/map/fractal-trace.xml
+++ b/src/filters/map/fractal-trace.xml
@@ -75,7 +75,11 @@
<variablelist>
<title>Mandelbrot parameters</title>
<varlistentry>
- <term>X1, X2, Y1, Y2, Depth</term>
+ <term>X1</term>
+ <term>X2</term>
+ <term>Y1</term>
+ <term>Y2</term>
+ <term>Depth</term>
<listitem>
<para>
These parameters are similar to X/YMIN, X/YMAX and ITER
@@ -87,7 +91,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Outside type</term>
+ <term>Outside Type</term>
<listitem>
<para>
Mapping image to fractal may reveal empty areas. You can select
diff --git a/src/filters/map/illusion.xml b/src/filters/map/illusion.xml
index 3beea7d..9ec04d1 100644
--- a/src/filters/map/illusion.xml
+++ b/src/filters/map/illusion.xml
@@ -76,6 +76,15 @@
</figure>
<variablelist>
<varlistentry>
+ <term>Preview</term>
+ <listitem>
+ <para>
+ If checked, parameter setting results are interactively displayed
+ in preview. Scroll bars allow you to move around the image.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
<term>Divisions</term>
<listitem>
<para>
@@ -86,7 +95,8 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Modes</term>
+ <term>Mode 1</term>
+ <term>Mode 2</term>
<listitem>
<para>
You have two arrangement modes for copies in image:
diff --git a/src/filters/map/map-object.xml b/src/filters/map/map-object.xml
index bc42cc1..390f529 100644
--- a/src/filters/map/map-object.xml
+++ b/src/filters/map/map-object.xml
@@ -72,16 +72,16 @@
<title>Options</title>
<sect4>
- <title>Preview domain</title>
+ <title>Preview</title>
<para>This preview has several possibilities:</para>
<variablelist>
<varlistentry>
<term>Preview!</term>
<listitem>
<para>
- <guibutton>Preview!</guibutton>: Preview is automatic for some
- options but you will have to press this button to update Preview
- after modifying many other parameters.
+ Preview is automatic for some options but you will have to press
+ this button to update Preview after modifying many other
+ parameters.
</para>
<para>
When mouse pointer is on Preview and the Light tab is selected,
@@ -94,21 +94,22 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Zoom buttons</term>
+ <term>Zoom out</term>
+ <term>Zoom in</term>
<listitem>
<para>
- <guibutton>Zoom buttons</guibutton> allow you to enlarge or to
- reduce image in Preview. Their action is limited, but may be
- useful in case of a large image.
+ Zoom buttons allow you to enlarge or to reduce image in Preview.
+ Their action is limited, but may be useful in case of a large
+ image.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Show Preview Wireframe</term>
+ <term>Show preview wireframe</term>
<listitem>
- <para><guilabel>Show Preview Wireframe</guilabel>: Puts a grid over
- the preview to make displacements and rotations more easy. Works
- well on a plan.
+ <para>
+ Puts a grid over the preview to make displacements and rotations
+ more easy. Works well on a plan.
</para>
</listitem>
</varlistentry>
@@ -116,9 +117,9 @@
</sect4>
<sect4>
- <title>General Options tab</title>
+ <title>General Options</title>
<figure>
- <title><quote>Map Object</quote> general options tab</title>
+ <title><quote>Map Object</quote> options (General)</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
@@ -180,30 +181,36 @@
Check this option to conceal this unpleasant aliasing effect
on borders. When checked, this option lets appear two settings:
</para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Depth</guilabel>: Defines antialiasing quality,
- to the detriment of execution speed.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Threshold</guilabel>: Defines antialiasing
- limits. Antialiasing stops when value difference between
- pixels becomes lower than this set value.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Depth</guilabel></term>
+ <listitem>
+ <para>
+ Defines antialiasing quality, to the detriment of
+ execution speed.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Threshold</guilabel></term>
+ <listitem>
+ <para>
+ Defines antialiasing limits. Antialiasing stops when value
+ difference between pixels becomes lower than this set
+ value.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect4>
<sect4>
- <title>Light tab</title>
+ <title>Light</title>
<figure>
- <title><quote>Light</quote> tab options</title>
+ <title><quote>Map Object</quote> options (Light)</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
@@ -215,22 +222,26 @@
<varlistentry>
<term>Light Settings</term>
<listitem>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Lightsource type</guilabel>: In this dropdown
- list, you can select among <emphasis>Point light</emphasis>,
- <emphasis>Directionnal light</emphasis> and <emphasis> No
- light</emphasis>.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Lightsource color</guilabel>: Press this button to
- open the Color Selector dialog.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Lightsource type</guilabel></term>
+ <listitem>
+ <para>
+ In this dropdown list, you can select among
+ <emphasis>Point light</emphasis>, <emphasis>Directionnal
+ light</emphasis> and <emphasis>No light</emphasis>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Lightsource color</guilabel></term>
+ <listitem>
+ <para>
+ Press this button to open the Color Selector dialog.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
@@ -252,9 +263,9 @@
</sect4>
<sect4>
- <title>Material tab</title>
+ <title>Material</title>
<figure>
- <title><quote>Material</quote> tab options</title>
+ <title><quote>Map Object</quote> options (Material)</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
@@ -266,53 +277,65 @@
<varlistentry>
<term>Intensity Levels</term>
<listitem>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Ambient</guilabel>:
- Amount of color to show where no light falls directly.
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Diffuse</guilabel>: Intensity of original color
- when lit by a light source.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Ambient</guilabel></term>
+ <listitem>
+ <para>
+ Amount of color to show where no light falls directly.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Diffuse</guilabel></term>
+ <listitem>
+ <para>
+ Intensity of original color when lit by a light source.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term>Reflectivity</term>
<listitem>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Diffusion</guilabel>: Higher values make object
- reflect more light (looks brighter).
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Specular</guilabel>: Controls how intense the
- highlights will be.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Highlight</guilabel>: Higher values make the
- highlights more focused.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Diffusion</guilabel></term>
+ <listitem>
+ <para>
+ Higher values make object reflect more light (looks
+ brighter).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Specular</guilabel></term>
+ <listitem>
+ <para>
+ Controls how intense the highlights will be.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Highlight</guilabel></term>
+ <listitem>
+ <para>
+ Higher values make the highlights more focused.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect4>
<sect4>
- <title>Orientation tab</title>
+ <title>Orientation</title>
<figure>
- <title><quote>Orientation</quote> tab options</title>
+ <title><quote>Map Object</quote> options (Orientation)</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
@@ -344,12 +367,12 @@
</sect4>
<sect4>
- <title>Box tab</title>
+ <title>Box</title>
<para>
This tab appears only when you select the Box object.
</para>
<figure>
- <title><quote>Box</quote> tab options</title>
+ <title><quote>Map Object</quote> options (Box)</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
@@ -372,7 +395,7 @@
<term>Scale</term>
<listitem>
<para>
- These X, Y, Z three sliders allow you to change the size of
+ These X, Y, Z sliders allow you to change the size of
every X, Y, Z dimension of the box.
</para>
</listitem>
@@ -381,12 +404,12 @@
</sect4>
<sect4>
- <title>Cylinder tab</title>
+ <title>Cylinder</title>
<para>
This tab appears only when you select the Cylinder object.
</para>
<figure>
- <title><quote>Cylinder</quote> tab options</title>
+ <title><quote>Map Object</quote> options (Cylinder)</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
@@ -407,24 +430,29 @@
<varlistentry>
<term>Size</term>
<listitem>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Radius</guilabel>:
- This slider and its input boxes let you control the
- Cylinder diameter. Unfortunately, this setting works on the
- image mapped onto the cylinder and resamples this image to
- adapt it to the new cylinder size. It would be better to
- have the possibility of setting size cylinder before mapping
- so that we could map a whole image.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Length</guilabel>: Controls cylinder length.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Radius</guilabel></term>
+ <listitem>
+ <para>
+ This slider and its input boxes let you control the
+ Cylinder diameter. Unfortunately, this setting works on the
+ image mapped onto the cylinder and resamples this image to
+ adapt it to the new cylinder size. It would be better to
+ have the possibility of setting size cylinder before mapping
+ so that we could map a whole image.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Length</guilabel></term>
+ <listitem>
+ <para>
+ Controls cylinder length.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
</variablelist>
diff --git a/src/filters/map/papertile.xml b/src/filters/map/papertile.xml
index 77b4c14..4be111c 100644
--- a/src/filters/map/papertile.xml
+++ b/src/filters/map/papertile.xml
@@ -90,23 +90,27 @@
<varlistentry>
<term>Movement</term>
<listitem>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Max%</guilabel>
- is the maximum displacement percentage against the side size
- of squares.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Wrap around</guilabel>:
- As tiles move, some can go out image borders. If this option
- is checked, what goes out on one side goes in on the opposite
- side.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Max (%)</guilabel></term>
+ <listitem>
+ <para>
+ This is the maximum displacement percentage against the side
+ size of squares.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Wrap around</guilabel></term>
+ <listitem>
+ <para>
+ As tiles move, some can go out image borders. If this option
+ is checked, what goes out on one side goes in on the
+ opposite side.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
@@ -116,27 +120,34 @@
Because of image cutting, original pixels can persist. There are
three ways treating them:
</para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Background</guilabel>: Remaining pixels will be
- replaced with the background type defined in the following
- section.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Ignore</guilabel>: Background Type option is
- not taken into account and remaining pixels are kept.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Force</guilabel>: Remaining pixels will be cut
- also.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Background</guilabel></term>
+ <listitem>
+ <para>
+ Remaining pixels will be replaced with the background type
+ defined in the following section.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Ignore</guilabel></term>
+ <listitem>
+ <para>
+ <guilabel>Background Type</guilabel> option is not taken
+ into account and remaining pixels are kept.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Force</guilabel></term>
+ <listitem>
+ <para>
+ Remaining pixels will be cut also.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
@@ -147,46 +158,62 @@
<guilabel>Background</guilabel> radio-button is checked, among
six options:
</para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Transparent</guilabel>: Background will be
- transparent.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Inverted image</guilabel>: Background colors
- will be inverted (255-value in every color channel).
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Image</guilabel>: Background colors
- will be unchanged. The original image is the background.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Foreground Color</guilabel>: Remaining pixels
- will be replaced by the Foreground color of Toolbox.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Background Color</guilabel>: Remaining pixels
- will be replaced by the Background color of Toolbox.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Select here</guilabel>: When this radio-button
- is checked, clicking in the color dwell will open a Color
- Selector where you can select the color you want for
- background.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Transparent</guilabel></term>
+ <listitem>
+ <para>
+ Background will be transparent.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Inverted image</guilabel></term>
+ <listitem>
+ <para>
+ Background colors will be inverted (255-value in every color
+ channel).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Image</guilabel></term>
+ <listitem>
+ <para>
+ Background colors will be unchanged. The original image is
+ the background.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Foreground color</guilabel></term>
+ <listitem>
+ <para>
+ Remaining pixels will be replaced by the Foreground color of
+ Toolbox.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Background color</guilabel></term>
+ <listitem>
+ <para>
+ Remaining pixels will be replaced by the Background color of
+ Toolbox.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Select here</guilabel></term>
+ <listitem>
+ <para>
+ When this radio-button is checked, clicking in the color
+ dwell will open a Color Selector where you can select the
+ color you want for background.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
diff --git a/src/filters/map/smalltiles.xml b/src/filters/map/smalltiles.xml
index 991f25d..5a87101 100644
--- a/src/filters/map/smalltiles.xml
+++ b/src/filters/map/smalltiles.xml
@@ -70,13 +70,47 @@
</figure>
<variablelist>
<varlistentry>
- <term>Number of Segments</term>
+ <term>Flip</term>
<listitem>
<para>
- <guilabel>n²</guilabel> means <quote>the image into n to
- the power of two tiles</quote>, where <quote>n</quote> is the
- number you set with the slider or its input box. n = 3 will
- make nine tiles in the image.
+ You can flip tiles according to the
+ <guilabel>Horizontal</guilabel> or/and
+ <guilabel>Vertical</guilabel> axis by checking the corresponding
+ option(s).
+ </para>
+ <para>
+ You can also decide which tiles will be flipped:
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>All tiles</guilabel></term>
+ <listitem>
+ <para>
+ No comment.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Alternate tiles</guilabel></term>
+ <listitem>
+ <para>
+ Only odd tiles will be flipped.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Explicit tile</guilabel></term>
+ <listitem>
+ <para>
+ You can define a particular tile using both
+ <guilabel>Row</guilabel> and <guilabel>Column</guilabel>
+ input boxes. This tile will be marked with a box in
+ Preview. Press <guibutton>Apply</guibutton> to mark this
+ explicit tile. Repeat this procedure to mark more than one
+ tile.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
</listitem>
</varlistentry>
@@ -91,37 +125,13 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Flip</term>
+ <term>Number of Segments</term>
<listitem>
<para>
- You can flip tiles according to the
- <guilabel>Horizontal</guilabel> or/and
- <guilabel>Vertical</guilabel> axis by checking the corresponding
- option(s).
- </para>
- <para>
- You can also decide which tiles will be flipped:
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>All tiles</guilabel>: no comment.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Alternate tiles</guilabel>: only odd tiles will
- be flipped.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Explicit tile</guilabel>: you can define, a
- particular tile by using both <guilabel>Line</guilabel>
- and <guilabel>Column</guilabel> input boxes. This tile
- will be marked with a box in Preview.
- </para>
- </listitem>
- </itemizedlist>
+ <guilabel>n²</guilabel> means <quote>the image into n to
+ the power of two tiles</quote>, where <quote>n</quote> is the
+ number you set with the slider or its input box. n = 3 will
+ make nine tiles in the image.
</para>
</listitem>
</varlistentry>
diff --git a/src/filters/map/tile.xml b/src/filters/map/tile.xml
index 6f8670d..3d01a47 100644
--- a/src/filters/map/tile.xml
+++ b/src/filters/map/tile.xml
@@ -70,9 +70,10 @@
</mediaobject>
</figure>
<variablelist>
- <title>Tile to new size</title>
+ <title>Tile to New Size</title>
<varlistentry>
- <term>Width/Height</term>
+ <term>Width</term>
+ <term>Height</term>
<listitem>
<para>
Input boxes and their arrow-heads allow you to enter the
@@ -89,17 +90,16 @@
this chain. You can choose a unit else than pixel by clicking on
the drop-down list button.
</para>
- <para><emphasis>
- The new image must be bigger than the original one
- </emphasis>.
- Else, you will get an image sample only. Choose sizes which are
- multiple of original sizes if you don't want to have truncated
- tiles.
+ <para>
+ <emphasis>The new image must be bigger than the original
+ one</emphasis>. Else, you will get an image sample only. Choose
+ sizes which are multiple of original sizes if you don't want to
+ have truncated tiles.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Create New image</term>
+ <term>Create new image</term>
<listitem>
<para>
It's in your interest to keep this option checked to avoid
diff --git a/src/filters/map/warp.xml b/src/filters/map/warp.xml
index 82753bd..57547d2 100644
--- a/src/filters/map/warp.xml
+++ b/src/filters/map/warp.xml
@@ -111,7 +111,7 @@
<variablelist>
<title>Basic Options</title>
<varlistentry>
- <term>Step Size</term>
+ <term>Step size</term>
<listitem>
<para>
<quote>Step</quote> is displacement distance for every filter
@@ -125,13 +125,12 @@
<term>Iterations</term>
<listitem>
<para>
- <guilabel>Iteration</guilabel> is the number of repetitions of
- effect when applying filter.
+ The number of repetitions of effect when applying filter.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>On Edges</term>
+ <term>On edges</term>
<listitem>
<para>
Because of displacement, a part of pixels are driven over the
@@ -139,45 +138,53 @@
places are emptying. Four following options allow you to fix this
issue:
</para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Warp</guilabel>
- (default): What goes out on one side is going into the
- opposite side.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Smear</guilabel>:
- Emptying places are filled with a spreading of the
- neighbouring image line.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Black</guilabel>
- : Emptying places are filled with black color.
- </para>
- </listitem>
- <listitem>
- <para>
- <guilabel>FG Color</guilabel>
- : Emptying places are filled with the Foreground color of the
- color area in Toolbox.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Warp</guilabel></term>
+ <listitem>
+ <para>
+ What goes out on one side is going into the opposite side
+ (this is the default).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Smear</guilabel></term>
+ <listitem>
+ <para>
+ Emptying places are filled with a spreading of the
+ neighbouring image line.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Black</guilabel></term>
+ <listitem>
+ <para>
+ Emptying places are filled with black color.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Foreground color</guilabel></term>
+ <listitem>
+ <para>
+ Emptying places are filled with the Foreground color of the
+ color area in Toolbox.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</listitem>
</varlistentry>
<varlistentry>
- <term>Displacement Map</term>
+ <term>Displacement map</term>
<listitem>
<para>
- To be listed in this drop-down list, the displacement map,
- which is a grey-scaled image, must be <emphasis>present on
- your screen when you call filter and must have the same size
- as the original image</emphasis>.
+ To be listed in this drop-down list, the displacement map, which
+ should be a grayscaled image, must be <emphasis>present on your
+ screen when you call filter and must have the same size as the
+ original image</emphasis>.
</para>
</listitem>
</varlistentry>
@@ -185,7 +192,7 @@
<variablelist>
<title>Advanced Options</title>
<varlistentry>
- <term>Dither Size</term>
+ <term>Dither size</term>
<listitem>
<para>
Once all pixels displaced, this option scatters them randomly,
@@ -204,7 +211,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Rotation Angle</term>
+ <term>Rotation angle</term>
<listitem>
<para>
This option sets displacement angle of pixels according to the
@@ -233,21 +240,33 @@
</listitem>
</varlistentry>
<varlistentry>
+ <term>Substeps</term>
+ <listitem>
+ <!-- CHECK: I'm unsure whether this is (a) makes senses, and
+ (b) is correct... :-| (ude, 2010-07-19) -->
+ <para>
+ If you specify a value > 1, the displacement vector is computed in
+ several substeps, giving you a finer control to the displace
+ process.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
<term>Magnitude map</term>
<listitem>
<para>
- In addition to displacement map, you can add a
- <guilabel>Magnitude Map</guilabel>. This map is also a
- grey-scaled image, with the same size as the source image and
- which must be present on your screen when you call filter.
- This map gives more or less strength to filter on some parts
- of the image, according to the grey levels of this magnitude
- map. Image areas corresponding to white parts of this map will
- undergo all the strength of filter. Image areas corresponding
- to black parts of the map will be spared by filter.
+ In addition to displacement map, you can add a Magnitude map. This
+ map should also be a grayscaled image, with the same size as the
+ source image and which must be present on your screen when you
+ call filter. This map gives more or less strength to filter on
+ some parts of the image, according to the grey levels of this
+ magnitude map. Image areas corresponding to white parts of this
+ map will undergo all the strength of filter. Image areas
+ corresponding to black parts of the map will be spared by filter.
Intermediate grey levels will lessen filter action on
- corresponding areas of the image. <guilabel>Use magnitude
- map</guilabel> must be checked for that.
+ corresponding areas of the image.
+ <guilabel>Use magnitude map</guilabel> must be checked
+ for that.
</para>
<figure>
<title>Magnitude Map example:</title>
@@ -282,18 +301,19 @@
</para>
</note>
<varlistentry>
- <term>The Gradient Map</term>
+ <term>Gradient scale</term>
<listitem>
- <para><emphasis>The gradient map</emphasis> is also a grayscaled map.
- Here, the displacement of pixels depends on the direction of
+ <para>
+ Using a gradient map, (this map should also be a grayscaled
+ image), the displacement of pixels depends on the direction of
grayscale transitions. The <guilabel>Gradient scale</guilabel>
option lets you set how much the grayscale variations will
- influence the displacement of pixels.
- On every iteration, the filter works of the whole image, not
- only on the red object: this explains burredness.
+ influence the displacement of pixels. On every iteration, the
+ filter works of the whole image, not only on the red object: this
+ explains burredness.
</para>
<figure>
- <title>Gradient map example</title>
+ <title>Gradient scale example</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
@@ -301,23 +321,33 @@
</imageobject>
<caption>
<para>
- From left to right: original image, displacement map,
- after applying <quote>Warp</quote> filter with a Gradient
- Scale map. Gradient is oblique, from top left to right
- bottom. The part of the image corresponding to the gradient
- is moved obliquely, 90° rotated (Rotation Angle 90° in
- Advanced options).
+ From left to right: original image, Gradient map, filter
+ applied.
</para>
</caption>
</mediaobject>
</figure>
+ <para>
+ In the example above, <quote>Warp</quote> filter is applied with a
+ gradient map (Gradient scale = 10.0). Gradient is oblique, from
+ top left to right bottom. The part of the image corresponding to
+ the gradient is moved obliquely, 90° rotated (Rotation angle 90°
+ in Advanced Options).
+ </para>
</listitem>
</varlistentry>
<varlistentry>
- <term>The Vector Map</term>
+ <term>Vector mag</term>
<listitem>
+ <para>
+ With this map, the displacement depends on the angle you set in
+ the <guilabel>Angle</guilabel> text box. 0° is upwards. Angles go
+ counter-clockwise. The <emphasis>vector control map</emphasis>
+ determines by how many pixels the image will move on every
+ iteration.
+ </para>
<figure>
- <title>Vector map example</title>
+ <title>Vector mag example</title>
<mediaobject>
<imageobject>
<imagedata format="PNG"
@@ -326,24 +356,26 @@
<caption>
<para>
From left to right: original image, displacement map,
- after applying <quote>Warp</quote> filter with a Vector
- map. Gradient is vertical, from top to bottom. Vector angle
- is 45°. The image is moved obliquely, 45° to the top left
- corner. The image is blurred because every iteration works
- on the whole image, and not only on the red bar.
+ filter applied.
</para>
</caption>
</mediaobject>
</figure>
<para>
- With this map, the displacement depends on the angle you set
- in the <guilabel>Angle</guilabel> text box. 0° is upwards.
- Angles go counter-clockwise. The <guilabel>Vector Magnitude
- </guilabel> determines by how many pixels the image will move on
- every iteration.
+ In the above example, <quote>Warp</quote> filter is applied with a
+ Vector mag. Gradient is vertical, from top to bottom. Vector angle
+ is 45°. The image is moved obliquely, 45° to the top left corner.
+ The image is blurred because every iteration works on the whole
+ image, and not only on the red bar.
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>Angle</term>
+ <listitem>
+ <para>Angle for fixed vector map (see above).</para>
+ </listitem>
+ </varlistentry>
</variablelist>
</sect3>
</sect2>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
