<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.0//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&showfoto;"><!-- replace kapp here, do *not* replace kappname-->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE"><!-- change language only here -->
  <!ENTITY showfoto '<application>Showfoto</application>'>

  <!-- Do not define any other entities; instead, use the entities
       from kde-genent.entities and $LANG/user.entities. -->
]>

<book lang="&language;">

<bookinfo>

<title>The &showfoto; Handbook</title>

<authorgroup>

    <author>
        <firstname>Gilles</firstname><surname>Caulier</surname>
        <affiliation><address><email>caulier_dot_gilles_at_free.fr</email></address></affiliation>
    </author>
    
    <author>
        <firstname>Gerhard</firstname><surname>Kulzer</surname>
        <affiliation><address><email>gerhard at kulzer.net</email></address></affiliation>
    </author>
    
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>


<copyright>
    <year>2004</year>
    <year>2005</year>
    <holder>The &showfoto; developers team</holder>
</copyright>

<!-- Translators: put here the copyright notice of the translation -->
<!-- Put here the FDL notice.  Read the explanation in fdl-notice.docbook
     and in the FDL itself on how to use it. -->
<legalnotice>&FDLNotice;</legalnotice>

<date>2005-11-14</date>
<releaseinfo>0.3.0</releaseinfo>

<abstract>
    
    <para>
        
        <inlinemediaobject>
            <imageobject><imagedata fileref="digikamlogo.png" format="PNG"/></imageobject>
            <textobject> <phrase>digiKam logo</phrase> </textobject>
        </inlinemediaobject>
    
    </para>

    <para>
    &showfoto; is a &kde; stand alone Photo Editor based on digiKam Image Editor. &showfoto; is a part of digiKam project.
    </para>
    
</abstract>

<keywordset>
    <keyword>KDE</keyword>
    <keyword>digikam</keyword>
    <keyword>showfoto</keyword>
    <keyword>Graphics</keyword>
</keywordset>

</bookinfo>

<!-- *********************************************************************** -->

<chapter id="introduction">
<title>Introduction</title>

    <sect1 id="using-kapp-background">
    <title>Background</title>

       <sect2 id="using-kapp-about">
       <title>About &showfoto;</title>

       <para>
       &showfoto; is a fast Image Editor with a few basic yet powerful image editing tools. You can use it to view your photographs and make corrections and alterations.
       </para>
            
       </sect2>

       <sect2>
       <title>Reporting Bugs</title>

       <para>
       Like the rest of &kde;, &showfoto; is an Open Source project. This means that it relies on its users to play their part by, at least, reporting problems and suggesting possible improvements.
       </para>

       <para>
       &showfoto; makes it as easy as possible for you to report bugs or suggest improvements. Wherever you are in the application the Help menu will include a Report Bugs option. This will display a message box with a highlighted link. Click on the link and your web browser will open the page for the reporting system. All the information required will already be filled in, just follow the instructions for completing your report.
       </para>
       </sect2>

       <sect2>
       <title>Support</title>
      
       <para>
       &showfoto; is a community supported project, which means that users and developers support one another. If you become a regular user of &showfoto; you are encouraged to join the &showfoto; Users Mailing List. You can start off by asking questions of other &showfoto; users and hopefully soon you will be answering the support questions of others.
       </para>

       <para>
       <ulink url="https://mail.kde.org/mailman/listinfo/digikam-users">&showfoto; Users Mailing 
       List joining instructions.</ulink>
       </para>

       <para>
       You can also visit the <ulink url="http://www.digikam.org">digiKam Home Page.</ulink> for news of new releases and other &showfoto; related information.
       </para>
       </sect2>

       <sect2>
       <title>Getting Involved</title>

       <para>
       There are many ways that you can get involved with the continued development of &showfoto;. You do not need to be a software developer. You can help with documentation, translation and user interface design or just contribute really good ideas to the wish-list. You can also get involved by testing early development code as it is being developed and providing feedback to the developers. Of course, if you are a software developer then you can help to make &showfoto; the best digital photograph application there is. 
       </para>

       <para>
       The best way to start getting involved with &showfoto; is to join the Developers Mailing List.
       <ulink url="https://mail.kde.org/mailman/listinfo/digikam-devel">&showfoto; Developer Mailing 
       List joining instructions.</ulink>
       </para>
       </sect2>

    </sect1>

    <sect1 id="using-kapp-fileformatsupport">
    <title>Supported Image File Formats</title>

        <sect2>
        <title>Still Photograph Formats</title>
        
            <sect3>
            <title>Introduction</title>
    
                <para>
                Almost all digital cameras store photographs in one of two formats: JPEG or TIFF. Many cameras enable you to select which of these formats to use. A full description of these formats can be found at the <ulink url="http://en.wikipedia.org/wiki/Graphics_file_format">Wikipedia</ulink>. &showfoto; supports both of these formats.
                </para>
            
            </sect3>

            <sect3>
            <title>Still Image Compression</title>
    
                <para>
                Image compression is the application of data compression on digital images. In effect, the objective is to reduce redundancy of the image data in order to be able to store or transmit data in an efficient form.
                </para>
            
                <para>
                Image compression can be lossy or lossless. Lossless compression methods is always be preferred for high value content for archival purposes before to apply transformations like croping, resizing, color corrections, &etc;. This is because lossy compression methods, especially when used at low bit rates, can introduce compression artifacts. Lossy methods are especially suitable for natural images such as photos in applications where minor (sometimes imperceptible) loss of fidelity is acceptable to achieve a substantial reduction in bit rate. Lossy compression is dedicaced to publish photographs on internet. 
                </para>
            
            </sect3>
                        
            <sect3>
            <title>JPEG</title>
                <para>
                JPEG is a compressed format, that trades some of the image quality to keep filesizes small. In fact, most cameras save their images in this format unless you specify otherwise. A JPEG image is stored using lossy compression and you can vary the amount of compression. This allows you to choose between lower compression and higher image quality or greater compression and poorer quality. The only reason to choose higher compression is because it creates smaller file so you can store more images, and it's easier to send them by e-mail, or post them on the Web. Most cameras give you two or three choices equivalent to good, better, best although the names vary.
                </para>
            
            </sect3>

            <sect3>
            <title>TIFF</title>
                <para>
                TIFF has been widely accepted and widely supported as an image format. Commonly, TIFF may be stored by the camera in uncompressed form or using lossless compression algorithm (Adobe Deflate). It maintains higher image quality but at the expense of much larger filesizes. Some cameras let you save your images in this format and it is a popular format because of its lossless compression algorithm. The problem is that the format has been altered by so many people that there are now 50 or more flavors and not all are recognizable by programs.
                </para>
            
            </sect3>

            <sect3>
            <title>PNG</title>
                <para>
                PNG is an image format that was developed as a replacement for a number of older, in the 1990's widely used, image file formats. It is a lossless format like TIFF but it is much more compact and saves disk space. Although your camera is unlikely to support PNG, some people like to convert their photographs to PNG as soon as they get them on their computer. Unlike JPEG, PNG images do not loose quality every time you re-encode them after modification. &showfoto; fully supports PNG images.
                </para>
    
                <para>
                PNG is an extensible file format for the lossless, portable, well-compressed storage of raster images. PNG provides a patent-free replacement for &GIF; and can also replace many common uses of TIFF. PNG is designed to work well in online viewing applications, such as the World Wide Web, so it is fully streamable with a progressive display option. Also, PNG can store gamma and chromaticity data for improved color matching on heterogeneous platforms. PNG supports 8 and 16 bits / colors /pixels depth. It's the perfect file format to archive your photographs. For more information about the PNG format see the <ulink url="http://www.libpng.org/pub/png/">PNG homepage</ulink>.
                </para>
            
            </sect3>

            <sect3>
            <title>RAW</title>
                
                <para>
                Some, typically more expensive, cameras allow you to store images in RAW format. RAW format is not really an image standard at all. It is different for every make of camera. RAW format images contain all the data that is taken directly from the camera's image sensor before the software in the camera applies things like white balance, sharpening &etc;. Storing  photographs in a camera's RAW format allows you to alter settings, such as white balance, after the photograph has been taken. Most professional photographers use RAW format, because it offers them maximum flexibility. The downside is that RAW image files can be very large indeed. If you want to learn more about RAW image format visit the very helpful guides <ulink url="http://www.luminous-landscape.com/tutorials/understanding-series/u-raw-files.shtml"> The Luminous Landscape</ulink> and <ulink url="http://www.cambridgeincolour.com/tutorials/RAW-file-format.htm"> Cambridge in Colour</ulink>. 
                </para>
                
                <note><para>
                &showfoto; do not yet support to load RAW image files. You can convert RAW format images into JPEG or TIFF with digiKam using the <ulink url="help:/kipi-plugins/rawconverter.html">RAW Image Converter plugin</ulink>.
                </para></note>
            
            </sect3>
            
        </sect2>

        <sect2>
        <title>How &showfoto; Supports File Formats</title>

        <para>
        &showfoto; relies on a number of libraries and support packages to load and save image formats. Which image formats are available will depend on the availability of these libraries on your system and, in some cases, on the way that those libraries have been compiled. On most distributions you will find that a wide range of image formats are viewable within &showfoto;.
        </para>

        <para>
        This dependence on other libraries means that it is not possible to give a definitive list of all of the formats that will be available on your system. At the very least JPEG, PNG, and TIFF will be available.
        </para>

        </sect2>
    
    </sect1>

    <sect1 id="using-kapp-pluginssupport">
    <title>Supported Plugins</title>

        <para>
        One of the nicest things about &showfoto; is how easily its functionality can be extended, by using <emphasis>digiKam Image Editor Plugins</emphasis>: these plugins add new image manipulation options. &showfoto; support the image plugin core included in digiKam (if installed) to perform basic image manipulations like Red Eyes Correction, Aspect ration crop, &etc;. Others plugins from <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins project</ulink> are also supported. This one is dedicated to providing a collection of advanced image editor tools. Image Editor Plugins setup is described in this <link linkend="setupplugins">section</link>.

        <inlinemediaobject>
            <imageobject><imagedata fileref="introductionplugininterfaces.png" format="PNG"/></imageobject>
            <textobject> <phrase>Plugins supported by &showfoto;</phrase> </textobject>
        </inlinemediaobject>
        </para>
                                    
        <para>
        Plugins can manipulate images in almost any way that users can. Their advantage is, that it is much easier to add a capability to &showfoto; by writing a small plugin than by modifying the &showfoto; core.
        </para>
                
    </sect1>
    
</chapter>

<!-- *********************************************************************** -->

