[digikam-doc] digikam: review Editor Filters section
Gilles Caulier
caulier.gilles at gmail.com
Wed Aug 24 13:47:11 UTC 2016
Git commit 1bb842769be13546c55a915efb3466fd409d4c10 by Gilles Caulier.
Committed on 24/08/2016 at 13:46.
Pushed by cgilles into branch 'master'.
review Editor Filters section
R +- -- digikam/editor-blurfx-farblur.png [from: digikam/blurfx_farblur.png - 100% similarity]
R +- -- digikam/editor-blurfx-focusblur.png [from: digikam/blurfx_focusblur.png - 100% similarity]
R +- -- digikam/editor-blurfx-frostglass.png [from: digikam/blurfx_frostglass.png - 100% similarity]
R +- -- digikam/editor-blurfx-mosaic.png [from: digikam/blurfx_mosaic.png - 100% similarity]
R +- -- digikam/editor-blurfx-motionblur.png [from: digikam/blurfx_motionblur.png - 100% similarity]
R +- -- digikam/editor-blurfx-radialblur.png [from: digikam/blurfx_radialblur.png - 100% similarity]
R +- -- digikam/editor-blurfx-shakeblur.png [from: digikam/blurfx_shakeblur.png - 100% similarity]
R +- -- digikam/editor-blurfx-smartblur.png [from: digikam/blurfx_smartblur.png - 100% similarity]
R +- -- digikam/editor-blurfx-softenerblur.png [from: digikam/blurfx_softenerblur.png - 100% similarity]
R +- -- digikam/editor-blurfx-zoomblur.png [from: digikam/blurfx_zoomblur.png - 100% similarity]
R +- -- digikam/editor-blurfxpreview.png [from: digikam/blurfxpreview.png - 100% similarity]
R +- -- digikam/editor-charcoalpreview.png [from: digikam/charcoalpreview.png - 100% similarity]
M +11 -10 digikam/editor-color.docbook
R +- -- digikam/editor-distortionfx-blockwaves1.png [from: digikam/distortionfx_blockwaves1.png - 100% similarity]
R +- -- digikam/editor-distortionfx-blockwaves2.png [from: digikam/distortionfx_blockwaves2.png - 100% similarity]
R +- -- digikam/editor-distortionfx-caricature.png [from: digikam/distortionfx_caricature.png - 100% similarity]
R +- -- digikam/editor-distortionfx-circularwaves1.png [from: digikam/distortionfx_circularwaves1.png - 100% similarity]
R +- -- digikam/editor-distortionfx-circularwaves2.png [from: digikam/distortionfx_circularwaves2.png - 100% similarity]
R +- -- digikam/editor-distortionfx-corners.png [from: digikam/distortionfx_corners.png - 100% similarity]
R +- -- digikam/editor-distortionfx-cylinderh.png [from: digikam/distortionfx_cylinderh.png - 100% similarity]
R +- -- digikam/editor-distortionfx-cylinderhv.png [from: digikam/distortionfx_cylinderhv.png - 100% similarity]
R +- -- digikam/editor-distortionfx-cylinderv.png [from: digikam/distortionfx_cylinderv.png - 100% similarity]
R +- -- digikam/editor-distortionfx-fisheyes.png [from: digikam/distortionfx_fisheyes.png - 100% similarity]
R +- -- digikam/editor-distortionfx-polarcoord.png [from: digikam/distortionfx_polarcoord.png - 100% similarity]
R +- -- digikam/editor-distortionfx-tiles.png [from: digikam/distortionfx_tiles.png - 100% similarity]
R +- -- digikam/editor-distortionfx-twirl.png [from: digikam/distortionfx_twirl.png - 100% similarity]
R +- -- digikam/editor-distortionfx-unpolarcoord.png [from: digikam/distortionfx_unpolarcoord.png - 100% similarity]
R +- -- digikam/editor-distortionfx-wavesh.png [from: digikam/distortionfx_wavesh.png - 100% similarity]
R +- -- digikam/editor-distortionfx-wavesv.png [from: digikam/distortionfx_wavesv.png - 100% similarity]
R +- -- digikam/editor-distortionfxpreview.png [from: digikam/distortionfxpreview.png - 100% similarity]
R +- -- digikam/editor-embosspreview.png [from: digikam/embosspreview.png - 100% similarity]
R +- -- digikam/editor-filmgrainpreview.png [from: digikam/filmgrainpreview.png - 100% similarity]
M +642 -673 digikam/editor-filters.docbook
R +- -- digikam/editor-infraredpreview.png [from: digikam/infraredpreview.png - 100% similarity]
R +- -- digikam/editor-oilpaintpreview.png [from: digikam/oilpaintpreview.png - 100% similarity]
R +- -- digikam/editor-raindropspreview.png [from: digikam/raindropspreview.png - 100% similarity]
http://commits.kde.org/digikam-doc/1bb842769be13546c55a915efb3466fd409d4c10
diff --git a/digikam/blurfx_farblur.png b/digikam/editor-blurfx-farblur.png
similarity index 100%
rename from digikam/blurfx_farblur.png
rename to digikam/editor-blurfx-farblur.png
diff --git a/digikam/blurfx_focusblur.png b/digikam/editor-blurfx-focusblur.png
similarity index 100%
rename from digikam/blurfx_focusblur.png
rename to digikam/editor-blurfx-focusblur.png
diff --git a/digikam/blurfx_frostglass.png b/digikam/editor-blurfx-frostglass.png
similarity index 100%
rename from digikam/blurfx_frostglass.png
rename to digikam/editor-blurfx-frostglass.png
diff --git a/digikam/blurfx_mosaic.png b/digikam/editor-blurfx-mosaic.png
similarity index 100%
rename from digikam/blurfx_mosaic.png
rename to digikam/editor-blurfx-mosaic.png
diff --git a/digikam/blurfx_motionblur.png b/digikam/editor-blurfx-motionblur.png
similarity index 100%
rename from digikam/blurfx_motionblur.png
rename to digikam/editor-blurfx-motionblur.png
diff --git a/digikam/blurfx_radialblur.png b/digikam/editor-blurfx-radialblur.png
similarity index 100%
rename from digikam/blurfx_radialblur.png
rename to digikam/editor-blurfx-radialblur.png
diff --git a/digikam/blurfx_shakeblur.png b/digikam/editor-blurfx-shakeblur.png
similarity index 100%
rename from digikam/blurfx_shakeblur.png
rename to digikam/editor-blurfx-shakeblur.png
diff --git a/digikam/blurfx_smartblur.png b/digikam/editor-blurfx-smartblur.png
similarity index 100%
rename from digikam/blurfx_smartblur.png
rename to digikam/editor-blurfx-smartblur.png
diff --git a/digikam/blurfx_softenerblur.png b/digikam/editor-blurfx-softenerblur.png
similarity index 100%
rename from digikam/blurfx_softenerblur.png
rename to digikam/editor-blurfx-softenerblur.png
diff --git a/digikam/blurfx_zoomblur.png b/digikam/editor-blurfx-zoomblur.png
similarity index 100%
rename from digikam/blurfx_zoomblur.png
rename to digikam/editor-blurfx-zoomblur.png
diff --git a/digikam/blurfxpreview.png b/digikam/editor-blurfxpreview.png
similarity index 100%
rename from digikam/blurfxpreview.png
rename to digikam/editor-blurfxpreview.png
diff --git a/digikam/charcoalpreview.png b/digikam/editor-charcoalpreview.png
similarity index 100%
rename from digikam/charcoalpreview.png
rename to digikam/editor-charcoalpreview.png
diff --git a/digikam/editor-color.docbook b/digikam/editor-color.docbook
index 00d7cf2..5f7503e 100644
--- a/digikam/editor-color.docbook
+++ b/digikam/editor-color.docbook
@@ -770,23 +770,24 @@
</sect3>
<sect3 id="blackandwhite-conversion">
+
<sect3info> <title>Black and White Conversion Filters</title>
- <abstract>
- <para>
- Black & White photography has always been fascinating in its abstraction capability. With the advent of digital photography, B&W has almost become a desktop activity, as color images can be easily converted on the computer into black and white, even providing a set of vintage film roll profiles.
- </para>
- </abstract>
- <keywordset>
- <keyword>Digikam</keyword>
- </keywordset>
+ <abstract>
+ <para>
+ Black & White photography has always been fascinating in its abstraction capability. With the advent of digital photography, B&W has almost become a desktop activity, as color images can be easily converted on the computer into black and white, even providing a set of vintage film roll profiles.
+ </para>
+ </abstract>
</sect3info>
+
<title>Introduction</title>
<anchor id="blackandwhitetool.anchor"/>
+
<para>
&digikam; comes with a couple of black & white filters that you can use on your photographs. Under the <menuchoice><guimenuitem>Filters</guimenuitem><guimenuitem>Black & White</guimenuitem></menuchoice> menu you will find classic black & white chemical toning used in analog photography. The controls come on three tabs: <emphasis>Film, Lens Filters, Tone</emphasis> and <emphasis>Lightness</emphasis> as shown on the screenshot below. Film, filters and color toning can be applied independently of each other (on top of each other). The filters actually influence the RGB channel mixing, whereas the toning purely adds a uniform monochromatic tint to the black & white photograph. In the lightness tab you will find a tonal adjustment tool (like curve adjust), a contrast tool and an over-exposure indicator to improve the b&w rendering.
</para>
+
<example> <title>The Black & White Filter tool in Action</title>
<screenshot><screeninfo>The B&W Filter tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editor-bwfilter.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
@@ -888,7 +889,7 @@
<informaltable><tgroup cols="2">
<thead><row>
- <entry>Preview</entry> <entry>Color Tint</entry>
+ <entry>Preview</entry> <entry>Color Tint</entry>
</row></thead>
<tbody>
@@ -912,7 +913,7 @@
</entry>
</row>
- <row>
+ <row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="&path;editor-convert-cold.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
diff --git a/digikam/distortionfx_blockwaves1.png b/digikam/editor-distortionfx-blockwaves1.png
similarity index 100%
rename from digikam/distortionfx_blockwaves1.png
rename to digikam/editor-distortionfx-blockwaves1.png
diff --git a/digikam/distortionfx_blockwaves2.png b/digikam/editor-distortionfx-blockwaves2.png
similarity index 100%
rename from digikam/distortionfx_blockwaves2.png
rename to digikam/editor-distortionfx-blockwaves2.png
diff --git a/digikam/distortionfx_caricature.png b/digikam/editor-distortionfx-caricature.png
similarity index 100%
rename from digikam/distortionfx_caricature.png
rename to digikam/editor-distortionfx-caricature.png
diff --git a/digikam/distortionfx_circularwaves1.png b/digikam/editor-distortionfx-circularwaves1.png
similarity index 100%
rename from digikam/distortionfx_circularwaves1.png
rename to digikam/editor-distortionfx-circularwaves1.png
diff --git a/digikam/distortionfx_circularwaves2.png b/digikam/editor-distortionfx-circularwaves2.png
similarity index 100%
rename from digikam/distortionfx_circularwaves2.png
rename to digikam/editor-distortionfx-circularwaves2.png
diff --git a/digikam/distortionfx_corners.png b/digikam/editor-distortionfx-corners.png
similarity index 100%
rename from digikam/distortionfx_corners.png
rename to digikam/editor-distortionfx-corners.png
diff --git a/digikam/distortionfx_cylinderh.png b/digikam/editor-distortionfx-cylinderh.png
similarity index 100%
rename from digikam/distortionfx_cylinderh.png
rename to digikam/editor-distortionfx-cylinderh.png
diff --git a/digikam/distortionfx_cylinderhv.png b/digikam/editor-distortionfx-cylinderhv.png
similarity index 100%
rename from digikam/distortionfx_cylinderhv.png
rename to digikam/editor-distortionfx-cylinderhv.png
diff --git a/digikam/distortionfx_cylinderv.png b/digikam/editor-distortionfx-cylinderv.png
similarity index 100%
rename from digikam/distortionfx_cylinderv.png
rename to digikam/editor-distortionfx-cylinderv.png
diff --git a/digikam/distortionfx_fisheyes.png b/digikam/editor-distortionfx-fisheyes.png
similarity index 100%
rename from digikam/distortionfx_fisheyes.png
rename to digikam/editor-distortionfx-fisheyes.png
diff --git a/digikam/distortionfx_polarcoord.png b/digikam/editor-distortionfx-polarcoord.png
similarity index 100%
rename from digikam/distortionfx_polarcoord.png
rename to digikam/editor-distortionfx-polarcoord.png
diff --git a/digikam/distortionfx_tiles.png b/digikam/editor-distortionfx-tiles.png
similarity index 100%
rename from digikam/distortionfx_tiles.png
rename to digikam/editor-distortionfx-tiles.png
diff --git a/digikam/distortionfx_twirl.png b/digikam/editor-distortionfx-twirl.png
similarity index 100%
rename from digikam/distortionfx_twirl.png
rename to digikam/editor-distortionfx-twirl.png
diff --git a/digikam/distortionfx_unpolarcoord.png b/digikam/editor-distortionfx-unpolarcoord.png
similarity index 100%
rename from digikam/distortionfx_unpolarcoord.png
rename to digikam/editor-distortionfx-unpolarcoord.png
diff --git a/digikam/distortionfx_wavesh.png b/digikam/editor-distortionfx-wavesh.png
similarity index 100%
rename from digikam/distortionfx_wavesh.png
rename to digikam/editor-distortionfx-wavesh.png
diff --git a/digikam/distortionfx_wavesv.png b/digikam/editor-distortionfx-wavesv.png
similarity index 100%
rename from digikam/distortionfx_wavesv.png
rename to digikam/editor-distortionfx-wavesv.png
diff --git a/digikam/distortionfxpreview.png b/digikam/editor-distortionfxpreview.png
similarity index 100%
rename from digikam/distortionfxpreview.png
rename to digikam/editor-distortionfxpreview.png
diff --git a/digikam/embosspreview.png b/digikam/editor-embosspreview.png
similarity index 100%
rename from digikam/embosspreview.png
rename to digikam/editor-embosspreview.png
diff --git a/digikam/filmgrainpreview.png b/digikam/editor-filmgrainpreview.png
similarity index 100%
rename from digikam/filmgrainpreview.png
rename to digikam/editor-filmgrainpreview.png
diff --git a/digikam/editor-filters.docbook b/digikam/editor-filters.docbook
index 839e834..3c66949 100644
--- a/digikam/editor-filters.docbook
+++ b/digikam/editor-filters.docbook
@@ -1,747 +1,716 @@
-<sect2> <title>Special Effects (Filters)</title>
-<sect3 id="infrared">
-<sect3info>
+<sect2> <title>Special Effects (Filters)</title>
-<title>Simulate Infrared Film</title>
+ <sect3 id="infrared">
+ <sect3info>
-<abstract>
-<para>
-The &digikam; <emphasis>Infrared Film</emphasis> filter simulates traditional infrared film material.
-</para>
-</abstract>
+ <title>Simulate Infrared Film</title>
-<keywordset>
-<keyword>Digikam</keyword>
-</keywordset>
+ <abstract>
+ <para>
+ The &digikam; <emphasis>Infrared Film</emphasis> filter simulates traditional infrared film material.
+ </para>
+ </abstract>
-</sect3info>
+ </sect3info>
-<title>Introduction</title>
+ <title>Introduction</title>
-<para>
-Simulating classical infrared film material (the effect is rendered in black and white) is an interesting alienation effect that is even stronger and more dramatic than pure black and white conversion. Contrast and an abstract touch are improved, which can underpin the expression of the photographer as an artist.
+ <para>
+ Simulating classical infrared film material (the effect is rendered in black and white) is an interesting alienation effect that is even stronger and more dramatic than pure black and white conversion. Contrast and an abstract touch are improved, which can underpin the expression of the photographer as an artist.
-It is like taking an image in black and white with a red filter on the camera lenses. Areas which reflect little red light, ⪚ the sky, will show as low density, dark areas. Areas which are excellent reflectors of red light, e.g. most green foliage, will be high density areas. And snow landscapes are really dramatic.
-</para>
+ It is like taking an image in black and white with a red filter on the camera lenses. Areas which reflect little red light, ⪚ the sky, will show as low density, dark areas. Areas which are excellent reflectors of red light, e.g. most green foliage, will be high density areas. And snow landscapes are really dramatic.
+ </para>
-<para>
-The algorithm is based on the method of the 'Simulate Infrared Film' tutorial of the GimpGuru.org web site available at <ulink url="http://www.gimpguru.org/Tutorials/SimulatedInfrared">this url</ulink>.
-The filter tries to reproduce the famous Ilford(tm) SFX200 infrared film. This film has a sensitivity range of 200-800 ISO.
-</para>
+ <para>
+ The algorithm is based on the method of the 'Simulate Infrared Film' tutorial of the GimpGuru.org web site available at <ulink url="http://www.gimpguru.org/Tutorials/SimulatedInfrared">this url</ulink>.
+ The filter tries to reproduce the famous Ilford(tm) SFX200 infrared film. This film has a sensitivity range of 200-800 ISO.
+ </para>
-<sect4 id="using-infrared">
-<title>Using the Infrared Filter</title>
+ <sect4 id="using-infrared">
+ <title>Using the Infrared Filter</title>
-<para>
-The left part of the dialog window lets you select the region to be shown in the preview section. Move the red rectangle with the mouse around to show the effect on different parts of the image.
-</para>
+ <para>
+ The left part of the dialog window lets you select the region to be shown in the preview section. Move the red rectangle with the mouse around to show the effect on different parts of the image.
+ </para>
-<para>
-The lower part provides the two controls, Film Grain and ISO sensitivity. Check the <guilabel>Add Film Grain</guilabel> box if you want to simulate the grainy texture of a high sensitivity film. The ISO-level slider modifies the amount of filmgrain added and the predominance of green color (chlorophyll in nature) in the conversion mixer. Green pastures will become white as snow! Try it out.
-</para>
+ <para>
+ The lower part provides the two controls, Film Grain and ISO sensitivity. Check the <guilabel>Add Film Grain</guilabel> box if you want to simulate the grainy texture of a high sensitivity film. The ISO-level slider modifies the amount of filmgrain added and the predominance of green color (chlorophyll in nature) in the conversion mixer. Green pastures will become white as snow! Try it out.
+ </para>
-<note><para>
-Because the filter mixes color channels to reproduce infrared film (with emphasis on green channel), one can not simulate infrared effect from black and white original photograph, since the color information is missing.
-</para></note>
+ <note><para>
+ Because the filter mixes color channels to reproduce infrared film (with emphasis on green channel), one can not simulate infrared effect from black and white original photograph, since the color information is missing.
+ </para></note>
-</sect4>
+ </sect4>
-<sect4 id="inaction-infrared">
-<title>The filter in action</title>
+ <sect4 id="inaction-infrared">
+ <title>The filter in action</title>
-<para>
-This is an example of the infrared film effect applied to a color image taken in New Zealand's landscapes. The original image is (1) and the converted image is (2). The film sensitivity used to simulate the infrared film is ISO-400. Higher ISO values will create a kind of aura in the highlights.
-</para>
+ <para>
+ This is an example of the infrared film effect applied to a color image taken in New Zealand's landscapes. The original image is (1) and the converted image is (2). The film sensitivity used to simulate the infrared film is ISO-400. Higher ISO values will create a kind of aura in the highlights.
+ </para>
- <para><inlinemediaobject><imageobject>
- <imagedata fileref="&path;infraredpreview.png" format="PNG" /> </imageobject>
- <textobject><phrase>The Infrared filter in Action</phrase></textobject></inlinemediaobject>
- </para>
+ <para><inlinemediaobject><imageobject>
+ <imagedata fileref="&path;editor-infraredpreview.png" format="PNG" /> </imageobject>
+ <textobject><phrase>The Infrared filter in Action</phrase></textobject></inlinemediaobject>
+ </para>
-</sect4>
+ </sect4>
-</sect3>
+ </sect3>
-<sect3 id="filmgrain">
-<sect3info>
+ <sect3 id="filmgrain">
+ <sect3info>
-<title>Film Grain</title>
+ <title>Film Grain</title>
-<abstract>
-<para>
-The &digikam; <emphasis>Filmgrain</emphasis> filter reproduces traditional film grain techniques
-of high speed films.
-</para>
-</abstract>
+ <abstract>
+ <para>
+ The &digikam; <emphasis>Filmgrain</emphasis> filter reproduces traditional film grain techniques
+ of high speed films.
+ </para>
+ </abstract>
-<keywordset>
-<keyword>Digikam</keyword>
-</keywordset>
+ </sect3info>
-</sect3info>
+ <title>Introduction</title>
-<title>Introduction</title>
+ <para>
+ The &digikam; <emphasis>Filmgrain</emphasis> filter is an easy tool to produce film grain on your
+ images as known from classical high speed film material as, for example, the famous B/W KodaK Tri-X.
+ In order to increase film sensitivity, manufacturers employed larger silver grains in the photo emulsion.
+ </para>
-<para>
-The &digikam; <emphasis>Filmgrain</emphasis> filter is an easy tool to produce film grain on your
-images as known from classical high speed film material as, for example, the famous B/W KodaK Tri-X.
-In order to increase film sensitivity, manufacturers employed larger silver grains in the photo emulsion.
-</para>
+ <para>
+ The film grain effect gives your shot a particular mood or seems to transport it in time. The treated
+ image acquires a timeless atmosphere, detached from every day life. If you want that gritty, art-house,
+ street-photography grainy film look, especially in monochromatic photos, use this filter.
+ </para>
-<para>
-The film grain effect gives your shot a particular mood or seems to transport it in time. The treated
-image acquires a timeless atmosphere, detached from every day life. If you want that gritty, art-house,
-street-photography grainy film look, especially in monochromatic photos, use this filter.
-</para>
+ <sect4 id="using-filmgrain">
+ <title>Using the Filmgrain filter</title>
-<sect4 id="using-filmgrain">
-<title>Using the Filmgrain filter</title>
+ <para>
+ There is a slider calibrated in ISO-sensitivity to control the grain intensity and granularity. The
+ default is set to ISO-2400, although higher values are often required. If you still want more grain,
+ apply the filter several times.
+ </para>
-<para>
-There is a slider calibrated in ISO-sensitivity to control the grain intensity and granularity. The
-default is set to ISO-2400, although higher values are often required. If you still want more grain,
-apply the filter several times.
-</para>
+ </sect4>
-</sect4>
+ <sect4 id="inaction-filmgrain">
+ <title>The filter in action</title>
-<sect4 id="inaction-filmgrain">
-<title>The filter in action</title>
+ <para>
+ This is an example of the film grain effect applied on a black and white image. The original
+ image is (1) and the corrected image is (2). The film sensitivity used for simulate the film
+ graininess is ISO-1600.
+ </para>
-<para>
-This is an example of the film grain effect applied on a black and white image. The original
-image is (1) and the corrected image is (2). The film sensitivity used for simulate the film
-graininess is ISO-1600.
-</para>
+ <para><inlinemediaobject><imageobject>
+ <imagedata fileref="&path;editor-filmgrainpreview.png" format="PNG" /> </imageobject>
+ <textobject><phrase>The Film Grain Filter in Action</phrase></textobject></inlinemediaobject>
+ </para>
- <para><inlinemediaobject><imageobject>
- <imagedata fileref="&path;filmgrainpreview.png" format="PNG" /> </imageobject>
- <textobject><phrase>The Film Grain Filter in Action</phrase></textobject></inlinemediaobject>
- </para>
+ </sect4>
-</sect4>
+ </sect3>
-</sect3>
+ <sect3 id="oilpaint">
+ <sect3info>
-<sect3 id="oilpaint">
-<sect3info>
+ <title>Oil Paint</title>
-<title>Oil Paint</title>
+ <abstract>
+ <para>
+ The &digikam; <emphasis>Oil Paint</emphasis> filter gives your image the look of an oilpainting.
+ It uses an algorithm copyrighted by Pieter Voloshyn.
+ </para>
+ </abstract>
-<abstract>
-<para>
-The &digikam; <emphasis>Oil Paint</emphasis> filter gives your image the look of an oilpainting.
-It uses an algorithm copyrighted by Pieter Voloshyn.
-</para>
-</abstract>
+ </sect3info>
-<keywordset>
-<keyword>Digikam</keyword>
-</keywordset>
+ <title>Introduction</title>
-</sect3info>
+ <para>
+ The &digikam; <emphasis>Oil Paint</emphasis> filter gives your digital images a nice
+ oilpainting-like look. Images of nature and still lifes are well suited for this effect.
+ </para>
-<title>Introduction</title>
+ <sect4 id="using-oilpaint">
+ <title>Using the Oil Paint filter</title>
-<para>
-The &digikam; <emphasis>Oil Paint</emphasis> filter gives your digital images a nice
-oilpainting-like look. Images of nature and still lifes are well suited for this effect.
-</para>
+ <para>
+ There are two sliders to control the effect. The upper slider selects the <guilabel>Brush Size</guilabel>
+ between 1 and 5. Bigger brushes are better suited for large images. <guilabel>Smooth</guilabel> controls
+ the smoothness or, seen from the other end, the jaggedness.
+ </para>
-<sect4 id="using-oilpaint">
-<title>Using the Oil Paint filter</title>
+ </sect4>
-<para>
-There are two sliders to control the effect. The upper slider selects the <guilabel>Brush Size</guilabel>
-between 1 and 5. Bigger brushes are better suited for large images. <guilabel>Smooth</guilabel> controls
-the smoothness or, seen from the other end, the jaggedness.
-</para>
+ <sect4 id="inaction-oilpaint">
+ <title>The Oil Paint filter in action</title>
-</sect4>
+ <para>
+ This is an example of the oil paint filter effect. The original image is (1) and the transformed
+ image is (2). <guilabel>Brush Size</guilabel> for this 640 pixel size image is 1,
+ <guilabel>Smooth</guilabel> is 17.
+ </para>
-<sect4 id="inaction-oilpaint">
-<title>The Oil Paint filter in action</title>
+ <para><inlinemediaobject><imageobject>
+ <imagedata fileref="&path;editor-oilpaintpreview.png" format="PNG" /> </imageobject>
+ <textobject><phrase>Oil Paint Image Effect Preview</phrase></textobject></inlinemediaobject>
+ </para>
-<para>
-This is an example of the oil paint filter effect. The original image is (1) and the transformed
-image is (2). <guilabel>Brush Size</guilabel> for this 640 pixel size image is 1,
-<guilabel>Smooth</guilabel> is 17.
-</para>
+ </sect4>
- <para><inlinemediaobject><imageobject>
- <imagedata fileref="&path;oilpaintpreview.png" format="PNG" /> </imageobject>
- <textobject><phrase>Oil Paint Image Effect Preview</phrase></textobject></inlinemediaobject>
- </para>
+ </sect3>
-</sect4>
+ <sect3 id="charcoal">
+ <sect3info>
-</sect3>
+ <title>Charcoal Drawing</title>
-<sect3 id="charcoal">
-<sect3info>
+ <abstract>
+ <para>
+ The &digikam; <emphasis>Charcoal</emphasis> is an effect filter that creates a charcoal sketch-like result.
+ </para>
+ </abstract>
-<title>Charcoal Drawing</title>
+ </sect3info>
-<abstract>
-<para>
-The &digikam; <emphasis>Charcoal</emphasis> is an effect filter that creates a charcoal sketch-like result.
-</para>
-</abstract>
+ <title>Introduction</title>
-<keywordset>
-<keyword>Digikam</keyword>
-</keywordset>
+ <para>
+ The &digikam; <emphasis>Charcoal</emphasis> filter uses the gradients of color and luminosity to
+ produce a grey scale charcoal sketch. The lines defining the outline of the image are pronounced.
+ Images with slowly changing gradients are not ideal for this effect. It is helpful to imagine what
+ scene you would pick to do as a hand sketch yourself, in order to choose the image to start with.
+ </para>
-</sect3info>
+ <sect4 id="using-charcoal">
+ <title>Using the Charcoal filter</title>
-<title>Introduction</title>
+ <para>
+ There are two sliders to control the effect on a scale of 1-100. The upper slider selects the pencil size,
+ whereas the second slider adjusts the contrast (smoothness).
+ </para>
-<para>
-The &digikam; <emphasis>Charcoal</emphasis> filter uses the gradients of color and luminosity to
-produce a grey scale charcoal sketch. The lines defining the outline of the image are pronounced.
-Images with slowly changing gradients are not ideal for this effect. It is helpful to imagine what
-scene you would pick to do as a hand sketch yourself, in order to choose the image to start with.
-</para>
+ </sect4>
-<sect4 id="using-charcoal">
-<title>Using the Charcoal filter</title>
+ <sect4 id="inaction-charcoal">
+ <title>The Charcoal filter in action</title>
-<para>
-There are two sliders to control the effect on a scale of 1-100. The upper slider selects the pencil size,
-whereas the second slider adjusts the contrast (smoothness).
-</para>
+ <para>
+ This is an example of the charcoal filter. The original image is (1) and the transformed image is (2).
+ Default values of 30 and 10 where applied. The result can be improved by adjusting the luminosity levels.
+ </para>
-</sect4>
+ <para><inlinemediaobject><imageobject>
+ <imagedata fileref="&path;editor-charcoalpreview.png" format="PNG" /> </imageobject>
+ <textobject><phrase>The Charcoal filter in Action</phrase></textobject></inlinemediaobject>
+ </para>
-<sect4 id="inaction-charcoal">
-<title>The Charcoal filter in action</title>
+ </sect4>
-<para>
-This is an example of the charcoal filter. The original image is (1) and the transformed image is (2).
-Default values of 30 and 10 where applied. The result can be improved by adjusting the luminosity levels.
-</para>
+ </sect3>
- <para><inlinemediaobject><imageobject>
- <imagedata fileref="&path;charcoalpreview.png" format="PNG" /> </imageobject>
- <textobject><phrase>The Charcoal filter in Action</phrase></textobject></inlinemediaobject>
- </para>
+ <sect3 id="emboss">
+ <sect3info>
-</sect4>
+ <title>Emboss Image</title>
-</sect3>
+ <abstract>
+ <para>
+ The &digikam; <emphasis>Emboss</emphasis> filter sculptures your image into 3-D as if it were stamped into wax. It uses an algorithm copyrighted by Pieter Voloshyn.
+ </para>
+ </abstract>
-<sect3 id="emboss">
-<sect3info>
+ </sect3info> <title>Introduction</title>
-<title>Emboss Image</title>
+ <para>
+ The &digikam; <emphasis>Emboss</emphasis> filter is a quick tool to render your images in a 3-D effect.
+ It works particularly well on images with simple structure where color is not the most important content.
+ The filter uses the difference between colors and luminosity to convert it into a grey, moon-like landscape
+ lit from 10 o'clock.
+ </para>
-<abstract>
-<para>
-The &digikam; <emphasis>Emboss</emphasis> filter sculptures your image into 3-D as if it were stamped into wax. It uses an algorithm copyrighted by Pieter Voloshyn.
-</para>
-</abstract>
+ <sect4 id="using-emboss"> <title>Using the Emboss filter</title>
-<keywordset>
-<keyword>Digikam</keyword>
-</keywordset>
+ <para>
+ The <guilabel>Depth</guilabel> control allows to define the contrast of the filtering.
+ A value of 30 (10%) is the standard.
+ </para>
+
+ </sect4>
+
+ <sect4 id="inaction-emboss"> <title>The Emboss filter in action</title>
+
+ <para>
+ This is an example of the emboss filter. The original image is (1) and the transformed image is (2).
+ The <guilabel>Depth</guilabel> applied is 10%.
+ </para>
+
+ <para><inlinemediaobject><imageobject>
+ <imagedata fileref="&path;embosspreview.png" format="PNG" /> </imageobject>
+ <textobject><phrase>The Emboss filter in Action</phrase></textobject></inlinemediaobject>
+ </para>
+
+ </sect4>
+
+ </sect3>
+
+ <sect3 id="distortionfx">
+ <sect3info>
+
+ <title>Distortion FX</title>
+
+ <abstract>
+ <para>
+ The &digikam; <emphasis>Distortion FX</emphasis> is a series of distorting effects for digital still images.
+ </para>
+ </abstract>
+
+ </sect3info>
+
+ <title>Introduction</title>
+
+ <para>
+ With this filter set, you can transform an ordinary photograph into a work of art suitable for framing using distorting operations. It uses algorithms copyrighted by Pieter Voloshyn.
+ </para>
+
+ <sect4 id="using-distortionfx">
+ <title>Using the filter</title>
+
+ <para>
+ These are the distorting effects available:
+ </para>
+
+ <para>
+
+ <informaltable><tgroup cols="2">
+
+ <thead>
+ <row>
+ <entry>Type</entry>
+ <entry>Preview</entry>
+ </row>
+ </thead>
+
+ <tbody>
+
+ <row>
+ <entry>
+ <guilabel>Fish Eyes</guilabel>: warps the photograph around a 3D spherical shape to reproduce the common photograph 'Fish Eyes' effect.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-fisheyes.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Twirl</guilabel>: spins the photograph to produce a Twirl pattern.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-twirl.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Cylinder Horizontal</guilabel>: warps the photograph around a horizontal cylinder.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-cylinderh.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Cylinder Vertical</guilabel>: warps the photograph around a vertical cylinder.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-cylinderv.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Cylinder H/V</guilabel>: warps the photograph around a 2 cylinders, vertical and horizontal.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-cylinderhv.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Caricature</guilabel>: distorts photograph with 'Fish Eyes' effect inverted.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-caricature.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Multiple Corners</guilabel>: splits the photograph like a multiple corners pattern.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-corners.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Waves Horizontal</guilabel>: distorts the photograph with horizontal waves.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-wavesh.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Waves Vertical</guilabel>: distorts the photograph with vertical waves.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-wavesv.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Block Waves 1</guilabel>: divides the image into cells and makes it look as if it is being viewed through glass blocks.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-blockwaves1.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Block Waves 2</guilabel>: like Block Waves 1 but with another version of glass blocks distortion.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-blockwaves2.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Circular Waves 1</guilabel>: distorts the photograph with circular waves.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-circularwaves1.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Circular Waves 2</guilabel>: other variation of Circular Waves effect.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-circularwaves2.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Polar Coordinates</guilabel>: converts the photograph from rectangular to polar coordinates.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-polarcoord.png" format="PNG" /> </imageobject></inlinemediaobject></para> </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Unpolar Coordinates</guilabel>: Polar Coordinate effect inverted.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-unpolarcoord.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Tiles</guilabel>: splits the photograph into square blocks and move them randomly inside the image.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-distortionfx-tiles.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ </tbody>
+
+ </tgroup></informaltable>
+
+ </para>
+
+ <warning><para>
+ Some effects can take a long time to run and cause high CPU load. You can always abort an effect by pressing <guilabel>Abort</guilabel> button during preview rendering.
+ </para></warning>
+
+ </sect4>
+
+ <sect4 id="inaction-distortionfx">
+ <title>The Distortion filter in action</title>
+
+ <para>
+ The Distortion FX dialog tool in action is available below.
+ </para>
+
+ <para><inlinemediaobject><imageobject>
+ <imagedata fileref="&path;editor-distortionfxpreview.png" format="PNG" /> </imageobject>
+ <textobject><phrase>The Distortion FX Dialog Tool Preview</phrase></textobject></inlinemediaobject>
+ </para>
+
+ </sect4>
+
+ </sect3>
+
+ <sect3 id="blurfx">
+ <sect3info>
+
+ <title>Blur FX</title>
+
+ <abstract>
+ <para>
+ The &digikam; <emphasis>Blur FX</emphasis> is a series of blurring effects for digital still images.
+ </para>
+ </abstract>
+
+ </sect3info>
+
+ <title>Introduction</title>
+
+ <para>
+ With this filter set, you can transform an ordinary photograph into a work of art suitable for framing using blurring operations. It uses algorithms copyrighted by Pieter Voloshyn.
+ </para>
+
+ <sect4 id="using-blurfx">
+ <title>Using the Blurfx</title>
+
+ <para>
+ These are the blurring effects available:
+ </para>
+
+ <para>
+
+ <informaltable><tgroup cols="2">
+
+ <thead>
+ <row>
+ <entry>Type</entry>
+ <entry>Preview</entry>
+ </row>
+ </thead>
+
+ <tbody>
+
+ <row>
+ <entry>
+ <guilabel>Zoom Blur</guilabel>: blurs the image along radial lines starting from a specified center point. This simulates the blur of a zooming camera, thereby giving the photograph a dynamic expression as often seen in sport photography.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-blurfx-zoomblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Radial Blur</guilabel>: blurs the image by rotating the pixels around the specified center point. This simulates the blur of a rotating camera.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-blurfx-radialblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Far Blur</guilabel>: blurs the image to simulate the effect of an unfocused camera lens. The subject seems to recede into the background.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-blurfx-farblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Motion Blur</guilabel>: blurs the image by swishing the pixels horizontally. This simulates the blur of a linearly moving camera, i.e. like a shot taken from a car or train.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-blurfx-motionblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Focus Blur</guilabel>: blurs the image corners to reproduce the astigmatism distortion of a lens.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-blurfx-focusblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Softener Blur</guilabel>: blurs the image softly in the darker tones and strongly in the high lights. This gives photographs a dreamy and glossy soft focus effect (Hamilton effect). It's ideal for creating romantic portraits, glamour photography, or adding a warm and subtle glow.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-blurfx-softenerblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Shake Blur</guilabel>: blurs the image by randomly moving the pixels simulating the blur of an arbitrarily moving camera.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-blurfx-shakeblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Smart Blur</guilabel>: finds the edges of color in photograph and blurs them without muddying the rest of the image.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-blurfx-smartblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Frost Glass</guilabel>: blurs the image by simulating randomly dispersing light filtering through hoarse frosted glass.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-blurfx-frostglass.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <guilabel>Mosaic</guilabel>: blurs the image by dividing the photograph into rectangular cells and then recreates it by filling those cells with average pixel value.
+ </entry>
+
+ <entry>
+ <para><inlinemediaobject><imageobject><imagedata fileref="&path;editor-blurfx-mosaic.png" format="PNG" /> </imageobject></inlinemediaobject></para>
+ </entry>
+ </row>
+
+ </tbody>
+
+ </tgroup></informaltable>
+
+ </para>
+
+ <warning><para>
+ Some effects can take a long time to run and cause high CPU load. You can always abort an effect by pressing the <guilabel>Abort</guilabel> button during preview rendering.
+ </para></warning>
+
+ </sect4>
+
+ <sect4 id="inaction-blurfx">
+ <title>The Blurfx in action</title>
+
+ <para>
+ An example of the Blur FX dialog in action is shown below.
+ </para>
+
+ <para><inlinemediaobject><imageobject>
+ <imagedata fileref="&path;editor-blurfxpreview.png" format="PNG" /> </imageobject>
+ <textobject><phrase>The Blur FX Dialog Tool Preview</phrase></textobject></inlinemediaobject>
+ </para>
+
+ </sect4>
+
+ </sect3>
+
+ <sect3 id="raindrops">
+ <sect3info>
+
+ <title>Rain Drops</title>
+
+ <abstract>
+ <para>
+ The &digikam; <emphasis>Raindrops</emphasis> filter puts beautiful raindrops on your image.
+ </para>
+ </abstract>
+
+ </sect3info>
+
+ <title>Introduction</title>
+
+ <para>
+ The <emphasis>Raindrops</emphasis> is nice little tool to put raindrops onto your images. Naturally, it renders your image in a kind of wet look. It uses an algorithm copyrighted by Pieter Voloshyn.
+ </para>
+
+ <sect4 id="using-raindrops">
+ <title>Using the Raindrops filter</title>
+
+ <para>
+ Three sliders give you control over the effect filter:
+ </para>
+
+ <para>
+ <guilabel>Drop size</guilabel> obviously allows to change the size of the drops. As the drop size doesn't
+ automatically scale with the image size it is often necessary to reduce the size for small images.
+ <guilabel>Number</guilabel> changes the number and density of drops.
+ <guilabel>Fish eye</guilabel> changes the optical effect of the drops across the image.
+ </para>
+
+ <note><para>
+ You can keep a zone clear of raindrops with the &digikam; Image Editor <guilabel>Select</guilabel> tool.
+ Selecting the area to avoid (for example a face) before launching the <emphasis>Raindrops</emphasis>
+ filter will keep it free from rain drops.
+ </para></note>
+
+ </sect4>
+
+ <sect4 id="inaction-raindrops">
+ <title>The Raindrops filter in action</title>
+
+ <para>
+ This is an example of the raindrops filter. The original image (1) shows a quiet sunset,
+ the transformed image (2) indicates a sunset after a thunderstorm. Default values have been
+ used for this example.
+ </para>
-</sect3info> <title>Introduction</title>
+ <para><inlinemediaobject><imageobject>
+ <imagedata fileref="&path;editor-raindropspreview.png" format="PNG" /> </imageobject>
+ <textobject><phrase>Rain Drops Image Effect Preview</phrase></textobject></inlinemediaobject>
+ </para>
-<para>
-The &digikam; <emphasis>Emboss</emphasis> filter is a quick tool to render your images in a 3-D effect.
-It works particularly well on images with simple structure where color is not the most important content.
-The filter uses the difference between colors and luminosity to convert it into a grey, moon-like landscape
-lit from 10 o'clock.
-</para>
+ </sect4>
-<sect4 id="using-emboss"> <title>Using the Emboss filter</title>
-
-<para>
-The <guilabel>Depth</guilabel> control allows to define the contrast of the filtering.
-A value of 30 (10%) is the standard.
-</para>
-
-</sect4>
-
-<sect4 id="inaction-emboss"> <title>The Emboss filter in action</title>
-
-<para>
-This is an example of the emboss filter. The original image is (1) and the transformed image is (2).
-The <guilabel>Depth</guilabel> applied is 10%.
-</para>
-
- <para><inlinemediaobject><imageobject>
- <imagedata fileref="&path;embosspreview.png" format="PNG" /> </imageobject>
- <textobject><phrase>The Emboss filter in Action</phrase></textobject></inlinemediaobject>
- </para>
-
-</sect4>
-
-</sect3>
-
-<sect3 id="distortionfx">
-<sect3info>
-
-<title>Distortion FX</title>
-
-<abstract>
-<para>
-The &digikam; <emphasis>Distortion FX</emphasis> is a series of distorting effects for digital still images.
-</para>
-</abstract>
-
-<keywordset>
-<keyword>Digikam</keyword>
-</keywordset>
-
-</sect3info>
-
-<title>Introduction</title>
-
-<para>
-With this filter set, you can transform an ordinary photograph into a work of art suitable for framing using distorting operations. It uses algorithms copyrighted by Pieter Voloshyn.
-</para>
-
-<sect4 id="using-distortionfx">
-<title>Using the filter</title>
-
-<para>
-These are the distorting effects available:
-</para>
-
-<para>
-
-<informaltable><tgroup cols="2">
-
-<thead>
- <row>
- <entry>Type</entry>
- <entry>Preview</entry>
- </row>
-</thead>
-
-<tbody>
-
- <row>
- <entry>
- <guilabel>Fish Eyes</guilabel>: warps the photograph around a 3D spherical shape to reproduce the common photograph 'Fish Eyes' effect.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_fisheyes.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Twirl</guilabel>: spins the photograph to produce a Twirl pattern.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_twirl.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Cylinder Horizontal</guilabel>: warps the photograph around a horizontal cylinder.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_cylinderh.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Cylinder Vertical</guilabel>: warps the photograph around a vertical cylinder.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_cylinderv.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Cylinder H/V</guilabel>: warps the photograph around a 2 cylinders, vertical and horizontal.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_cylinderhv.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Caricature</guilabel>: distorts photograph with 'Fish Eyes' effect inverted.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_caricature.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Multiple Corners</guilabel>: splits the photograph like a multiple corners pattern.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_corners.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Waves Horizontal</guilabel>: distorts the photograph with horizontal waves.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_wavesh.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Waves Vertical</guilabel>: distorts the photograph with vertical waves.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_wavesv.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Block Waves 1</guilabel>: divides the image into cells and makes it look as if it is being viewed through glass blocks.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_blockwaves1.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Block Waves 2</guilabel>: like Block Waves 1 but with another version of glass blocks distortion.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_blockwaves2.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Circular Waves 1</guilabel>: distorts the photograph with circular waves.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_circularwaves1.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Circular Waves 2</guilabel>: other variation of Circular Waves effect.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_circularwaves2.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Polar Coordinates</guilabel>: converts the photograph from rectangular to polar coordinates.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_polarcoord.png" format="PNG" /> </imageobject></inlinemediaobject></para> </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Unpolar Coordinates</guilabel>: Polar Coordinate effect inverted.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_unpolarcoord.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Tiles</guilabel>: splits the photograph into square blocks and move them randomly inside the image.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_tiles.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
-</tbody>
-
-</tgroup></informaltable>
-
-</para>
-
-<warning><para>
-Some effects can take a long time to run and cause high CPU load. You can always abort an effect by pressing <guilabel>Abort</guilabel> button during preview rendering.
-</para></warning>
-
-</sect4>
-
-<sect4 id="inaction-distortionfx">
-<title>The Distortion filter in action</title>
-
-<para>
-The Distortion FX dialog tool in action is available below.
-</para>
-
- <para><inlinemediaobject><imageobject>
- <imagedata fileref="&path;distortionfxpreview.png" format="PNG" /> </imageobject>
- <textobject><phrase>The Distortion FX Dialog Tool Preview</phrase></textobject></inlinemediaobject>
- </para>
-
-</sect4>
-
-</sect3>
-
-<sect3 id="blurfx">
-<sect3info>
-
-<title>Blur FX</title>
-
-<abstract>
-<para>
-The &digikam; <emphasis>Blur FX</emphasis> is a series of blurring effects for digital still images.
-</para>
-</abstract>
-
-<keywordset>
-<keyword>Digikam</keyword>
-</keywordset>
-
-</sect3info>
-
-<title>Introduction</title>
-
-<para>
-With this filter set, you can transform an ordinary photograph into a work of art suitable for framing using blurring operations. It uses algorithms copyrighted by Pieter Voloshyn.
-</para>
-
-<sect4 id="using-blurfx">
-<title>Using the Blurfx</title>
-
-<para>
-These are the blurring effects available:
-</para>
-
-<para>
-
-<informaltable><tgroup cols="2">
-
-<thead>
- <row>
- <entry>Type</entry>
- <entry>Preview</entry>
- </row>
-</thead>
-
-<tbody>
-
- <row>
- <entry>
- <guilabel>Zoom Blur</guilabel>: blurs the image along radial lines starting from a specified center point. This simulates the blur of a zooming camera, thereby giving the photograph a dynamic expression as often seen in sport photography.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_zoomblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Radial Blur</guilabel>: blurs the image by rotating the pixels around the specified center point. This simulates the blur of a rotating camera.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_radialblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Far Blur</guilabel>: blurs the image to simulate the effect of an unfocused camera lens. The subject seems to recede into the background.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_farblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Motion Blur</guilabel>: blurs the image by swishing the pixels horizontally. This simulates the blur of a linearly moving camera, i.e. like a shot taken from a car or train.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_motionblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Focus Blur</guilabel>: blurs the image corners to reproduce the astigmatism distortion of a lens.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_focusblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Softener Blur</guilabel>: blurs the image softly in the darker tones and strongly in the high lights. This gives photographs a dreamy and glossy soft focus effect (Hamilton effect). It's ideal for creating romantic portraits, glamour photography, or adding a warm and subtle glow.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_softenerblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Shake Blur</guilabel>: blurs the image by randomly moving the pixels simulating the blur of an arbitrarily moving camera.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_shakeblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Smart Blur</guilabel>: finds the edges of color in photograph and blurs them without muddying the rest of the image.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_smartblur.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Frost Glass</guilabel>: blurs the image by simulating randomly dispersing light filtering through hoarse frosted glass.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_frostglass.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
- <row>
- <entry>
- <guilabel>Mosaic</guilabel>: blurs the image by dividing the photograph into rectangular cells and then recreates it by filling those cells with average pixel value.
- </entry>
-
- <entry>
- <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_mosaic.png" format="PNG" /> </imageobject></inlinemediaobject></para>
- </entry>
- </row>
-
-</tbody>
-
-</tgroup></informaltable>
-
-</para>
-
-<warning><para>
-Some effects can take a long time to run and cause high CPU load. You can always abort an effect by pressing the <guilabel>Abort</guilabel> button during preview rendering.
-</para></warning>
-
-</sect4>
-
-<sect4 id="inaction-blurfx">
-<title>The Blurfx in action</title>
-
-<para>
-An example of the Blur FX dialog in action is shown below.
-</para>
-
- <para><inlinemediaobject><imageobject>
- <imagedata fileref="&path;blurfxpreview.png" format="PNG" /> </imageobject>
- <textobject><phrase>The Blur FX Dialog Tool Preview</phrase></textobject></inlinemediaobject>
- </para>
-
-</sect4>
-
-</sect3>
-
-<sect3 id="raindrops">
-<sect3info>
-
-<title>Rain Drops</title>
-
-<abstract>
-<para>
-The &digikam; <emphasis>Raindrops</emphasis> filter puts beautiful raindrops on your image.
-</para>
-</abstract>
-
-<keywordset>
-<keyword>Digikam</keyword>
-</keywordset>
-
-</sect3info>
-
-<title>Introduction</title>
-
-<para>
-The <emphasis>Raindrops</emphasis> is nice little tool to put raindrops onto your images. Naturally, it renders your image in a kind of wet look. It uses an algorithm copyrighted by Pieter Voloshyn.
-</para>
-
-<sect4 id="using-raindrops">
-<title>Using the Raindrops filter</title>
-
-<para>
-Three sliders give you control over the effect filter:
-</para>
-
-<para>
-<guilabel>Drop size</guilabel> obviously allows to change the size of the drops. As the drop size doesn't
-automatically scale with the image size it is often necessary to reduce the size for small images.
-<guilabel>Number</guilabel> changes the number and density of drops.
-<guilabel>Fish eye</guilabel> changes the optical effect of the drops across the image.
-</para>
-
-<note><para>
-You can keep a zone clear of raindrops with the &digikam; Image Editor <guilabel>Select</guilabel> tool.
-Selecting the area to avoid (for example a face) before launching the <emphasis>Raindrops</emphasis>
-filter will keep it free from rain drops.
-</para></note>
-
-</sect4>
-
-<sect4 id="inaction-raindrops">
-<title>The Raindrops filter in action</title>
-
-<para>
-This is an example of the raindrops filter. The original image (1) shows a quiet sunset,
-the transformed image (2) indicates a sunset after a thunderstorm. Default values have been
-used for this example.
-</para>
-
- <para><inlinemediaobject><imageobject>
- <imagedata fileref="&path;raindropspreview.png" format="PNG" /> </imageobject>
- <textobject><phrase>Rain Drops Image Effect Preview</phrase></textobject></inlinemediaobject>
- </para>
-
-</sect4>
-
-</sect3>
+ </sect3>
</sect2>
diff --git a/digikam/infraredpreview.png b/digikam/editor-infraredpreview.png
similarity index 100%
rename from digikam/infraredpreview.png
rename to digikam/editor-infraredpreview.png
diff --git a/digikam/oilpaintpreview.png b/digikam/editor-oilpaintpreview.png
similarity index 100%
rename from digikam/oilpaintpreview.png
rename to digikam/editor-oilpaintpreview.png
diff --git a/digikam/raindropspreview.png b/digikam/editor-raindropspreview.png
similarity index 100%
rename from digikam/raindropspreview.png
rename to digikam/editor-raindropspreview.png
More information about the kde-doc-english
mailing list