<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kappname "&digikam;"><!-- replace kapp here, do *not* replace kappname-->
<!ENTITY package "extragear-graphics">
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE"><!-- change language only here -->
<!ENTITY digikam '<application>digiKam</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 &digikam; Handbook</title>
<authorgroup>
<author>
<firstname>Gilles</firstname><surname>Caulier</surname>
<affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation>
</author>
<author>
<firstname>Richard</firstname><surname>Taylor</surname>
<affiliation><address><email>rjt-digicam_at_thegrindstone_dot_me_dot_uk</email></address></affiliation>
</author>
<author>
<firstname>Ralf</firstname><surname>Hoelzer</surname>
<affiliation><address><email>kde_at_ralfhoelzer.com</email></address></affiliation>
</author>
<author>
<firstname>Joern</firstname><surname>Ahrens</surname>
<affiliation><address><email>joern.ahrens_at_kdemail_dot_net</email></address></affiliation>
</author>
<author>
<firstname>Oliver</firstname><surname>Doerr</surname>
<affiliation><address><email>oliver_at_doerr-privat.de</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>2001</year>
<year>2007</year>
<holder>The &digikam; 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>2006-02-28</date>
<releaseinfo>0.9.1</releaseinfo>
<abstract>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="digikamlogo.png" format="PNG"/></imageobject>
<textobject> <phrase>&digikam; logo</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
&digikam; is a &kde; Photo Management Application with support for Digital Cameras.
</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>Digital Camera</keyword>
<keyword>digiKam</keyword>
<keyword>gphoto</keyword>
<keyword>Graphics</keyword>
<keyword>Color Management</keyword>
<keyword>exiv2</keyword>
<keyword>dcraw</keyword>
</keywordset>
</bookinfo>
<!-- *********************************************************************** -->
<chapter id="introduction">
<title>Introduction</title>
<sect1 id="using-kapp-background">
<title>Background</title>
<sect2 id="using-kapp-about">
<title>About &digikam;</title>
<para>
&digikam; is an advanced digital photo management application for the &kde; desktop. It provides a simple interface which makes importing and organizing digital photographs a "snap". &digikam; enables you to manage large numbers of digital photographs in Albums and to organize these photographs for easy retrieval using tags. It has many features for viewing, organizing, manipulating and sharing your pictures.
</para>
<para>
An easy to use Camera interface is provided, that will connect to your digital camera and download photographs directly into &digikam; Albums. More than 800 digital cameras are supported through the gphoto2 library.
</para>
<para>&digikam; incorporates a fast Image Editor with basic image editing tools. You can use the Image Editor to view your photographs, comment and rate them, make corrections and alterations. The editing power can be easily extended by two sets of plugins, the <ulink url="http://www.kipi-plugins.org">Kde Image Plugins Interface</ulink> (<ulink url="help:/kipi-plugins/index.html">manual</ulink>) and the <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins.</ulink> (<ulink url="help:/digikamimageplugins/index.html">manual</ulink>)
</para>
<para>Whereas &digikam; remains easy to use, it provides professional level features by the dozens. It is fully 16 bit enabled including all available plugins, supports RAW format conversion through David Coffins dcraw and ICC color management work flow.
</para>
</sect2>
<sect2>
<title>Reporting Bugs</title>
<para>
Like the rest of &kde;, &digikam; 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>
&digikam; 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>
&digikam; is a community supported project, which means that users and developers support one another. If you become a regular user of &digikam; you are encouraged to join the &digikam; Users Mailing List. You can start off by asking questions of other &digikam; 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">&digikam; 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 &digikam; related information.
</para>
</sect2>
<sect2>
<title>Getting Involved</title>
<para>
There are many ways that you can get involved with the continued development of &digikam;. 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 &digikam; the best digital photograph application there is.
</para>
<para>
The best way to start getting involved with &digikam; is to join the Developers Mailing List.
<ulink url="https://mail.kde.org/mailman/listinfo/digikam-devel">&digikam; Developer Mailing
List joining instructions.</ulink>
</para>
</sect2>
</sect1>
<sect1 id="using-kapp-firstrun">
<title>Getting Started</title>
<sect2 id="firstrundialog">
<title>The First Run Dialog</title>
<para>
<inlinemediaobject><imageobject>
<imagedata fileref="introductionfirstrundialog.png" format="PNG" /> </imageobject>
</inlinemediaobject></para>
<para>
When you start &digikam; for the very first time it will ask you where you store your photographs. You can type in the path name of a folder or click on the <guilabel>folder</guilabel> icon
<inlinemediaobject>
<imageobject><imagedata fileref="introductionfoldericon.png" format="PNG"/></imageobject>
<textobject> <phrase>Folder Icon</phrase> </textobject>
</inlinemediaobject>
to select a folder from the dialog.
</para>
</sect2>
<sect2>
<title>The Scan Items Dialog</title>
<para>
If you already have a collection of photographs on your hard disk, you can enter the top-level folder containing the photographs, this is called the Albums Library folder. &digikam; will treat each sub-folder of the folder you've entered as an Album. None of the photographs will be altered. During folders parsing you can see a progress dialog like this:
</para>
<para>
<inlinemediaobject> <imageobject>
<imagedata fileref="introductionscandialog.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
</sect2>
<sect2>
<title>The Albums Missing Dialog</title>
<para>This parsing for modifications happens at every application start-up, but it can be disabled in the <guilabel>Settings</guilabel> under <guilabel>Miscellaneous</guilabel>
</para>
<para>
As &digikam; uses your folders on your hard disk directly, other applications like file managers can remove any albums outside a &digikam; session. In this case &digikam; will tell you at the next session if all albums that have been removed from the &digikam; photographs root path shall be deleted from albums database. If you want to move folders around and do not want to do that in &digikam;, we suggest you do that while &digikam; is running, so the database will be kept in sync and you do not lose any metadata.
</para>
<para><inlinemediaobject><imageobject>
<imagedata fileref="introductionalbumsmissingdialog.png" format="PNG" />
</imageobject>
<textobject><phrase>The Albums Missing Dialog</phrase></textobject></inlinemediaobject>
</para>
<para>
When you use an existing folder of photographs, as the Album Library folder, you will notice that the Albums in the My Album list do not have photographs as their icons. The first time you view each Album &digikam; will create a thumbnail from the first photograph in the Album and use this as the Album icon. See the <link linkend="using-kapp-myalbumsview">My Album</link> section for details of how to change the Album icon.
</para>
<para>
If you have previously accessed your photograph collection with another application, that has created thumbnails in non-standard sub-folders, &digikam; will show these thumbnail folders as separate Albums. &digikam; follows the <ulink url="http://www.freedesktop.org/">freedesktop.org</ulink> standards for thumbnail folders. There is no way of hiding non-standard thumbnail folders from the "My Album" list. If you want to keep them you could create an Album Collection that just contains all the thumbnail Folders and then view your Albums in By Collection order. See the <link linkend="using-kapp-myalbumsview">My Album</link> section for more about Album Collections.
</para>
<para>
Once you have configured the Album Library Folder you can setup &digikam; to work with your digital camera. Then learn how to use <link linkend="using-kapp-myalbumsview">My Albums</link> and <link linkend="using-kapp-mytagsview">My Tags</link> to arrange your photograph Albums.
</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>. &digikam; supports both of these formats.
</para>
</sect3>
<sect3>
<title>Still Image Compression</title>
<para>
Image compression is the application of data compression schemes on digital images. It is done through reducing 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 are always preferred for their high preservation value for archival purposes before applying transformations like cropping, resizing, color corrections, &etc;. This is because lossy compression methods, especially when used at low bit rates, introduce compression artifacts. Lossy methods are suitable for natural images such as photos in applications where minor (sometimes imperceptible) loss of fidelity is acceptable to achieve a substantial reduction in file size. Lossy compression is good for image publishing on the 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 is 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>
<para>
JPEG 2000 is supported as well. In general it give for the same compression ratio the better (smoother) results compared to JPEG. The 2000 version has the option of being lossless if so specified in the settings.
</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 (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 lose quality every time you re-encode them after modification. &digikam; fully supports PNG images and the Batch Processing Images Plugin can convert a batch of images from any supported format to PNG in one step. See the <link linkend="using-kapp-setup">Configuration</link> section for information about using plugins with &digikam;.
</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 on-line 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.
</para>
<para>
If you want to learn more about RAW image format visit the very helpful guides<ulink url="http://en.wikipedia.org/wiki/RAW_image_format"> Wikipedia</ulink> <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>. You can convert RAW format images into JPEG or TIFF in &digikam; using the <ulink url="help:/kipi-plugins/rawconverter.html">RAW Image Converter plugin</ulink>. See the <link linkend="using-kapp-setup">Configuration</link> section for information about using plugins with &digikam;.
</para>
<para>
&digikam; supports RAW image loading only relying on the <ulink url="http://www.cybercom.net/~dcoffin/dcraw"> DCRAW program</ulink> which is included into &digikam; core and supports over 200 RAW file formats. See below a short list of main camera RAW files supported by &digikam;:
<informaltable><tgroup cols="2">
<thead><row>
<entry>RAW File Format</entry>
<entry>Description</entry>
</row></thead>
<tbody>
<row><entry>
CRW, CR2
</entry><entry>
Canon digital camera RAW file formats
</entry></row>
<!-- ************************ -->
<row><entry>
NEF
</entry><entry>
Nikon digital camera RAW file format
</entry></row>
<!-- ************************ -->
<row><entry>
ORF
</entry><entry>
Olympus digital camera RAW file format
</entry></row>
<!-- ************************ -->
<row><entry>
RAF
</entry><entry>
Fuji digital camera RAW file format
</entry></row>
<!-- ************************ -->
<row><entry>
PEF, PTX
</entry><entry>
Pentax digital camera RAW file format
</entry></row>
<!-- ************************ -->
<row><entry>
X3F
</entry><entry>
Sigma digital camera RAW file format
</entry></row>
<!-- ************************ -->
<row><entry>
DCR, KDC, DC2, K25
</entry><entry>
Kodak digital camera RAW file format
</entry></row>
<!-- ************************ -->
<row><entry>
SRF, ARW, MRW, MDC
</entry><entry>
Sony/Minolta digital camera RAW file format
</entry></row>
<!-- ************************ -->
<row><entry>
RAW
</entry><entry>
Panasonic, Casio, Leica digital camera RAW file format
</entry></row>
<!-- ************************ -->
<row><entry>
DNG (CS1, HDR)
</entry><entry>
Adobe RAW file format (Digital Negative)
</entry></row>
<!-- ************************ -->
<row><entry>
BAY
</entry><entry>
Casio RAW (Bayer)
</entry></row>
<!-- ************************ -->
<row><entry>
ERF
</entry><entry>
Epson digital camera RAW file format
</entry></row>
<!-- ************************ -->
<row><entry>
FFF
</entry><entry>
Imacon/Hasselblad RAW format
</entry></row>
<!-- ************************ -->
<row><entry>
MOS
</entry><entry>
CREO Photo RAW
</entry></row>
<!-- ************************ -->
<row><entry>
PXN
</entry><entry>
Fotoman RAW
</entry></row>
<!-- ************************ -->
<row><entry>
RDC
</entry><entry>
Ricoh RAW format
</entry></row>
</tbody>
</tgroup></informaltable>
</para>
</sect3>
</sect2>
<sect2>
<title>Moving Image Formats (Videos)</title>
<para>
Many digital cameras support taking of short movie clips. These clips are usually stored in AVI or MPEG format. &digikam; understands these formats and will generate thumbnails for the movie files. However, &digikam; is not a movie editing application and it does not have any built-in movie viewing or editing capabilities. If you double click on a movie file &digikam; will use your &kde; settings to choose a viewing application to use.
</para>
</sect2>
<sect2>
<title>How &digikam; Supports File Formats</title>
<para>
&digikam; 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 &digikam;.
</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>
<para>
&digikam; only displays files that are in formats that it understands. It does this by looking at the file extension on the files and checking this against a predefined list. If the file extension is in the list &digikam; will show the file in the Image View. You can change the list of file extensions that &digikam; will accept, see the <link linkend="using-kapp-setup">Configuration</link> section for more details.
</para>
</sect2>
</sect1>
<sect1 id="using-kapp-pluginssupport">
<title>Supported Plugins</title>
<para>
One of the nicest things about &digikam; is how easily its functionality can be extended, by using plugins. Two plugin architectures are available:
<itemizedlist>
<listitem><para><emphasis>Kipi Plugins</emphasis>: the <ulink url="http://www.kipi-plugins.org">Kde Image Plugins Interface project (kipi)</ulink> (<ulink url="help:/kipi-plugins/index.html">manual</ulink>) is an effort to develop a common plugin structure for &digikam;, <application>KPhotoAlbum</application>, <application>Showimg</application> and <application>Gwenview</application>. Its aim is to share image plugins among graphical applications. Kipi Plugins setup is described in this <link linkend="setupkipiplugins">section</link>.</para></listitem>
<listitem><para><emphasis>Image Editor Plugins</emphasis>: these plugins add new image manipulation options in the &digikam; Image Editor. The <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins project</ulink> (<ulink url="help:/digikamimageplugins/index.html">manual</ulink>) is dedicated to providing a collection of tools using this architecture. Image Editor Plugins setup is described in this <link linkend="setup-editor">section</link>.
</para></listitem>
</itemizedlist>
<inlinemediaobject>
<imageobject><imagedata fileref="introductionplugininterfaces.png" format="PNG"/></imageobject>
<textobject> <phrase>The &digikam; plugins interface</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 &digikam; by writing a small plugin than by modifying the &digikam; core.
</para>
</sect1>
<sect1 id="using-kapp-camerasupport">
<title>Supported Digital Still Cameras</title>
<anchor id="digitalstillcamera.anchor"/>
<sect2>
<title>Introduction</title>
<para>
Current digital cameras are characterized by the use of <emphasis>Compact &Flash; Memory</emphasis> cards and <emphasis>USB</emphasis> or <emphasis>FireWire (IEEE-1394 or i-link)</emphasis> for data transmission. The actual transfers to a host computer is commonly carried out using the <emphasis>USB Mass Storage</emphasis> device class (so that the camera appears as a disk drive) or using the <emphasis>Picture Transfer Protocol (PTP)</emphasis> and its derivatives. Older cameras may use the <emphasis>Serial Port (RS-232)</emphasis> connection.
</para>
<informaltable><tgroup cols="2">
<thead><row>
<entry>Preview Example</entry>
<entry>Connector Type</entry>
</row></thead>
<tbody>
<row>
<entry>
<para><inlinemediaobject><imageobject><imagedata fileref="introductionfirewireconnector.png" format="PNG" /> </imageobject></inlinemediaobject></para>
</entry>
<entry>
FireWire (IEEE-1394 or i-link) connector from a professional digital still camera
</entry>
</row>
<row>
<entry>
<para><inlinemediaobject><imageobject><imagedata fileref="introductionusbconnector.png" format="PNG" /> </imageobject></inlinemediaobject></para>
</entry>
<entry>
Universal Serial Bus (USB) connector from a consumer digital still camera
</entry>
</row>
<row>
<entry>
<para><inlinemediaobject><imageobject><imagedata fileref="introductionserialconnector.png" format="PNG" /> </imageobject></inlinemediaobject></para>
</entry>
<entry>
Serial Port (RS-232) connector from an old digital still camera
</entry>
</row>
</tbody>
</tgroup></informaltable>
</sect2>
<sect2>
<title>Transfers Using gPhoto2: PTP and RS-232 Serial Port</title>
<para>
&digikam; employs the <emphasis>gPhoto2</emphasis> program to communicate with digital still cameras. gPhoto2 is a free, redistributable set of digital camera software applications which supports a growing number of over 800 cameras. gPhoto2 has support for the <emphasis>Picture Transfer Protocol</emphasis>, which is a widely-supported protocol developed by the International Imaging Industry Association to allow the transfer of images from digital cameras to computers and other peripheral devices without the need of additional device drivers.
</para>
<para>
Many old digital still cameras used <emphasis>Serial Port</emphasis> to communicate with host computer. Because photographs are big files and serial port transfers are slow, this connection is now obsolete. &digikam; supports these cameras and performs image transfers using the gPhoto2 program. You can find a complete list of supported digital cameras at this <ulink url="http://www.gphoto.org/proj/libgphoto2/support.php">url</ulink>.
</para>
</sect2>
<sect2>
<title>Transfers Using Mass Storage Device</title>
<para>
Of the devices that are not directly supported by gPhoto2, there is support for the <emphasis>Mass Storage</emphasis> protocol, which is well-supported under &GNU;/&Linux;. This includes any digital cameras and Memory Card Readers. Mass Storage interfaces are:
<itemizedlist>
<listitem><para><emphasis>USB Mass Storage</emphasis>: it is a set of computing interface using a communications protocols defined by the USB Implementers Forum that run on the Universal Serial Bus. This standard provides an interface to a variety of storage devices, including digital cameras.</para></listitem>
<listitem><para><emphasis>FireWire Mass Storage</emphasis>: it is a set of computing interface using a communications protocols developed primarily by Apple Computer in the 1990s. FireWire offering high-speed communications and asynchronous real-time data services. Like USB Mass Storage, this standard provides an interface to a variety of storage devices, including digital still cameras. Almost all recent digital cameras support USB version 1 and eventually will support USB version 2, a very few support FireWire.
</para></listitem>
</itemizedlist>
To use a generic Mass Storage device with &digikam;, select <guilabel>Mounted Camera</guilabel> item in <link linkend="cameraselection.anchor">Camera Setup</link> list and set the correct mount point path.
</para>
</sect2>
</sect1>
</chapter>
<!-- *********************************************************************** -->
<chapter id="using-kapp">
<title>Using &digikam;</title>
<sect1 id="using-kapp-mainwindow">
<title>The Main &digikam; Window</title>
<sect2 id="using-kapp-mainwindow-intro">
<title>Introduction to the Main Window</title>
<para>
<inlinemediaobject><imageobject><imagedata fileref="maininterfacepreview.png" format="PNG" /> </imageobject>
</inlinemediaobject>
</para>
<para>&digikam;'s main window has four areas. The first one is a sidebar in the left margin that lets you switch between 4 views: <guibutton>My Albums</guibutton>, <guibutton>My Dates</guibutton>, <guibutton>My Tags</guibutton> and <guibutton>My Searches</guibutton>. Then there is a tree navigator showing the selected view. The main image window is right in the center. And on the right hand side there is another <link linkend="using-kapp-sidebar">sidebar</link> shown. This one can be used to show all information of your images. You can use these views to organize and find your photographs.
</para>
<anchor id="maininterface-statusbar"/>
<para>The status bar at the bottom shows:<itemizedlist>
<listitem><para>file name when single file selected</para></listitem>
<listitem><para>selection information when several items are selected</para></listitem>
<listitem><para>progress bar for batch processes, ⪚ assign tags</para></listitem>
<listitem><para>navigation bar that lead through the images in the main view</para></listitem>
</itemizedlist>
</para>
<para>
Across the top of the window is a Menu Bar and right below it is the tool bar.
</para>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="maininterfacetoolbar.png" format="PNG"/></imageobject>
<textobject> <phrase>The Default Main Toolbar</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
<itemizedlist>
<listitem><para>(1) : Navigate one view backwards in the Album History.</para></listitem>
<listitem><para>(2) : Navigate one view forwards in the Album History.</para></listitem>
<listitem><para>(3) : Create a new Album.</para></listitem>
<listitem><para>(4) : Edit Album Properties.</para></listitem>
<listitem><para>(5) : Quick Search Images Tool.</para></listitem>
<listitem><para>(6) : Open Image Editor.</para></listitem>
<listitem><para>(7) : Rename Image.</para></listitem>
<listitem><para>(8) : Increase Thumbnail Size.</para></listitem>
<listitem><para>(9) : Decrease Thumbnail Size.</para></listitem>
<listitem><para>(10) : Toggle Full Screen.</para></listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="using-kapp-myalbumsview">
<title>"My Albums" View</title>
<para>
The "My Albums" tree provides an organized view of your photograph albums. All photographs that are managed by &digikam; are stored in a single folder branch. The albums can be sorted by their folder layout on the hard disk, by the Collection name that has been set in the Album Properties or by the Date of that Albums (this date can also be changed in the Properties of each Album).
</para>
<para>
You can switch between these sort orders using <guimenuitem>Sort Albums</guimenuitem> from the <guimenu>View</guimenu> menu.
</para>
<sect3 id="using-kapp-createnewalbum">
<title>Creating a New Album</title>
<para>
There are a number of ways to create a new Album. You can create a new Album when you upload new photographs from the Camera using the Camera Tool. You can also create a new empty Album by clicking the <menuchoice><guimenu>View</guimenu> </menuchoice> button on the tool bar. As an additional option, you can create a new Album by importing an existing folder of photographs from your computer, just select <menuchoice><guimenu>Album</guimenu> <guimenuitem>Import</guimenuitem> <guimenuitem>Import Folders</guimenuitem></menuchoice> from the Menu Bar and select the folder that you want to import. An Album will be created with the same name as the hard disk folder. You can use drag and drop to import a folder. Drag a folder icon, for example from a &konqueror; window. Than drop it on the album list on the left. A menu will appear that gives you the option to move or copy the folder into &digikam;.
</para>
</sect3>
<sect3 id="using-kapp-deletealbum">
<title>Deleting an Album</title>
<para>
When you delete an Album from &digikam; it will be moved into the &kde; Trash Can. As an option you could change this behavior, so that delete really did remove the Album and all of the photographs in it. This can be changed by selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &digikam;</guimenuitem></menuchoice> and selecting the Miscellaneous page. At the top of this page are the settings that control what happens when a photograph is deleted. To delete an Album right-click the Album in the "My Album" tree and select Delete Album from Hard Disk from the context menu.
</para>
</sect3>
<sect3 id="using-kapp-addphototoalbum">
<title>Adding a Photograph to an Album</title>
<para>
Most of the time you will create new Albums and populate them with photographs directly from your camera using the Camera Tool. However, sometimes you may want to add a photograph that you already have on your computer to an existing Album. To add a photograph to an Album, make sure that the Album is selected. Then, either click the <guilabel>Add Images</guilabel> icon in the tool bar or select <menuchoice><guimenu>Album</guimenu> <guimenuitem>Import</guimenuitem> <guimenuitem>Add Images</guimenuitem></menuchoice> from the Menu Bar. Select the photographs that you want to add from the file dialog and click <guilabel>Open</guilabel>. The photographs will be copied into the Album. Additionally, you can use drag and drop to import photographs. Drag the photographs icons, for example from a &konqueror; window. Than drop it on the image list on the right hand side.
</para>
<para>
If you have a scanner configured you can also scan a photograph straight into an Album. Select
<menuchoice><guimenu>Album</guimenu>
<guimenuitem>Import</guimenuitem>
<guimenuitem>Scan Images</guimenuitem></menuchoice>.
You can also take a screenshot and add this directly to an Album. Select
<menuchoice><guimenu>Album</guimenu>
<guimenuitem>Import</guimenuitem>
<guimenuitem>Screenshot</guimenuitem></menuchoice>.
</para>
</sect3>
<sect3 id="using-kapp-movecopyitem">
<title>Moving or Copying Photographs Between Albums</title>
<para>
Simply drag the photograph and drop it on the destination Album to move or copy it from on Album to another. A menu will appear that gives you the option to <guilabel>Move</guilabel> or <guilabel>Copy</guilabel> the photograph. You can move or copy multiple photographs the same way, just select all the photographs that you want to move and drag them on to the destination Album.
</para>
</sect3>
<sect3 id="using-kapp-managealbums">
<title>Managing Albums</title>
<anchor id="albumpropsedit.anchor"/>
<para>
An Album contains a set of photographs and the Album Properties allows you to set information about this set. To access the Album Properties right-click on an Album and select <guilabel>Edit Album Properties</guilabel> from the context menu.
</para>
<para>The Album Properties dialog allows you to set:</para>
<example>
<title>The Album Properties Dialog</title>
<screenshot><mediaobject><imageobject><imagedata fileref="maininterfacealbumproperties.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<itemizedlist>
<listitem><para>The Album <guilabel>Title</guilabel> : this will be used in the "My Albums" list.
</para></listitem>
<listitem><para>The Album <guilabel>Collection</guilabel> : this is a way of grouping your Albums together by a common label. The Collection you set will be used to order your albums when you select <guilabel>By Collection</guilabel> from the drop down box in the tool bar or using <menuchoice><guimenu>View</guimenu><guimenuitem>Sort Albums</guimenuitem><guimenuitem>By Collection</guimenuitem></menuchoice>. If you want to add and delete Collection labels, use the <link linkend="setup-collection">Collection Settings</link> dialog.
</para></listitem>
<listitem><para>The <guilabel>Comments</guilabel> for the Album : this will be shown in the banner at the top of the main Image Window.
</para></listitem>
<listitem><para>The Album <guilabel>Date</guilabel> : this will be used when you order your Albums by date using <menuchoice><guimenu>View</guimenu><guimenuitem>Sort Albums</guimenuitem><guimenuitem>By Date</guimenuitem></menuchoice>.
</para></listitem>
<listitem><para><guilabel>Oldest, Average, Newest</guilabel> buttons : these will set the <guilabel>Date</guilabel> to the oldest, average or latest date of the images in that album. It will first try to calculate the average date of the images in the album based on the EXIF-headers. If that fails it will fall back to modification date of the files in that folder.
</para></listitem>
</itemizedlist>
</sect3>
<sect3 id="using-kapp-setalbumicon">
<title>Setting the Album Icon</title>
<para>
When you first view an Album, &digikam; selects the first photograph in the Album as the icon to display in the "My Album" list. This helps you remember what kind of photographs are contained in an Album. Sometimes the first photograph in the Album is not the most representative and you want to select a different one as the Album icon.
</para>
<para>
To select a different photograph as the Album icon, right-click on the photograph that you want to use as the Album icon and select "Set as Album Thumbnail" from the context menu. Additionally you can use drag and drop to set the Album icon. Drag the photographs icon and drop it on the currently selected Album in the Album list.
</para>
</sect3>
<sect3 id="using-kapp-aboutcollections">
<title>Notes About Album Collections</title>
<para>
An Album can only be in one Album Collection and Album Collections cannot be nested.
</para>
<para>
&digikam; also supports tagging individual photographs using the "My Tags" area at the left of the main window. Album Collections are different to photograph tagging because the Album Collection applies to all the photographs in an Album rather than to individual photographs. You can use both Album Collections and tagging to organize your photographs.
</para>
</sect3>
</sect2>
<sect2 id="using-kapp-imageview">
<title>Image View</title>
<sect3>
<title>Introduction</title>
<para>
The Image Window provides the main view of your photographs. When you select an Album the photographs in that Album will be displayed in the Image Window. Each photograph is displayed as a thumbnail. You can alter the size of the thumbnails using the magnifier buttons in the tool bar.
<inlinemediaobject>
<imageobject><imagedata fileref="editorzoombuttons.png" format="PNG"/></imageobject>
<textobject> <phrase>The Thumbnail size buttons</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
The first time you select an Album you may have to wait briefly while the thumbnails are generated, unless you used the
<menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Rebuild all Thumbnails</guimenuitem>
</menuchoice> menu item beforehand.
</para>
<para>
Information about each photograph is displayed below each thumbnail. You can control what information is displayed from the
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure &digikam;</guimenuitem>
</menuchoice>
dialog. Select the Albums page and look for the <guilabel>Extra Information in Thumbnail View</guilabel> section.
</para>
<para>
The thumbnails have Tool Tips which will pop up if you allow the mouse to dwell over a thumbnail for a moment. The Tool Tip shows the most important properties of the photograph including any Tags that you have applied. The screenshot at the top of the <link linkend="using-kapp-mainwindow-intro">Introduction to the Main Window</link> section shows a Tool Tip being displayed.
</para>
</sect3>
<sect3>
<title>Image Management</title>
<para>
Photographs are what &digikam; is all about. The Albums and Tags allow you to organize and find your photographs in a way that suits you. You can access all of the functions that &digikam; can perform on a photograph by right-clicking the thumbnail (context menu) or by selecting from the Image menu in the Menu Bar. You have the choice between viewing the images, viewing by slide show, or of editing the images.
</para>
</sect3>
<sect3 id="using-kapp-imageviewing">
<title>Viewing a Photograph</title>
<para>
There are several possibilities to view an image. You can either click on it, push
<menuchoice>
<shortcut><keycombo action="press"><keycap>F3</keycap></keycombo></shortcut>
<guimenu>Image</guimenu><guimenuitem>View...</guimenuitem>
</menuchoice> or
<menuchoice>
<shortcut><keycombo action="press"><keycap>Enter</keycap></keycombo></shortcut>
<guimenu></guimenu></menuchoice>
or select <menuchoice><guimenu>View</guimenu></menuchoice> from the context menu. The image will take the whole central space of the main window. For viewing it larger, click the sidebars away (by just clicking on them). While viewing images you can take action from the context menu at any time. To get back to the album view, just click again or press
<menuchoice>
<shortcut><keycombo action="press"><keycap>Esc</keycap></keycombo></shortcut>
<guimenu></guimenu></menuchoice> or
<menuchoice>
<shortcut><keycombo action="press"><keycap>F3</keycap></keycombo></shortcut>
<guimenu></guimenu></menuchoice> puts you back into the main window.
</para>
</sect3>
<sect3 id="using-kapp-imageediting">
<title>Editing a Photograph</title>
<para>
You can open the Image Editor on a photograph either using
<menuchoice>
<shortcut><keycap>F4</keycap></shortcut>
<guimenu>Image</guimenu><guimenuitem>Edit...</guimenuitem>
</menuchoice>
or by right-clicking and selecting <guilabel>Edit</guilabel> from the context menu. See the <link linkend="using-kapp-imageeditor">&digikam; Image Editor</link> section for instructions on how to edit your photographs. The Image Editor lets you view your photographs and make a number of adjustments to them.
</para>
</sect3>
<sect3 id="using-kapp-externalapp">
<title>Viewing or Editing a Photograph With Another Application</title>
<para>
Sometimes &digikam; may not provide all of the capabilities you need. You can open a photograph in another application by right-clicking on it and selecting from the <guilabel>Open With</guilabel> sub-menu. The list applications that appear in this menu is controlled by the standard &kde; file associations for the image format type of this photograph. Look into the &kde; manual for instructions on changing these file associations if the application that you need is not listed.
</para>
<para>
Note that there can be a problem with meta-data embedded in photographs when they are edited by other image manipulation applications. Some applications do not retain the photograph's meta-data when you save a modified image. This means that if you modify a photograph using one of these programs you will lose information such as orientation, aperture &etc;. that are stored in the EXIF and IPCT tags.
</para>
</sect3>
<sect3 id="using-kapp-rotateimage">
<title>Lossless Image Rotation</title>
<note><para>
You will need to have the Kipi JPEG Lossless Plugin installed for the rotation features. If you do not have this plugin installed you can still rotate your photographs, but you have to do so from the Image Editor inside. The Image Editor uses a different method of rotating an image, you may not notice any difference but the Image Editor method can cause some loss of quality in the photograph when saving the picture as JPEG. The rotation methods described here uses the Kipi JPEG Lossless Plugin and does preserve the quality in the original photograph.
</para></note>
<para>
&digikam; provides two ways to get your photographs the right way up. The simplest method is to right-click the thumbnail and select <guilabel>Rotate</guilabel> and then pick the correct amount of rotation needed.
</para>
<para>
Many digital cameras now have an orientation sensor. This sensor can detect how you hold the camera while taking a picture. It stores this orientation information inside the image. This meta data is stored in an embedded meta-data section called EXIF. The cameras could rotate the image themselves right away, but they have limited processing power, so they leave this job to an application like &digikam;. If the camera is storing the orientation, then &digikam; can use it to automatically rotate your photographs so that they are the correct way up when you display them. &digikam; will rotate the picture on disk according to this orientation information.
</para>
<para>
The photograph is rotated without loss of quality and the orientation information is set to normal, so that other EXIF-aware applications will handle it correctly. To use this feature, right-click on the thumbnail and select
<menuchoice>
<guimenu>Image</guimenu><guimenuitem>Auto Rotate/Flip Using EXIF Information</guimenuitem>
</menuchoice>
. The Camera Tool can perform this operation automatically when it uploads the photographs from your camera which will ensure that your photographs are always the right way up. The rotate operation will do nothing, if your camera does not include this information in the photos.
</para>
</sect3>
<sect3 id="using-kapp-renameimage">
<title>Renaming a Photograph</title>
<para>
You can change the filename for a photograph by right-clicking a thumbnail and selecting
<menuchoice>
<shortcut><keycap>F2</keycap></shortcut>
<guimenu>Rename</guimenu>
</menuchoice>. Remember to keep the file extension (.jpg, .tif, &etc;).
</para>
</sect3>
<sect3 id="using-kapp-deleteimage">
<title>Deleting a Photograph</title>
<para>
When you delete a photograph from &digikam; it will be moved to the &kde; Trash Can.
<menuchoice>
<shortcut><keycombo action="simul"><keycap>F8</keycap></keycombo> </shortcut>
<guimenu>Image</guimenu><guimenuitem>Delete</guimenuitem>
</menuchoice> or
<menuchoice>
<shortcut><keycap>Delete</keycap> </shortcut><guimenu></guimenu>
</menuchoice>
If you prefer that Delete really removes the photograph completely, than you can do that by
<menuchoice>
<shortcut><keycap>&Shift;</keycap><keycap>Delete</keycap> </shortcut>
<guimenu></guimenu>
</menuchoice>
</para>
</sect3>
</sect2>
<sect2 id="using-kapp-mydatesview">
<title>"My Dates" View from Main Window</title>
<para><inlinemediaobject><imageobject><imagedata fileref="maininterfacedateview.png" format="PNG" /> </imageobject>
<textobject><phrase>Dates View from Main Window</phrase></textobject></inlinemediaobject>
</para>
<para>
The "My Dates" view organizes your photographs based on their dates. &digikam; uses either the
EXIF date or, if no EXIF date is available, the last modification time of the file.
</para>
<para>
When you select a month from the list, all photographs from that month are displayed in the Image View.
You can select days or weeks in the date sheet at the bottom of the Date View to show only the photographs
from the selected dates.
</para>
</sect2>
<sect2 id="using-kapp-mytagsview">
<title>"My Tags" View</title>
<para>
(Hierarchical) photograph tagging provides a flexible and powerful way to organize and catalog your photographs. Tags are labels that can be applied to individual photographs or whole groups. Once a Tag has been set to a photograph, that photograph can be found again by selecting the Tag or doing a search.
</para>
<example> <title>Selecting a Tag and applying a new one</title>
<screenshot><mediaobject><imageobject><imagedata fileref="maininterfacetagsview.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
When a Tag is selected, all of the photographs that are marked with that Tag are displayed.
</para>
<para>
Tags can be arranged in a hierarchical tree. This allows you to organize your Tags in a logical manner. It also allows you to collapse parts of the tree in the "My Tags" list so that you can easily find the Tags that you are looking for.
</para>
<tip>
<para>Tags are stored in a database for fast access, and, the applied tags are written into IPTC data fields of the image (at least for JPEG). So can use your tags with other programs or, on case of loss of that data in the database, the tags will be re-imported when the image is noticed by &digikam;.</para></tip>
<sect3 id="using-kapp-managetags">
<title>Managing Tags</title>
<para>
You can add new Tags by right-clicking on either the "My Tags" label or an existing Tag and selecting <guilabel>New Tag</guilabel>. If you add a new Tag by right-clicking on an existing Tag, your new Tag will be created as a sub-Tag.
</para>
<para>
You can delete a Tag by right-clicking on the Tag you want to delete and selecting <guilabel>Delete</guilabel> Tag. When you delete a tag the photographs themselves are not deleted. Simply the tag is removed from those photographs.
</para>
<para>
You can move the position of a Tag within the tree by dragging it into the position that you want and dropping it there. A menu will appear that gives you the option to
<guilabel>Move</guilabel> the Tag. This works from the left and right sidebar. A Tag can only be in one place in the tree at a time.
</para>
<para>
You can set the Tag Properties by right-clicking on a Tab and selecting <guilabel>Edit Tag Properties</guilabel>. The Tag Properties allow you to change the name of the Tag and the icon used in the "My Tag" tree.
</para>
<para>
To select a different photograph as the Tag icon, right-click on the photograph that you want to use as the Tag icon and select "Set as Tag Thumbnail" from the context menu. Additionally you can use drag and drop to set the Tag icon. Drag the photographs icon and drop it on the currently selected Tag in the Tag list.
</para>
</sect3>
<sect3 id="using-kapp-taggingimages">
<title>Tagging Photographs</title>
<para>
Before you can get the most out of &digikam;'s Tagging capabilities you must first tag your photographs. There are two methods of tagging photographs. Once you have identified the photographs that you want to tag you can either drag and drop them onto the Tag in the "My Tags" tree or, by right-clicking on the selected photographs in the Image Window, you can use the <guilabel>Assign Tag</guilabel> menu to select the Tags you wish to set.
</para>
<para>
You can label a photograph with as many Tags as you like. The photograph will appear when you select any of the Tags that are set against it. This way you can set a Tag for each person in a photograph, as well as the place the photograph was taken, the event it was taken at, &etc;.
</para>
<example> <title>Tagging Image with context menu, or with drag&drop from either sidebar</title>
<screenshot><mediaobject><imageobject><imagedata fileref="maininterfaceassigntags.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
Once you have tagged a photograph, the Tag name will appear under the thumbnail in the Image Window.
</para>
<para>
You can remove a Tag from a photograph by right-clicking on the photograph and using the <guilabel>Remove</guilabel> Tag menu. This menu will only show those Tags that have been set on this photograph.
</para>
</sect3>
</sect2>
<sect2 id="using-kapp-mysearchesview">
<title>"My Searches" View</title>
<sect3>
<title>The Quick Search Tool</title>
<anchor id="quicksearchtool.anchor"/>
<para>
Quick Search provides you with a simple search form to search all data fields in the album library with a single query. You can enter any arguments in the <guilabel>Search</guilabel> text field and it will be used to determine the results. For instance, you can enter the string 'birthday' to search the complete album library for occurrences of the word 'birthday' in photograph description, or '05.png' to search for a specific image file name '05.png' (no escaping as in regexpressions needed).
</para>
<para>Search Properties:<itemizedlist>
<listitem><para>searches are case insensitive</para></listitem>
<listitem><para>blank separated search terms are boolean AND combinations</para></listitem>
<listitem><para>special characters are literal and not interpreted ( . * ? / &etc;)</para></listitem>
<listitem><para>include all elements of the database: names, rating, keywords, tags, albums, collections, dates (and more in the future)</para></listitem>
</itemizedlist>
</para>
<para>
The Quick Search really works intuitively. If you want to search photographs from a certain date, you can simply type <userinput>2005</userinput>, but it is even possible to search for a certain month. Just enter the name of the month in your local language. If it is Dutch, you can enter <userinput>Maart</userinput>, to see the pictures of March. The combination of 'Maart 2006' means 'Maart AND 2006' and therefore is equivalent to '2006 Maart'. Or look for 'Maart 2007 cr2' to find all RAW files of March 2007.
</para>
<example>
<title>Quick Search Tool Dialog in Action</title>
<screenshot><mediaobject><imageobject><imagedata fileref="maininterfacequicksearch.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
When you are satisfied with your selection, click on the <guilabel>Ok</guilabel> button, and the search will be carried out, and the results displayed in "My Search" view from the main window. The <guilabel>Save search as</guilabel> text field will be used to label your query in "My Search" list. If you want to modify your selection after performing a search, simply right click on the item from "My Search" view and select an option from pop-up menu.
</para>
<para>
If you select <guilabel>Edit Search</guilabel>, the search form will re-appear, containing your previous search information. If you select <guilabel>Edit as Advanced Search</guilabel>, the advanced search tool dialog will be come up to modify your previous search information using more elaborate search rules. See the <link linkend="using-kapp-mainwindow-advancedsearchtool">The Advanced Search Tool</link> section for more information.
</para>
<para>
If you want to remove an existing search from the list, just select <guilabel>Delete Search</guilabel> from pop-up menu.
</para>
<example>
<title>Search View from Main Window</title>
<screenshot><mediaobject><imageobject><imagedata fileref="maininterfacesearchview.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</sect3>
<sect3 id="using-kapp-mainwindow-advancedsearchtool">
<title>The Advanced Search Tool</title>
<anchor id="advancedsearchtool.anchor"/>
<para>
Advanced Search tool provides an extended search form which can be used to search in specific fields of the &digikam; albums database.
</para>
<para>
The <guilabel>Search Rules</guilabel> list is used to set all options to process a search query in albums database. all rules are listed vertically and separated by an operator. An option can be added or deleted to the list using <guilabel>Add/Delete Option</guilabel> or grouped/ungrouped together using <guilabel>Group/Ungroup Options</guilabel>. Each option can be combined with another one using <guilabel>As well as</guilabel> or <guilabel>Or</guilabel> logical operator.
</para>
<tip>
<para>
If you made added a rule with <guilabel>As well as</guilabel> and you realize that it should have been <guilabel>Or</guilabel>, you can easily switch to that by double clicking on the text <guilabel>As well as</guilabel> in the rules area.
</para>
</tip>
<para>
An option is composed by four fields:
<example>
<title>A Query Option Detail</title>
<screenshot><mediaobject><imageobject><imagedata fileref="maininterfaceadvancedsearchoption.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<itemizedlist>
<listitem><para>(1): the item used to search in database, which can be an album, a name, a tag, an image, a keyword, &etc;.
</para></listitem>
<listitem><para>(2): the logical operator to process the item which depends on the item type.
</para></listitem>
<listitem><para>(3): the operator argument which can be a string or a name already set by database.
</para></listitem>
<listitem><para>(4): a checked box to manage the option using Add/Delete and Group/Ungroup controls.
</para></listitem>
</itemizedlist>
</para>
<para>
For instance, you can set an advanced query to search all items in database using these options:
<itemizedlist>
<listitem><para>All album names contains the string 'adrien' and all image captions contains the string 'an'.
</para></listitem>
<listitem><para>Or all item which have the tag 'Peoples'.
</para></listitem>
<listitem><para>Or all keywords contains the string 'gilles'.
</para></listitem>
</itemizedlist>
<example>
<title>Advanced Search Tool Dialog in Action</title>
<screenshot><mediaobject><imageobject><imagedata fileref="maininterfaceadvancedsearch.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</para>
<para>
If you want to group options together, just check the option box at the end of the rule and press <guilabel>Group</guilabel> button. Options will be appear in the list like this:
<example>
<title>A Query Grouped Options Example</title>
<screenshot><mediaobject><imageobject><imagedata fileref="maininterfaceadvancedsearchoptiongroup.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</para>
<para>
When you are satisfied with your search settings, click on the <guilabel>Ok</guilabel> button, and the advanced search will be carried out, and the results displayed in "My Search" view from the main window. The <guilabel>Save search as</guilabel> text field will be used to name your advanced query in "My Search" list. If you want to modify your selection after performing an advanced search, simply right click on one item from "My Search" view and select <guilabel>Edit Search</guilabel> from pop-up menu.
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="using-kapp-sidebar">
<title>&digikam; sidebar</title>
<anchor id="sidebar.anchor"/>
<sect2>
<title>Introduction to the right sidebar</title>
<para>
The &digikam; main window has a sidebar at the right border providing important information and actions of the selected images. This same sidebar is also available in the <link linkend="using-kapp-imageeditor">Image Editor</link> view. It can be displayed by respectively clicking on one of the five tabs:
</para>
<para>
<itemizedlist>
<listitem><para><link linkend="using-kapp-sidebarfileproperties">Properties</link> : File and image properties, key shooting parameters (EXIF tags)</para></listitem>
<listitem><para><link linkend="using-kapp-sidebarmetadata">Metadata</link> : EXIF, Makernotes, IPTC and GPS data (these properties can be edited by two kipi-plugins</para></listitem>
<listitem><para><link linkend="using-kapp-sidebarcolors">Colors</link> : Histograms and embedded ICC profiles</para></listitem>
<listitem><para><link linkend="using-kapp-sidebarcommentstags">Comments & Tags</link> : Comments, Date & Time setting, Rating, Tags</para></listitem>
<listitem><para><link linkend="using-kapp-sidebartagfilters">Tag Filters</link> : Tag filters applied to main window selection</para></listitem>
</itemizedlist>
Clicking successively onto the same tab will make the sidebar pop up or fold back into the border.
</para>
</sect2>
<sect2 id="using-kapp-sidebarfileproperties">
<title>Properties</title>
<para>
The properties sidebar shows the essential information about the selected image which are largely self-explanatory. It is grouped into the following sections:
<itemizedlist>
<listitem><para>File Properties: these are file system related information</para></listitem>
<listitem><para>Image Properties: shows the image and format properties like dimension, compression, color-depth, &etc;</para></listitem>
<listitem><para>Photograph Properties: shows a summary of the most important parameters when taking the photograph. This data is taken from the EXIF data fields if available</para></listitem>
</itemizedlist>
<example> <title>Sidebar File Properties</title>
<screenshot><screeninfo>sidebar File Properties Example</screeninfo><mediaobject><imageobject><imagedata fileref="sidebarfileproperties.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</para>
</sect2>
<sect2 id="using-kapp-sidebarmetadata">
<title>The Metadata Tabs</title>
<para>
The metadata sidebar is composed of four sub tabs <guilabel>EXIF, Makernotes, IPTC and GPS data</guilabel>. On the left, two button lets you choose between full and simplified data display. Next to it are a printer and copy icon, They do just that - print (&kprinter; dialog) or copy the respective tab data to the clipboard. In the main window view you will find a navigation button set with the file name on top of the tabs.
</para>
<para><inlinemediaobject><imageobject><imagedata fileref="sidebarmetadata.png" format="PNG" /> </imageobject><textobject><phrase>The Metadata Tabs</phrase></textobject></inlinemediaobject>
</para>
<sect3 id="using-kapp-sidebarmetadataexif">
<title>EXIF Tags</title>
<anchor id="kexif.anchor"/>
<sect4>
<title>What is EXIF?</title>
<para>
EXIF stands for <ulink url="http://www.exif.org">EXtended Interchange Format</ulink>. It was designed specifically for digital cameras. It allows a large amount of information about the photograph to be stored. This information describes the camera which took the image along with the settings (including date and time) in use when the picture was taken. An in-line thumbnail can be included.
</para>
<para>
EXIF format contains a set of 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>Image Information</guilabel>: contains general information about the image.
</para></listitem>
<listitem><para>
<guilabel>Embedded Thumbnail</guilabel>: contains information about the embedded thumbnail image.
</para></listitem>
<listitem><para>
<guilabel>Photograph Information</guilabel>: contains extended information about the photograph.
</para></listitem>
<listitem><para>
<guilabel>Interoperability</guilabel>: contains information to support interoperability between different EXIF implementations.
</para></listitem>
</itemizedlist>
</para>
</sect4>
<sect4>
<title>How to Use EXIF Viewer?</title>
<para>
You can review embedded EXIF information for the selected image from the first sidebar tab. The EXIF Viewer is purely informational: nothing you do with it will cause any change to the EXIF sections. If there are more entries than space available, just scroll down with the mouse wheel.
</para>
<para>
You can use two different levels to display EXIF marker sections:
<itemizedlist>
<listitem><para>
<guilabel>Simple</guilabel>: display only more important EXIF marker for photograph.
</para></listitem>
<listitem><para>
<guilabel>Full</guilabel>: display all EXIF markers.
</para></listitem>
</itemizedlist>
For the displayed data, EXIF Viewer provides a contextual help. Select an item with &RMB; and the corresponding help can be displayed with the "What's This?" option of the dialog.
</para>
<para>
Some vendors add additional EXIF sections, such as Canon, Fujifilm, Nikon, Minolta, and Sigma. These sections contain vendor and model specific notes. These will be displayed in <guilabel>Makernote</guilabel> section.
</para>
</sect4>
</sect3>
<sect3 id="using-kapp-sidebarmetadatamakernote">
<title>Makernote Tags</title>
<sect4>
<title>What is Makernote?</title>
<para>
The EXIF standard defines a Makernote tag, which allows camera manufacturers to place any custom format metadata in the file. This is used increasingly by camera manufacturers to store a myriad of camera settings not listed in the EXIF standard, such as shooting modes, post-processing settings, serial number, focusing modes, &etc; As this tag format is proprietary and manufacturer-specific.
</para>
</sect4>
<sect4>
<title>How to Use Makernote Viewer?</title>
<para>
You can review embedded Makernote information for the selected image from the first sidebar tab. The Makernote Viewer is purely informational: nothing you do with it will cause any change to the Makernote sections.
</para>
<para><inlinemediaobject><imageobject><imagedata fileref="sidebarmetadatamakernote.png" format="PNG" /> </imageobject><textobject><phrase>The Makernote Viewer in Action</phrase></textobject></inlinemediaobject>
</para>
</sect4>
</sect3>
<sect3 id="using-kapp-sidebarmetadataiptc">
<title>IPTC Tags</title>
<sect4>
<title>What is IPTC?</title>
<para>
The <ulink url="http://www.iptc.org">International Press Telecommunications Council</ulink>, is a consortium of the world's major news agencies and news industry vendors. It develops and maintains technical standards for improved news exchange that are used by virtually every major news organization in the world.
</para>
<para>
The IPTC was established in 1965 by a group of news organizations to safeguard the telecommunications interests of the world's press. Since the late 1970s IPTC's activities have primarily focused on developing and publishing industry standards for the interchange of news data.
</para>
<para>
In particular, the IPTC defined a set of metadata attributes that can be applied to images. These were defined originally in 1979, and revised significantly in 1991 to be the "Information Interchange Model" (IIM), but the concept really advanced in 1994 when Adobe defined a specification for actually embedding the metadata into digital image files - known as "IPTC headers".
</para>
</sect4>
<sect4>
<title>How to Use IPTC Viewer?</title>
<para>
You can review embedded IPTC information for the selected image from the first sidebar tab. The IPTC Viewer is purely informational: nothing you do with it will cause any change to the IPTC sections.
</para>
<para><inlinemediaobject><imageobject><imagedata fileref="sidebarmetadataiptc.png" format="PNG" /> </imageobject><textobject><phrase>The IPTC Viewer in Action</phrase></textobject></inlinemediaobject>
</para>
</sect4>
</sect3>
<sect3 id="using-kapp-sidebarmetadatagps">
<title>Metadata GPS tab</title>
<sect4>
<title>What is GPS?</title>
<para>
The <ulink url="http://en.wikipedia.org/wiki/Global_Positioning_System">Global Positioning System</ulink> usually called GPS, is the only fully-functional satellite navigation system. A constellation of more than two dozen GPS satellites broadcasts precise timing signals by radio, allowing any GPS receiver to accurately determine its location (longitude, latitude, and altitude) anywhere on Earth. GPS also provides an extremely precise time reference and gauge speed with a very high degree of accuracy.
</para>
<para>
The GPS information can be stored in pictures directly by camera or to syncing files with an external GPS device. Look this <link linkend="using-kapp-gps">section</link> for more information.
</para>
</sect4>
<sect4>
<title>How to Use GPS Locator?</title>
<para>
This tab provides the GPS section of the metadata. The displayed positioning data are actually stored in the image's EXIF tags (and not yet in the database). That allows the location to be read by any other application that can understand EXIF GPS data.
</para>
<para>
In this tab, a little world map shows where the picture has been taken. If you want a more detailed map, just select on the bottom your favorite web map service and press <guilabel>More Info</guilabel> to launch an external web browser instance.
</para>
<example> <title>sidebar Metadata GPS info</title>
<screenshot><screeninfo>sidebar Metadata info</screeninfo><mediaobject><imageobject><imagedata fileref="sidebarmetadatagps.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</sect4>
</sect3>
</sect2>
<sect2 id="using-kapp-sidebarcolors">
<title>Colors</title>
<para>
The colors sidebar has two sub tabs <guilabel>Color and ICC Profile</guilabel>. Here are more details about <link linkend="using-kapp-iccprofile">Color Management</link>
</para>
<sect3 id="using-kapp-histogramviewer">
<title>Histogram Viewer</title>
<anchor id="histogramviewer.anchor"/>
<para>
The histogram for an image shows the amount of each color that is present and their different amplitudes within the image. If your photograph has a color cast you might be able to see what is wrong by looking at the histogram.
</para>
<para>
The Histogram Viewer shows 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 or Adjust Curves Image Editor plugin. These plugins are part of the <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins project</ulink>. For more information about using Plugins in &digikam; see the <link linkend="using-kapp-setup">Configuration</link> section.
</para>
<example> <title>The Histogram Viewer in Action</title>
<screenshot><screeninfo>The Histogram Viewer in Action</screeninfo><mediaobject><imageobject><imagedata fileref="sidebarcolorshistogramviewer.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<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 superposed, so that you can see all of the color distribution information in a single view. In this mode, the histogram foreground color can be chosen with the <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 Image Editor.
</para>
<para>
With <guilabel>Scale</guilabel> option, you can determine 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 of the <guilabel>Statistics</guilabel> field 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>
The statistics shown at the bottom of the Histogram Viewer describe 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>
In <guilabel>Colors</guilabel> channel mode, the statistics is 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>
<example> <title>An Image Histogram in All Colors Mode</title>
<screenshot><screeninfo>An Image Histogram in All Colors Mode</screeninfo><mediaobject><imageobject><imagedata fileref="editorhistogramdescription.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
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.
<example> <title>An Over Exposed Photograph</title>
<screenshot><screeninfo>An Over Exposed Photograph</screeninfo><mediaobject><imageobject><imagedata fileref="editorhistogramsample3.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
With a correctly exposed photograph, the histogram will have a distribution of brightness that will be most prominent near the center part of the graph.
<example> <title>A Correctly Exposed Photograph</title>
<screenshot><screeninfo>A Correctly Exposed Photograph</screeninfo><mediaobject><imageobject><imagedata fileref="editorhistogramsample2.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
With an over exposed photograph, the histogram will have the bulge showing the brightness distributed mostly towards the right of the graph.
<example> <title>An Under Exposed Photograph</title>
<screenshot><screeninfo>An Under Exposed Photograph</screeninfo><mediaobject><imageobject><imagedata fileref="editorhistogramsample1.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</para>
<para>
Important: not all photographs have to exhibit this bulge in the center 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-sidebarcommentstags">
<title>Comments & Tags</title>
<para>
This sidebar tab serves to apply and edit image attributes like comments, rating, date and tags. The attributes are stored in the associated database, in the IPTC and EXIF data fields and become part of the image. All attributes are accessible in one sidebar view as shown in the screenshot below. During image reading the order of priority is a) database b) IPTC and c) EXIF. So if there is a discrepancy between any of the three, this priority will take effect and a synchronization will take place. This sidebar has a first-previous-next-last arrow navigator field on top if shown in the main application.
</para>
<example> <title>sidebar Comments & Tags example</title>
<screenshot><screeninfo>sidebar Comments & Tags Example</screeninfo><mediaobject><imageobject><imagedata fileref="sidebarcommentstags.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<sect3>
<title>Comment View</title>
<para>
The comment view can be used to type or paste in a comment of unlimited size (see note below). The text is UTF-8 compatible, meaning that all special characters are allowed. The comments are copied to EXIF and IPTC comment fields to be used from other applications.
</para>
<caution><para>
The IPTC data does only support ASCII characters and 2000 characters at most (old American norm). All comments will be truncated after 2000 chars, and special characters will be malformed. If you intend to use the IPTC comment field in other applications you should be compliant with these restrictions.
</para></caution>
</sect3>
<sect3>
<title>Date & Time</title>
<para>
In the Date & Time section, which reflects the time of taking the photograph, you can change all values. From the date combo-box a calender opens, and the time setting spin-box can also be written by directly typing the time. The dating is copied to the EXIF 'Date and Time' field. If you need to change a number of images for their creating time & date, there is a more comfortable method available (requiring the kipi-plugins). This latter option can be found under <menuchoice><guimenuitem>Image</guimenuitem><guimenuitem>Adjust time & date...</guimenuitem></menuchoice>. Select the images to be changed in the main view and call the plugin.
</para>
</sect3>
<sect3>
<title>Rating</title>
<para>
The Rating section displays a 0...5 star rating scheme that can be used in searches and sort orders. It can be applied by a single mouse click to the 5 stars in the sidebar or with a keyboard short-cut Ctrl+0...5. The rating from the sidebar is always applied to one image at a time. To rate a number of images, select them and pop-up the context menu (right-click) to apply a common rating.
</para>
<para>The rating is then transcribed into the IPTC 'urgency' data field. The transcoding follows the scheme in this table:
</para>
<informaltable><tgroup cols="2">
<thead><row>
<entry>&digikam; Rating</entry>
<entry>IPTC Urgency</entry>
</row></thead>
<tbody>
<row> <entry>-</entry> <entry>8</entry> </row>
<row> <entry>*</entry> <entry>7</entry> </row>
<row> <entry>*</entry> <entry>6</entry> </row>
<row> <entry>**</entry> <entry>5</entry> </row>
<row> <entry>***</entry> <entry>4</entry> </row>
<row> <entry>****</entry> <entry>3</entry> </row>
<row> <entry>****</entry> <entry>2</entry> </row>
<row> <entry>*****</entry> <entry>1</entry> </row>
</tbody>
</tgroup></informaltable>
</sect3>
<sect3>
<title>Tag Tree</title>
<para>
The Tag view shows an adaptive filter tag search box, the tag tree and a combo-box containing the tags previously applied in this &digikam; session.
</para>
<para>
The tag tree will be adapted dynamically as a function of the search word as you type into the box. So it is easy to quickly reduce the number of possibilities when searching for a tag. Of course, this feature is only useful if you have many tags.
</para>
<para>
The combo-box at the bottom is another ergonomic feature for easy tagging of an image series. As you apply different tags they will be memorized in this box for quick access.
</para>
<para>
Otherwise tags are simply applied by checking the respective boxes in the tree. All tags of an image are transcribed into the IPTC 'keyword' data field.
</para>
<note><para>
In case you have selected a number of images in the main view and you check a tag in the tag tree, this one is only applied to the highlighted image, and not to the whole selection. If you want to tag selections, refer to the <link linkend="using-kapp-sidebartagfilters">Tag filters</link> section.
</para></note>
</sect3>
</sect2>
<sect2 id="using-kapp-sidebartagfilters">
<title>Tag Filters</title>
<para>
The tag filter sidebar is used to modify the set of images displayed in the main window view. Normally one uses the left sidebar with its Album, Date, Tag and Searches view. When additionally one or more tags on right sidebar tag filter is checked, only the cross-section of these two selections will be displayed. All created tags are available.
</para>
<para>
To give an example, suppose you have a tag called 'public' which tags all images except your private ones. Then you can check this 'public' tag in the right sidebar to hide the private pictures (all those not having 'public' tag). Whatever view mode you chose from the left sidebar, 'public' only picture will be displayed. Another typical example is the selection of a subset of tags in a hierarchical tree. Suppose you want to display 'red' and 'green' from a tag tree containing 7 different colors as sub-tags. Simply click on the 'color' tag of the main view and check 'red' and 'green' from the right sidebar.
</para>
<para>Another use is <emphasis>drag-and-drop tagging</emphasis>. Lets say you selected in the main view a number of pictures to tag them. If the tag already exists, simply drag it from the right sidebar onto the selection (any one of the highlighted pictures). A dialog will pop-up and ask if this tag should be applied.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="sidebartagfilters.png" format="PNG" /> </imageobject><textobject><phrase>Sidebar Tag Filters</phrase></textobject></inlinemediaobject>
</para>
<para>
In the above example the main window shows the pictures from a calender date, the tag filter is set to 'not tagged', which reduces the set to 3 images. They have been selected with Ctrl+a, then a tag is dragged from the right tag tree over the selection and dropped. A pop-up dialog asks if the tag shall be applied.
</para>
</sect2>
</sect1>
<sect1 id="using-kapp-camera">
<title>Using a Digital Camera With &digikam;</title>
<anchor id="camerainterface.anchor"/>
<sect2>
<title>Introduction to Camera Interface</title>
<para>
The Camera Tool allows you to download your photographs directly from your camera into a &digikam; Album. You can access the Camera Tool by clicking on the Camera menu and selecting from the list of configured Cameras. See the <link linkend="cameraselection.anchor">Setup Camera Section</link> of the manual for instructions on how to setup &digikam; to work with your Camera. If you want to have more information about how &digikam; supports digital camera, please a take a look at <link linkend="using-kapp-camerasupport">this section</link>.
</para>
<para>
The Camera Interface is not the only way to get your photographs into &digikam;. See the <link linkend="using-kapp-addphototoalbum">Adding a photograph to an Album</link> section for a description of how to add photographs that are already on your hard disk. But Camera Interface provides a lots of advanced settings to import pictures into your albums database.
</para>
<para>
To be able to use your digital camera with &digikam;, connect the camera to your computer, switch the camera to the image display mode and turn it on. You can find more descriptions in the manual that comes with your camera.
</para>
<para>
When you start the Camera Interface, it will try to connect to the Camera. For some cameras this connection phase can take a little while. When connected, a <guilabel>Ready</guilabel> indicator will appear on the bottom and thumbnails of any photographs on the camera will be displayed. Some cameras cannot provide thumbnails of the photographs, if this is the case you will only see the filenames and an mime-type icon for each items stored by your camera (photograph, movies, sounds, etc).
</para>
<example> <title>The Camera Client Window</title>
<screenshot><screeninfo>The Camera Client Window</screeninfo> <mediaobject><imageobject><imagedata fileref="cameraclient.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</sect2>
<sect2>
<title>Getting information About Photographs from the Cameras</title>
<para>
Before to download photographs on your computer, you can need to see camera item information. Using the
<menuchoice><guimenuitem>Properties</guimenuitem></menuchoice> and <menuchoice><guimenuitem>Metadata</guimenuitem></menuchoice> side bar tabs from Camera Interface will launch camera item properties and metadata information.
</para>
<example> <title>The Camera Item Properties Side Bar Tab</title>
<screenshot><screeninfo>The Camera Item Properties Side Bar Tab</screeninfo><mediaobject><imageobject><imagedata fileref="cameraclientitemproperties.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
The Properties tab displays file information recorded by the camera and a resume of photographer information to describe how the picture has been taken. A flag indicates if the picture has not yet been downloaded to the computer. Note, all this information may be unavailable with some digital cameras.
</para>
<para>
The Metadata tab displays internal pictures metadata like EXIF, Makernotes, GPS, &etc;. This information are the same than <link linkend="using-kapp-sidebarmetadata">sidebar Meta-Data</link> from &digikam; main interface or image editor. Note, all these metadata can be unavailable with some digital cameras.
</para>
</sect2>
<sect2>
<title>Downloading Photographs to your computer</title>
<para>
The simplest way to download photographs from your camera to your computer is to click the <guilabel>Download</guilabel> button and then click <guilabel>Download All</guilabel>. This will download all of the photographs on the camera to a single Album in &digikam;. The download process will not remove the photographs from the camera. It is always advisable to check that the photographs have downloaded safely into the Album you were expecting before deleting them from the camera.
</para>
<para>
If you do not want to download all of the photographs you can select just those that you need using the standard &kde; selection methods. Once you have the photographs selected click <guilabel>Download</guilabel> and then <guilabel>Download Selected</guilabel>. The <guilabel>Download Selected</guilabel> button will be grayed out until you have selected some photographs.
</para>
<note><para>
If supported by your camera an option <guilabel>Download new</guilabel> is available. Those are pictures not yet downloaded by &digikam;. In that case the new pictures are already marked with a star in the thumbnail window. Obviously if you choose this handy option, it will download the new pictures only.
</para></note>
</sect2>
<sect2>
<title>Selecting a Target Album</title>
<anchor id="targetalbumdialog.anchor"/>
<para>
Using <guilabel>Download All</guilabel> or <guilabel>Download Selected</guilabel> buttons will bring up a dialog, that allows you to select a target Album into which the photographs will be downloaded. The list of existing Albums is displayed, ordered by the Folder method (see the <link linkend="using-kapp-myalbumsview">My Albums View</link> for details of Album ordering). You can select the target Album from this list and then click OK.
</para>
<example> <title>The Target Album Selection Dialog</title>
<screenshot><screeninfo>The Target Album Selection Dialog</screeninfo><mediaobject><imageobject><imagedata fileref="cameratargetalbumdialog.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
If you want to create a new Album, into which you could download the photographs, click the <guilabel>New Album</guilabel> button. The new Album will be created as a sub-Folder of the Album that is currently selected in the existing Album list. This means that, if you do not want your new Album to be a sub-Folder of an existing Folder, you must first select the "My Albums" entry from the very top of the existing Albums list before creating a new Album.
</para>
<para>
When you have selected the target Album, click OK and &digikam; will download the photographs from the camera to that album.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="cameraclientdownload.png" format="PNG" /> </imageobject><textobject><phrase>The Downloading in Progress</phrase></textobject></inlinemediaobject>
</para>
</sect2>
<sect2>
<title>Deleting Photographs from the Cameras</title>
<para>
Once you are happy with the downloaded photographs that you wanted, you are ready to delete photographs from the Camera. You can delete all of the photographs in one go by clicking the
<menuchoice>
<guimenu>Delete</guimenu>
<guimenuitem>Delete All</guimenuitem>
</menuchoice>
button. If you just want to delete a selection of the photographs, you have to select those that you want to delete and click
<menuchoice><guimenu>Delete</guimenu>
<guimenuitem>Delete Selected</guimenuitem></menuchoice>
</para>
<caution><para>
Please note that there is no way to restore a photo that you have deleted from the camera. The photographs are not moved to the &kde; Trash Can, they are removed completely. It is best to double check that you have successfully downloaded a photograph into a &digikam; Album before you delete it from the camera. Anyway, if you plan to empty the camera card, you better do that from the camera menu because it is much quicker.
</para></caution>
</sect2>
<sect2 id="using-kapp-cameraclientrenaming">
<title>Automatic Renaming</title>
<para>
Cameras often do not use very meaningful filenames for photographs. The filenames are usually reused once the photographs have been deleted from the camera. This can lead to filename clashes if you download photographs from many shootings into the same Album. It can also be useful to include the date and time that a picture was taken into the filename.
</para>
<example> <title>Files Renaming Options</title>
<screenshot><screeninfo>Files Renaming Options</screeninfo><mediaobject><imageobject><imagedata fileref="cameraclientsetting1.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
&digikam; can automatically rename your photographs using the date and time information included by the camera in the photograph. To use this feature, click the <guilabel>Settings</guilabel> button on the Camera Interface. The Camera Interface window will expand to reveal some extra features. Select <guilabel>Customize</guilabel> and then enter any filename prefix you would like. As an option you can then add the date & time, a sequence number or a combination of both. The sequence number may be needed if you have a camera with a very fast multi-shoot mode where it is possible to get two photographs with exactly the same data and time.
</para>
<para>
In the next box you find the options for rotating/flipping the image and for date-based sub-albums. If you check the latter option, folder per day will be automatically generated.
</para>
<para>
The 'On the fly operations' open three more options that act on the photos before storing them on disk. The first two relate to the authors data in <link linkend="authoridentity">Default Author Identity</link>" Settings. If checked the respective items will be copied into the EXIF tags and IPTC fields. The last option allows to fix a date & time for all downloaded pictures.
</para>
<tip>
<para>
<itemizedlist>
<listitem><para>If you want another date format then the default date format, you could fill in for example: <userinput>photo-%Y-%m-%d %H:%M:%S</userinput> in the prefix edit line (turn off <guilabel>Add camera provided date and time</guilabel>). For additional customization read the man page of strftime.</para></listitem>
<listitem><para>When you select <guilabel>Use camera provided names</guilabel>, you have the option to change the filenames to lowercase when downloading. Or use uppercase if you prefer.</para></listitem>
</itemizedlist>
</para>
</tip>
<para>
The new filename that &digikam; will use for the photographs when they are downloaded is shown underneath the name provided by the camera in the thumbnail view. The renaming settings will be remembered next time you use the camera Interface.
</para>
</sect2>
<sect2>
<title>Camera Information Based Operations</title>
<sect3>
<title>Automatic Rotation</title>
<para>
&digikam; can use any information about the orientation of the camera in the moment the photograph was taken for automatic rotation of the photograph when it is downloaded. Not all cameras include this information. See the <link linkend="using-kapp-sidebarmetadata">sidebar Meta-Data</link> section for more detail about information that your camera may have embedded in your photographs.
</para>
<example> <title>On the fly Operations Options</title>
<screenshot><screeninfo>On the fly Operations Options</screeninfo><mediaobject><imageobject><imagedata fileref="cameraclientsetting3.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
This automatic rotation is switched on by default, and if your camera does not include the information, &digikam; will leave the photograph at its original orientation. If you would like to switch the automatic rotation off, click the <guilabel>Advanced</guilabel> button and deselect the <guilabel>Auto Orient</guilabel> option at the bottom of the window.
</para>
</sect3>
<sect3>
<title>Automatic Destination Albums Creation</title>
<para>
If your camera provides information about the date of the photograph's taking, &digikam; can use this to automatically create sub-albums in the destination Album when it is downloaded.
Sub-albums names will be based on image dates. All images which have the same date will be downloaded into the same sub-album. Not all cameras include this information.
See the <link linkend="using-kapp-sidebarmetadata">
sidebar Meta-Data</link> section for more detail about
information your camera may have embedded in your photographs.
</para>
<example> <title>Albums Auto-creation Options</title>
<screenshot><screeninfo>Albums Auto-creation Options</screeninfo><mediaobject><imageobject><imagedata fileref="cameraclientsetting2.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
This option is switched off by default and in this case &digikam; will download the photographs
in the root destination Albums. If you would like to switch on this option click the
<guilabel>Advanced</guilabel> button and select the <guilabel>Download photo in automatically</guilabel>
option at the bottom of the window.
</para>
</sect3>
</sect2>
<sect2>
<title>Uploading Photographs to your camera</title>
<para>
The simplest way to upload photographs from your computer to your camera is to click the <guilabel>Download</guilabel> button and then click <guilabel>Upload</guilabel>. A standard &kde; file selection dialog will appear to select the files from your computer to copying on your camera. You can select more than one file using the standard &kde; selection methods.
</para>
<para>
When pictures selection is done, &digikam; will ask you where you want upload the files in your camera. A camera folder selection dialog will appear. Just select one folder and press OK to start uploading. All images from your computer will not removed.
</para>
<example> <title>The Camera Folder Selection Dialog</title>
<screenshot><screeninfo>The Camera Folder Selection Dialog</screeninfo><mediaobject><imageobject><imagedata fileref="camerafolderselectiondialog.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<note><para>
Uploading feature is not supported by all camera drivers.
</para></note>
</sect2>
<sect2 id="using-kapp-gps">
<title>How to use a GPS device with &digikam;</title>
<note><para>
<inlinemediaobject>
<imageobject><imagedata fileref="handheld_gps.png" format="PNG"/></imageobject>
</inlinemediaobject>GPS (global positioning system) is used as a generic term throughout this document, it just means a location in latitude and longitude global coordinates that can be displayed on a map. The actual technical implementation that provides the data can be the American GPS, the Russian GLONAS, the European GALILEO or any other system.
</para></note>
<para>
Not only for professional photographers can it be interesting to link an image to a precise geographical location. Not everybody uses an airplane to overfly and scan a certain area with automatic GPS data recording. Environmental planners, military, police, construction bureaus, real estate agencies, all will have an immediate application.
</para>
<para>
But if, after some time, one has forgotten where the picture was taken, if one loves the nice feature to open with a simple click a browser displaying a zoom of the area, if you like to send your picture as a postcard to another &digikam; user (who is then able to locate your shot), or if you simply need the documentation aspect of it - having position data stored in a photo is great.
</para>
<para>
Now, how do we get GPS data into the images? First it is to say that <ulink url="http://www.exiv2.org/tags.html">exif2</ulink> supports many kinds of the GPS data fields, even bearing, satellite and map references. So the question is really how to get the data into those fields? There are at least three ways to do this: directly with the appropriate hardware, per post-treatment of GPS and image files using the <ulink url="http://www.kipi-plugins.org">Geolocalization</ulink> (<ulink url="help:/kipi-plugins/geolocalization.html">Manual</ulink>) kipi-plugin and per 'manual' insertion of known locations.
</para>
<itemizedlist>
<listitem><para>Direct GPS data insertion into the image files</para>
<para>
To our knowledge there is at the time of writing no camera that integrates a GPS unit. But there are a few that combine with GPS receivers, either as a plug-in card or by data transmission through cable or bluetooth.
</para>
<para><ulink url="http://www.engadget.com.nyud.net:8090/2004/09/17/diy-black-box-tagging-photos-with-gps-coordinates/">Selfmade Howto</ulink>
</para>
<para>Cameras with GPS interface:
<ulink url="http://www.lupinelogic.com/products/coyoteye.html">CoyoteEye iPAQ</ulink>
<ulink url="http://www.survey-lab.com/">Ike</ulink>
<ulink url="http://www.kodak.com/global/en/service/professional/tib/tib7061.jhtml?id=0.1.14.34.3.110&lc=en">Kodak DCS Pro</ulink>
<ulink url="http://nikonimaging.com/global/products/digitalcamera/index.htm">Nikon DSLR</ulink>
<ulink url="http://www.geospatialexperts.com/ricoh.html">Ricoh Pro G3</ulink> <ulink url="http://digitalcameras.engadget.com/2004/04/30/gps-attachment-for-sony-digital-camcorders/">Sony</ulink>
</para>
</listitem>
<listitem><para>Post-treatment of GPS data and image files</para>
<para>
Using the <ulink url="http://www.kipi-plugins.org">Geolocalization</ulink> kipi-plugin (<ulink url="help:/kipi-plugins/geolocalization.html">Manual</ulink> if kipi-plugins are already installed).
</para>
<para>
The approach is dead easy: whilst taking your pictures just keep a GPS device running and carry it around with the camera. Once you are done, download the pictures and the GPS tracks, and run the above plugin. It will correlate the data in the time domain; so it is important that the camera be accurate in its clock setting (the GPS device is always accurate through the satellites). The positional accuracy interpolated from the track points can be as good as 20 meters. Of course, this approach only works if your camera can record EXIF data.
</para>
<para>The GPS track download from a device can be managed with the <ulink url="http://www.ncc.up.pt/gpsman">gpsman</ulink> or <ulink url="http://www.gpsbabel.org">gpsbabel</ulink>. It is important that the downloaded track are being stored in gpx format, which is the only one compatible with the Geolocalization plugin.
</para>
<para>
Several programs exist for &Windows; and MacOS that are able to extract and correlate data from pictures and GPS data tracks. The following site provides the same functionality for &Linux;:
<ulink url="http://freefoote.dview.net/linux_gpscorr.html">gpsCorr</ulink> or
<ulink url="http://www.carto.net/projects/photoTools/gpsPhoto/">gpsPhoto</ulink>
</para>
</listitem>
<listitem>
<para>'Manual' insertion of known locations</para>
<para>If you happen to know the latitude/longitude or other data you can use the this script which is a GPS wrapper for Phil Harvey's <ulink url="http://www.sno.phy.queensu.ca/~phil/exiftool">ExifTool</ulink> that uses the signed floating number coordinate notation as produced by maps.google.
</para>
<tip><para>
maps.google.com does not show the street maps of Europe. But here are European sites (.fr .de .es .it .co.uk at least) that show all navigation details in all of Europe.
</para></tip>
</listitem>
</itemizedlist>
<para>
GPS devices:
<ulink url="http://www.letsgodigital.org/en/9323/sony_gps_photography/">GPS tracker from Sony </ulink> and
<ulink url="http://www.emtac.com/products/bluetooth/index.html#btgps">EMTAC bluetooth GPS </ulink>
</para>
</sect2>
</sect1>
<sect1 id="using-kapp-imageeditor">
<title>&digikam; Image Editor</title>
<anchor id="imageeditor.anchor"/>
<sect2>
<title>Introduction to Image Editor</title>
<para>
&digikam; incorporates a fast Image Editor with a few basic yet powerful image editing tools. You can use the Image Editor to view your photographs and to make corrections and alterations. The Image Editor can be accessed either by clicking on a thumbnail in the Image Window or by right-clicking on a thumbnail and selecting <guilabel>View/Edit</guilabel> from the context menu.
</para>
<para>
The Image Editor provides a number of tools that enable you to adjust a photograph. Some of these tools are provided by plugins to &digikam;. So they may not be available by default on your distribution. See the <link linkend="setup-editor">Setup Image Editor Section</link> for more details about &digikam; Image Editor plugins.
</para>
<example> <title>The Image Editor Window</title>
<screenshot><screeninfo>The Image Editor Window</screeninfo><mediaobject><imageobject><imagedata fileref="editorpreview.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
The image editor 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>
</itemizedlist>
</para>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="editortoolbar.png" format="PNG"/></imageobject>
<textobject> <phrase>The Image Editor Toolbar</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
<itemizedlist>
<listitem><para>(1) : First Current Album Image.</para></listitem>
<listitem><para>(2) : Previous Image.</para></listitem>
<listitem><para>(3) : Next Image.</para></listitem>
<listitem><para>(4) : Last Current Album Image.</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>
</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 lose 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>
You have to press the &LMB; over the undo or redo icon in the tool bar and hold it down for a moment to produce a context menu. If you choose one of the menu items, all undo/redo actions until the chosen ones are undone/undone.
</para>
</sect2>
<sect2>
<title>Moving Between Photographs</title>
<para>
Once you have started the Image Editor you can move between photographs in the same Album or Tag view by using the navigator buttons on the tool bar or the entries in the <guilabel>File</guilabel> menu. If 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.
</para>
<para>
To make a photograph fit the window use this button on the tool bar:<guilabel>Zoom Autofit</guilabel>
<inlinemediaobject>
<imageobject><imagedata fileref="editorautosizebutton.png" format="PNG"/></imageobject>
<textobject> <phrase>The Image Editor AutoFit Button</phrase> </textobject>
</inlinemediaobject>
</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 &digikam; dialog accessed from the main &digikam; window, see the <link linkend="setup-editor">Setup Image Editor Section</link>.
</para>
</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 not only a common operation, but an often underestimated photographer's tool to compose an image. The Image Editor makes it very easy. To crop a photograph simply drag a rectangle over the image by holding down the &LMB; and moving the mouse. You will see a wire frame rectangle appear as you move the mouse.
</para>
<example> <title>The Current Image Selection in Image Editor</title>
<screenshot><screeninfo>The Current Image Selection in Image Editor</screeninfo>
<mediaobject><imageobject> <imagedata fileref="editorimageselection.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
When you release the button the area of the photograph that will be removed by a crop operation is greyed out. 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 (&Ctrl;+X). 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>
<example> <title>The Aspect Ratio Crop Tool Dialog</title>
<screenshot><screeninfo>The Aspect Ratio Crop Tool Dialog</screeninfo>
<mediaobject><imageobject> <imagedata fileref="editorratiocroptool.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
In the preview area you can resize 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 correspondence 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>
10x15cm 20x30cm 30x45cm
3.5x5" 4x6" 8x12" 12x18" 16x24" 20x30"
</entry>
<entry>
2:3
</entry>
</row>
<row>
<entry>
6x8cm 15x20cm 18x24cm 30x40cm
3.75x5" 4.5x6" 6x8" 7.5x10" 9x12"
</entry>
<entry>
3:4
</entry>
</row>
<row>
<entry>
20x25cm 40x50cm
8x10" 16x20"
</entry>
<entry>
4:5
</entry>
</row>
<row>
<entry>
15x21cm 30x42cm
5x7"
</entry>
<entry>
5:7
</entry>
</row>
<row>
<entry>
21x30cm 42x60cm
</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>
The Aspect Ratio Crop tool remembers the settings depending on image orientation (horizontal or vertical). When you use the crop tool next time these settings will be used as default values depending on the image orientation. The changed image dimensions are stored into the EXIF tables so that the EXIF data reflects the cropped image and not the original one.
</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 center 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>
<example> <title>Image Composition Example Using Rules of Third</title>
<screenshot><screeninfo>Image Composition Example Using Rules of Third
</screeninfo><mediaobject><imageobject> <imagedata fileref="editorrulethirdlinesexample.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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>
<example> <title>Photograph Composition Example Using Harmonious Triangles</title>
<screenshot><screeninfo>Photograph Composition Example Using Harmonious Triangles" </screeninfo><mediaobject><imageobject><imagedata fileref="editorharmonioustrianglesexample.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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 is 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 provides 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>
<example> <title>Image Composition example using Golden Spiral</title>
<screenshot><screeninfo>Image Composition Example Using Golden Spiral </screeninfo><mediaobject><imageobject> <imagedata fileref="editorgoldenspiralexample.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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>
<example> <title>Image Composition example using Golden Spiral Sections</title>
<screenshot><screeninfo>Image Composition Example Using Golden Spiral Sections </screeninfo><mediaobject><imageobject><imagedata fileref="editorgoldenspiralsectionsexample.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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>
<example> <title>Photograph Composition Example Using Golden Triangle</title>
<screenshot><screeninfo>Photograph Composition Example Using Golden Triangles </screeninfo><mediaobject><imageobject><imagedata fileref="editorgoldentrianglesexample.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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>
<example> <title>Image Composition example using Golden Sections</title>
<screenshot><screeninfo>Photograph Composition Example Using Golden Sections </screeninfo><mediaobject><imageobject><imagedata fileref="editorgoldensectionsexample.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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>
<example> <title>The Resize Tool Dialog</title>
<screenshot><screeninfo>The Resize Tool Dialog</screeninfo><mediaobject><imageobject><imagedata fileref="editorresizetool.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
This image resizing tool uses a standard linear interpolation method to approximate pixels. If you want to up size a small image with a better quality, try the 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 shows a wrong orientation 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 or turn over the image horizontally or vertically like a card deck. With the rotating options, you can rotate the image in 90 degrees steps clockwise. It can be used to change the display mode to Portrait or Landscape. Be aware that this rotation is not lossless when using JPEG format. You also can rotate more accurately to a finer degree 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 eyes are caused when the camera flashlight 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. By the way, with a separate flash light the red eye effect is less likely because of the different viewing angle of flash and lens. 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>
<example> <title>The Red Eyes Correction Tool in Action</title>
<screenshot><screeninfo>The Red Eyes Correction Tool in Action" </screeninfo><mediaobject><imageobject><imagedata fileref="editorredeyescorrection.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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>
<example> <title>The Apply Texture Tool in Action</title>
<screenshot><screeninfo>The Apply Texture Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="editorcommondialogtools.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<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. Many good SLR cameras apply less image processing to the pictures than simpler cameras (which tend to artificially increase the contrast to make the pictures look crisp). This kind of slight blur can be easily improved with &digikam; tools.
</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>
<example> <title>The Sharpen Tool in Action</title>
<screenshot><screeninfo>The Sharpen Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="editorsharpenplugin.png" format="PNG" /> </imageobject></mediaobject></screenshot> </example>
<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 the Refocus plug-in available from <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins project</ulink>, and you can access it with the
<menuchoice><guimenu>Fix</guimenu>
<guimenuitem>Refocus</guimenuitem></menuchoice> menu entry.
See the dedicated <ulink url="help:/digikamimageplugins/refocus.html">Refocus manual</ulink> for more information and comparison of all the sharpening techniques.
Yet another technique is called the Unsharp Masking. 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.
<example> <title>The Unsharp Mask Image Editor Plugin in Action</title>
<screenshot><screeninfo>The Unsharp Mask Image Editor Plugin in Action" </screeninfo><mediaobject><imageobject><imagedata fileref="editorunsharpedmaskplugin.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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>
<example> <title>The Noise Reduction Image Editor Plugin in Action</title>
<screenshot><screeninfo>The Noise Reduction Image Editor Plugin in Action" </screeninfo><mediaobject><imageobject><imagedata
fileref="editornoisereductionplugin.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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 with the <menuchoice><guimenu>Fix</guimenu><guimenuitem>Blur</guimenuitem></menuchoice> menu entry and experiment with the level. The preview window on the right of the dialog shows the effect of the operation on your photograph.
</para>
<example> <title>The Blur Tool in Action</title>
<screenshot><screeninfo>The Blur Tool in Action" </screeninfo><mediaobject><imageobject><imagedata fileref="editorblurplugin.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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 color 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>
<example> <title>The Color Balance Tool in Action</title>
<screenshot><screeninfo>The Color Balance Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="editorcolorbalance.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<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>
<example> <title>The Hue Saturation Lightness Tool in Action</title>
<screenshot><screeninfo>The Hue Saturation Lightness Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="editorhsladjust.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<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.
<example><title>Normalize Colors Correction Preview</title> <screenshot><screeninfo>Normalize Colors Correction Preview</screeninfo><mediaobject><imageobject><imagedata fileref="editornormalize.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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.
<example><title>Equalize Colors Correction Preview</title> <screenshot><screeninfo>Equalize Colors Correction Preview</screeninfo><mediaobject><imageobject><imagedata fileref="editorequalize.png" format="PNG" /> </imageobject></mediaobject></screenshot> </example>
</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.
<example><title>Auto Levels Correction Preview</title> <screenshot><screeninfo>Auto Levels Correction Preview</screeninfo><mediaobject><imageobject><imagedata fileref="editorautolevels.png" format="PNG" /> </imageobject></mediaobject></screenshot> </example>
</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.
<example><title>Stretch Contrast Correction</title> <screenshot><screeninfo>Stretch Contrast Correction Preview</screeninfo><mediaobject><imageobject><imagedata fileref="editorstretchcontrast.png" format="PNG" /> </imageobject></mediaobject></screenshot> </example>
</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>
<example> <title>The Brightness Contrast Gamma Tool in Action</title>
<screenshot><screeninfo>The Brightness Contrast Gamma Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="editorbcgadjust.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>
If you have the Adjust Levels plugin installed (see the <link linkend="setup-editor">Setup Image Editor 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 tools 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.
<example> <title>The Adjust Levels Image Editor Plugin in Action</title>
<screenshot><screeninfo>The Adjust Levels Image Editor Plugin in Action" </screeninfo><mediaobject><imageobject><imagedata fileref="editoradjustlevels.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</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!
<example> <title>The Adjust Curves Image Editor Plugin in Action</title>
<screenshot><screeninfo>The Adjust Curves Image Editor Plugin in Action" </screeninfo><mediaobject><imageobject><imagedata
fileref="editoradjustcurves.png" format="PNG" /> </imageobject></mediaobject></screenshot> </example>
</para>
</sect2>
<sect2>
<title>Special Effects and Filters</title>
<anchor id="blackandwhitetool.anchor"/>
<para>
&digikam; comes with a couple of black and white filters that you can use on your photographs. Under the <menuchoice><guimenuitem>Filters</guimenuitem><guimenuitem>Black & White</guimenuitem></menuchoice> menu you will find classic black and white chemical toning used in analog photography. The controls come on three tabs: <emphasis>filters, tone</emphasis> and <emphasis>lightness</emphasis> as shown on the screenshot below. The filters and color toning can be applied independently of each other (on top of each other). The filters actually influence the RGB channel mixing, whereas the toning purely adds a uniform monochromatic tint to the black and white photograph. In the lightness tab you will find a tonal adjustment tool (like curve adjust), a contrast tool and an over-exposure indicator to improve the b&w rendering.
</para>
<example> <title>The Black & White Filter Plugin in Action</title>
<screenshot><screeninfo>The B&W Filter Plugin in Action" </screeninfo><mediaobject><imageobject><imagedata fileref="editorbwfilter.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
<para>The table below shows in more detail the effect of all filters and tints.</para>
<informaltable><tgroup cols="2">
<thead><row>
<entry>Preview</entry>
<entry>Filter Type</entry>
</row></thead>
<tbody>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_original.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Original color image taken in New Zealand landscapes.
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_bw.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Neutral Black and White: simulate black and white neutral film exposure.
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_bwgreen.png" format="PNG" /> </imageobject></inlinemediaobject>
</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>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_bworange.png" format="PNG" /> </imageobject></inlinemediaobject>
</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>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_bwred.png" format="PNG" /> </imageobject></inlinemediaobject>
</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>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_bwyellow.png" format="PNG" /> </imageobject></inlinemediaobject>
</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>
</tbody>
</tgroup></informaltable>
<informaltable><tgroup cols="2">
<thead><row>
<entry>Preview</entry>
<entry>Color Tint</entry>
</row></thead>
<tbody>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_sepia.png" format="PNG" /> </imageobject></inlinemediaobject>
</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>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_brown.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Brown Tone: more neutral than Sepia Tone filter.
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_cold.png" format="PNG" /> </imageobject></inlinemediaobject>
</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>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_platinium.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Platinum Tone: effect that replicate traditional platinum chemical toning done in the darkroom.
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="editorconvert_selenium.png" format="PNG" /> </imageobject></inlinemediaobject>
</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="setup-editor">Setup Image Editor Section</link>), like Film Grain, Rain Drops, Solarize, Charcoal Drawing, &etc;.
</para>
<example> <title>The Rain Drops Image Editor Plugin in Action</title>
<screenshot><screeninfo>The Adjust Levels Image Editor Plugin in Action" </screeninfo><mediaobject><imageobject><imagedata fileref="editorraindropsplugin.png" format="PNG" /> </imageobject></mediaobject></screenshot>
</example>
</sect2>
<sect2>
<title>Printing Images</title>
<para>
When you want to print the current image from the Image Editor, select
<menuchoice><guimenu>File</guimenu>
<guimenuitem>Print image</guimenuitem></menuchoice> (&Ctrl;+P) and you get the standard &kde; Print dialog, where you can adjust the settings before printing your photograph.
</para>
<para>
For more information about advanced printing settings, please consult <ulink url="help:/kdeprint/index.html">&kde; Print manual</ulink>.
</para>
<para>
From the main window view you can print single images or whole sets of them. Entire thumbnail pages can be printed with your selection. All you need to do is selecting images the standard way and call <menuchoice><guimenu>Album</guimenu><guimenuitem>Export</guimenuitem> <guimenuitem>Print Wizard</guimenuitem></menuchoice>. Then follow the instructions and choices to make.
</para>
</sect2>
<sect2 id="using-kapp-iccprofile">
<title>ICC color profile management</title>
<para>
What is the importance of ICC color profile management anyway? In simple terms it is alike hi-fi stereo, where high fidelity is seeked from source to speakers, passing through microphone, recoding media, player and amplifier. Much the same, ICC color profile management tries to maintain color fidelity from photographic subject through the camera to the output media screen, print, paper and beamer. Luckily digital photography has taken out one source of distortion, the storage media (as the &CD-ROM; did in the audio field).
</para>
<para>The figure below pictures the problem: Every time there is a transfer from one device to another, an ICC profile is used to correct for the inaccuracies or limitations of the device. The central work space (which is called Profile Connection Space, PCS) provides a common platform to translate the device color spaces into each other.
</para>
<para>The inter-connection between devices and their color spaces</para>
<para>
<inlinemediaobject><imageobject><imagedata
fileref="colormanagement.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
<tip>
<para><emphasis>CM Pros.</emphasis> CM is really important whenever you need identical results between shooting sessions, accurate source reproduction, close rendering results between various display media (this would rather point CM to professionals).</para>
<para>As a passionate amateur you can also profit from CM, since it is mostly associated with 16 bit color depth. RAW mode shooting is much more forgiving in terms of exposure than processed shooting (JPEG), so you can generally underexpose and recover the highlights. And, the human eye is much more sensitive to luminosity variations in the dark scales than a digital camera is. Careful tonal adjustment there close to the blacks will produce a better dynamic of the picture. That is why RAW mode pictures often have an appearance of more depth to them.</para>
<para><emphasis>CM Cons.</emphasis> If you do not use color management you still can realize fantastic pictures. In journalism or emotional contexts, for holiday photos you do not need any color management.</para>
</tip>
<para>
The ICC standard covers a data format to exchange color information of devices. ISO 22028-1 specifies unambiguous exchange of color image data of color space encoding, viewing conditions, image state and reference medium. Here follows an example of the differences in color language: one kind of green defined (by the same numbers) in one color space looks different in another color space. This is what happens when no color management is applied.
</para>
<para>
(88, 249, 16) in Adobe RGB <inlinemediaobject><imageobject><imagedata fileref="2Greens.png" format="PNG"/></imageobject></inlinemediaobject> The same RGB value in sRGB
</para>
<para>
Photographers want to use the full gamut of their camera and their ink jet printers. Editing of pictures should be done in a work space, where equal RGB-numbers result into gray.
</para>
<para>
The following diagram tries to outline the logic &digikam; will follow in its CM work flow, depending on the settings made in <emphasis>IO Files</emphasis> and <emphasis>ICC profiles</emphasis> of the configuration page.
</para>
<para>
<inlinemediaobject><imageobject>
<imagedata fileref="ICCworkflowlogic.png" format="PNG" />
</imageobject></inlinemediaobject>
</para>
<sect3 id="softproofing">
<title>Soft Proofing</title>
<para> Soft Proofing is a way of previewing on the screen (monitor) the result to be expected from an output on another device, typically a printer. Soft proofing will show you the difference to be expected before you actually do it (and waste your costly ink). So you can improve your settings without wasting time and money.
</para>
</sect3>
<sect3 id="rendering-intention">
<title>Rendering intention</title>
<para>Rendering intent refers to the way gamuts are handled when the intended target color space cannot handle the full gamut.</para>
<itemizedlist>
<listitem><para><emphasis>Perceptual</emphasis>, also called Picture or Maintain Full Gamut. This is generally recommended for photographic images. The color gamut is expanded or compressed when moving between color spaces to maintain consistent overall appearance. Low saturation colors are changed very little. More saturated colors within the gamuts of both spaces may be altered to differentiate them from saturated colors outside the smaller gamut space. Perceptual rendering applies the same gamut compression to all images, even when the image contains no significant out-of-gamut colors.</para>
</listitem>
<listitem><para><emphasis>Relative Colorimetric</emphasis>, also called Proof or Preserve Identical Color and White Point. Reproduces in-gamut colors exactly and clips out-of-gamut colors to the nearest reproducible hue.</para>
</listitem>
<listitem><para><emphasis>Absolute Colorimetric</emphasis>, also called Match or Preserve Identical Colors. Reproduces in-gamut colors exactly and clips out-of-gamut colors to the nearest reproducible hue, sacrificing saturation and possibly lightness. On tinted papers, whites may be darkened to keep the hue identical to the original. For example, cyan may be added to the white of a cream-colored paper, effectively darkening the image. Rarely of interest to photographers.</para>
</listitem>
<listitem><para><emphasis>Saturation</emphasis>, also called Graphic or Preserve Saturation. Maps the saturated primary colors in the source to saturated primary colors in the destination, neglecting differences in hue, saturation, or lightness. For block graphics; rarely of interest to photographers.</para>
</listitem>
</itemizedlist>
</sect3>
<sect3 id="iccprofile-links">
<title>Links</title>
<para><ulink url="http://www.oyranos.org/wiki/index.php?title=Main_Pag">Color wiki</ulink> <ulink url="http://en.wikipedia.org/wiki/CIELAB">CIELAB</ulink> <ulink url="http://en.wikipedia.org/wiki/Gamut">Gamut explained</ulink></para>
</sect3>
</sect2>
</sect1>
<sect1 id="using-kapp-setup">
<title>&digikam; Configuration</title>
<sect2 id="setupdialog">
<title>The Setup Dialog Window</title>
<anchor id="setupdialog.anchor"/>
<para>
&digikam; tries to give you as much control on how it works as possible. There are many options that change the behavior of &digikam;. To access these settings select
<menuchoice><guimenu>Setting</guimenu>
<guimenuitem>Configure &digikam;</guimenuitem></menuchoice> from the Menu Bar. The configuration dialog is separated into 15 pages. You can change between these pages by clicking on the icons on the left-hand side of the dialog.
</para>
<sect3 id="setup-album"> <title>Album Settings</title>
<para>
The Album settings control how the main application will behave.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupalbum.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
<para>
The <guilabel>Album Library Path</guilabel> is the location on your hard disk where &digikam; will store all of the Albums. If you change this location without manually moving all of the Albums on the hard disk, &digikam; assumes that there are no existing Albums and will generate a new database at the new location. Your old Albums will not be altered but you will need to change the Album Library Path back to the old location to access them. If you are not sure of what you are doing it is best not to change this location.
</para>
<para>
The <guilabel>Thumbnails</guilabel> options are described in the <link linkend="using-kapp-imageview">Images</link> section.
</para>
<para>
The <guilabel>Click action</guilabel> can be set to <guilabel>Show embedded preview</guilabel> or <guilabel>Start image editor</guilabel>. You herewith define the default behavior of &digikam; when you click on an image item in the main view.
</para>
</sect3>
<sect3 id="setup-collection"> <title>Collection Settings</title>
<para>
This dialog manage your Collection types. Album Collections are described in detail in the <link linkend="using-kapp-myalbumsview">My Albums</link> section.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupcollections.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
</sect3>
<sect3 id="authoridentity"> <title>Default Author Identity for IPTC</title>
<para>
This page contains the default identity and copyright data as shown on the printscreen below. The data will be automatically written into the respective IPTC data fields if so selected during the download from the <link linkend="using-kapp-cameraclientrenaming">camera interface</link>. Also, if you call for database synchronisation, this data will be written into the IPTC fields.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="cameraclientidentity.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
</sect3>
<sect3 id="setupembeddedinfo"> <title>Metadata (embedded information settings)</title>
<para>
Image files can have some meta-data embedded into the image file format. This meta-data can be stored in a number of standard formats. &digikam; can read meta-data in the EXIF format if it is present in the file. &digikam; can also write comments into the <ulink url="http://www.exif.org">EXIF information</ulink>. Writing comments to the EXIF section is limited to JPEG images.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupembeddedinfo.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
<para>
These settings allow you to control how &digikam; will deal with this embedded information.
</para>
<para>
<guilabel>Save image comments as embedded comments (JFIF) in JPEG images</guilabel> : this will synchronize the comments that you add to your photographs with those in embedded in the image. This is useful because the comments embedded in the image can be read by other image viewers. Care should be taken if you have images that already have comments embedded in them because these comments will be overwritten by the comments made within &digikam;.
</para>
<para>
<guilabel>Rotate Images and Thumbnails according to EXIF tag</guilabel> : this will use any orientation information that your camera has included in the EXIF information to automatically rotate your photographs so that they are the correct way up when displayed. It will not actually rotate the image file, only the display of the image on the screen. If you want to permanently rotate the image on file, you can right-click on the thumbnail and select <guilabel>Auto-rotate/flip according to EXIF orientation</guilabel>. The image will then be rotated on disk and the tag will be reset to "normal". If your camera routinely gets this orientation information wrong you might like to switch this feature off.
</para>
<para>
<guilabel>Set EXIF Orientation Tag to Normal after rotate/flip</guilabel> : the Auto Rotate option automatically corrects the orientation of images taken with digital cameras that have an orientation sensor. The camera adds an orientation tag to the image's EXIF meta-data. &digikam; can read this tag to adjust the image accordingly. If you manually rotate an image, this meta-data will be incorrect. This option will set the orientation tag to "Normal" after an adjustment, assuming that you rotated it to the correct orientation. Switch this off if you don't want &digikam; to make changes to the orientation tag, when you rotate or flip the image.
</para>
</sect3>
<sect3 id="setup-tooltip">
<title>Album Item Tooltip Settings</title>
<para>
This setup page covers all options of information appearing when the mouse hovers over a file in the main view. According the checked options they will be shown or not.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setuptooltip.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
</sect3>
<sect3 id="setup-mimetype">
<title>Mime Type Settings</title>
<para>
&digikam; can understand lots of different image file types as well as some video and audio formats. To control which types of files &digikam; will try to display you can add or remove file extensions from these lists. Any files that are in the &digikam; Album folders that do not match these extensions will be ignored by &digikam;.
</para>
<note><para>The default settings can be easily restored by clicking onto the update buttons to the right of each category.</para></note>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupmimetypes.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
</sect3>
<sect3 id="setup-editor">
<title>Image Editor Settings</title>
<para>
By default the Image Editor will use a black background behind photographs when they are displayed. If you prefer a different background color you can choose one here. You can also turn off the ToolBar when the Image Editor is in full screen mode.
</para>
<para>
Over and underexposed areas of an image can be indicated by dark and light marker colors that can be defined here. In the editor this viewing mode can be switched on and off with F10 and F11 respectively.</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupimageeditor.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
</sect3>
<sect3 id="setup-saveimages"> <title>Save Image Options</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 the Image Editor 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 the Image Editor 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>
<inlinemediaobject><imageobject><imagedata fileref="setupsaveimages.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
<para>
With <guilabel>PNG compression</guilabel> option, you can reduce PNG image files size. This operation does not reduce image quality because PNG uses 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>Compress TIFF</guilabel> option, you can toggle to use <emphasis>Deflate</emphasis> compression algorithm with TIFF image files. This will reduce the TIFF image files size. It has no image quality effect because <emphasis>Deflate</emphasis> is a lossless algorithm.
</para>
<para>
With the <guilabel>LossLess JPEG 2000 files</guilabel> option allows for lossless storage, or, if the lossy options is selected, even then the quality for comparative files size is much better than normal JPEG. At the time of writing, metadata is not yet supported, but it is in the 'pipeline'.
</para>
</sect3>
<sect3 id="setup-raw-decoder">
<title>RAW Decoder Settings</title>
<para>
In the early versions of &digikam; the Image 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 the Image Editor will behave.
</para>
<para><guilabel>16-bit color depth</guilabel></para>
<para>If enabled, all RAW files will be decoded to 16-bit color depth using a linear gamma curve. To prevent dark picture rendering in the editor, it is recommended to use Color Management in this mode. If disabled, all RAW files will be decoded to 8-bit color depth with a BT.709 gamma curve and a 99th-percentile white point. This mode is faster than 16-bit decoding. In 8-bit mode only will the <guilabel>brightness</guilabel> setting be taken into account (dcraw limitation).
</para>
<para><guilabel>Interplate RGB as four colors</guilabel></para>
<para>The default is to assume that all green pixels are the same. If even-row green pixels of the CCD sensor are more sensitive to ultraviolet light than odd-row this difference causes a mesh pattern in the output; using this option solves this problem with minimal loss of detail. To resume, this option blurs the image a little, but it eliminates false 2x2 mesh patterns with VNG quality method or mazes with AHD quality method.</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setuprawfiledecoding.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
<para><guilabel>Use camera white balance</guilabel></para>
<para>Use the camera's custom white-balance settings if set. Otherwise apply <guilabel>Automatic color balance</guilabel> if this option is set.</para>
<para><guilabel>Automatic color balance</guilabel></para>
<para>Only used if camera white balance is not set. The default is to use a fixed color balance based on a white card photographed in sunlight.</para>
<para><guilabel>Use Super CCD secondary sensors</guilabel></para>
<para>For Fuji Super CCD SLR cameras only. Use the secondary sensors, in effect underexposing the image by four stops to reveal detail in the highlights. For all other camera types this option is being ignored.</para>
<para><guilabel>Highlights</guilabel></para>
<para>This is the story of the three highlight options, courtesy to <ulink url="http://linux.vilars.com/">Nicolas Vilars</ulink> :</para>
<para>Default is here to consider highlights (read: part of your pictures that are burned due to the inability of your camera to capture the highlights) as plain / solid white (<guilabel>solid white</guilabel> option). You can get some fancy results with the <guilabel>unclip</guilabel> option which will paint the highlights in various pinks. At last you can try to consider recovering some parts of the missing information from the highlights (<guilabel>reconstruct</guilabel> option).</para>
<para>
This is possible because the blue pixels tends to saturate less quickly than the greens and the reds. &digikam;/dcraw will try to reconstruct the missing green and red colors from the remaining none saturated blue pixels. Of course here everything is a question of tradeoff between how much color or white you want.</para>
<para>If you select <guilabel>reconstruct</guilabel> as the option, you will be given the choice to set a level. A value of 3 is a compromise and can/should be adapted on a per picture basis.</para>
<note><para>
A small warning here, for the few curious that have read the man pages of Dcraw, the author says that 5 is the compromise, 0 is solid white and 1 unclip. This is because in &digikam; 0 and 1 are the "solid white" and "unclip" options in the drop down menu (if you select these, the level slider will be grayed out). Therefore, the slider in Digikam with the "reconstruct" option will let you choose between 0 to 7 (instead of 0 to 9 in Dcraw command line) where 3 is the compromise instead of 5 in "native" Dcraw command line tool.</para></note>
<para><guilabel>Brightness</guilabel> (works in 8 bit mode only)</para>
<para>
Set the luminosity to your taste, you probably need to go a little higher than the default = 1. But this can be adjusted later with the image options in the Digikam image editor. Given the cost in time for demosaicing, stay conservative.
</para>
<para><guilabel>Quality</guilabel></para>
<para>
A <ulink url="http://en.wikipedia.org/wiki/Demosaicing">demosaicing</ulink> algorithm is a digital image process used to interpolate a complete image from the partial raw data received from the color-filtered image sensor internal to many digital cameras in form of a matrix of colored pixels. Also known as CFA interpolation or color reconstruction.</para>
<para>
&digikam; and Dcraw offer us three alternatives: bi-linear, VNG interpolation, AHD interpolation. It seems that <emphasis>AHD interpolation</emphasis> (for Adaptive Homogeneity-Directed) is the best choice for quality according to some test that I have performed and the paper of the person that implemented it. <emphasis>VNG interpolation</emphasis> (Variable Number of Gradients) was the first algorithm used by Dcraw but suffers from color artifacts on the edge. <emphasis>Bilinear</emphasis> is interesting if you are looking for speed with a acceptable result.</para>
<para><guilabel>Enable Noise Reduction</guilabel></para>
<para>
While demosaicing your picture, you can additionally ask for noise reduction (at a speed penalty). This option applies a noise reduction algorithm while the picture still is in CIE Lab color space. Because the noise is only applied to the Luminosity layer (the "L" of the Lab), it should not blur your picture as traditional noise reduction algorithms do in RVB mode. So, if you converted an image from RAW and it appears noisy, rather than applying a denoiser, go back and re-convert with this option enabled. The defaults are: <emphasis>Domain</emphasis> = 2 and <emphasis>Range</emphasis> = 4.
</para>
</sect3>
<sect3 id="setup-iccprofiles"> <title>ICC Profiles setup</title>
<para>
&digikam; has the ability to color manage your pictures. RAW files are not color managed at all. Your camera provides the data it has captured in a raw format and will let you manage all the processing. Every camera has its specifics regarding how it captures color information, therefore you will need to apply a specific profile to the pictures you want to process. Please refer to the section <link linkend="using-kapp-iccprofile">ICC color profile management</link> for more details an explanations.
</para><para>
Basically, a profile "maps" the color information and gives information on how one should render them. It gives also information to LCMS and &digikam; on how to translate the color information from one color space to an other in order to keep the colors as accurate as possible.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupiccprofiles.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
<para><guilabel>Behaviour</guilabel> Ask when open an image in image editor / Launch Color Management plugin with RAW files</para>
<para><guilabel>Color Profiles Directory</guilabel>
Set this to the directory where you stores all your profiles ⪚ "/urs/share/color/icc" or "/home/user/Pictures/.icc". &digikam; will scan this directory when starting up.</para>
<para><guilabel>ICC Profiles Settings</guilabel>
Here you are given the ability to provide "default" choices for your profiles. Everything is adaptable later-on at the opening of a RAW file.</para>
<itemizedlist>
<listitem><para>The Use color managed view is an alternative to using Xcalib or Argyll. Only your picture will be color managed, not your entire screen! </para></listitem>
<listitem><para>
You have to provide a workspace profile (such as Adobe RGB or sRGB). If you want to go to print with your pictures, you may want to go to Adobe RGB, if it is only for web publishing, sRGB is better (Adobe RGB will be displayed slightly dull in non color managed enable software such as browsers). However you may change this later of course, therefore Adobe RGB can be a good choice for storing and picture handling as you can always change it to sRGB before releasing a picture for your blog.</para></listitem>
<listitem><para>
input profile should match the camera maker you are using. I am the (happy) owner of a Minolta 7D and I therefore use a Minolta profile.</para></listitem>
<listitem><para>
There are some other options such as the soft proof profile which enables you to emulate, granted that you have a profile for it, how your picture will render for a particular device. It is useful before printing for instance because your printer has a smaller gamut than your camera and some colors might look saturated. You may want to fix this manually instead of relying on the "blind" algorithm of your printer.</para></listitem>
</itemizedlist>
</sect3>
<sect3> <title>Process a raw picture</title>
<para>
From there everything is simple, select a RAW picture and open it in the editor. The color management plugin will be displayed after the picture has been processed in order to adjust color rendering. Without color management all pictures are very dark, this is normal. You can experiment the various profiles you have in order to select the best input profile according to your picture (some tends to be very neutral, even a bit dull, some gives more saturated results, &etc;).
</para>
</sect3>
<sect3 id="setup-imageplugins">
<title>Setup Image Plugins</title>
<para>
The Image Editor only implements some very simple photo manipulation tools in the core application. For an easy development of more manipulation tools the Image Editor supports a plugin interface. If your distribution has installed the additional Image Editor 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 information about advanced Image Editor plugins, you can consult the 'DigikamImagePlugins' project at <ulink url="http://extragear.kde.org/apps/digikamimageplugins">&digikam;-Image-Plugins</ulink>.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupimageplugins.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
</sect3>
<sect3 id="setupkipiplugins">
<title>Kipi Plugins Settings</title>
<para>
Kipi is the &kde; Image Plugin Interface. It is an interface that is supported by a number of &kde; image viewer/editor applications. By providing this interface &digikam; can take advantage of many plugins that are written to work with any application that implements the Kipi interface.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupkipiplugins.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
<para>
If your distribution has the Kipi plugins package installed you will see a list of available plugins. Select those that you want to use and they will be loaded into &digikam;. The plugins will appear as new menu entries in the main Menu Bar and in the context menu for thumbnails.
</para>
<para>
Keyboard shortcuts to actions that plugins perform can be set up in the
<menuchoice><guimenu>Setting</guimenu>
<guimenuitem>Configure Shortcuts</guimenuitem></menuchoice> menu.
</para>
<para>
For more information about Kipi plugins, you can consult the Kipi project at <ulink url="http://www.kipi-plugins.org">http://www.kipi-plugins.org</ulink> or the <ulink url="help:/kipi-plugins/index.html">kipi-plugins manual</ulink>.
</para>
</sect3>
<sect3 id="setup-slideshow">
<title>Slide show setup</title>
<para>The slide show setup should be easy to understand. The upper slider adjusts the time between image transitions; usually a time of 4-5 seconds is good. The other checkboxes enable/disable the metadata to be shown on the bottom of the slide show pictures during display.</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupslideshow.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
</sect3>
<sect3 id="setupcamera">
<title>Camera Settings</title>
<para>
The camera settings shows on the left the list of the currently supported cameras. On the right at the top there is an auto-detect button, which tries to identify the camera connected to your computer (make sure that the camera is connected properly to the computer and turned on in the image display mode). Below this are the port settings; the currently supported are Serial, USB, and USB/FireWire Mass Storage.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupcamera.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
<anchor id="cameraselection.anchor"/>
<para>
Clicking on a camera in the list on the left will display the supported ports which you can then select. If there is only one supported port it will be automatically selected. At the bottom on the right there is a box for setting the exact path in case of a serial port. Please note that USB interface does not need any paths to be set. If you cannot find your camera on the list, you can try to use a generic Mass Storage device to selecting <guilabel>Mounted Camera</guilabel> item in the list.
</para>
<para>
At the very bottom is where you set the path for a USB or FireWire (IEEE-1394 or i-link) Mass Storage camera. This box becomes active once you select USB or FireWire Mass Storage camera in the camera list. You need to enter here the path where you mount the camera, usually "/mnt/camera" or "/mnt/removable".
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupaddcamera.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
<para>
To be able to use your digital camera with &digikam;, connect the camera to your computer, switch the camera to the image display mode and turn it on.
</para>
<para>
Try and see if &digikam; can auto-detect the camera; if not, you can set the camera model and port manually. Once you have the camera setup, go to the "Cameras" menu in the main interface and you will see the camera listed in the menu.
</para>
<note><para>
You can choose any title you like for the camera in the setup and this title will be used in the main window <guilabel>Cameras</guilabel> menu. If you have more than one cameras, you can add them through this setup interface.
Yet another possibility - and a very convenient one - is provided by the script in <ulink url="http://digikam.free.fr/hotplug/">usbcam.tar.gz</ulink>. When this is installed, &digikam; will open all by itself whenever a camera is plugged into the USB connector for download.
</para></note>
</sect3>
<sect3 id="setupmisc">
<title>Miscellaneous Settings</title>
<para>
With the <guilabel>Show confirmation dialog when moving items to trash</guilabel> setting you can set the verbosity of &digikam; when you delete a photograph or an Album. See <link linkend="using-kapp-deleteimage">Deleting a Photograph</link> and <link linkend="using-kapp-deletealbum">Deleting an Album</link> sections for more details.
</para>
<para>
The editorial changes done through the right sidebar can be quietly applied by &digikam; when setting the <guilabel>Apply changes in the right sidebar without confirmation</guilabel> option. Otherwise the changes must be applied by pressing the <guilabel>Apply changes</guilabel> button.
</para>
<para>
You can also switch off the display of the splash screen when &digikam; loads. This may speed up the start time of &digikam; slightly.
</para>
<anchor id="rescan-items" />
<para>
The <guilabel>Scan for new items at start-up</guilabel> option forces &digikam; to scan the album library tree for new items added or removed between &digikam; sessions. This may slow down the start time of &digikam;. If any items have been removed from the album library, &digikam; will ask your confirmation before definitely removing the item references in database.
</para>
<para>
<inlinemediaobject><imageobject><imagedata fileref="setupmisc.png" format="PNG" /> </imageobject></inlinemediaobject>
</para>
</sect3>
</sect2>
<sect2 id="setuptheme"> <title>The Theme Setup</title>
<para>
Color schemes are supplied like themes to personalize &digikam; main interface for you pleasure. To access these settings select
<menuchoice><guimenu>Setting</guimenu>
<guimenuitem>Themes</guimenuitem></menuchoice> from the Menu Bar and select your preferred theme to use. A preview of the available themes is listed below:
</para>
<informaltable><tgroup cols="2">
<thead><row>
<entry>Preview</entry>
<entry>Theme Name</entry>
</row></thead>
<tbody>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="setupthemeclean.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Clean
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="setupthemedark.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Dark
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="setupthemedefault.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Default
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="setupthemedessert.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Dessert
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="setupthemedigicasa.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Digicasa
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="setupthemedreary.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Dreary
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="setupthememarine.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Marine
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="setupthemeorangecrush.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
OrangeCrush
</entry>
</row>
<row>
<entry>
<inlinemediaobject><imageobject><imagedata fileref="setupthemesandy.png" format="PNG" /> </imageobject></inlinemediaobject>
</entry>
<entry>
Sandy
</entry>
</row>
</tbody>
</tgroup></informaltable>
<note><para>
Theme settings are implemented in simple text file. If you are interested to create a new theme for &digikam;, you can find more information about it in this <ulink url="http://www.digikam.org/themeguide.html">tutorial</ulink>.
</para></note>
</sect2>
</sect1>
</chapter>
<!-- *********************************************************************** -->
<chapter id="menu-descriptions"> <title>Menu Descriptions</title>
<sect1>
<title>The main &digikam; window</title>
<sect2> <title>The Album Menu</title>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="menualbum.png" format="PNG"/></imageobject>
<textobject> <phrase>Album Menu</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Alt;</keycap><keycap>Left</keycap></keycombo> </shortcut>
<guimenu>Album</guimenu><guimenuitem>Back</guimenuitem>
</menuchoice></term>
<listitem><para><action>Go back to the previously visited View using history.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Alt;</keycap><keycap>Right</keycap></keycombo> </shortcut>
<guimenu>Album</guimenu><guimenuitem>Forward</guimenuitem>
</menuchoice></term>
<listitem><para><action>Go forward to the previously visited View using history. You can only go forward if you've just gone back.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>N</keycap></keycombo> </shortcut> <guimenu>Album</guimenu><guimenuitem>New Album</guimenuitem>
</menuchoice></term>
<listitem><para><action>Create a new album folder.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu><guimenuitem>Edit Album Properties</guimenuitem>
</menuchoice></term>
<listitem><para><action>Edit the currently selected album title, comments and collection.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>F5</keycap></keycombo> </shortcut>
<guimenu>Album</guimenu><guimenuitem>Refresh</guimenuitem>
</menuchoice></term>
<listitem><para><action>Refresh the current view in the Main Window.</action></para></listitem>
</varlistentry>
<varlistentry id="synchronize-metadata">
<term><menuchoice>
<guimenu>Album</guimenu>
<guimenuitem>Sync Pictures Metadata</guimenuitem>
</menuchoice></term>
<listitem><para><action>Synchronize the metadata between database and the file's metadata of all items of the current Main Window</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu>
<guimenuitem>Open in &konqueror;</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open &konqueror; with the current Album path.</action></para></listitem>
</varlistentry>
<!-- Import sub menu -->
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>I</keycap></keycombo> </shortcut>
<guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Add Images</guimenuitem>
</menuchoice></term>
<listitem><para><action>Select images to be added to the currently selected Album.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Import Folders</guimenuitem>
</menuchoice></term>
<listitem><para><action>Select folders to be imported like Albums to the currently selected Album</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Scan Images</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin for image acquisition with a scanner.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/acquireimages.html">Acquire Images manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Screenshot</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to take a screenshot.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/acquireimages.html">Acquire Images manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<!-- Export sub menu -->
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>Archive to
&CD;/DVD</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to archive Albums to &CD; or DVD using K3b.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/cdarchiving.html">&CD; Archiving manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>Export to Flickr...</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to upload or update images to <ulink url="http://www.flickr.com/">Flickr</ulink> server.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/flickrexport.html">&CD; Flickr Export manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>Remote Gallery sync...</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to upload or update images to <ulink url="http://www.gallery2.org/">web galleries</ulink>.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/galleryexport.html">&CD; Gallery Export manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>&HTML; Gallery</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to create a &HTML; gallery with Albums.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/imagesgallery.html">Images Gallery manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>Print
Wizard</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to print Album images.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/printwizard.html">Print Wizard manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>SimpleViewer export</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to export to <ulink url="http://www.airtightinteractive.com/photos/">SimpleViewer</ulink>.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/simpleviewer.html">SimpleViewer manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Album</guimenu>
<guimenuitem>Delete Album/Move Album to trash</guimenuitem>
</menuchoice></term>
<listitem><para><action>Delete/Move to trash selected Album and all items in it.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>Q</keycap></keycombo> </shortcut>
<guimenu>Album</guimenu><guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Quit &digikam;</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- *********************************************************************** -->
<sect2> <title>The Tag Menu</title>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="menutag.png" format="PNG"/></imageobject>
<textobject> <phrase>Tags Menu</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Tag</guimenu><guimenuitem>New Tag</guimenuitem>
</menuchoice></term>
<listitem><para><action>Create a new Tag entry in the Albums Database.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tag</guimenu><guimenuitem>Edit Tag Properties</guimenuitem>
</menuchoice></term>
<listitem><para><action>Edit the properties of the currently selected Tag.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tag</guimenu><guimenuitem>Delete Tag</guimenuitem>
</menuchoice></term>
<listitem><para><action>Remove the currently selected Tag from the Album's Database.</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- *********************************************************************** -->
<sect2> <title>The Image Menu</title>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="menuimage.png" format="PNG"/></imageobject>
<textobject> <phrase>Image Menu</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="press"><keycap>F3</keycap></keycombo> </shortcut>
<guimenu>Image</guimenu><guimenuitem>View...</guimenuitem>
</menuchoice> or
<menuchoice>
<shortcut><keycombo action="press"><keycap>Enter</keycap></keycombo></shortcut>
<guimenu></guimenu></menuchoice></term>
<listitem><para><action>View the selected image.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="press"><keycap>Esc</keycap></keycombo></shortcut>
<guimenu></guimenu></menuchoice> or
<menuchoice>
<shortcut><keycombo action="press"><keycap>F3</keycap></keycombo></shortcut>
<guimenu></guimenu></menuchoice></term>
<listitem><para><action>Puts you back from 'image view' into the main window.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="press"><keycap>F4</keycap></keycombo> </shortcut>
<guimenu>Image</guimenu><guimenuitem>Edit...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open the currently selected image in the &digikam; image editor.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu><guimenuitem>Correct EXIF Orientation Tag</guimenuitem>
</menuchoice></term>
<listitem><para><action>Manual EXIF Orientation Tag adjustment options of the currently selected image.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu><guimenuitem>Auto Rotate/Flip using EXIF information</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin menu entry to manually activate the auto rotate/flip feature for the currently selected images using the EXIF orientation tag.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu><guimenuitem>Rotate</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin menu entry for rotating the currently selected images by 90/180/270 degrees.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu><guimenuitem>Flip</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin menu entry for flipping the currently selected images horizontally or vertically.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu><guimenuitem>Convert to Black and White</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin menu entry for converting the currently selected images to black and white.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu><guimenuitem>Email images</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin for emailing images with your preferred mail agent.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/sendimages.html">Send Images manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu><guimenuitem>Geolocalization</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to handle GPS meta data of the image.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/geolocalization.html">Geolocalization manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu><guimenuitem>Metadata</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to handle meta data of the image (EXIF, IPTC, comments).
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/metadata.html">Metadata manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu><guimenuitem>Adjust Time and Date</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin for adjusting time and date of the currently selected images.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/timeadjust.html">Time Adjust manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu><guimenuitem>Set as Background</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin for setting the currently selected image as the desktop background.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/wallpaper.html">Wall Paper manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="press"><keycap>F2</keycap></keycombo> </shortcut>
<guimenu>Image</guimenu><guimenuitem>Rename</guimenuitem>
</menuchoice></term>
<listitem><para><action>Rename the currently selected image.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="press"><keycap>F8</keycap></keycombo> </shortcut>
<guimenu>Image</guimenu><guimenuitem>Delete</guimenuitem>
</menuchoice></term>
<listitem><para><action>Move to trash (recoverable delete)</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- *********************************************************************** -->
<sect2> <title>The Select Menu</title>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="menuselect.png" format="PNG"/></imageobject>
<textobject> <phrase>Select Menu</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>A</keycap></keycombo> </shortcut>
<guimenu>Select</guimenu><guimenuitem>Select All</guimenuitem>
</menuchoice></term>
<listitem><para><action>Select all images currently shown</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>U</keycap></keycombo> </shortcut>
<guimenu>Select</guimenu><guimenuitem>Select None</guimenuitem>
</menuchoice></term>
<listitem><para><action>Unselect all items in the current view</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>*</keycap></keycombo> </shortcut>
<guimenu>Select</guimenu><guimenuitem>Invert Selection</guimenuitem>
</menuchoice></term>
<listitem><para><action>Invert the current selection</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- *********************************************************************** -->
<sect2>
<title>The View Menu</title>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="menuview.png" format="PNG"/></imageobject>
<textobject> <phrase>View Menu</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>F</keycap></keycombo> </shortcut>
<guimenu>View</guimenu><guimenuitem>Full Screen Mode</guimenuitem>
</menuchoice></term>
<listitem><para><action>Switch to full screen (same as F11).</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu><guimenuitem>Slide Show</guimenuitem>
</menuchoice></term>
<listitem><para><action>Slide Show including RAW files.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="press"><keycap>F9</keycap></keycombo> </shortcut>
<guimenu>View</guimenu><guimenuitem>All</guimenuitem>
</menuchoice></term>
<listitem><para><action>Start slide show of all images in current window.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Alt;</keycap><keycap>F9</keycap></keycombo> </shortcut>
<guimenu>View</guimenu><guimenuitem>Selection</guimenuitem>
</menuchoice></term>
<listitem><para><action>Start slide show on selected images.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Shift;</keycap><keycap>F9</keycap></keycombo> </shortcut>
<guimenu>View</guimenu><guimenuitem>Recursive</guimenuitem>
</menuchoice></term>
<listitem><para><action>Slide show that recurses through the current album tree.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>+</keycap></keycombo> </shortcut>
<guimenu>View</guimenu><guimenuitem>Increase Thumbnail Size</guimenuitem>
</menuchoice></term>
<listitem><para><action>Increase the thumbnail size of the currently selected Album.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>-</keycap></keycombo> </shortcut>
<guimenu>View</guimenu><guimenuitem>Decrease Thumbnail Size</guimenuitem>
</menuchoice></term>
<listitem><para><action>Decrease the thumbnail size of the currently selected Album.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu><guimenuitem>Sort Albums</guimenuitem>
</menuchoice></term>
<listitem><para><action>Sort all &digikam; Albums by Folder, by Collection, or by Date.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu><guimenuitem>Sort Images</guimenuitem>
</menuchoice></term>
<listitem><para><action>Sort all images in current Album by Name, Path, Date, File Size or by Rating.</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- *********************************************************************** -->
<sect2>
<title>The Tools Menu</title>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="menutools.png" format="PNG"/></imageobject>
<textobject> <phrase>Tools Menu</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>F</keycap></keycombo> </shortcut>
<guimenu>Tools</guimenu><guimenuitem>Quick Search</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Launch the simple search items dialog.
</action></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Alt;</keycap><keycap>&Ctrl;</keycap><keycap>F</keycap></keycombo> </shortcut>
<guimenu>Tools</guimenu><guimenuitem>Advanced Search</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Launch the advanced search items dialog.
</action></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Scan for new images</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Rescan the library for images not yet in the database (see also <link linkend="rescan-items">start-up option</link>).
</action></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Rebuild all Thumbnails...</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Launch rebuild of all thumbnails (that can take a long time if you have many images).
</action></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Sync all Pictures Metadata</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Launch synchronization of all metadata between database and files of all files (not just current view as with <link linkend="synchronize-metadata">this</link> menu).
</action></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Find Duplicate Images</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to find duplicate images in Albums Database.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/findduplicateimages.html">Find Duplicate Images manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Image Viewer</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin OpenGL full screen image viewer with the selected image.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/openglviewer.html">Calendar manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Create Calendar</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin for creating a calendar with Album items.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/calendar.html">Calendar manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Create MPEG Slideshow</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin for creating an MPEG Slideshow with Album items.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/mpegencoder.html">MPEG Encoder manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Remote Galleries</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin to set up a list of remote galleries for exporting.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/remotegalleries.html">Slide Show manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Slideshow</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin for displaying an advanced slide show with Album items.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/slideshow.html">Slide Show manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>RAW Image Converter (single)</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin for converting a single RAW image.
</action></para>
<para>
See the dedicated
<ulink url="help:/kipi-plugins/rawconverter.html">RAW Converter manual</ulink>
for more information.
</para>
</listitem>
</varlistentry>
<!-- Import sub menu -->
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Batch Processes</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Kipi plugin menu entries for performing batch Processes on currently selected images.
</action></para>
<para>
See the dedicated manuals for more information:
<itemizedlist>
<listitem><para>
<ulink url="help:/kipi-plugins/colorimages.html">Color Images manual</ulink>
</para></listitem>
<listitem><para>
<ulink url="help:/kipi-plugins/convertimages.html">Convert Images manual</ulink>
</para></listitem>
<listitem><para>
<ulink url="help:/kipi-plugins/effectimages.html">Effect Images manual</ulink>
</para></listitem>
<listitem><para>
<ulink url="help:/kipi-plugins/filterimages.html">Filter Images manual</ulink>
</para></listitem>
<listitem><para>
<ulink url="help:/kipi-plugins/recompressimages.html">Recompress Images manual</ulink>
</para></listitem>
<listitem><para>
<ulink url="help:/kipi-plugins/renameimages.html">Rename Images manual</ulink>
</para></listitem>
<listitem><para>
<ulink url="help:/kipi-plugins/resizeimages.html">Resize Images manual</ulink>
</para></listitem>
<listitem><para>
<ulink url="help:/kipi-plugins/rawconverter.html">RAW Converter manual</ulink>
</para></listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- *********************************************************************** -->
<sect2>
<title>The Camera Menu</title>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="menucamera.png" format="PNG"/></imageobject>
<textobject> <phrase>Camera Menu</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
Any configured digital camera will be listed here. You can use the "Add Camera" menu entry to add a new camera to the list. Please, read the <link linkend="cameraselection.anchor">Setup Camera Section</link>
for more information.
</para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Camera</guimenu><guimenuitem>Media Browse</guimenuitem>
</menuchoice></term>
<listitem><para><action>Browsing attached media devices like card readers, DVDs or memory sticks.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Camera</guimenu><guimenuitem>Add camera</guimenuitem>
</menuchoice></term>
<listitem><para><action>Interactively add a new camera.</action></para></listitem>
</varlistentry>
</variablelist>
</sect2>
<!-- *********************************************************************** -->
<sect2 id="settings-menu">
<title>The Settings Menu</title>
<para>
<inlinemediaobject>
<imageobject><imagedata fileref="menusettings.png" format="PNG"/></imageobject>
<textobject> <phrase>Settings Menu</phrase> </textobject>
</inlinemediaobject>
</para>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Show Toolbar/Hide Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Enable or disable the main &digikam; tool bar.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Show Statusbar/Hide Statusbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Enable or disable the main &digikam; status bar.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts</guimenuitem>
</menuchoice></term>
<listitem><para><action>Configure the &digikam; shortcuts.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure Toolbars</guimenuitem>
</menuchoice></term>
<listitem><para><action>Configure the &digikam; tool bars.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure &digikam;</guimenuitem>
</menuchoice></term>
<listitem><para><action>Launch &digikam; configure dialog.</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
</sect1>
<!-- *********************************************************************** -->
<sect1>
<title>The Image Editor</title>
<sect2>
<title>The File Menu</title>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="press"><keycap>PgUp</keycap></keycombo> </shortcut>
<guimenu>File</guimenu><guimenuitem>Back</guimenuitem>
</menuchoice></term>
<listitem><para><action>Display the previous image of the current Album.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="press"><keycap>PgDown</keycap></keycombo> </shortcut>
<guimenu>File</guimenu><guimenuitem>Forward</guimenuitem>
</menuchoice></term>
<listitem><para><action>Display the next image of the current Album.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><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 Album.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><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 Album.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><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
Album.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><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 &digikam; Image Editor.</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- *********************************************************************** -->
<sect2>
<title>The Edit Menu</title>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><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 action="simul"><keycap>&Ctrl;</keycap><keycap>Z</keycap></keycombo> </shortcut>
<guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem>
</menuchoice></term>
<listitem><para><action>Cancel the last action applied to the current image using history.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><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>
<guimenu>Image</guimenu><guimenuitem>Apply Texture</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>
Image Editor 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>
Image Editor 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>
Image Editor 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>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>U</keycap></keycombo> </shortcut>
<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>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>B</keycap></keycombo> </shortcut>
<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>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>B</keycap></keycombo> </shortcut>
<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>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>I</keycap></keycombo> </shortcut>
<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>Depth</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggle between 8 bit and 16 bit format on color channels.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Color Management</guimenuitem>
</menuchoice></term>
<listitem><para><action>Invokes the interactive Color Management editor.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Levels
Adjust</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>White Balance</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>Colors</guimenuitem><guimenuitem>Curves
Adjust</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>
Image Editor 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>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>Inpainting</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>
Image Editor 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>Unsharp Mask</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>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>
<varlistentry>
<term><menuchoice>
<guimenu>Fix</guimenu><guimenuitem>Lens Distortion Correction</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>
Image Editor plugin to reduce artifacts 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>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>Anti Vignetting</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>
</variablelist>
</para>
</sect2>
<!-- *********************************************************************** -->
<sect2>
<title>The Transform Menu</title>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>&Shift;</keycap><keycap>9</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 action="simul"><keycap>&Shift;</keycap><keycap>8</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 action="simul"><keycap>&Shift;</keycap><keycap>7</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>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>*</keycap></keycombo> </shortcut>
<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>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>/</keycap></keycombo> </shortcut>
<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>
<shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>X</keycap></keycombo> </shortcut>
<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>Shear</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>Blowup</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor plugin to blow up (magnify) a photograph while minimizing image quality loss.
</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>Free Rotation</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>
Image Editor 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 action="simul"><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 action="simul"><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 action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>A</keycap></keycombo> </shortcut>
<guimenu>View</guimenu><guimenuitem>Zoom AutoFit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggle between zoom factor autofit to image edit window or 100% zoom window size.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu><guimenuitem>Histogram</guimenuitem>
</menuchoice></term>
<listitem><para><action>Display superposed histogram on current image (Luminosity, Red, Green, Blue, Alpha).</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu><guimenuitem>Slideshow</guimenuitem>
</menuchoice></term>
<listitem><para><action>Start a slideshow of the current album.</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- *********************************************************************** -->
<sect2 id="filters-menu"> <title>The Filters Menu</title>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Filters</guimenu><guimenuitem>Black and White</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open the Black and White filter dialog for the current image.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Filters</guimenu><guimenuitem>Raindrops</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>
Image Editor 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>
Image Editor 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>
Image Editor 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>
Image Editor 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>
Image Editor 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>
Image Editor 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>
Image Editor 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>
Image Editor 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>
Image Editor 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 action="simul"><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 Shortcuts</guimenuitem>
</menuchoice></term>
<listitem><para><action>Configure the &digikam; image editor shortcuts.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure Toolbars</guimenuitem>
</menuchoice></term>
<listitem><para><action>Configure the &digikam; image editor tool bars.</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- *********************************************************************** -->
<sect2>
<title>The Help Menu</title>
&help.menu.documentation;
<para>Additionally &digikam; 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 &digikam; 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 2001-2006, &digikam; 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_gmail_dot_com</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>
<listitem>
<para>
Ralf Hoelzer <email>kde_at_ralfhoelzer.com</email>:
Developer.
</para>
</listitem>
</itemizedlist>
</para>
<para>
Documentation copyrighted by:
<itemizedlist>
<listitem>
<para>
2001-2002
Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email>.
</para>
</listitem>
<listitem>
<para>
2002-2003
<itemizedlist>
<listitem><para>Gilles Caulier <email>caulier_dot_gilles_at_gmail_dot_com</email></para></listitem>
<listitem><para>Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email></para></listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para>
2003-2006
<itemizedlist>
<listitem><para>Gilles Caulier <email>caulier_dot_gilles_at_gmail_dot_com</email></para></listitem>
<listitem><para>Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email></para></listitem>
<listitem><para>Richard Taylor
<email>rjt-digicam_at_thegrindstone_dot_me_dot_uk</email></para></listitem>
<listitem><para>Ralf Hoelzer <email>kde_at_ralfhoelzer.com</email></para></listitem>
<listitem><para>Joern Ahrens <email>kde_at_jokele.de</email></para></listitem>
<listitem><para>Oliver Doerr <email>oliver_at_doerr-privat.de</email></para></listitem>
<listitem><para>Gerhard Kulzer <email>gerhard at kulzer.net</email></para></listitem>
</itemizedlist>
</para>
</listitem>
</itemizedlist>
All Pictures copyrighted 2003-2006 by Gilles Caulier <email>caulier_dot_gilles_at_gmail_dot_com</email>.
</para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;
&underGPL;
</chapter>
<appendix id="installation">
<title>Installation</title>
<sect1 id="getting-kapp">
<title>How to Obtain &digikam;</title>
<para>
The website for &digikam; is at <ulink url="http://www.digikam.org">http://www.digikam.org</ulink>. Please check it regularly to get the latest news about &digikam;. &digikam; 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> and <emphasis>kipi</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 &digikam;, 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>gphoto2 2.x</para></listitem>
<listitem><para>imlib2 >= 1.2.0</para></listitem>
<listitem><para>libgdbm >= 1.8.0</para></listitem>
<listitem><para>libkipi >= 0.1</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>
Gphoto2 can be obtained from <ulink url="http://www.gphoto.org">Gphoto Home Page</ulink>.
</para>
<para>
libkipi can be obtained from <ulink url="http://www.kipi-plugins.org">
http://www.kipi-plugins.org</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 &digikam; on your system, type the following in the base folder 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 libkipi/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 information bug report.
</para>
<para>
Because &digikam; depends on <emphasis>libkipi</emphasis> and <emphasis>libkexif</emphasis>, you must build these libraries before you build &digikam;.
</para>
</note>
<para>
Since &digikam; 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:
-->