<chapter id="using-kapp">
<title>Using &showfoto;</title>
           
    <sect1 id="using-kapp-imageeditor">
    <title>&showfoto; Image Editor</title>
    <anchor id="imageeditor.anchor"/>
    
        <sect2>
        <title>Introduction to Image Editor</title>

            <para>
            &showfoto; provides a number of tools that enable you to adjust a photograph. Some of these tools are provided by plugins to &showfoto;. So they may not be available by default on your distribution. See the <link linkend="setupplugins">Setup Plugins Section</link> for more details about &showfoto; plugins.
            </para>
            
            <figure>
                <title>The Main Window</title>
                <graphic srccredit="The Main Window" fileref="editorpreview.png"/>
            </figure>
            
            <para>
            &showfoto; has just one main window with:
            
            <itemizedlist>
            
                <listitem><para>
                A status at the bottom which shows the filename, the current file number, the current zoom level, and the current image size.
                </para></listitem>

                <listitem><para>
                A Menu Bar across the top and below that a Tool Bar that provides quick access to some commonly used functions.
                </para></listitem>
                
                <listitem><para>
                A thumbs bar on the right shows the preview of currents image files loaded. Just right click with mouse to change the current image in editor.
                </para></listitem>
                            
            </itemizedlist>
            </para>
                        
            <para>
                <inlinemediaobject>
                    <imageobject><imagedata fileref="editortoolbar.png" format="PNG"/></imageobject>
                    <textobject> <phrase>The Main Toolbar</phrase> </textobject>
                </inlinemediaobject>
            </para>
            
            <para>
            
            <itemizedlist>
            
                <listitem><para>(1) : First Image in current list.</para></listitem>

                <listitem><para>(2) : Previous Image.</para></listitem>
                   
                <listitem><para>(3) : Next Image.</para></listitem>
                
                <listitem><para>(4) : Last Image in current list.</para></listitem>
                
                <listitem><para>(5) : Save the modified image.</para></listitem>

                <listitem><para>(6) : Undoing last action.</para></listitem>
                
                <listitem><para>(7) : Redoing previous action.</para></listitem>

                <listitem><para>(8) : Restore the Current Image From Disk.</para></listitem>
            
                <listitem><para>(9) : Zoom Into the Image.</para></listitem>
            
                <listitem><para>(10) : Zoom Out of the Image.</para></listitem>
            
                <listitem><para>(11) : Toggle Auto Zooming (if selected image will fit in the window).</para></listitem>
            
                <listitem><para>(12) : Rotate the Current Image.</para></listitem>
            
                <listitem><para>(13) : Crop Image to the Selected Region.</para></listitem>
                
                <listitem><para>(14) : Toogle to full screen.</para></listitem>
                
                <listitem><para>(15) : Run slide show tool.</para></listitem>
            
            </itemizedlist>
            
            </para>
            
        </sect2>
    
        <sect2>
        <title>Restoring Your Original Photograph</title>
            
            <para>
            The editing functions of the Image Editor will make changes to your photograph. None of the editing functions will change the original photograph unless you select 
            <menuchoice><guimenu>File</guimenu>
            <guimenuitem>Save</guimenuitem></menuchoice> 
            or click the <guilabel>Save</guilabel> button in the Tool Bar. Note that once you have saved the changed version you will not be able to recover the original photograph.
            </para>
        
            <para>
            You might prefer to take a copy of your photograph before you make any changes. You can use 
            <menuchoice><guimenu>File</guimenu>
            <guimenuitem>Save As</guimenuitem></menuchoice> 
            to save a working copy.
            </para>
            
            <para>
            At any time <emphasis>before</emphasis> you save your photograph you can restore the view to the original image by selecting 
            <menuchoice><guimenu>File</guimenu>
            <guimenuitem>Revert</guimenuitem></menuchoice> 
            or clicking the 
            <inlinemediaobject>
                <imageobject><imagedata fileref="editorrevertbutton.png" format="PNG"/></imageobject>
                <textobject><phrase>The Image Editor Revert Button</phrase></textobject>
            </inlinemediaobject>
            <guilabel>Revert</guilabel> button on the Tool Bar. You will loose any changes that you have made to the photograph since it was last saved.
            </para>
            
        </sect2>

        <sect2>
        <title>Undoing/Redoing Actions</title>
            
            <para>
            Almost anything you do to an image in Image Editor can be undone/redone. You can undo the most recent action by choosing <menuchoice><guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem></menuchoice>, and redo by <menuchoice><guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem></menuchoice>
            </para>
            
            <para>
            If these are done so frequently that you really should memorize the keyboard shortcuts, <guilabel>Ctrl-Z</guilabel> to undoing action, and <guilabel>Ctrl-Shift-Z</guilabel> to redoing action.
            </para>

            <para>
            To  get a popup menu with the available undo/redo actions, you have to press the left mouse button at the undo or redo icon in the toolbar and hold it down for a moment. If you choose one of the menu items, all undo/redo actions until the choosen one are done.
            </para>
                        
        </sect2>
        
        <sect2>
        <title>Moving Between Photographs</title>
            
            <para>
            Once you have started the Image Editor with several images at once you can move between photographs by using the navigator buttons on the Tool Bar or the entries in the <guilabel>File</guilabel> menu. If you show the thumbnail bar you can also navigate by clicking the thumbnails. When you have made any changes to the current photograph you will be asked if you want to save them.
            </para>
        
        </sect2>

        <sect2>
        <title>Changing the View</title>

            <para>
            You can zoom in and out of a photograph using the 
            <inlinemediaobject>
                <imageobject><imagedata fileref="editorzoombuttons.png" format="PNG"/></imageobject>
                <textobject> <phrase>The Image Editor Zoom Buttons</phrase> </textobject>
            </inlinemediaobject> buttons on the Tool Bar or the entries in the View menu. 
            To make a photograph fit into the window use the <guilabel>Zoom Autofit</guilabel> 
            <inlinemediaobject>
                <imageobject><imagedata fileref="editorautosizebutton.png" format="PNG"/></imageobject>
                <textobject> <phrase>The Image Editor AutoFit Button</phrase> </textobject>
            </inlinemediaobject>
            button on the Tool Bar.
            </para>

            <para>
            <menuchoice><guimenu>View</guimenu>
            <guimenuitem>Toggle Full Screen</guimenuitem></menuchoice> will display the photograph using the full screen mode. You can move back to the normal view by pressing the <keycombo><keycap>Esc</keycap></keycombo> key. By default the Tool Bar is still displayed even in Full Screen Mode. If you would prefer that the Tool Bar is not displayed you can turn it off in the Configure &showfoto; dialog accessed from the main &showfoto; window, see the <link linkend="setupgeneral">Setup General Section</link>.
            </para>
        
        </sect2>

        <sect2>
        <title>Image Properties</title>
            
            <sect3 id="using-kapp-exifviewertool">
            <title>EXIF Viewer Tool</title>
            
                <anchor id="kexif.anchor"/>
                
                <sect4>
                <title>What is EXIF?</title>
                    
                    <para>
                    EXIF stands for <emphasis>EXtended Interchange Format</emphasis>. It was designed specifically for digital cameras. It allows a large amount of information about the photograph to be stored. Those informations are describing the camera which took the image along with the settings (including date and time) in use when the picture was taken. Also it allows an inline thumbnail to be included.
                    </para>

                    <para>
                    EXIF format contains different marker sections named <emphasis>Image File Directories</emphasis> (IFD). The sections likely to be found in a normal EXIF file are as follows:
                    
                    <itemizedlist>
            
                        <listitem><para>
                            <guilabel>0</guilabel>: contains general information about the photograph.
                        </para></listitem>

                        <listitem><para>
                            <guilabel>1</guilabel>: contains information about the embedded thumbnail image.
                        </para></listitem>

                        <listitem><para>
                            <guilabel>EXIF</guilabel>: contains extended information about the photograph.
                        </para></listitem>

                        <listitem><para>
                            <guilabel>GPS</guilabel>: contains Global Positioning System information provides by the camera during the capture.
                        </para></listitem>

                        <listitem><para>
                            <guilabel>Interoperability</guilabel>: contains information to support interoperability between different EXIF implementations.
                        </para></listitem>
                                                                                                    
                        <listitem><para>
                            <guilabel>Thumbnail</guilabel>: displays the embedded thumbnail image.
                        </para></listitem>
                    
                    </itemizedlist>
                    
                    </para>                

                </sect4>
                
                <sect4>
                <title>How to Use EXIF Viewer?</title>
                    
                    <para>             
                    You can review embedded EXIF information for the image using 
                    <menuchoice><guimenu>Image</guimenu>
                    <guimenuitem>Properties</guimenuitem></menuchoice> and <guilabel>EXIF</guilabel> page. 
                    The EXIF Viewer is purely informational: nothing you do with it will cause any change to the EXIF sections. 
                    </para>
            
                    <figure>
                        <title>The EXIF Viewer in Action</title>
                        <graphic srccredit="The EXIF Viewer in Action" fileref="editorexifviewer.png"/>
                    </figure>
            
                    <para>             
                    
                    You can use two different levels to display EXIF marker sections:
                    
                    <itemizedlist>
            
                        <listitem><para>
                            <guilabel>Simple</guilabel>: display only EXIF marker.
                        </para></listitem>

                        <listitem><para>
                            <guilabel>Full</guilabel>: display all markers excepted thumbnails.
                        </para></listitem>

                    </itemizedlist>
                  
                    Some vendors add additional EXIF sections, such as Canon, Fujifilm, Nikon, and Sigma. These sections contain vendor and model specific notes. These will be displayed with 
                    <guilabel>Full</guilabel> level.
                    </para>
                    
                    <para>
                    For the EXIF data displayed, EXIF Viewer provides a contextual help. Select an item on the top and the corresponding help can be displayed with the "What's This?" option of the dialog.
                    </para>
                                
                </sect4>
                
            </sect3>
            
            <sect3 id="using-kapp-filepropertiestool">
            <title>File Properties Tool</title>
            
                <anchor id="filepropertiestool.anchor"/>
                
                <para>
                You can view the file properties using 
                <menuchoice><guimenu>Image</guimenu>
                <guimenuitem>Properties</guimenuitem></menuchoice> and <guilabel>General</guilabel> page. 
                This page allow you to see a large image thumbnail, general image and file system informations.
                </para>
            
            </sect3>

            <sect3 id="using-kapp-histogramviewer">
            <title>Histogram Viewer</title>
            
                <anchor id="histogramviewer.anchor"/>
            
                <para>
                If you are interested in the detailed histogram of your photograph you can view it using 
                <menuchoice><guimenu>Image</guimenu>
                <guimenuitem>Properties</guimenuitem></menuchoice> and <guilabel>Histogram</guilabel> page. 
                The histogram for a image shows the amount of each colour that is present and their different amplitudes within the image. If your photograph has a colour cast you might be able to see what is wrong by looking at the histogram.
                </para>
            
                <para>
                The Histogram Viewer shows you informations about the statistical distribution of color values in the current image. It is purely informational: nothing you do with it will cause any change to the image. If you want to perform a histogram-based color correction, use the Adjust Levels image plugin. This plugin is part of the <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins project</ulink>. For more information about using Plugins in &showfoto; see the <link linkend="using-kapp-setup">Configuration</link> section.
                </para>
                                                
                <figure>
                    <title>The Histogram Viewer in Action</title>
                    <graphic srccredit="The Histogram Viewer in Action" fileref="editorhistogramviewer.png"/>
                </figure>
            
                <para>
                An image can be decomposed into <guilabel>Red</guilabel>, <guilabel>Green</guilabel>, <guilabel>Blue</guilabel>, <guilabel>Alpha</guilabel> color channels. <guilabel>Alpha</guilabel> channel is a Layer in the image that supports transparency (like PNG or &GIF; images). Each channel supports a range of intensity levels from 0 to 255 (integer valued). Thus, a black pixel is encoded by 0 on all color channels; a white pixel by 255 on all color channels. A transparent pixel is encoded by 0 on the alpha channel; an opaque pixel by 255.
                </para>
            
                <para>
                The Histogram Viewer allows you to view each channel separately:
            
                <itemizedlist>
            
                    <listitem><para>
                        <guilabel>Intensity</guilabel>: shows the distribution of brightness values.
                    </para></listitem>

                    <listitem><para>
                        <guilabel>Red</guilabel>, <guilabel>Green</guilabel>, <guilabel>Blue</guilabel>: show the distribution of intensity levels for the Red, Green, or Blue channels respectively.
                    </para></listitem>
                
                    <listitem><para>
                        <guilabel>Alpha</guilabel>: shows the distribution of opacity levels. If the layer is completely opaque or completely transparent, the histogram will consist of a single bar on the left or right edge.
                    </para></listitem>

                    <listitem><para>
                        <guilabel>Colors</guilabel>: shows the <guilabel>Red</guilabel>, <guilabel>Green</guilabel>, and <guilabel>Blue</guilabel> histograms superimposed, so that you can see all of the color distribution information in a single view. In this mode, the histogram foreground color can be choose with 
                        <guilabel>Color</guilabel> option.
                    </para></listitem>
                            
                </itemizedlist>
            
                </para>
            
                <para> 
                With the <guilabel>Rendering</guilabel> option, you can determine whether the histogram will be displayed using the <guilabel>Full Image</guilabel> data or only with the current <guilabel>Image Selection</guilabel>. This option can only be enabled, if you have previously selected an image region with editor.
                </para>

                <para> 
                With <guilabel>Scale</guilabel> option, you can change whether the histogram will be displayed using a linear or logarithmic Y axis. For images taken with a digital camera, the <guilabel>Linear</guilabel> mode is usually the most useful. However, for images that contain substantial areas of constant color a <guilabel>Linear</guilabel> histogram will often be dominated by a single bar. In this case a <guilabel>Logarithmic</guilabel> histogram will be more useful. 
                </para>

                <para> 
                You can restrict the analysis, for the <guilabel>Statistics</guilabel> shown at the bottom of the dialog, to a limited range of values if you wish. You can set the range in one of two ways: 
            
                <itemizedlist>
            
                    <listitem><para>
                        Click and drag the pointer across the histogram display area, from the lowest level to the highest level of the range you want.
                    </para></listitem>

                    <listitem><para>
                        Use the spin button entries below the histogram area. Left entry is bottom of range and right entry is top of range.  
                    </para></listitem>
            
                </itemizedlist>
                            
                </para> 
            
                <para> 
                At the bottom of the Histogram Viewer are shown statistics describing the distribution of channel values, restricted to the selected range. These are:
            
                <itemizedlist>
            
                    <listitem><para>
                         The mean.
                    </para></listitem>

                    <listitem><para>
                         The standard deviation.
                    </para></listitem>
            
                    <listitem><para>
                         The median of the selected histogram portion.   
                    </para></listitem>

                    <listitem><para>
                         The number of pixels in the image.
                    </para></listitem>

                    <listitem><para>
                         The number whose values fall within the selected range.
                    </para></listitem>

                    <listitem><para>
                         The percentage whose values fall within the selected range.
                    </para></listitem>      
                                                      
                </itemizedlist>

                With <guilabel>Colors</guilabel> channel mode, this informations are updated with the foreground color selected with <guilabel>Color</guilabel> option.
                </para>
        
            </sect3>

            <sect3 id="using-kapp-usinghistogram">
            <title>How To Use an Histogram</title>
                
                <para>
                Histograms are a graphical means to assess the accuracy of an image shown on the screen. The graph represents the 3 regions of the photograph brightness:
                
                <itemizedlist>
            
                    <listitem><para>
                         (1) : the shadows-tone on the left.
                    </para></listitem>

                    <listitem><para>
                         (2) : the middle-tone on the middle.
                    </para></listitem>
            
                    <listitem><para>
                         (3) : the highlights-tone on the right.   
                    </para></listitem>

                </itemizedlist>

                <figure>
                    <title>An Image Histogram in All Colors Mode</title>
                    <graphic srccredit="An Image Histogram in All Colors Mode" fileref="editorhistogramdescription.png"/>
                </figure>
                
                The distribution of the graph, where the spikes and bulges are clustered, indicates whether the image is too dark, too bright, or well-balanced. 
                </para>
        
                <para>
                With an under exposed photograph, the histogram will have a distribution of brightness that tends to be mostly on the left of the graph.

                <figure>
                    <title>An Over Exposed Photograph</title>
                    <graphic srccredit="An Over Exposed Photograph" fileref="editorhistogramsample3.png"/>
                </figure>
                         
                With a correctly exposed photograph, the histogram will have a distribution of brightness that will be most prominent near the centre part of the graph.
                       
                <figure>
                    <title>A Correctly Exposed Photograph</title>
                    <graphic srccredit="A Correctly Exposed Photograph" fileref="editorhistogramsample2.png"/>
                </figure>
                
                With an over exposed photograph, the histogram will have the bulge showing the brightness distributed mostly towards the right of the graph.
                
                <figure>
                    <title>An Under Exposed Photograph</title>
                    <graphic srccredit="An Under Exposed Photograph" fileref="editorhistogramsample1.png"/>
                </figure>

                </para>

                <para>
                Important: not all photographs have to exhibit this bulge in the centre part of their histogram. Much depends on the subject of the photograph. In some cases, it might be appropriate for the histogram to show a peak at one end or the other, or both.
                </para>
                        
                <para>
                The histogram is a reliable way of deciding whether or not a photograph is correctly exposed. Should the histogram show an over or under exposure, an <link linkend="using-kapp-correctingexposure">Exposure Correction Tool</link>
                should be used to fix the photograph.
                </para>
                
            </sect3>
                    
        </sect2>

        <sect2 id="using-kapp-adjustingimage">
        <title>Adjusting a Photograph</title>

            <sect3 id="using-kapp-croppingimage">
            <title>Cropping a Photograph</title>
             
                <sect4 id="using-kapp-manualcrop">
                <title>Manual Crop</title>

                    <para>
                    Cropping a photograph is a common operation and the &showfoto; makes it very easy. To crop a photograph simple drag a rectangle over the image by holding down the left mouse button and moving the mouse. You will see a wire frame rectangle appear as you move the mouse.
                    </para>
            
                    <figure>
                        <title>The Current Image Selection in Image Editor</title>
                        <graphic srccredit="The Current Image Selection in Image Editor" 
                        fileref="editorimageselection.png"/>
                    </figure>
             
                    <para>
                    When you release the button the area of the photograph that will be removed by a crop operation is darkened. This allows you to get a good view of how your photograph will look once you have cropped it. You can change the size if the cropped area by dragging the corners of the rectangle and you can create a new crop area simply by dragging out another rectangle.
                    </para>
            
                    <para>
                    Once you are happy with the crop, click on the 
                    <inlinemediaobject>
                        <imageobject><imagedata fileref="editorcropbutton.png" format="PNG"/></imageobject>
                        <textobject> <phrase>The Image Editor Crop Button</phrase> </textobject>
                    </inlinemediaobject> 
                    button on the Tool Bar and the photograph will be cropped. Use the 
                    <menuchoice><guimenu>File</guimenu>
                    <guimenuitem>Save</guimenuitem></menuchoice> or 
                    <menuchoice><guimenu>File</guimenu>
                    <guimenuitem>Save As</guimenuitem></menuchoice> 
                    entries in the File menu to safe the newly cropped photograph.
                    </para>

                </sect4>
            
                <sect4 id="using-kapp-proportionalcrop">
                <title>Proportional Crop</title>

                    <anchor id="ratiocroptool.anchor"/>                                
                    
                    <para>
                    The Aspect Ratio Crop tool goes further. While you are editing digital images, it is often necessary to create a compatible format with, for example, your photo-album or paper formats. If you print an image from your digital camera and then try to put it in your photo album, you may notice that the camera has a different width or height ratio than a normal photographic film format so you need to crop your digital images in a predefined ratio (for example 5:7 or 2:3 which is a standard photo ratio).
                    </para>
                
                    <figure>
                        <title>The Aspect Ratio Crop Tool Image Selection Tab</title>
                        <graphic srccredit="The Aspect Ratio Crop Tool Image Selection Tab" 
                        fileref="editorratiocroptool.png"/>
                    </figure>
                    
                    <para>
                    In the preview area you can size the cropping rectangle by moving the corners with the mouse. It will keep the ratio value set in the bottom of dialog.
                    </para>
                    
                    <para>
                    In the Aspect Ratio Crop tool settings, you specify the <guilabel>Orientation</guilabel> as <guilabel>Portrait</guilabel> or <guilabel>Landscape</guilabel>. Portrait will always have the larger size assigned to the <guilabel>Height</guilabel> and Landscape to the <guilabel>Width</guilabel>.
                    </para>
                    
                    <para>
                    Aspect Ratio Crop tool uses a relative ratio. That means it is the same if you use centimeters or inches and it doesn't specify the physical size. For example, you can see below a correspondance list of traditional photographic paper sizes and aspect ratio crop.
                    </para>
                    
                    <informaltable><tgroup cols="2">
            
                        <thead><row>
                        <entry>Standard Photograph Paper Size</entry>
                        <entry>Aspect Ratio Crop</entry>
                        </row></thead>

                            <tbody>
                                <row>
                                    <entry>
                                    10x15cms&nbsp;20x30cms&nbsp;30x45cms 
                                    3.5x5"&nbsp;4x6"&nbsp;8x12"&nbsp;12x18"&nbsp;16x24"&nbsp;20x30"
                                    </entry>
                
                                    <entry>
                                    2:3
                                    </entry>
                                </row>

                                <row>
                                    <entry>
                                    6x8cms&nbsp;15x20cms&nbsp;18x24cms&nbsp;30x40cms 
                                    3.75x5"&nbsp;4.5x6"&nbsp;6x8"&nbsp;7.5x10"&nbsp;9x12"
                                    </entry>
                    
                                    <entry>
                                    3:4
                                    </entry>
                                </row>
                                
                                <row>
                                    <entry>
                                    20x25cms&nbsp;40x50cms 
                                    8x10"&nbsp;16x20"
                                    </entry>
                    
                                    <entry>
                                    4:5
                                    </entry>
                                </row>

                                <row>
                                    <entry>
                                    15x21cms&nbsp;30x42cms 
                                    5x7"
                                    </entry>
                    
                                    <entry>
                                    5:7
                                    </entry>
                                </row>
                                
                                <row>
                                    <entry>
                                    21x30cms&nbsp;42x60cms 
                                    </entry>
                    
                                    <entry>
                                    7:10
                                    </entry>
                                </row>
                                                                                                
                            </tbody>
            
                    </tgroup></informaltable>
                    
                    <para>
                    At the far right of the dialog two buttons are available to move the crop selection automatically to the horizontal or vertical center of the image.
                    </para>
                    
                    <para>
                    At the very bottom line of the dialog, the <guilabel>Max. Ratio</guilabel> button lets you set the crop area size to the maximum size according with the current aspect ratio settings and orientation.
                    </para>
                
                    <note><para>
                    Aspect Ratio Crop tool remember settings depending of image orientation (Horizontal or Vertical). For each tool session, the current image orientation is used to restore the better settings adapted to the image.
                    </para></note>
                    
                </sect4>
            
                <sect4 id="using-kapp-compositionguides">
                <title>Composition Guide</title>
                                <para>
                    When first looking at an image, the eye of the viewer rarely settles at the centre of the image, but moves instead from the top left to the right, and then from the lower left to the right again. This pattern is most unconscious but has been well-documented. It is probably associated with the western reading pattern. From the photographer's point of view, the goal then becomes to guide the gaze of the viewer to the subject, being aware of the way many people perceive an image.
                    </para>                                                                                
                    
                    <para>
                    The <guilabel>Composition Guide</guilabel> settings provides guiding elements to better compose your images. These guides are:

                    <itemizedlist>
                
                        <listitem>
                            
                            <para>
                            <guilabel>Rule of Thirds</guilabel>: a grid that divides the picture into thirds in every direction (that makes for 9 parts). These proportions are close to the golden rule and are derived from the field of view of the human eye. They are often used with slight variations throughout a large number of commonly used objects. Within that frame there are precise areas where the important parts of the image should be placed. The same principle is used to determine the position of the horizon and the proportion of ground to sky.
                            </para>
                                                        
                            <para>
                            Many photographers and artists are aware of the Rule of Thirds, where a picture is divided into three sections vertically and horizontally and the points of intersection represent places to position important visual elements. Moving a horizon in a landscape to the position of one third is often more effective than placing it in the middle, but it could also be placed near the bottom one quarter or sixth. There is nothing obligatory about applying the Rule of Thirds. In placing visual elements for effective composition, one must assess many factors including color, dominance, size and balance together with proportion. Often a certain amount of image balance or tension can make a composition more effective.
                            </para>
                            
                            <figure>
                                <title>Photograph Composition Example Using Rules of Third</title>
                                <graphic srccredit="Photograph Composition Example Using Rules of Third" 
                                fileref="editorrulethirdlinesexample.png"/>
                            </figure>
                                                    
                        </listitem>
    
                        <listitem>
                        
                            <para>
                            <guilabel>Harmonious Triangles</guilabel>: Harmonious divisions rely on the principle of similarity. Like the Rule of Thirds guide, Harmonious Triangles are another division of the image using a rectangle into equiangular harmonious triangles aligned with the diagonal.
                            </para>
                            
                            <figure>
                                <title>Photograph Composition Example Using Harmonious Triangles</title>
                                <graphic srccredit="Photograph Composition Example Using Harmonious Triangles" 
                                fileref="editorharmonioustrianglesexample.png"/>
                            </figure>
                            
                        </listitem>
                
                        <listitem>
                        
                            <para>
                            <guilabel>Golden Mean</guilabel>: The Golden Mean is a ratio underlying numerous growth patterns throughout nature (from the spiral of a Nautilus shell to the petals of a sunflower), it has an uncanny way of showing up in all kinds of things we deem beautiful.
                            </para>
                        
                            <para>
                            The Golden Ratio is the irrational number 1.618033988..., and it's usage dates back to the ancient Egyptians and Greeks who used it in the construction of their temples and pyramids. Artists and architects throughout time have used the Golden Ratio when composing their paintings, buildings, and even photographs, in order to give their creations a sense of natural order and beauty.
                            </para>
                            
                            <para>
                            The ratio is inherent in the Fibonacci series: 1, 1, 2, 3, 5, 8, 13, 21, 34, &etc;, where each succeeding number after 1 is equal to the sum of the two preceding numbers. The ratio formed 1:1.618 is the Golden Mean. A composition following this rule is considered visually harmonious.
                            </para>
                            
                            <para>
                            The Golden Mean provide more fluid guidelines when used to compose an image. These guides are listed below:
                            
                            <itemizedlist>                            
                        
                                <listitem>                                                        
                            
                                    <para>
                                    The <guilabel>Golden Spiral</guilabel> guide will increase your odds of getting captivating results in your photographs. As opposed to Rule of Thirds, the Golden Spiral forms a fluid line for the eye to trace through the picture. This style of composition will invite the viewer's gaze into the picture along the line of the spiral, creating a more symmetrical visual flow, and an overall compelling viewing experience.
                                    </para>
        
                                    <figure>
                                        <title>Photograph Composition Example Using Golden Spiral</title>
                                        <graphic srccredit="Photograph Composition Example Using Golden Spiral" 
                                        fileref="editorgoldenspiralexample.png"/>
                                    </figure>
                                    
                                </listitem>
                                    
                                <listitem>
                                                    
                                    <para>                                                        
                                    One more rule is a <guilabel>Golden Spiral Sections</guilabel> (or Golden Rectangles). These rectangles are used to build the Golden Spiral. There should be something leading the eye to the center of the composition. It could be a line or several subjects. This "something" could just be there without leading the eyes, but it would make its job.
                                    </para>
                                                                
                                    <figure>
                                        <title>Photograph Composition Example Using Golden Spiral Sections</title>
                                        <graphic srccredit="Photograph Composition Example Using Golden Spiral Sections" 
                                        fileref="editorgoldenspiralsectionsexample.png"/>
                                    </figure>
                                
                                </listitem>
                                
                                <listitem>
                                                            
                                    <para>
                                    The <guilabel>Golden Triangles</guilabel> is a derivative of the Golden Spiral discussed above. Its vertices are the midpoints of the sides of the Golden Rectangle. Note that unlike Harmonious Triangles, Golden Triangles aren't equiangular triangle. Placing diagonals along these lines can make an otherwise static subject appear more dynamic.
                                    </para>
                                    
                                    <para>
                                    When you use Golden Triangles to break up your frame, you're creating an effect dubbed by professional photographic experts named Dynamic Symmetry. Try to keep your focal subject on one of the intersecting points, and place other visual information into the triangles you've already divided out. The result will be a very attractive composition you may not have otherwise attained.
                                    </para>
                                    
                                    <figure>
                                        <title>Photograph Composition Example Using Golden Triangle</title>
                                        <graphic srccredit="Photograph Composition Example Using Golden Triangles" 
                                        fileref="editorgoldentrianglesexample.png"/>
                                    </figure>
                                
                                </listitem>
                                
                                <listitem>
                                                            
                                    <para>                                         
                                    Like the Rule of Thirds the <guilabel>Golden Sections</guilabel> affects the ratio of a picture size as well as the placement of the main subjects on the photo. This ratio is close to the 35mm ratio, so you don't need to change the size of the photo in most cases. But you need to consider the composition: the main subject should lie on one of the four lines or four intersections (subject's eye for example). Truthfully speaking, these rules are not the same. Rule of Thirds is a simplified version of the Golden Mean.
                                    </para>
        
                                    <figure>
                                        <title>Photograph Composition Example Using Golden Sections</title>
                                        <graphic srccredit="Photograph Composition Example Using Golden Sections" 
                                        fileref="editorgoldensectionsexample.png"/>
                                    </figure>                                                                                                   
                                </listitem>
    
                            </itemizedlist>
                            </para>
                            
                       </listitem>
     
                    </itemizedlist>
                    
                    </para>
                    
                    <para>
                    The <guilabel>Flip Horizontal</guilabel> and <guilabel>Flip Vertical</guilabel> options can be used to apply flip transformation to the harmonious divisions.
                    </para>
                    
                    <para>
                    The <guilabel>Color</guilabel> button lets you set the guidelines color. If you have an high color contrast image, the guidelines may become invisible. By this way, you can adapt the color guide to the current image.
                    </para>
                
                </sect4>
            
            </sect3>

            <sect3 id="using-kapp-resizingimage">
            <title>Resizing a Photograph</title>
                            
                <anchor id="resizetool.anchor"/>

                <para>
                If the photograph has the wrong size you can scale it to the size you would like by using Transform Resize tool. Select  <menuchoice><guimenu>Transform</guimenu><guimenuitem>Resize</guimenuitem></menuchoice> and adjust the target values. The Resize tool dialog is available below.
                </para>

                <figure>
                    <title>The Resize Tool Dialog</title>
                    <graphic srccredit="The Resize Tool Dialog" fileref="editorresizetool.png"/>
                </figure>
            
                <para>
                This image resizing tool use a standard linear interpolation method to approximate pixels. If you want to resizing up a small image with a better quality, try Blowup tool. It is a plug-in available from <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins project</ulink>, and you can access it by the <menuchoice><guimenu>Transform</guimenu><guimenuitem>Blowup</guimenuitem></menuchoice> menu entry. See the dedicated <ulink url="help:/digikamimageplugins/blowup.html">Blowup manual</ulink> for more information.
                </para>
                                
            </sect3>

            <sect3 id="using-kapp-rotatingflippingimage">
            <title>Rotating or Flipping a Photograph</title>
                
                <para>
                If the photograph is the wrong orientate you can <guilabel>Flip</guilabel> or <guilabel>Rotate</guilabel> it to the correct orientation you would like by using Transform Flip/Rotate tools available in 
                <menuchoice><guimenu>Transform</guimenu>
                <guimenuitem>Rotate</guimenuitem></menuchoice> 
                and 
                <menuchoice><guimenu>Transform</guimenu>
                <guimenuitem>Flip</guimenuitem></menuchoice> 
                menus. 
                </para>
            
                <para>
                With flipping options, you can flip, turn over, the image horizontally or vertically like a card. With rotating options, you can rotate the image 90 degrees clockwise or counter-clockwise or by 180 degrees. Can be used to change mode to Portrait or Landscape. You can rotate more progressively by using the Free Rotation tool. It is a plug-in 
                available from <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins 
                project</ulink>, and you can access it by the 
		<menuchoice><guimenu>Transform</guimenu>
                <guimenuitem>Free Rotation</guimenuitem></menuchoice> menu entry.
                See the dedicated <ulink url="help:/digikamimageplugins/freerotation.html">Free Rotation manual</ulink> for more information.  
                </para>
                
            </sect3>
                
            <sect3 id="using-kapp-redeyecorrection">
            <title>Fix Red Eye in a Photograph</title>
                
                <anchor id="redeyecorrectiontool.anchor"/>
            
                <para>
                Red Eye is caused when flash photography is used to take photographs of people. The red is the reflection from the back the eye which can be seen because the pupil cannot react quickly enough to the flash. You can correct some of the worst effect of Red Eye by selecting the area of the eye on the photograph, in the same way as described for cropping above. Then select 
                <menuchoice><guimenu>Fix</guimenu>
                <guimenuitem>Red Eye Reduction</guimenuitem></menuchoice>.
                </para>
            
                <figure>
                    <title>The Red Eyes Correction Tool in Action</title>
                    <graphic srccredit="The Red Eyes Correction Tool in Action" 
                    fileref="editorredeyescorrection.png"/>
                </figure>
            
            </sect3>
        
        </sect2>

        <sect2 id="using-kapp-adjustsharpness">
        <title>Adjusting Sharpness</title>
        
        <anchor id="blursharpentool.anchor"/>
        
            <sect3>
            <title>Introduction to Common Tool Dialogs</title>
                
                <para>
                All Image Editor tools like Sharpen, Blur, Noise Reduction, Refocus, Unsharpen Mask, &etc;. use a common dialog style that previews the effect before applying the filter to the current image. Below you see the "Apply Texture" tool in action using this common dialog layout:
                </para>
            
                <figure>
                    <title>The Apply Texture Tool in Action</title>
                    <graphic srccredit="The Apply Texture Tool in Action" fileref="editorcommondialogtools.png"/>
                </figure>
                
                <para>

                <itemizedlist>
                
                    <listitem><para>
                        <emphasis>(1)</emphasis>: This progress bar indicates the status of filter application on the current image. To the left of it, five buttons allow to select the comparative mode style of the preview area. The modes are:
                        
                        <itemizedlist>
                
                            <listitem><para>Separate horizontally with duplication. The top area shows the original and the lower one the filter effect for comparison.</para></listitem>
            
                            <listitem><para>Separate vertically with duplication. The left area shows the original and the right one the filter effect for comparison.</para></listitem>

                            <listitem><para>Separate 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>Separate 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>Direct effect preview. The effect preview is applied to all of the selected zoom area.</para></listitem>
                                                                                        
                        </itemizedlist>

                    </para></listitem>
    
                    <listitem><para><emphasis>(2)</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>(3)</emphasis>: The filter settings area.</para></listitem>
                    
                    <listitem><para><emphasis>(4)</emphasis>: The original area for the zoomed image region. This area is unchanged by the filter. Click and drag with the mouse in this area to move it on the image.</para></listitem>
                    
                    <listitem><para><emphasis>(5)</emphasis>: The target area for the zoomed image region. This area is changed by the filter and presents the actual preview. Click and drag with the mouse in this area to move it on the image.</para></listitem>
    
                </itemizedlist>
            
                </para>
                                
            </sect3>
            
            <sect3>
            <title>Unblurring a Photograph</title>
            
                <para>
                If the camera focus is not set perfectly or if the camera is moving when the picture is taken the result is a blurred photograph. If there is a lot of blurring, you probably won't be able to do much about it with any technique. If there is only a moderate amount, you should be able to improve the picture. 
                </para>
                
                <para>
                In some situations, you may be able to get useful results by sharpening an photograph using the Sharpen tool by the <menuchoice><guimenu>Fix</guimenu>
                <guimenuitem>Sharpen</guimenuitem></menuchoice> menu entry.
                </para>
                
                <figure>
                    <title>The Sharpen Tool in Action</title>
                    <graphic srccredit="The Sharpen Tool in Action" fileref="editorsharpenplugin.png"/>
                </figure>
                
                <para>
                You should be careful with this though, or the results will not look very natural: sharpening increases the apparent sharpness of edges in the photograph, but also amplifies noise. The generally most  useful technique for sharpening a fuzzy photograph is called the Unsharp Mask. It is a plug-in available from <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins project</ulink>, and you can access it by the
                <menuchoice><guimenu>Fix</guimenu>
                <guimenuitem>Unsharp Mask</guimenuitem></menuchoice> menu entry.
                See the dedicated <ulink url="help:/digikamimageplugins/unsharp.html">Unsharp Mask 
                manual</ulink> for more information.                
                
                <figure>
                    <title>The Unsharp Mask Image Editor Plugin in Action</title>
                    <graphic srccredit="The Unsharp Mask Image Editor Plugin in Action" 
                    fileref="editorunsharpedmaskplugin.png"/>
                </figure>
                
                </para>
            
            </sect3>
                
            <sect3>
            <title>Reducing Graininess In a Photograph</title>
                
                <para>
                When you take a photograph in low-light conditions or with a very fast exposure time, the camera does not get enough data to make good estimates of the true color at each pixel, and consequently the resulting photograph looks grainy. You can "smooth out" the graininess by blurring the image, but then you will also lose sharpness. Probably the best approaches, if the graininess is not too bad, is to use the Noise Reduction filter. It is a plug-in available from <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins project</ulink>, and you can access it by the
                <menuchoice><guimenu>Fix</guimenu>
                <guimenuitem>Noise Reduction</guimenuitem></menuchoice> menu entry.
                See the dedicated <ulink url="help:/digikamimageplugins/despeckle.html">Noise Reduction manual</ulink> for more information.  
                </para>
            
                <figure>
                    <title>The Noise Reduction Image Editor Plugin in Action</title>
                    <graphic srccredit="The Noise Reduction Image Editor Plugin in Action" 
                    fileref="editornoisereductionplugin.png"/>
                </figure>
                                
            </sect3>                
                
            <sect3>
                <title>Softening a Photograph</title>
                <para>
                Sometimes you have the opposite problem: an image is too crisp. The solution is to blur it a bit: fortunately blurring an image is much easier than sharpening it. Select the Blur Tool, by the <menuchoice><guimenu>Fix</guimenu><guimenuitem>Blur</guimenuitem></menuchoice> menu entry and experiment with the level. The preview windows on the right of the dialogs show the effect of the operation of your photograph.
                </para>

                <figure>
                    <title>The Blur Tool in Action</title>
                    <graphic srccredit="The Blur Tool in Action" 
                    fileref="editorblurplugin.png"/>
                </figure>
                            
            </sect3>
        
        </sect2>
        
        <sect2 id="using-kapp-correctingcolor">
        <title>Correcting Colour</title>
            
            <anchor id="colorbalancetool.anchor"/>
            
            <para>
            Digital cameras often have problems with lighting conditions and it is not unusual to want to correct the colour, contrast and brightness of a photograph. You can experiment with altering the levels of different aspects of your photographs using the tools under the 
            <menuchoice><guimenu>Fix</guimenu>
            <guimenuitem>Colors</guimenuitem></menuchoice> menu.
            You can see any adjustments you make reflected in the preview. When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect.
            </para>

            <figure>
                <title>The Color Balance Tool in Action</title>
                <graphic srccredit="The Color Balance Tool in Action" fileref="editorcolorbalance.png"/>
            </figure>

            <anchor id="hsladjusttool.anchor"/>
            
            <para>
            If your image is washed out (which can easily happen when you take pictures in bright light) try the Hue/Saturation/Lightness tool, which gives you three sliders to manipulate, for Hue, Saturation, and Lightness. Raising the saturation will probably make the image look better. In some cases, it is useful to adjust the lightness at the same time. ("Lightness" here is similar to "Brightness" in the Brightness/Contrast/Gamma tool, except that they are formed from different combinations of the red, green, and blue channels).  
            </para>
            
            <para>
            When you take pictures in low light conditions, you could get the opposite problem: too much saturation. In this case the Hue/Saturation tool is again a good one to use, only by reducing the saturation instead of increasing it. You can see any adjustments you make reflected in the preview image. When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect.
            </para>
            
            <figure>
                <title>The Hue Saturation Lightness Tool in Action</title>
                <graphic srccredit="The Hue Saturation Lightness Tool in Action" fileref="editorhsladjust.png"/>
            </figure>
                                    
            <anchor id="autocolorcorrectiontool.anchor"/>

            <para>
            The <guilabel>Normalize</guilabel>, <guilabel>Equalize</guilabel>, <guilabel>Auto Levels</guilabel>, and <guilabel>Stretch Contrast</guilabel> available from <menuchoice><guilabel>Fix</guilabel><guimenuitem>Auto-Correction</guimenuitem></menuchoice> menu entry menu will attempt to work out the best color levels automatically. You will need to experiment with the effects of these functions to see what works best with your photograph. 
            
            <itemizedlist>
            
                <listitem><para>
                <guilabel>Normalize</guilabel>: this method scales brightness values across the selected image so that the darkest point becomes black, and the brightest point becomes as bright as possible without altering its hue. This is often a "magic fix" for images that are dim or washed out.
                
                <graphic srccredit="Normalize Colors Correction Preview" fileref="editornormalize.png"/>

                </para></listitem>

                <listitem><para>
                <guilabel>Equalize</guilabel>: this method adjusts the brightness of colors across the selected image so that the histogram for the Value channel is as flat as possible, that is, so that each possible brightness value appears at about the same number of pixels as each other value. Sometimes Equalize works wonderfully at enhancing the contrasts of an image. Other times it gives garbage. It is a very powerful operation, which can either work miracles on a picture or destroy it. 
                
                <graphic srccredit="Equalize Colors Correction Preview" fileref="editorequalize.png"/>
                
                </para></listitem>
                
                <listitem><para>
                <guilabel>Auto-levels</guilabel>: this method maximizes the tonal range in the Red, Green, and Blue channels. It determines the image shadow and highlight limit values and adjust the Red, Green, and Blue channels to a full histogram range.
                
                <graphic srccredit="Auto Levels Correction Preview" fileref="editorautolevels.png"/>

                </para></listitem>

                <listitem><para>
                <guilabel>Stretch Contrast</guilabel>: this method enhances the contrast and brightness of the RGB values of an image by stretching the lowest and highest values to their fullest range, adjusting everything in between. This is noticeable only with washed-out images and can be a good fix-it tool for bad photographs.
                
                <graphic srccredit="Stretch Contrast Correction Preview" fileref="editorstretchcontrast.png"/>

                </para></listitem>
                                                
            </itemizedlist>
            
            </para>
            
            <para>
            The results of any adjustments you make will not be remembered until you save your photograph.
            </para>
        </sect2>

        <sect2 id="using-kapp-correctingexposure">
        <title>Correcting Exposure</title>
        
            <anchor id="bcgadjusttool.anchor"/>
                    
            <para>
            The simplest tool to use is the Brightness/Contrast/Gamma tool. It is also the least powerful, but in many cases it does everything you need. This tool is often useful for images that are overexposed or underexposed; it is not useful for correcting color casts. The tool gives you three sliders to adjust, for "Brightness", "Contrast" and "Gamma". You can see any adjustments you make reflected in the preview image. When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect. 
            </para>
            
            <figure>
                <title>The Brightness Contrast Gamma Tool in Action</title>
                <graphic srccredit="The Brightness Contrast Gamma Tool in Action" fileref="editorbcgadjust.png"/>
            </figure>

            <para>
            If you have the Adjust Levels plugin installed (see the <link linkend="setupplugins">Setup Plugins Section</link>) you will have additional entry in the Fix menu called 
            <menuchoice><guimenu>Fix</guimenu>
            <guimenuitem>Colors</guimenuitem>
            <guimenuitem>Levels Adjust</guimenuitem></menuchoice>. This tool provides an integrated way of seeing the results of adjusting multiple levels and also enables you to save level settings for application to multiple photographs. This can be useful if your camera or scanner often makes the same mistakes and you want to apply the same corrections. See the dedicated <ulink url="help:/digikamimageplugins/adjustlevels.html">Adjust Levels manual</ulink> for more information.
            
            <figure>
                <title>The Adjust Levels Image Editor Plugin in Action</title>
                <graphic srccredit="The Adjust Levels Image Editor Plugin in Action" 
                fileref="editoradjustlevels.png"/>
            </figure>

            </para>                                            
        
            <para>                                            
            A very powerful way of correcting exposure problems is to use the Adjust Curves plugin available by <menuchoice><guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem>
            <guimenuitem>Curves Adjust</guimenuitem></menuchoice> menu entry. This tool allows you to click and drag control points on a curve to create a free function mapping input brightness levels to output brightness levels. The Curves tool can replicate any effect you can achieve with Brightness/Contrast/Gamma or the Adjust Levels plugin, though it is more powerful than either one of them. Once again, we refer you to the <ulink url="help:/digikamimageplugins/adjustcurves.html">Adjust Curves manual</ulink> for more detailed instructions, but the easiest way to learn how to use it is by experimenting. 
            
	    But this plugin can do more for you, it helps you to improve the tonal quality of your photographs to very finely stepped gray scales. And don't forget that the better the photographs are (good exposure, lossless format, 24 or 32 bit deep) the more you can improve them. Navigate to the "Achieving ultimate tonal quality" section of this instructive page: <ulink url="http://www.normankoren.com/digital_tonality.html">Tonal quality and dynamic range in digital cameras by Norman Koren</ulink>. Use Adjust Curves tool to do just the same!
	    
            <figure>
                <title>The Adjust Curves Image Editor Plugin in Action</title>
                <graphic srccredit="The Adjust Curves Image Editor Plugin in Action" 
                fileref="editoradjustcurves.png"/>
            </figure>

            </para>                                            
                    
        </sect2>

        <sect2>
        <title>Special Effects and Filters</title>
            
            <anchor id="blackandwhitetool.anchor"/>

            <para>
            By default &showfoto; provides a couple of simple toning filters that you can use on your photographs. Under the Filters menu you will find classic Black and White chemical toning used in analog photography. Color toning changes the monochromatic tint of a basically black and white photograph. When applied it gives the picture a warm, antique feeling. Some examples of colors toning types available in &showfoto; are listed below:
            </para>

            <informaltable><tgroup cols="2">
            
            <thead><row>
                <entry>Preview</entry>
                <entry>Type</entry>
            </row></thead>

            <tbody>
                <row>
                    <entry>
                    <graphic srccredit="Orignal in Color" fileref="editorconvert_original.png"/>
                    </entry>
                
                    <entry>
                    Original color image taken in New Zealand landscapes.
                    </entry>
                </row>

                <row>
                    <entry>
                    <graphic srccredit="Neutral Black and White" fileref="editorconvert_bw.png"/>
                    </entry>
                
                    <entry>
                    Neutral Black and White: simulate black and white neutral film exposure. 
                    </entry>
                </row>

                <row>
                    <entry>
                    <graphic srccredit="Black and White with Green Filter" fileref="editorconvert_bwgreen.png"/>
                    </entry>
                
                    <entry>
                    Black and White with Green Filter: simulate black and white film exposure using green filter. This provide an universal asset for all scenics, especially suited for portraits photographed against sky. Similar to 004 Cokin(tm) Green filter.
                    </entry>
                </row>

                <row>
                    <entry>
                    <graphic srccredit="Black and White with Orange Filter" fileref="editorconvert_bworange.png"/>
                    </entry>
                
                    <entry>
                    Black and White with Orange Filter: simulate black and white film exposure using orange filter. This will enhances landscapes, marine scenes and aerial photography. Similar to 002 Cokin(tm) Orange filter.
                    </entry>
                </row>

                <row>
                    <entry>
                    <graphic srccredit="Black and White with Red Filter" fileref="editorconvert_bwred.png"/>
                    </entry>
                
                    <entry>
                    Black and White with Red Filter: simulate black and white film exposure using red filter. Using this one for creates dramatic sky effects and simulates moonlight scenes in daytime. Similar to 003 Cokin(tm) Red filter.
                    </entry>
                </row>

                <row>
                    <entry>
                    <graphic srccredit="Black and White with Yellow Filter" fileref="editorconvert_bwyellow.png"/>
                    </entry>
                
                    <entry>
                    Black and White with Yellow Filter: simulate black and white film exposure using yellow filter. Most natural tonal correction and improves contrast. Ideal for landscapes. Similar to 001 Cokin(tm) Yellow filter.
                    </entry>
                </row>
                                                                
                <row>
                    <entry>
                    <graphic srccredit="Sepia" fileref="editorconvert_sepia.png"/>
                    </entry>
                    
                    <entry>
                    Sepia Tone: gives a warm highlight and mid-tone while adding a bit of coolness to the shadows-very similar to the process of bleaching a print and re-developing in a sepia toner (typical for your grandmothers photographs). Similar to 005 Cokin(tm) Sepia filter.
                    </entry>
                </row>
                                
                 <row>
                    <entry>
                    <graphic srccredit="Brown" fileref="editorconvert_brown.png"/>
                    </entry>
                    
                    <entry>
                    Brown Tone: more neutral than Sepia Tone filter.
                    </entry>
                </row>
            
               <row>
                    <entry>
                    <graphic srccredit="Cold Tone" fileref="editorconvert_cold.png"/>
                    </entry>
                    
                    <entry>
                    Cold Tone: start subtle and replicate printing on a cold tone black and white paper such as a bromide enlarging paper.
                    </entry>
                </row>
            
                <row>
                    <entry>
                    <graphic srccredit="Platinum" fileref="editorconvert_platinium.png"/>
                    </entry>
                    
                    <entry>
                    Platinum Tone: effect that replicate traditional platinum chemical toning done in the darkroom.
                    </entry>
                </row>
            
                <row>
                    <entry>
                    <graphic srccredit="Selenium" fileref="editorconvert_selenium.png"/>
                    </entry>
                    
                    <entry>
                    Selenium Tone: effect that replicate traditional selenium chemical toning done in the darkroom.
                    </entry>
                </row>
            
            </tbody>
            
            </tgroup></informaltable>
                                                        
            <para>
             Many other filters and special effects are available if you have the additional Image Editor Plugins installed (see the <link linkend="setupplugins">Setup Plugins Section</link>), like Film Grain, Rain Drops, Solarize, Charcoal Drawing, &etc;. 
            </para>

            <figure>
                <title>The Rain Drops Image Editor Plugin in Action</title>
                <graphic srccredit="The Adjust Levels Image Editor Plugin in Action" 
                fileref="editorraindropsplugin.png"/>
            </figure>
        
        </sect2>
                   
        <sect2>
        <title>Printing Image</title>
            
            <para>
            When you want to print the current image, select 
            <menuchoice><guimenu>File</guimenu>
            <guimenuitem>Print</guimenuitem></menuchoice> and you get the standard &kde; Print dialog, where you can adjust the settings before printing your photograph.
            </para>         
            
            <para>
            For more informations about advanced printing settings, please consult <ulink url="help:/kdeprint/index.html">KDEPrint manual</ulink>.
            </para>
            
        </sect2>
            
    </sect1>  
        
    <sect1 id="using-kapp-setup">
    <title>&showfoto; Configuration</title>

        <anchor id="setupdialog.anchor"/>
        
        <para>
        &showfoto; tries to give you as much control on how it works as possible. There are many options that change the behaviour of &showfoto;. To access these settings select
        <menuchoice><guimenu>Setting</guimenu>
        <guimenuitem>Configure &showfoto;</guimenuitem></menuchoice> from the Menu Bar. The configuration dialog is separated into eight pages. You can change between these pages by clicking on the icons on the left-hand side of the dialog.
        </para>

        <sect2 id="setupgeneral">
        <title>General Settings</title>

            <para>
            When changes are made to JPEG files and they are saved back to the hard disk the JPEG file must be re-encoded. Each time a JPEG file is encoded a decision must be made on the level of quality that is to be applied. Unfortunately the level of quality applied is not recorded in the image file. This means that &showfoto; cannot use the same quality ratio when saving an altered image as was used for the original image. You can change the default level of quality that &showfoto; will apply when it saves altered images by moving the <guilabel>JPEG quality</guilabel> slider  (1: low quality / 100: high quality and no compression).
            </para>

            <para>
            With <guilabel>PNG compression</guilabel> option, you can reduce PNG image files size. This operation doesn't reduce image quality because PNG usees a lossless algorithm. The only effect is that image data needs more time to compress/decompress. If you have a fast computer you can change this value for to use a high compression factor (1: low compression / 9: high compression).
            </para>
            
            <para>
            With <guilabel>Using TIFF compression</guilabel> option, you can toogle to use <emphasis>Adobe Deflate</emphasis> compression algorithm with TIFF image files. This will reduce the TIFF image files size. This has no image quality effect because Adobe Deflate is a lossless algorithm. 
            </para>
            
            <para>
            By default the editor will use a black background behind photographs when they are displayed. If you prefer a different background colour you can select one here.
            </para>

            <para>
            Other options manage user interface rules. You can control how &showfoto; will behave when you delete a photograph. You can also turn off the ToolBar and Thumbar when &showfoto; is in full screen mode. Too, you can switch off the display of the splash screen when &showfoto; loads. This may speed up the start time very slightly.
            </para>

            <figure>
                <title>The General Settings</title>
                <graphic srccredit="The general Settings" fileref="setupgeneral.png"/>
            </figure>
                        
        </sect2>
        
        <sect2 id="setupplugins">
        <title>Plugins Settings</title>

            <para>
            In the early versions of &showfoto; the editor was just a viewer for photographs, but it is rapidly developing into a very useful photo manipulation tool. This dialog allows you to control how &showfoto; will behave.
            </para>

            <figure>
                <title>The Plugins Settings</title>
                <graphic srccredit="The Plugins Settings" fileref="setupplugins.png"/>
            </figure>
            
            <para>
            &showfoto; only implements some very simple photo manipulation tools in the core application. For an easy development of more manipulation tools the editor supports a plugin interface. If your distribution has installed the additional &showfoto; plugins they will be listed in the Image Plugins list. You can enable or disable these plugins that you see here.
            </para>

            <para>
            For more informations about advanced &showfoto; plugins, you can consult the 'DigikamImagePlugins' project at <ulink url="http://extragear.kde.org/apps/digikamimageplugins">http://extragear.kde.org/apps/digikamimageplugins</ulink>.
            </para>
                        
        </sect2> 

        <sect2 id="setupslideshow">
        <title>Slide Show Settings</title>

            <para>
            &showfoto; can slides you photograph to do a nice presentation to your friends. Use this tab to set it properly:
            </para>

            <figure>
                <title>The Slide Show Settings</title>
                <graphic srccredit="The Slide Show Settings" fileref="setupslideshow.png"/>
            </figure>
            
            <para>

                <itemizedlist>
            
                    <listitem>
                        
                        <para>
                        <guilabel>Delay between images</guilabel>: The length of time between image changes during the slideshow. You can use the slider, type a new value into the field, or use the small arrows to increase or decrease the value. The default is 3 seconds.
                        </para>
                                                
                    </listitem>

                    <listitem>
                        
                        <para>
                        <guilabel>Start with current image</guilabel>: Indicates if the slideshow should start with the first image in the thumbbar or with the image which is currently selected.
                        </para>
                                                
                    </listitem>

                    <listitem>
                        
                        <para>
                        <guilabel>Display in Loop</guilabel>: If you enable this option, slideshow will loop untill you abort it.
                        </para>
                                                
                    </listitem>

                    <listitem>
                        
                        <para>
                        <guilabel>Fullscreen mode</guilabel>: Indicates if &showfoto; should switch to full-screen mode when starting the slideshow. 
                        </para>
                                                
                    </listitem>
                
                </itemizedlist>
            
            </para>
                        
        </sect2> 
                                   
    </sect1>    

