<sect3 id="editor-filters-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, &ie; 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-blurfx-preview.png" format="PNG" /> </imageobject>
        <textobject><phrase>The Blur FX Dialog Tool Preview</phrase></textobject></inlinemediaobject>
    </para>

    </sect4>

</sect3>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
