 <sect1 id="photographic-editing"> <title>Photographic Editing - Workflow</title>

    <sect2 id="image-editing-tools"> <title>Image Editing/Workflow Tools</title>

        <sect3 id="standard-workflow"> <title>A Standard Workflow Proposal</title>

            <para>When performing a basic workflow, the primary areas for consideration are:

            <orderedlist>

                <listitem><para>Exposure: <link linkend="editor-color-wb">White Balance</link></para></listitem>

                <listitem><para>Color: <link linkend="editor-color-wb">White Balance</link></para></listitem>

                <listitem><para>
                        Black and white points: <link linkend="editor-color-wb">White Balance</link> or 
                        <link linkend="editor-color-levels">Adjust Levels</link>
                </para></listitem>

                <listitem><para>Contrast: <link linkend="editor-color-curves">Adjust Curves</link></para></listitem>

                <listitem><para>
                        Saturation: <link linkend="editor-color-wb">White Balance</link> or 
                        <link linkend="editor-filters-colorsfx">Vivid</link> or <link linkend="editor-color-correction">Hue/Saturation/Lightness</link>
                </para></listitem>

                <listitem><para>Resizing (interpolation) : <link linkend="editor-transform-resize">Change Size</link></para></listitem>

                <listitem><para><link linkend="editor-enhance-sharpen">Sharpening</link></para></listitem>

                <listitem><para><ulink url="help:/digikam/index.html#dam">Digital Asset Management</ulink> (applying tags, captions, rating, geolocation, save under new name)</para></listitem>

            </orderedlist>

            We recommend this sequence of image editing steps to ensure optimum photographic quality for the end product.
            In particular, never do sharpening before the last step. And we recommend using a lossless format like PNG or TIFF for storing photographs.
            Otherwise you'll lose a bit every time you save the results. If you can afford it, use 16 bit/channel for your best shots.
            If you want to change color space, in particular if you want to work in CIEL*a*b, 16 bit per channel are required to avoid truncation effects.
            </para>

            <para>If you swap step 4 and 5, which is well possible if the initial contrast is already very good, you can do the first 4 adjustment in the same plugin, the white balance</para>

            <para>Many of the tools you may need for photographic editing are included with &digikam;. Their description follows here. </para>

        </sect3>

        <sect3> <title>Introduction to common editing tools features</title>

            <para>
                All Image Editor tools like Sharpen, Blur, Noise Reduction, Refocus, Unsharp Mask, &etc; use a common dialog style that previews the effect before applying the filter to the current image. Below you see the <quote>Apply Texture</quote> tool in action using this common dialog layout:
            </para>

            <example> <title>The Apply Texture Tool in Action</title>
                <screenshot>
                    <screeninfo>The Apply Texture Tool in Action</screeninfo>
                    <mediaobject>
                    <imageobject>
                        <imagedata fileref="&path;editor-commondialogtools.png" format="PNG" />
                    </imageobject>
                    </mediaobject>
                </screenshot>
            </example>

            <para>

                <itemizedlist>

                    <listitem><para>

                        <emphasis>(1)</emphasis>: The seven buttons to the top left select the comparison style of the preview area. The modes are:

                        <itemizedlist>

                            <listitem><para>Original image.</para></listitem>

                            <listitem>
                                <para>Split vertically without duplication. The left area shows the original whereas the right side shows the filter applied to the continuation of the selected zoom.</para>
                            </listitem>

                            <listitem>
                                <para>Split horizontally without duplication. The top area shows the original whereas the lower area shows the filter applied to the continuation of the selected zoom.</para>
                            </listitem>

                            <listitem>
                                <para>Split vertically. The left area shows the original and the right one the filter effect for comparison.</para>
                            </listitem>

                            <listitem>
                                <para>Split horizontally. The top area shows the original and the lower one the filter effect for comparison.</para>
                            </listitem>

                            <listitem>
                                <para>Effect preview. This is a live effect preview without comparison.</para>
                            </listitem>

                            <listitem>
                                <para>'Mouse over' style: preview when mouse is off the preview (in the settings area), otherwise shows original.</para>
                            </listitem>

                        </itemizedlist>

                    </para></listitem>

                        <listitem>
                        <para><emphasis>(2)</emphasis>: There are two buttons that can be toggled to show over or underexposure. The colors can be customized in the <link linkend="setupdialog.anchor">general setup page</link>.</para>
                        </listitem>

                        <listitem>
                        <para><emphasis>(3)</emphasis>: The preview selector frame. Click and drag with the mouse on the floating frame to move it on the image. The preview area on the left of dialog is updated accordingly.</para>
                        </listitem>

                        <listitem>
                        <para>   <emphasis>(4)</emphasis>: The filter or plugin settings area.</para>
                        </listitem>

                        <listitem>
                        <para><emphasis>(5)</emphasis>: At the lower left corner: there is help and a reset to defaults button (all settings are remembered from the last use of the plugin).</para>
                        </listitem>

                        <listitem>
                        <para><emphasis>(6)</emphasis>: There is a progress indicator for plugins with involved calculations.</para>
                        </listitem>

                </itemizedlist>

            </para>

        </sect3>

        <sect3> <title>The &digikam; tool set</title>

            <itemizedlist>

                <listitem><para>Image Color
                    <itemizedlist>
                    <listitem><para><link linkend="editor-color-depth">Encoding Depth</link></para></listitem>
                    <listitem><para><link linkend="editor-color-profile">Color-Space Converter</link></para></listitem>
                    <listitem><para><link linkend="editor-color-auto">Auto Correction</link></para></listitem>
                    <listitem><para><link linkend="editor-color-exposure">Brightness/Contrast/Gamma</link></para></listitem>
                    <listitem><para><link linkend="hsladjusttool.anchor">Hue/Saturation/Lightness</link></para></listitem>
                    <listitem><para><link linkend="colorbalancetool.anchor">Color Balance</link></para></listitem>
                    <listitem><para><link linkend="editor-color-levels">Levels Adjust</link></para></listitem>
                    <listitem><para><link linkend="editor-color-wb">White Balance/Exposure/Saturation</link></para></listitem>
                    <listitem><para><link linkend="editor-color-curves">Curves Adjust</link></para></listitem>
                    <listitem><para><link linkend="editor-color-mixer">Channel Mixer</link></para></listitem>
                    <listitem><para><link linkend="editor-color-bw">Black and White</link></para></listitem>
                    <listitem><para><link linkend="infraredtool.anchor">Simulate Infrared Film</link></para></listitem>
                    <listitem><para><link linkend="editor-color-neg">Color Negative</link></para></listitem>
                    </itemizedlist>
                </para></listitem>

                <listitem><para>Image Enhancement
                    <itemizedlist>
                    <listitem><para><link linkend="editor-enhance-sharpen">Sharpening (sharpen, unsharp mask, refocus)</link></para></listitem>
                    <listitem><para><link linkend="editor-enhance-blur" >Blur Tool</link></para></listitem>
                    <listitem><para><link linkend="editor-enhance-redeyes">Red Eyes Removal</link></para></listitem>
                    <listitem><para><link linkend="editor-enhance-inpaint">Photograph Inpainting</link></para></listitem>
                    <listitem><para><link linkend="editor-enhance-localcontrast">Local Contrast</link></para></listitem>
                    <listitem><para><link linkend="editor-enhance-nr">Noise Reduction</link></para></listitem>
                    <listitem><para><link linkend="editor-enhance-hotpixels">Hot Pixel Correction</link></para></listitem>
                    <listitem><para><link linkend="editor-enhance-distortion">Lens Distortion Correction</link></para></listitem>
                    <listitem><para><link linkend="editor-enhance-restoration">Photograph Restoration</link></para></listitem>
                    <listitem><para><link linkend="editor-enhance-vignetting">Vignetting Correction Tool</link></para></listitem>
                    <listitem><para><link linkend="editor-enhance-lenscorrection">Lens Auto-Correction Tool</link></para></listitem>
                    </itemizedlist>
                </para></listitem>

                <listitem><para>Image Transformation Tools
                    <itemizedlist>
                    <listitem><para><link linkend="editor-transform-crop">Crop Tool</link></para></listitem>
                    <listitem><para><link linkend="editor-transform-rotateflip">Change Size</link></para></listitem>
                    <listitem><para><link linkend="editor-transform-liquid">Liquid Resizement</link></para></listitem>
                    <listitem><para><link linkend="editor-transform-resize">Change Size</link></para></listitem>
                    <listitem><para><link linkend="editor-transform-freerotation">Free Rotation</link></para></listitem>
                    <listitem><para><link linkend="editor-transform-perspective">Perspective Adjustment</link></para></listitem>
                    <listitem><para><link linkend="editor-transform-shear">Shearing Tool</link></para></listitem>
                    </itemizedlist>
                </para></listitem>

                <listitem><para>Image Decoration
                    <itemizedlist>
                    <listitem><para><link linkend="editor-decorate-border">Add Border</link></para></listitem>
                    <listitem><para><link linkend="editor-decorate-inserttext">Insert Text</link></para></listitem>
                    <listitem><para><link linkend="editor-decorate-texture">Apply Texture</link></para></listitem>
                    </itemizedlist>
                </para></listitem>

                <listitem><para>Special Effect Filters
                    <itemizedlist>
                    <listitem><para><link linkend="editor-filters-colorsfx">Color Effects</link></para></listitem>
                    <listitem><para><link linkend="editor-filters-filmgrain">Add Film Grain</link></para></listitem>
                    <listitem><para><link linkend="editor-filters-oilpaint">Simulate Oil Painting</link></para></listitem>
                    <listitem><para><link linkend="editor-filters-charcoal">Simulate Charcoal Drawing</link></para></listitem>
                    <listitem><para><link linkend="editor-filters-emboss">Emboss Photograph</link></para></listitem>
                    <listitem><para><link linkend="editor-filters-distortionfx">Distortion FX</link></para></listitem>
                    <listitem><para><link linkend="editor-filters-blurfx">Blur FX</link></para></listitem>
                    <listitem><para><link linkend="editor-filters-raindrops">Add Rain Drops</link></para></listitem>
                    </itemizedlist>
                </para></listitem>

            </itemizedlist>

        </sect3>

    </sect2>

    <sect2 id="raw-workflow"> <title>Processing RAW image files, RAW work-flow</title>
    <anchor id="rawprocessing.anchor"/>

        <para>A typical RAW workflow with &digikam; may follow these steps:</para>

            <itemizedlist>

                <listitem><para>Setting up the RAW conversion and color management preferences:

                    <itemizedlist>

                        <listitem><para>get the ICC color profiles for the camera, display and printer</para></listitem>

                        <listitem><para>setup &digikam; correctly defining a color work space </para></listitem>

                    </itemizedlist>

                </para></listitem>

                <listitem><para>Camera whitepoint setting</para></listitem>

                <listitem><para>Demosaicing (includes interpolation, noise filtering and
                    <ulink url="help:/digikam/using-setup.html#CA.anchor">chromatic aberration correction</ulink>)
                </para></listitem>

                <listitem><para>Conversion to a color space</para> </listitem>

                <listitem><para>Gamma correction, tone mapping</para> </listitem>

                <listitem><para>Color profile assignment</para> </listitem>

                <listitem><para>Dynamic range expansion (optional)</para></listitem>

                <listitem><para>Continue with <link linkend="standard-workflow">standard workflow</link></para></listitem>

            </itemizedlist>

        <para>
        From there everything is simple, select a RAW image and open it in the editor. The color management widget will be displayed after the image has been processed in order to adjust color rendering. Without color management all images are very dark, this is normal. You can experiment the various profiles you have in order to select the best input profile according to your image (some tends to be very neutral, even a bit dull, some gives more saturated results, &etc;).
        </para>

    </sect2>

    &doc-editor-color;

    &doc-editor-enhance;

    &doc-editor-transform;

    &doc-editor-decorate;

    &doc-editor-filters;

</sect1>

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