</chapter>

<!-- *********************************************************************** -->

<chapter id="menudescriptions">
<title>Menu Descriptions</title>

<sect1>
<title>The Main Window</title>

    <sect2>
    <title>The File Menu</title>

    <para>
    <variablelist>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>PgUp</keycap></keycombo></shortcut>
                <guimenu>File</guimenu><guimenuitem>Previous</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Display the previous image of the current list.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>PgDown</keycap></keycombo></shortcut>
                <guimenu>File</guimenu><guimenuitem>Next</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Display the next image of the current list.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>Home</keycap></keycombo></shortcut>
                <guimenu>File</guimenu><guimenuitem>First</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Display the first image of current list.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>End</keycap></keycombo></shortcut>
                <guimenu>File</guimenu><guimenuitem>Last</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Display the last image of current list.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></shortcut>
                <guimenu>File</guimenu><guimenuitem>Save</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Save the current image if it has been modified.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>File</guimenu><guimenuitem>Save As</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Save the current image in a new file.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>File</guimenu><guimenuitem>Revert</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Restore the current image from the original file if it has been modified.</action></para></listitem>
        </varlistentry>
                            
        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Shift</keycap><keycap>Del</keycap></keycombo></shortcut>
                <guimenu>File</guimenu><guimenuitem>Delete File/Move to trash</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Delete/Move to trash the current image from the current list.</action></para></listitem>
        </varlistentry>
    
        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo></shortcut>
                <guimenu>File</guimenu><guimenuitem>Print Image</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Print the current image.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo></shortcut>
                <guimenu>File</guimenu><guimenuitem>Quit</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Quit &showfoto; Image Editor.</action></para></listitem>
        </varlistentry>
            
    </variablelist>
    </para>

    </sect2>

    <!-- *********************************************************************** -->
    
    <sect2>
    <title>The Edit Menu</title>

    <para>
    <variablelist>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo></shortcut>
                <guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Copy the current image selection in the clipboard.</action></para></listitem>
        </varlistentry>
        
        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo></shortcut>
                <guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Undo the last action applied to the current image using history.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>Z</keycap></keycombo></shortcut>
                <guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Redo the last action applied to the current image using history.</action></para></listitem>
        </varlistentry>
    
    </variablelist>
    </para>

    </sect2>

    <!-- *********************************************************************** -->
    
    <sect2>
    <title>The Image Menu</title>

    <para>
    <variablelist>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>F3</keycap></keycombo></shortcut>
                <guimenu>Image</guimenu><guimenuitem>Edit Comments and Tags</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Edit the comments and tags of the currently 
            selected image.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Alt</keycap><keycap>Return</keycap></keycombo></shortcut>
                <guimenu>Image</guimenu><guimenuitem>Properties</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>View General Properties, Permissions, embedded Meta-Data, EXIF information, 
            and Histogram of the currently selected image.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Image</guimenu><guimenuitem>Apply Texture</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to apply decorative texture to the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/texture.html">Apply Texture manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>      
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Image</guimenu><guimenuitem>Add Border</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to add a decorative border around the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/border.html">Add Border manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>      

        <varlistentry>
            <term><menuchoice>
                <guimenu>Image</guimenu><guimenuitem>Insert Text</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to insert text in the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/inserttext.html">Insert Text manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>      
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Image</guimenu><guimenuitem>Template Superimpose</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin for apply a template to the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/superimpose.html">Template Superimpose manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>      
                
    </variablelist>
    </para>

    </sect2>

    <!-- *********************************************************************** -->
    
    <sect2>
    <title>The Fix Menu</title>

    <para>
    <variablelist>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem>
                <guimenuitem>Brightness/Contrast/Gamma</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Exposure correction of the current image by Brightness, Contrast, or Gamma adjustments.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem>
                <guimenuitem>Hue/Saturation/Lightness</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Color correction of the current image by Hue, Saturation, or Lightness 
            adjustments.</action></para></listitem>
        </varlistentry>
    
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Color 
                Balance</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Color correction of the current image by Red, Green, or Blue 
            adjustments.</action></para></listitem>
        </varlistentry>
    
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Auto-Correction</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Automatic color correction of the current image by an histogram 
            manipulation.</action></para></listitem>
        </varlistentry>
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Invert</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Invert image colors.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Levels 
                Adjust</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to adjust levels manually on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/adjustlevels.html">Adjust Levels manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Curves 
                Adjust</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to adjust curves manually on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/adjustcurves.html">Adjust Curves manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Channel Mixer</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to mix color channels on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/channelmixer.html">Channel Mixer manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>White Balance</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to adjust white color balance on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/whitebalance.html">White Balance manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>
                                    
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Blur</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Focus error correction of the current image by a blurring 
            operation.</action></para></listitem>
        </varlistentry>
    
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Sharpen</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Focus error correction of the current image by a sharping 
            operation.</action></para></listitem>        
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Red Eye Reduction</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Red Eye correction using the current selection of the current 
            image.</action></para></listitem>        
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Unsharp Mask</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to operate an Unsharp mask on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/unsharp.html">Unsharp Mask manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Lens Distortion Correction</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to correct lens distortion of the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/lensdistortion.html">Lens Distortion Correction manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>                
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Restoration</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to reduce artefacts on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/restoration.html">Photograph Restoration manual</ulink> 
                    for more information.
                </para>     
            </listitem>            
        </varlistentry>
                
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Inpainting</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to remove unwanted area on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/inpainting.html">Photograph Inpainting manual</ulink> 
                    for more information.
                </para>     
            </listitem>            
        </varlistentry>
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Noise Reduction</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to reduce the noise on the current image with using a Despeckle
                    filter.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/despeckle.html">Noise Reduction manual</ulink> 
                    for more information.
                </para>     
            </listitem>            
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Anti Vignetting</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to correct vignetting of the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/antivignetting.html">Anti Vignetting manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>                

        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Refocus</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    Image Editor plugin to refocus the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/refocus.html">Refocus Photograph manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Fix</guimenu><guimenuitem>Hot Pixels Correction</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    Image Editor plugin to remove hot pixels on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/hotpixels.html">Hot Pixels Photograph manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>
                                
    </variablelist>
    </para>

    </sect2>

    <!-- *********************************************************************** -->
    
    <sect2>
    <title>The Transform Menu</title>

    <para>
    <variablelist>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Shift</keycap><keycap>1</keycap></keycombo></shortcut>
                <guimenu>Transform</guimenu><guimenuitem>Rotate</guimenuitem><guimenuitem>90 
                degrees</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>90 degrees rotation of the current image.</action></para></listitem>
        </varlistentry>
    
        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Shift</keycap><keycap>2</keycap></keycombo></shortcut>
                <guimenu>Transform</guimenu><guimenuitem>Rotate</guimenuitem><guimenuitem>180 
                degrees</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>180 degrees rotation of the current image.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Shift</keycap><keycap>3</keycap></keycombo></shortcut>
                <guimenu>Transform</guimenu><guimenuitem>Rotate</guimenuitem><guimenuitem>270 
                degrees</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>270 degrees rotation of the current image.</action></para></listitem>
        </varlistentry>
    
        <varlistentry>
            <term><menuchoice>
                <guimenu>Transform</guimenu><guimenuitem>Flip</guimenuitem><guimenuitem>Horizontally</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Horizontal flip of the current image.</action></para></listitem>
        </varlistentry>
    
        <varlistentry>
            <term><menuchoice>
                <guimenu>Transform</guimenu><guimenuitem>Flip</guimenuitem><guimenuitem>Vertically</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Vertical flip of the current image.</action></para></listitem>
        </varlistentry>
    
        <varlistentry>
            <term><menuchoice>
                <guimenu>Transform</guimenu><guimenuitem>Crop</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Crop the current image to the current selection.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Transform</guimenu><guimenuitem>Resize</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Resize the current image to the appropriate factor or dimensions.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Transform</guimenu><guimenuitem>Aspect Ratio Crop</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Crop the current image using an constrained aspect ratio.</action></para></listitem>
        </varlistentry>
                
        <varlistentry>
            <term><menuchoice>
                <guimenu>Transform</guimenu><guimenuitem>Blowup</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to blow up a photograph without less image quality.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/blowup.html">Blowup manual</ulink> 
                    for more information.
                </para>     
            </listitem>            
        </varlistentry>        
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Transform</guimenu><guimenuitem>Shear</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to shear the current image.horizontally or vertically.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/sheartool.html">Shear Tool manual</ulink> 
                    for more information.
                </para>     
            </listitem>            
        </varlistentry>
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Transform</guimenu><guimenuitem>Free Rotation</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to rotate the current image by any angle in degrees.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/freerotation.html">Free Rotation manual</ulink> 
                    for more information.
                </para>     
            </listitem>            
        </varlistentry>
            
        <varlistentry>
            <term><menuchoice>
                <guimenu>Transform</guimenu><guimenuitem>Perspective Adjustment</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to adjust perspective of the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/perspective.html">Perspective Adjustment manual</ulink> 
                    for more information.
                </para>     
            </listitem>            
        </varlistentry>
    
    </variablelist>
    </para>

    </sect2>
            
    <!-- *********************************************************************** -->
    
    <sect2>
    <title>The View Menu</title>

    <para>
    <variablelist>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>+</keycap></keycombo></shortcut>
                <guimenu>View</guimenu><guimenuitem>Zoom In</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Increase the zoom factor on the current image.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>-</keycap></keycombo></shortcut>
                <guimenu>View</guimenu><guimenuitem>Zoom Out</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Decrease the zoom factor on the current image.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>A</keycap></keycombo></shortcut>
                <guimenu>View</guimenu><guimenuitem>Zoom AutoFit</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Set the zoom factor for adapting the current image size to the Image Editors 
            window size.</action></para></listitem>
        </varlistentry>
                            
        <varlistentry>
            <term><menuchoice>
                <guimenu>View</guimenu><guimenuitem>Histogram</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Display superimposed histogram under current image.</action></para></listitem>
        </varlistentry>
    
    </variablelist>
    </para>

    </sect2>

    <!-- *********************************************************************** -->
    
    <sect2>
    <title>The Filters Menu</title>

    <para>
    <variablelist>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Filters</guimenu><guimenuitem>Black and White</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Apply Black and White filter to the current image.</action></para></listitem>
        </varlistentry>
                
        <varlistentry>
            <term><menuchoice>
                <guimenu>Filters</guimenu><guimenuitem>Raindrops</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to add Rain Drops on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/raindrops.html">Rain Drops manual</ulink> 
                    for more information.
                </para>     
            </listitem>       
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Filters</guimenu><guimenuitem>Infrared Film</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to simulate infrared film on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/infrared.html">Infrared Film manual</ulink> 
                    for more information.
                </para>     
            </listitem>       
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Filters</guimenu><guimenuitem>Oil paint</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to simulate Oil Painting on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/oilpaint.html">Oil Paint manual</ulink> 
                    for more information.
                </para>     
            </listitem>       
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Filters</guimenu><guimenuitem>Emboss</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to Emboss the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/emboss.html">Emboss Image manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Filters</guimenu><guimenuitem>Solarize Image</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to Solarize the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/solarizeimage.html">Solarize Image manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>
                
        <varlistentry>
            <term><menuchoice>
                <guimenu>Filters</guimenu><guimenuitem>Distortion Effects</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to apply distortion special effects on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/distortionfx.html">Distortion Effects manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>
        
        <varlistentry>
            <term><menuchoice>
                <guimenu>Filters</guimenu><guimenuitem>Add Film Grain</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin for to adding Film Grain on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/filmgrain.html">Film Grain manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Filters</guimenu><guimenuitem>Blur Effects</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to apply blurring special effects on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/blurfx.html">Blur Effects manual</ulink> 
                    for more information.
                </para>     
            </listitem>
        </varlistentry>
                                            
        <varlistentry>
            <term><menuchoice>
                <guimenu>Filters</guimenu><guimenuitem>Charcoal Drawing</guimenuitem>
            </menuchoice></term>
            <listitem>
                <para><action>
                    digiKam image plugin to simulate Charcoal Drawing on the current image.
                </action></para>
                <para>
                    See the dedicated 
                    <ulink url="help:/digikamimageplugins/charcoal.html">Charcoal Drawing manual</ulink> 
                    for more information.
                </para>     
            </listitem>            
        </varlistentry>
    
    </variablelist>
    </para>

    </sect2>

    <!-- *********************************************************************** -->

    <sect2>
    <title>The Settings Menu</title>

    <para>
    <variablelist>

        <varlistentry>
            <term><menuchoice>
                <shortcut><keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>F</keycap></keycombo>
                </shortcut>
                <guimenu>Settings</guimenu><guimenuitem>Full Screen Mode</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Toggles the graphic interface to full screen mode.</action></para></listitem>
        </varlistentry>
    
        <varlistentry>
            <term><menuchoice>
                <guimenu>Settings</guimenu><guimenuitem>Configure Shorcuts</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Configure the &showfoto; image editor shortcuts.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Settings</guimenu><guimenuitem>Configure Toolbars</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Configure the &showfoto; image editor toolbars.</action></para></listitem>
        </varlistentry>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Settings</guimenu><guimenuitem>Configure &showfoto;</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Lauch &showfoto; configure dialog.</action></para></listitem>
        </varlistentry>
        
    </variablelist>
    </para>

    </sect2>
        
    <!-- *********************************************************************** -->
            
    <sect2>
    <title>The Help Menu</title>
    &help.menu.documentation;

    <para>Additionally &showfoto; Image Editor offers this item:</para>

    <variablelist>

        <varlistentry>
            <term><menuchoice>
                <guimenu>Help</guimenu><guimenuitem>ImagePlugins' Handbooks</guimenuitem>
            </menuchoice></term>
            <listitem><para>Launch the &kde; help interface with the &showfoto; Image Editor 
            plugins handbooks.</para></listitem>
        </varlistentry>
    
    </variablelist>

    </sect2>
            
