Warning, /documentation/digikam-doc/image_editor/effects_tools.rst is written in an unsupported language. File is not indexed.

0001 .. meta::
0002    :description: digiKam Image Editor Effects Tools
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, image, editor, blur, charcoal, solarize, vivid, neon, edges, lut3D, distortion, emboss, film, grain, oil, paint, rain, drops
0004 
0005 .. metadata-placeholder
0006 
0007    :authors: - digiKam Team
0008 
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0010 
0011 .. _effects_tools:
0012 
0013 Effects Tools
0014 =============
0015 
0016 .. contents::
0017 
0018 .. _effects_blur:
0019 
0020 Blur FX
0021 -------
0022 
0023 The digiKam Blur FX is a series of blurring effects for digital still images.
0024 
0025 With this filter set, you can transform an ordinary photograph into a work of art suitable for framing using blurring operations.
0026 
0027 .. figure:: images/editor_blur_fx.webp
0028     :alt:
0029     :align: center
0030 
0031     The digiKam Image Editor Blur FX Tool
0032 
0033 These are the blurring effects available:
0034 
0035     - **Zoom Blur**: 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.
0036 
0037     - **Radial Blur**: blurs the image by rotating the pixels around the specified center point. This simulates the blur of a rotating camera.
0038 
0039     - **Far Blur**: blurs the image to simulate the effect of an unfocused camera lens. The subject seems to recede into the background.
0040 
0041     - **Motion Blur**: 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.
0042 
0043     - **Focus Blur**: blurs the image corners to reproduce the astigmatism distortion of a lens.
0044 
0045     - **Softener Blur**: 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.
0046 
0047     - **Shake Blur**: blurs the image by randomly moving the pixels simulating the blur of an arbitrarily moving camera.
0048 
0049     - **Smart Blur**: finds the edges of color in photograph and blurs them without muddying the rest of the image.
0050 
0051     - **Frost Glass**: blurs the image by simulating randomly dispersing light filtering through hoarse frosted glass.
0052 
0053     - **Mosaic**: blurs the image by dividing the photograph into rectangular cells and then recreates it by filling those cells with average pixel value.
0054 
0055 .. warning::
0056 
0057     Some effects can take a long time to run and cause high CPU load. You can always abort an effect by pressing the **Abort** button during preview rendering.
0058 
0059 .. _effects_charcoal:
0060 
0061 Charcoal Drawing
0062 ----------------
0063 
0064 The digiKam Charcoal is an effect filter that creates a charcoal sketch-like result.
0065 
0066 The digiKam Charcoal 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.
0067 
0068 .. figure:: images/editor_charcoal.webp
0069     :alt:
0070     :align: center
0071 
0072     The digiKam Image Editor Charcoal Tool
0073 
0074 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 (**Smooth**).
0075 
0076 .. note ::
0077 
0078     The result can be improved by adjusting the luminosity levels.
0079 
0080 .. _effects_color:
0081 
0082 Color Filter Effects
0083 --------------------
0084 
0085 The digiKam Color Effects tool provides four color effects: a Solarization effect, a Velvia filter, Neon effect, Edge filter, and Lut3D.
0086 
0087 In the age of chemical image processing, solarizing (also known as Sabatier) was an effect created by exposing a partially developed print to a brief flash of light, then completing the development. The colored, darker areas shield the additional light from the sensitive photo layers, which has the net effect of making the lighter areas darker and colors being inverted during the second exposure. The result resembles a partially negative image. The tool allows to adjust the interesting effect smoothly.
0088 
0089 .. _effects_solarize:
0090 
0091 The Solarization Effect
0092 ~~~~~~~~~~~~~~~~~~~~~~~
0093 
0094 The **Level** control helps to preview the solarization by simply increasing it. At about 50% intensity the image shows what was once chemically possible. If you further increase the effect it will finally become a negative image, a stage of inversion not achievable on photographic paper.
0095 
0096 .. figure:: images/editor_solarize.webp
0097     :alt:
0098     :align: center
0099 
0100     The digiKam Image Editor Solarize Tool
0101 
0102 .. _effects_vivid:
0103 
0104 The Vivid Effect
0105 ~~~~~~~~~~~~~~~~
0106 
0107 The vivid filter simulates what is known as *Velvia* effect. It is different from saturation in that it has a more pronounced contrast effect that bring colors brilliantly alive and glowing. Try it, it renders beautiful for many subjects.
0108 
0109 Velvia is a brand of daylight-balanced color reversal film produced by the Japanese company Fujifilm. The name is a contraction of *Velvet Media*, a reference to its smooth image structure. Velvia has very saturated colors under daylight, high contrast. These characteristics make it the slide film of choice for most nature photographers. Velvia's highly saturated colors are, however, considered overdone by some photographers, especially those who don't primarily shoot landscapes. You can control the Velvia intensity with the **level** setting.
0110 
0111 .. figure:: images/editor_vivid.webp
0112     :alt:
0113     :align: center
0114 
0115     The digiKam Image Editor Vivid Tool
0116 
0117 .. _effects_neon:
0118 
0119 The Neon Effect
0120 ~~~~~~~~~~~~~~~
0121 
0122 The neon filter simulates neon light along the contrast edges. The **Level** parameter controls the lightness of the result, whereas the **Iteraction** slider determines the thickness of the neon light. With big images, the filter might eat the CPU time for a moment.
0123 
0124 .. figure:: images/editor_neon.webp
0125     :alt:
0126     :align: center
0127 
0128     The digiKam Image Editor Neon Tool
0129 
0130 .. _effects_edges:
0131 
0132 The Find Edges Effect
0133 ~~~~~~~~~~~~~~~~~~~~~
0134 
0135 The find edges filter detects the edges in a photograph and their strength. With the **Level** parameter, a low value results in black, high-contrasted image with thin edges. A high value results in thick edges with low contrast and many colors in dark areas. **Iteration** allows to increase or decrease the frame presence in image.
0136 
0137 .. figure:: images/editor_edges.webp
0138     :alt:
0139     :align: center
0140 
0141     The digiKam Image Editor Find Edges Tool
0142 
0143 .. _effects_lut3d:
0144 
0145 The Lut3D Effect
0146 ~~~~~~~~~~~~~~~~
0147 
0148 The Lut3D filter coloring images by applying transformation based on a 3D lookup table. 
0149 
0150 In the film industry, 3D lookup tables are used to map one color space to another. They are commonly used to calculate preview colors for a monitor or digital projector of how an image will be reproduced on another display device, typically the final digitally projected image or release print of a movie. A 3D LUT is a 3D lattice of output RGB color values that can be indexed by sets of input RGB colour values. Each axis of the lattice represents one of the three input color components and the input color thus defines a point inside the lattice. Since the point may not be on a lattice point, the lattice values must be interpolated; most products use trilinear interpolation.
0151 
0152 The tool provide a list of Lut3D to apply on the image, including preview thumbnail of the effect. **Intensity** setting allows to adjust the colors overall of the effect on image.
0153 
0154 .. figure:: images/editor_lut3d.webp
0155     :alt:
0156     :align: center
0157 
0158     The digiKam Image Editor Lut3D Tool
0159 
0160 .. _effects_distortion:
0161 
0162 Distortion FX
0163 -------------
0164 
0165 The digiKam Distortion FX is a series of distorting effects for digital still images.
0166 
0167 With this filter set, you can transform an ordinary photograph into a work of art suitable for framing using distorting operations.
0168 
0169 .. figure:: images/editor_distortion_fx.webp
0170     :alt:
0171     :align: center
0172 
0173     The digiKam Image Editor Distortion FX Tool
0174 
0175 These are the distorting effects available:
0176 
0177     - **Fish Eyes**: warps the photograph around a 3D spherical shape to reproduce the common photograph 'Fish Eyes' effect.
0178 
0179     - **Twirl**: spins the photograph to produce a Twirl pattern.
0180 
0181     - **Cylinder Horizontal**: warps the photograph around a horizontal cylinder.
0182 
0183     - **Cylinder Vertical**: warps the photograph around a vertical cylinder.
0184 
0185     - **Cylinder H/V**: warps the photograph around a 2 cylinders, vertical and horizontal.
0186 
0187     - **Caricature**: distorts photograph with 'Fish Eyes' effect inverted.
0188 
0189     - **Multiple Corners**: splits the photograph like a multiple corners pattern.
0190 
0191     - **Waves Horizontal**: distorts the photograph with horizontal waves.
0192 
0193     - **Waves Vertical**: distorts the photograph with vertical waves.
0194 
0195     - **Block Waves 1**: divides the image into cells and makes it look as if it is being viewed through glass blocks.
0196 
0197     - **Block Waves 2**: like Block Waves 1 but with another version of glass blocks distortion.
0198 
0199     - **Circular Waves 1**: distorts the photograph with circular waves.
0200 
0201     - **Circular Waves 2**: other variation of Circular Waves effect.
0202 
0203     - **Polar Coordinates**: converts the photograph from rectangular to polar coordinates.
0204 
0205     - **Unpolar Coordinates**: Polar Coordinate effect inverted.
0206 
0207     - **Tiles**: splits the photograph into square blocks and move them randomly inside the image.
0208 
0209 .. warning::
0210 
0211     Some effects can take a long time to run and cause high CPU load. You can always abort an effect by pressing **Abort** button during preview rendering.
0212 
0213 .. _effects_emboss:
0214 
0215 Emboss Image
0216 ------------
0217 
0218 The digiKam Emboss filter sculptures your image into 3-D as if it were stamped into wax.
0219 
0220 The digiKam Emboss 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.
0221 
0222 The **Depth** control allows to define the contrast of the filtering. A value of 30 (10%) is the standard.
0223 
0224 .. figure:: images/editor_emboss.webp
0225     :alt:
0226     :align: center
0227 
0228     The digiKam Image Editor Emboss Tool
0229 
0230 .. _effects_filmgrain:
0231 
0232 Film Grain
0233 ----------
0234 
0235 The digiKam Filmgrain filter reproduces traditional film grain techniques of high speed films.
0236 
0237 This 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.
0238 
0239 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.
0240 
0241 .. figure:: images/editor_film_grain.webp
0242     :alt:
0243     :align: center
0244 
0245     The digiKam Image Editor Film Grain Tool
0246 
0247 As common settings, a slider allows control the **Grain size** and you can turn on the granularity simulating a photographic distribution. For **Luminance**, **Chrominance Blue**, and **Chrominance Red** channels, you can adjust the grain **Intensity** with a effects on **Shadows**, **Middletones**, and **Highlight**.
0248 
0249 .. note::
0250 
0251     If you process a black and white image, the grain needs to be applied only on **Luminance** channel.
0252 
0253 .. _effects_oilpaint:
0254 
0255 Oil Paint
0256 ---------
0257 
0258 The digiKam Oil Paint filter gives your image the look of an oilpainting.
0259 
0260 This filter gives your digital images a nice oilpainting-like look. Images of nature and still lives are well suited for this effect.
0261 
0262 .. figure:: images/editor_oil_paint.webp
0263     :alt:
0264     :align: center
0265 
0266     The digiKam Image Editor Oil Paint Tool
0267 
0268 There are two sliders to control the effect. The upper slider selects the **Brush Size** between 1 and 5. Bigger brushes are better suited for large images. **Smooth** controls the smoothness or, seen from the other end, the jaggedness.
0269 
0270 .. _effects_raindrops:
0271 
0272 Rain Drops
0273 ----------
0274 
0275 The digiKam Raindrops filter puts beautiful raindrops on your image.
0276 
0277 The Raindrops is nice little tool to put raindrops onto your images. Naturally, it renders your image in a kind of wet look.
0278 
0279 Three sliders give you control over the effect filter: **Drop size** 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. **Number** changes the number and density of drops. **Fish eye** changes the optical effect of the drops across the image.
0280 
0281 .. note::
0282 
0283     You can keep a zone clear of raindrops with the digiKam Image Editor **Select** tool. Selecting the area to avoid (for example a face) before launching the Raindrops filter will keep it free from rain drops.
0284 
0285 .. figure:: images/editor_rain_drops.webp
0286     :alt:
0287     :align: center
0288 
0289     Rain Drops Tool Applying Effect to Whole Image Excepted on Dog Face