</sect1>

<!-- *********************************************************************** -->

</chapter>

<chapter id="credits">

<title>Credits and License</title>

<para>
    
    <inlinemediaobject>
        <imageobject><imagedata fileref="digikamlogo.png" format="PNG"/></imageobject>
        <textobject> <phrase>digiKam logo</phrase> </textobject>
    </inlinemediaobject>
    
</para>

<para>
Program copyright 2004-2005, &showfoto; developers team

    <itemizedlist>

        <listitem>
            <para>
            Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email>: 
            Coordinator, Main Developer.
            </para>
        </listitem>
    
        <listitem>
            <para>
            Caulier Gilles <email>caulier_dot_gilles_at_free.fr</email>: 
            Co-coordinator, Developer, French Translations.
            </para>
        </listitem>
    
        <listitem>
            <para>
            Joern Ahrens <email>kde_at_jokele.de</email>: 
            Developer.
            </para>
        </listitem>
        
        <listitem>
            <para>
            Tom Albers <email>tomalbers_at_kde.nl</email>: 
            Developer.
            </para>
        </listitem>    
        
    </itemizedlist>

</para>

<para>
Documentation copyrighted by:

    <itemizedlist>
        
        <listitem>
            <para>
            2004-2005 
            <itemizedlist>
                <listitem><para>Gilles Caulier <email>caulier_dot_gilles_at_free.fr</email></para></listitem>
                <listitem><para>Gerhard Kulzer <email>gerhard at kulzer.net</email></para></listitem>
            </itemizedlist>
            </para>
        </listitem>
        
    </itemizedlist>
    
All Pictures copyrighted 2004-2005 by Gilles Caulier <email>caulier_dot_gilles_at_free.fr</email>.
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;

&underGPL;

</chapter>

<appendix id="installation">
<title>Installation</title>

<sect1 id="getting-kapp">
<title>How to Obtain &showfoto;</title>

<para>
&showfoto; is a part of <emphasis>digiKam project</emphasis> and the website is at <ulink url="http://www.digikam.org">http://www.digikam.org</ulink>. Please check it regularly to get the latest news about &showfoto;. &showfoto; can be obtained in binary and source format from <ulink url="http://sourceforge.net/project/showfiles.php?group_id=42641">http://sourceforge.net/project/showfiles.php?group_id=42641</ulink>.
</para>

<para>
Also you can checkout the <emphasis>digiKam</emphasis> source code modules
from &kde; Extragear SVN repository like this:

<screen width="40">
    <prompt>%</prompt> <userinput>svn co -N svn://anonsvn.kde.org/home/kde/trunk/extragear/graphics</userinput>
    <prompt>%</prompt> <userinput>cd graphics</userinput>
    <prompt>%</prompt> <userinput>svn up digikam</userinput>
    <prompt>%</prompt> <userinput>svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/kde-common/admin</userinput>
</screen>

</para>

<para>
The last SVN snapshoots can be downloaded at this &URL; <ulink url="ftp://ftp.kde.org/pub/kde/unstable/snapshots/">
ftp://ftp.kde.org/pub/kde/unstable/snapshots/</ulink>.
</para>

</sect1>

<sect1 id="requirements">
<title>Requirements</title>

<para>
In order to successfully use &showfoto;, you need the following:
<itemizedlist>
    <listitem><para>AutoConf >= 2.5</para></listitem>
    <listitem><para>AutoMake >= 1.7.0</para></listitem>
    <listitem><para>&kde; 3.x</para></listitem>
    <listitem><para>imlib2 >= 1.2.0</para></listitem>
    <listitem><para>libkexif >= 0.1</para></listitem>
    <listitem><para>libtiff >= 3.5.x</para></listitem>
    <listitem><para>DigikamImagePlugins >= 0.7.3 (optional)</para></listitem>
</itemizedlist>
</para>

<para>
&kde; can be obtained from <ulink url="http://www.kde.org">&kde; Home Page</ulink>.
</para>

<para>
libkexif can be obtained from <ulink url="http://www.digikam.org">
http://www.digikam.org</ulink>.
</para>

<para>
DigikamImagePlugins can be obtained from <ulink url="http://extragear.kde.org/apps/digikamimageplugins">
http://extragear.kde.org/apps/digikamimageplugins</ulink>.
</para>

<para> 
Most likely your distribution vendor might already have packaged and provided these packages.
</para>

</sect1>

<sect1 id="compilation">
<title>Compilation and Installation</title>

<para>
In order to compile and install &showfoto; on your system, type the following in the basedirectorys of the <emphasis>libkipi</emphasis> and <emphasis>digikam</emphasis> module distributions:

<screen width="40">
    <prompt>%</prompt> <userinput>export WANT_AUTOCONF_2_5=1</userinput>
    <prompt>%</prompt> <userinput>export KDEDIR=KDE_installation_dir_on_your_system</userinput>
    <prompt>%</prompt> <userinput>export 
    PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/path/to/installation/lib/pkgconfig</userinput>    
    <prompt>%</prompt> <userinput>make -f Makefile.cvs</userinput>
    <prompt>%</prompt> <userinput>./configure</userinput>
    <prompt>%</prompt> <userinput>make</userinput>
    <prompt>%</prompt> <userinput>su</userinput>
    <prompt>%</prompt> <userinput>make install</userinput>
</screen>
</para>

<note>
<title>Important Notices</title>

<para>
Stage 3 is required if you are installing libkexif in a non-standard location, and you must let pkg-config know about their paths.
</para>

<para>
More specific compilation and installation options can be passed to the <emphasis>configure</emphasis> script. Use <userinput>./configure --help</userinput> on the command line to view these options.
</para>

<para>
Use <emphasis>--enable-debug=full</emphasis> option with <emphasis>configure</emphasis> script for to provide a full informations bug report.
</para>

<para>
Because &showfoto; depends on <emphasis>libkexif</emphasis>, you must build or install this library before you build &showfoto;.
</para>

</note>

<para>
Since &showfoto; uses autoconf and automake you should not have trouble compiling it. If you run into problems please report them to <email>digikam-users@kde.org</email>.
</para>

</sect1>

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
