2
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.0//EN" "dtd/kdex.dtd" [
3
<!ENTITY kappname "&digikam;"><!-- replace kapp here, do *not* replace kappname-->
4
<!ENTITY % addindex "IGNORE">
5
<!ENTITY % English "INCLUDE"><!-- change language only here -->
6
<!ENTITY digikam '<application>digiKam</application>'>
8
<!-- Do not define any other entities; instead, use the entities
9
from kde-genent.entities and $LANG/user.entities. -->
12
<book lang="&language;">
16
<title>The &digikam; Handbook</title>
21
<firstname>Renchi</firstname><surname>Raju</surname>
22
<affiliation><address><email>renchi_at_pooh.tam.uiuc.edu</email></address></affiliation>
26
<firstname>Gilles</firstname><surname>Caulier</surname>
27
<affiliation><address><email>caulier_dot_gilles_at_free.fr</email></address></affiliation>
31
<firstname>Richard</firstname><surname>Taylor</surname>
32
<affiliation><address><email>rjt-digicam_at_thegrindstone_dot_me_dot_uk</email></address></affiliation>
36
<firstname>Ralf</firstname><surname>Hoelzer</surname>
37
<affiliation><address><email>kde_at_ralfhoelzer.com</email></address></affiliation>
41
<firstname>Joern</firstname><surname>Ahrens</surname>
42
<affiliation><address><email>kde_at_jokele.de</email></address></affiliation>
46
<firstname>Oliver</firstname><surname>Doerr</surname>
47
<affiliation><address><email>oliver_at_doerr-privat.de</email></address></affiliation>
51
<firstname>Gerhard</firstname><surname>Kulzer</surname>
52
<affiliation><address><email>gerhard at kulzer.net</email></address></affiliation>
57
<!-- TRANS:ROLES_OF_TRANSLATORS -->
62
<holder>The &digikam; developers team</holder>
65
<!-- Translators: put here the copyright notice of the translation -->
66
<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook
67
and in the FDL itself on how to use it. -->
68
<legalnotice>&FDLNotice;</legalnotice>
70
<date>2005-02-26</date>
71
<releaseinfo>0.7.2</releaseinfo>
78
<imageobject><imagedata fileref="digikamlogo.png" format="PNG"/></imageobject>
79
<textobject> <phrase>&digikam; logo</phrase> </textobject>
85
&digikam; is a KDE Photo Management Application with support for Digital Cameras.
91
<keyword>KDE</keyword>
92
<keyword>Digital Camera</keyword>
93
<keyword>digikam</keyword>
94
<keyword>gphoto</keyword>
95
<keyword>Graphics</keyword>
100
<!-- *********************************************************************** -->
102
<chapter id="introduction">
103
<title>Introduction</title>
105
<sect1 id="using-kapp-background">
106
<title>Background</title>
108
<sect2 id="using-kapp-about">
109
<title>About &digikam;</title>
112
&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.
116
An easy to use Camera interface is provided, that will connect to your digital camera and download photographs directly into &digikam; Albums.
119
<para>&digikam; incorporates a fast Image Editor with a few basic image editing tools. You can use the Image Editor to view your photographs, and make corrections and alterations.
125
<title>Reporting Bugs</title>
128
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.
132
&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.
137
<title>Support</title>
140
&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.
144
<ulink url="http://lists.sourceforge.net/lists/listinfo/digikam-users">&digikam; Users Mailing
145
List joining instructions.</ulink>
149
You can also visit the <ulink url="http://digikam.sourceforge.net">&digikam; Home Page.</ulink> for news of new releases and other &digikam; related information.
154
<title>Getting Involved</title>
157
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.
161
The best way to start getting involved with &digikam; is to join the Developers Mailing List.
162
<ulink url="http://lists.sourceforge.net/lists/listinfo/digikam-devel">&digikam; Developer Mailing
163
List joining instructions.</ulink>
169
<sect1 id="using-kapp-firstrun">
170
<title>Getting Started</title>
172
<anchor id="firstrundialog.anchor"/>
175
<title>The First Run Dialog</title>
176
<graphic srccredit="The First Run Dialog" fileref="firstrundialog.png"/>
180
When you start &digikam; for the very first time it will ask you where you want to store your photographs. You can type in the path name of a folder or click on the <guilabel>Folder</guilabel> icon
182
<imageobject><imagedata fileref="foldericon.png" format="PNG"/></imageobject>
183
<textobject> <phrase>Folder Icon</phrase> </textobject>
185
to select a folder from the dialog.
189
If you already have a collection of photographs on your hard disk, you can enter the top-level folder containing those photographs as 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.
193
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.
197
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 a 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.
201
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.
206
<sect1 id="using-kapp-fileformatsupport">
207
<title>Supported Image File Formats</title>
210
<title>Still Photograph Formats</title>
213
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. JPEG is a compressed format, that trades some of the image quality to keep file sizes small. TIFF is not a compressed format, it maintains higher image quality but at the expense of much larger file sizes. 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.
217
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 can save you disk space. Although your camera is unlikely to support PNG, some people like to convert their photographs to PNG as soon as they get them on their computer. Unlike JPEG, PNG images do not loose quality every time you re-encode them after alteration. &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;. For more information about the PNG format see the <ulink url="http://www.libpng.org/pub/png/">PNG homepage</ulink>.
221
Some, typically more expensive, cameras allow you to store images in RAW format. RAW format is not really an image standard at all. It is different for every make of camera. RAW format images contain all the data that is taken directly from the camera's image sensor before the software in the camera applies things like white balance, sharpening etc. Storing photographs in a camera's RAW format allows you to alter settings, such as white balance, after the photograph has been taken. Most professional photographers use RAW format, because it offers them maximum flexibility. The downside is that RAW image files can be very large indeed. If you want to learn more about RAW image format visit the very helpful guide <ulink url="http://www.luminous-landscape.com/tutorials/understanding-series/u-raw-files.shtml"> The Luminous Landscape</ulink>. You can convert RAW format images into JPEG or TIFF in &digikam; using the RAW Image Converter plugin. See the <link linkend="using-kapp-setup">Configuration</link> section for information about using plugins with &digikam;.
227
<title>Moving Image Formats</title>
230
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 manipulation 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.
235
<title>How &digikam; Supports File Formats</title>
238
&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;.
242
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 and TIFF will be available.
246
&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.
253
<sect1 id="using-kapp-pluginssupport">
254
<title>Supported Plugins</title>
257
One of the nicest things about &digikam; is how easily its functionality can be extended, by using plugins. Two plugin architectures are available:
261
<listitem><para><emphasis>Kipi Plugins</emphasis>: the <ulink url="http://extragear.kde.org/apps/kipi">Kde Image Plugins Interface project</ulink> is an effort to develop a common plugin structure for &digikam;, <application>KimDaBa</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="setupkipi">section</link>.</para></listitem>
263
<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> is dedicated to providing a collection of tools using this architecture. Image Editor Plugins setup is described in this <link linkend="setupeditor">section</link>.
268
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.
275
<!-- *********************************************************************** -->
277
<chapter id="using-kapp">
278
<title>Using &digikam;</title>
281
<sect1 id="using-kapp-mainwindow">
282
<title>The Main &digikam; Window</title>
284
<sect2 id="using-kapp-mainwindow-intro">
285
<title>Introduction to the Main Window</title>
290
<title>The Main Window</title>
291
<graphic srccredit="The Main Window" fileref="mainwindow.png"/>
294
&digikam;'s main window has three areas. The <guilabel>My Albums</guilabel> list in the top left, the <guilabel>My Tags</guilabel> list in the bottom left and the main Image Window on the right-hand side. You can use these three views to organize and find your photographs.
298
Across the top of the window is a Menu Bar and below it is the Tool Bar.
303
<imageobject><imagedata fileref="maintoolbar.png" format="PNG"/></imageobject>
304
<textobject> <phrase>The Default Main Toolbar</phrase> </textobject>
312
<listitem><para>(1) : Move one step backwards in the Album History.</para></listitem>
314
<listitem><para>(2) : Move one step forwards in the Album History.</para></listitem>
316
<listitem><para>(3) : New Album.</para></listitem>
318
<listitem><para>(4) : Add Images.</para></listitem>
320
<listitem><para>(5) : Edit Album Properties.</para></listitem>
322
<listitem><para>(6) : Open Image Editor.</para></listitem>
324
<listitem><para>(7) : Edit Image Comments and Tags.</para></listitem>
326
<listitem><para>(8) : Image Properties, Meta-Data, and Histogram.</para></listitem>
328
<listitem><para>(9) : Rename Image.</para></listitem>
330
<listitem><para>(10) : Increase Thumbnail Size.</para></listitem>
332
<listitem><para>(11) : Decrease Thumbnail Size.</para></listitem>
334
<listitem><para>(12) : Toggle Full Screen.</para></listitem>
342
<sect2 id="using-kapp-myalbumsview">
343
<title>"My Albums" View</title>
346
The "My Albums" list provides an organized view of your photograph albums. All photographs that are managed by &digikam; are stored in a single Album. These albums can be sorted by their Folder (directory) layout on the hard disk, by the Collection name that has been set in the Album Properties or by the Date that the Albums were first created (this date can also be changed in the Properties of each Album).
350
You can switch between these orderings using the drop-down list in the Tool Bar at the top of the window.
353
<sect3 id="using-kapp-createnewalbum">
354
<title>Creating a New Album</title>
357
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 <guilabel>New Album</guilabel> button on the Tool Bar. As an additional option, you can create a new Album by importing an existing folder (directory) of photographs from your hard disk, 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 directory icon, for example from a <application>Konqueror</application> 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;.
362
<sect3 id="using-kapp-deletealbum">
363
<title>Deleting an Album</title>
366
When you delete an Album from &digikam; it will be moved into the KDE Trash Can. As an option you could change this behaviour, 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.
371
<sect3 id="using-kapp-addphototoalbum">
372
<title>Adding a Photograph to an Album</title>
375
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 <application>Konqueror</application> window. Than drop it on the image list on the right hand side.
379
If you have a scanner configured you can also scan a photograph straight into an Album. Select
380
<menuchoice><guimenu>Album</guimenu>
381
<guimenuitem>Import</guimenuitem>
382
<guimenuitem>Scan Images</guimenuitem></menuchoice>.
383
You can also take a screenshot and add this directly to an Album. Select
384
<menuchoice><guimenu>Album</guimenu>
385
<guimenuitem>Import</guimenuitem>
386
<guimenuitem>Screenshot</guimenuitem></menuchoice>.
391
<sect3 id="using-kapp-movecopyitem">
392
<title>Moving or Copying Photographs Between Albums</title>
395
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.
400
<sect3 id="using-kapp-managealbums">
401
<title>Managing Albums</title>
403
<anchor id="albumpropsedit.anchor"/>
406
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.
410
The Album Properties dialog allows you to set:
413
<title>The Album Properties Dialog</title>
414
<graphic srccredit="The Main Window" fileref="albumproperties.png"/>
419
<listitem><para>The Album <guilabel>Title</guilabel> : this will be used in the "My Albums" list.
422
<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 list in the Tool Bar. If you want to add and delete Collection labels, use the <link linkend="setupcollection">Collection Settings</link> dialog.
425
<listitem><para>The <guilabel>Comments</guilabel> for the Album : this will be shown in the banner at the top of the main Image Window.
428
<listitem><para>The Album <guilabel>Date</guilabel> : this will be used when you order your Albums by date.
437
<sect3 id="using-kapp-setalbumicon">
438
<title>Setting the Album Icon</title>
441
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.
445
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.
450
<sect3 id="using-kapp-aboutcollections">
451
<title>Notes About Album Collections</title>
454
An Album can only be in one Album Collection and Album Collections can not be nested.
458
&digikam; also supports tagging individual photographs using the "My Tags" area at the bottom 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.
465
<sect2 id="using-kapp-imageview">
466
<title>Image View</title>
469
<title>Introduction</title>
472
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.
474
<imageobject><imagedata fileref="zoombuttons.png" format="PNG"/></imageobject>
475
<textobject> <phrase>The Thumbnail size buttons</phrase> </textobject>
480
The first time you select an Album you may have to wait briefly while the thumbnails are generated.
484
Information about each photograph is displayed below each thumbnail. You can control what information is displayed from the
486
<guimenu>Settings</guimenu>
487
<guimenuitem>Configure &digikam;</guimenuitem>
489
dialog. Select the Albums page and look for the <guilabel>Extra Information in Thumbnail View</guilabel> section.
493
The thumbnails have ToolTips which will pop up if you allow the mouse to dwell over a thumbnail for a moment. The ToolTip 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 ToolTip being displayed.
499
<title>Image Management</title>
502
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. The Image Editor lets you view your photographs and make a number of adjustments to them. You can access all of the functions that &digikam; can perform on a photograph by right-clicking the thumbnail or selecting from the Image menu in the Menu Bar.
507
<sect3 id="using-kapp-imageviewing">
508
<title>Viewing a Photograph</title>
511
You can open the Image Editor on a photograph either by double-clicking the thumbnail or by right-clicking and selecting <guilabel>View/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.
516
<sect3 id="using-kapp-externalapp">
517
<title>Viewing or Editing a Photograph With Another Application</title>
520
Sometimes &digikam; may not provide all of the capabilities that 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 in the KDE manual for instructions on changing these file associations if the application that you need is not listed.
524
Note that there can be a problem with meta-data embedded in photographs when they are edited by some 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 loose information such as orientation, aperture etc.
529
<sect3 id="using-kapp-rotateimage">
530
<title>Rotating a Photograph</title>
533
You will need to have the Kipi JPEG Lossless Plugin installed for these 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. The rotation methods described here use the Kipi JPEG Lossless Plugin and do not loose any quality in the original photograph.
537
&digikam; provides two ways to get your photographs the right way up. The simplest method is to right-click the thumbnail and select Rotate and then pick the correct amount of rotation needed.
541
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.
545
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 <guilabel>Auto Rotate/Flip Using EXIF Information</guilabel>. 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.
550
<sect3 id="using-kapp-imagemetadata">
551
<title>Photograph Meta-Data, Properties and Histogram</title>
553
<sect4 id="using-kapp-tagscommentsedit">
554
<title>Editing Tags and Comments</title>
556
<anchor id="tagscommentsedit.anchor"/>
559
&digikam; lets you view quite a lot of meta-data about your photographs. Meta-data is any information about a photograph that is not part of the image itself, for example, the date the photograph was taken is meta-data about the photograph.
563
Some meta-data is attached to photographs by the camera that took the picture. This camera meta-data is stored inside the image file and is called EXIF data. To view this information right-click on a thumbnail and select <guilabel>Properties</guilabel> from the context menu.
567
Other meta-data is associated with a photograph by &digikam; itself. Comments and Tags are meta-data that &digikam; manages for your photographs. You can edit the Comments and Tags for a photograph by right-clicking a thumbnail and selecting <guilabel>Edit Comments and Tags</guilabel>.
571
Unless you have a good reason for placing comments in the JPEG COM field of your images it is probably best to use the main Comments/Tags dialog for adding comments to your photographs. Unfortunately there is no standard where to place a comment. Some applications use the JPEG COM section, but this only works for JPEG images. Other applications store comments in the EXIF field, which is limited to JPEG and TIFF images. &digikam; stores comments in its internal database, so that all image and video formats can be handled the same way.
575
<title>The Item Comments and Tags Dialog</title>
576
<graphic srccredit="The Item Comments and Tags Dialog" fileref="commentstags.png"/>
580
Editing comments can be a tedious activity. The Comments/Tags dialog makes it easier by allowing you to move between photographs without having to select each in turn. To use this feature, open the Commands/Tags dialog on the first photograph you want to comment on and then use the <guilabel>Forward</guilabel> and <guilabel>Back</guilabel> buttons to move between each photograph.
585
<sect4 id="using-kapp-propertiesmetadatahistogram">
586
<title>Displaying Properties, embedded Meta-Data, and Histogram</title>
588
<anchor id="propertiesmetadatahistogram.anchor"/>
591
There is one more set of embedded meta-data that &digikam; can access from a photograph. This can be accessed by right-clicking on a photograph and selecting <guilabel>Properties</guilabel> from the context menu.
595
This dialog will tell you general informations about current image like how large the photograph is and were it is stored on the hard disk.
599
<title>The Image Properties Dialog with General Tab</title>
600
<graphic srccredit="The Image Properties Dialog with General Tab"
601
fileref="imageproperties3.png"/>
605
This dialog will show you the same EXIF information provided in the EXIF Viewer dialog described in the <link linkend="using-kapp-exifviewertool"> EXIF Viewer section</link>.
609
<title>The Image Properties Dialog with EXIF Viewer in Action</title>
610
<graphic srccredit="The Image Properties Dialog with EXIF Viewer in Action"
611
fileref="imageproperties2.png"/>
615
This dialog will show you the full image histograms. You can find more informations about histograms in the <link linkend="using-kapp-histogramviewer">Histogram Viewer</link> section.
619
<title>The Image Properties Dialog with Histogram Viewer in Action</title>
620
<graphic srccredit="The Image Properties Dialog with Histogram Viewer in Action"
621
fileref="imageproperties.png"/>
625
Quite like within the Edit Comments and Tags dialog, you can move between photographs without having to select each in turn. Use the <guilabel>Forward</guilabel> and <guilabel>Back</guilabel> buttons to move between each photograph.
632
<sect3 id="using-kapp-renameimage">
633
<title>Renaming a Photograph</title>
636
You can change the filename for a photograph by right-clicking a thumbnail and selecting <guilabel>Rename</guilabel>. Remember to keep the file extension (.jpg, .tif, etc.).
641
<sect3 id="using-kapp-deleteimage">
642
<title>Deleting a Photograph</title>
645
When you delete a photograph from &digikam; it will be moved to the KDE Trash Can. If you prefer that Delete really removes the photograph completely, than you can set this option by selecting
646
<menuchoice><guimenu>Settings</guimenu>
647
<guimenuitem>Configure &digikam;</guimenuitem></menuchoice>
648
and selecting the <guilabel>Miscellaneous</guilabel> page. At the top of that page are the settings that control what happens when a photograph is deleted.
652
To delete a photograph right-click the thumbnail and select <guilabel>Delete</guilabel> from the context menu.
659
<sect2 id="using-kapp-mytagsview">
660
<title>"My Tags" View</title>
663
Photograph tagging provides a flexible and powerful way to organize and catalog your photographs. Tags are labels that can be applied to individual photographs. Once a Tag has been set to a photograph, that photograph can be found again by selecting the Tag.
667
<title>Selecting a Tag</title>
668
<graphic srccredit="Selecting a Tag" fileref="tagsview.png"/>
672
When a Tag is selected, all of the photographs that are marked with that Tag are displayed.
676
Tags can be arranged into 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.
680
By default, when you select a Tag in the tree that contains other sub-Tags, &digikam; will not display photographs that are labeled with the sub-Tags. You can change this behaviour, if you prefer that all photographs marked with a sub-Tag of the current Tag should be displayed. To set this option open
681
<menuchoice><guimenu>Settings</guimenu>
682
<guimenuitem>Configure &digikam;</guimenuitem></menuchoice>
683
from the main Menu Bar, select the <guilabel>Albums</guilabel> page and then
684
select <guilabel>Show Items in sub-Tags</guilabel>.
687
<sect3 id="using-kapp-managetags">
688
<title>Managing Tags</title>
691
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.
695
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 that are marked with that Tag are not deleted. Simply the Tag is removed from those photographs.
699
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
700
<guilabel>Move</guilabel> the Tag. A Tag can only be in one place in the tree at a time.
704
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.
709
<sect3 id="using-kapp-taggingimages">
710
<title>Tagging Photographs</title>
713
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.
717
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.
721
<title>Tagging Image with Main Pop-up Menu</title>
722
<graphic srccredit="Tagging Image with Main Pop-up Menu" fileref="assigntags.png"/>
726
Once you have tagged a photograph, the Tag name will appear under the thumbnail in the Image Window.
730
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.
739
<sect1 id="using-kapp-camera">
740
<title>Using a Digital Camera With &digikam;</title>
741
<anchor id="camerainterface.anchor"/>
744
<title>Introduction to Camera Interface</title>
747
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="setupcamera">Setup Camera Section</link> of the manual for instructions on how to setup &digikam; to work with your Camera.
751
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 in on your hard disk.
755
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.
759
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 "Ready" indicator will appear 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 icon for each photograph.
763
<title>The Camera Client Window</title>
764
<graphic srccredit="The Camera Client Window" fileref="cameraclient.png"/>
770
<title>Downloading Photographs</title>
773
The simplest way to download the photographs 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.
777
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.
783
<title>Selecting a Target Album</title>
784
<anchor id="targetalbumdialog.anchor"/>
787
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.
791
<title>The Target Album Selection Dialog</title>
792
<graphic srccredit="The Target Album Selection Dialog" fileref="targetalbumdialog.png"/>
796
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.
800
When you have selected the target Album, click OK and &digikam; will download the photographs from the camera to that album.
804
<title>The Downloading from Camera in Progress</title>
805
<graphic srccredit="The Downloading from Camera in Progress" fileref="cameraclientdownload.png"/>
811
<title>Deleting Photographs from the Cameras</title>
814
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
816
<guimenu>Delete</guimenu>
817
<guimenuitem>Delete All</guimenuitem>
819
button. If you just want to delete a selection of the photographs, you have to select those that you want to delete and click
820
<menuchoice><guimenu>Delete</guimenu>
821
<guimenuitem>Delete Selected</guimenuitem></menuchoice>
825
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.
831
<title>Automatic Renaming </title>
834
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 shoots into the same Album. It can also be useful to include the date and time that a photograph was taken in the filename.
838
<title>The Camera Interface Advanced Options</title>
839
<graphic srccredit="The Camera Interface Advanced Options" fileref="cameraclientadvanced.png"/>
843
&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>Advance</guilabel> button on the Camera Interface. The Camera Interface window will expand to reveal some extra features. Select <guilabel>Customize Names</guilabel> and then enter any filename prefix you would like. Then, optionally, add the date and time and an a sequence number. The sequence number may be needed if you have a camera with a very fast multi-shot mode. With this mode, it is possible to get two photographs with exactly the same data and time.
847
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.
853
<title>Camera Information Based Operations</title>
856
<title>Automatic Rotation</title>
859
&digikam; can use any information about the orientation of the camera in the moment the photograph was taken for automatically rotation of the photograph when it is downloaded. Not all cameras include this informations. See the <link linkend="using-kapp-imagemetadata">Photograph Meta-Data, Properties and Histogram</link> section for more detail about informations that your camera may have embedded in your photographs.
863
This automatic rotation is switched on by default, and if your camera does not include the information, &digikam; will leave the photograph in 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.
869
<title>Automatic Destination Albums Creation</title>
872
If your camera provide information about the date when a photograph is taken &digikam; can use
873
this to automatically create sub-albums in the destination Album when it is downloaded.
874
Sub-albums names will be based on image dates. All images who have the same date will be
875
downloaded on the same sub-album. Not all cameras include this information.
876
See the <link linkend="using-kapp-imagemetadata">
877
Photograph Meta-Data, Properties and Histogram</link> section for more detail about
878
information your camera may have embedded in your photographs.
882
This option is switched off by default and in this case &digikam; will download the photographs
883
in the root destination Albums. If you would like to switch on this option click the
884
<guilabel>Advanced</guilabel> button and select the <guilabel>Download photo in automatically</guilabel>
885
option at the bottom of the window.
894
<sect1 id="using-kapp-imageeditor">
895
<title>&digikam; Image Editor</title>
896
<anchor id="imageeditor.anchor"/>
899
<title>Introduction to Image Editor</title>
902
&digikam; incorporates a fast Image Editor with a few basic 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 double 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.
906
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="setupeditor">Setup Image Editor Section</link> for more details about &digikam; Image Editor plugins.
910
<title>The Image Editor Window</title>
911
<graphic srccredit="The image editor window" fileref="imageeditor.png"/>
915
The image editor has just one main window with:
920
A status at the bottom which shows the filename, the current file number, the current zoom level, and the current image size.
924
A Menu Bar across the top and below that a Tool Bar that provides quick access to some commonly used functions.
932
<imageobject><imagedata fileref="imageeditortoolbar.png" format="PNG"/></imageobject>
933
<textobject> <phrase>The Image Editor Toolbar</phrase> </textobject>
941
<listitem><para>(1) : First Current Album Image.</para></listitem>
943
<listitem><para>(2) : Previous Image.</para></listitem>
945
<listitem><para>(3) : Next Image.</para></listitem>
947
<listitem><para>(4) : Last Current Album Image.</para></listitem>
949
<listitem><para>(5) : Save the modified image.</para></listitem>
951
<listitem><para>(6) : Undoing last action.</para></listitem>
953
<listitem><para>(7) : Restore the Current Image From Disk.</para></listitem>
955
<listitem><para>(8) : Zoom Into the Image.</para></listitem>
957
<listitem><para>(9) : Zoom Out of the Image.</para></listitem>
959
<listitem><para>(10) : Toggle Auto Zooming (if selected image will fit in the window).</para></listitem>
961
<listitem><para>(11) : Rotate the Current Image.</para></listitem>
963
<listitem><para>(12) : Crop Image to the Selected Region.</para></listitem>
972
<title>Restoring Your Original Photograph</title>
975
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
976
<menuchoice><guimenu>File</guimenu>
977
<guimenuitem>Save</guimenuitem></menuchoice>
978
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.
982
You might prefer to take a copy of your photograph before you make any changes. You can use
983
<menuchoice><guimenu>File</guimenu>
984
<guimenuitem>Save As</guimenuitem></menuchoice>
985
to save a working copy.
989
At any time <emphasis>before</emphasis> you save your photograph you can restore the view to the original image by selecting
990
<menuchoice><guimenu>File</guimenu>
991
<guimenuitem>Revert</guimenuitem></menuchoice>
994
<imageobject><imagedata fileref="revertbutton.png" format="PNG"/></imageobject>
995
<textobject><phrase>The Image Editor Revert Button</phrase></textobject>
997
<guilabel>Revert</guilabel> button on the Tool Bar. You will loose any changes that you have made to the photograph since it was last saved.
1003
<title>Undoing Actions</title>
1006
Almost anything you do to an image in Image Editor can be undone. You can undo the most recent action by choosing <menuchoice><guimenu>Edit</guimenu><guimenuitem>Cancel</guimenuitem></menuchoice>, but this is done so frequently that you really should memorize the keyboard shortcut, <guilabel>Ctrl-Z</guilabel>.
1010
The undo-stack design is very simple: actions are either reversible (rotate,flip) or irreversible (rest of the actions and all of the plugin actions). The reversible undos are implemented by just saving the commands and for the irreversible undos image copies are stored in plain binary cache files.
1016
<title>Moving Between Photographs</title>
1019
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.
1025
<title>Changing the View</title>
1028
You can zoom in and out of a photograph using the
1030
<imageobject><imagedata fileref="zoombuttons.png" format="PNG"/></imageobject>
1031
<textobject> <phrase>The Image Editor Zoom Buttons</phrase> </textobject>
1032
</inlinemediaobject> buttons on the Tool Bar or the entries in the View menu.
1033
To make a photograph fit into the window use the <guilabel>Zoom Autofit</guilabel>
1035
<imageobject><imagedata fileref="editorautosizebutton.png" format="PNG"/></imageobject>
1036
<textobject> <phrase>The Image Editor AutoFit Button</phrase> </textobject>
1037
</inlinemediaobject>
1038
button on the Tool Bar.
1042
<menuchoice><guimenu>View</guimenu>
1043
<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="setupeditor">Setup Image Editor Section</link>.
1049
<title>Image Properties</title>
1051
<sect3 id="using-kapp-commentsedittool">
1052
<title>Comments Editing Tool</title>
1054
<anchor id="commentsedittool.anchor"/>
1057
You can view some of the properties of your photograph by selecting the options in the <guilabel>Image</guilabel> menu.
1058
You can edit the comments set for this photograph using <menuchoice><guimenu>Image</guimenu><guimenuitem>Edit Comments and Tags</guimenuitem></menuchoice>. The new Comments and Tags will be remembered when you close the photograph, even if you do not save the photograph first. For more informations about Comments and Tags dialog, please see <link linkend="using-kapp-tagscommentsedit">Editing Tags and Comments</link> section.
1063
<sect3 id="using-kapp-exifviewertool">
1064
<title>EXIF Viewer Tool</title>
1066
<anchor id="kexif.anchor"/>
1069
<title>What is EXIF?</title>
1072
EXIF stands for <emphasis>EXtended Interchange Format</emphasis>. It was designed specifically for digital cameras. It allows a large amount of information about the photograph to be stored. Those informations are describing the camera which took the image along with the settings (including date and time) in use when the picture was taken. Also it allows an inline thumbnail to be included. See the <link linkend="using-kapp-imagemetadata">Photograph Meta-Data and Properties</link> section for more detail about information embedded data in your photographs.
1076
EXIF format contains different marker sections named <emphasis>Image File Directories</emphasis> (IFD). The sections likely to be found in a normal EXIF file are as follows:
1081
<guilabel>0</guilabel>: contains general information about the photograph.
1085
<guilabel>1</guilabel>: contains information about the embedded thumbnail image.
1089
<guilabel>EXIF</guilabel>: contains extended information about the photograph.
1093
<guilabel>GPS</guilabel>: contains Global Positioning System information provides by the camera during the capture.
1097
<guilabel>Interoperability</guilabel>: contains information to support interoperability between different EXIF implementations.
1101
<guilabel>Thumbnail</guilabel>: displays the embedded thumbnail image.
1111
<title>How to Use EXIF Viewer?</title>
1114
You can review embedded EXIF information for the image using
1115
<menuchoice><guimenu>Image</guimenu>
1116
<guimenuitem>Properties</guimenuitem></menuchoice> and <guilabel>EXIF</guilabel> page.
1117
The EXIF Viewer is purely informational: nothing you do with it will cause any change to the EXIF sections.
1121
<title>The EXIF Viewer in Action</title>
1122
<graphic srccredit="The EXIF Viewer in Action" fileref="exifviewer.png"/>
1127
You can use two different levels to display EXIF marker sections:
1132
<guilabel>Simple</guilabel>: display only EXIF marker.
1136
<guilabel>Full</guilabel>: display all markers excepted thumbnails.
1141
Some vendors add additional EXIF sections, such as Canon, Fujifilm, Nikon, and Sigma. These sections contain vendor and model specific notes. These will be displayed with
1142
<guilabel>Full</guilabel> level.
1146
For the EXIF data displayed, EXIF Viewer provides a contextual help. Select an item on the top and the corresponding help can be displayed with the "What's This?" option of the dialog.
1153
<sect3 id="using-kapp-filepropertiestool">
1154
<title>File Properties Tool</title>
1156
<anchor id="filepropertiestool.anchor"/>
1159
You can view the file properties using
1160
<menuchoice><guimenu>Image</guimenu>
1161
<guimenuitem>Properties</guimenuitem></menuchoice> and <guilabel>General</guilabel> page.
1162
This page allow you to see a large image thumbnail, general image and file system informations, and the &digikam; Meta-Data.
1167
<sect3 id="using-kapp-histogramviewer">
1168
<title>Histogram Viewer</title>
1170
<anchor id="histogramviewer.anchor"/>
1173
If you are interested in the detailed histogram of your photograph you can view it using
1174
<menuchoice><guimenu>Image</guimenu>
1175
<guimenuitem>Properties</guimenuitem></menuchoice> and <guilabel>Histogram</guilabel> page.
1176
The histogram for a image shows the amount of each colour that is present and their different amplitudes within the image. If your photograph has a colour cast you might be able to see what is wrong by looking at the histogram.
1180
The Histogram Viewer shows you informations about the statistical distribution of color values in the current image. It is purely informational: nothing you do with it will cause any change to the image. If you want to perform a histogram-based color correction, use the Adjust Levels Image Editor plugin. This plugin is part of the <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins project</ulink>. For more information about using Plugins in &digikam; see the <link linkend="using-kapp-setup">Configuration</link> section.
1184
<title>The Histogram Viewer in Action</title>
1185
<graphic srccredit="The Histogram Viewer in Action" fileref="histogramimageplugin.png"/>
1189
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.
1193
The Histogram Viewer allows you to view each channel separately:
1198
<guilabel>Intensity</guilabel>: shows the distribution of brightness values.
1202
<guilabel>Red</guilabel>, <guilabel>Green</guilabel>, <guilabel>Blue</guilabel>: show the distribution of intensity levels for the Red, Green, or Blue channels respectively.
1206
<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.
1210
<guilabel>Colors</guilabel>: shows the <guilabel>Red</guilabel>, <guilabel>Green</guilabel>, and <guilabel>Blue</guilabel> histograms superimposed, so that you can see all of the color distribution information in a single view. In this mode, the histogram foreground color can be choose with
1211
<guilabel>Color</guilabel> option.
1219
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.
1223
With <guilabel>Scale</guilabel> option, you can change whether the histogram will be displayed using a linear or logarithmic Y axis. For images taken with a digital camera, the <guilabel>Linear</guilabel> mode is usually the most useful. However, for images that contain substantial areas of constant color a <guilabel>Linear</guilabel> histogram will often be dominated by a single bar. In this case a <guilabel>Logarithmic</guilabel> histogram will be more useful.
1227
You can restrict the analysis, for the <guilabel>Statistics</guilabel> shown at the bottom of the dialog, to a limited range of values if you wish. You can set the range in one of two ways:
1232
Click and drag the pointer across the histogram display area, from the lowest level to the highest level of the range you want.
1236
Use the spin button entries below the histogram area. Left entry is bottom of range and right entry is top of range.
1244
At the bottom of the Histogram Viewer are shown statistics describing the distribution of channel values, restricted to the selected range. These are:
1253
The standard deviation.
1257
The median of the selected histogram portion.
1261
The number of pixels in the image.
1265
The number whose values fall within the selected range.
1269
The percentage whose values fall within the selected range.
1274
With <guilabel>Colors</guilabel> channel mode, this informations are updated with the foreground color selected with <guilabel>Color</guilabel> option.
1279
<sect3 id="using-kapp-usinghistogram">
1280
<title>How To Use a Histogram</title>
1283
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:
1288
(1) : the shadows-tone on the left.
1292
(2) : the middle-tone on the middle.
1296
(3) : the highlights-tone on the right.
1302
<title>The Histogram Description</title>
1303
<graphic srccredit="The Histogram Description" fileref="histogramdescription.png"/>
1306
The distribution of the graph, where the spikes and bulges are clustered, indicates whether the image is too dark, too bright, or well-balanced.
1312
With an under exposed photograph, the histogram will have a distribution of brightness that tends to be mostly on the left of the graph.
1315
<title>An Over Exposed Photograph</title>
1316
<graphic srccredit="An Over Exposed Photograph" fileref="histogramsample1.png"/>
1319
With a correctly exposed photograph, the histogram will have a distribution of brightness that will be most prominent near the centre part of the graph.
1322
<title>A Correctly Exposed Photograph</title>
1323
<graphic srccredit="A Correctly Exposed Photograph" fileref="histogramsample2.png"/>
1326
With an over exposed photograph, the histogram will have the bulge showing the brightness distributed mostly towards the right of the graph.
1329
<title>An Under Exposed Photograph</title>
1330
<graphic srccredit="An Under Exposed Photograph" fileref="histogramsample3.png"/>
1336
Important: not all photographs have to exhibit this bulge in the centre part of their histogram. Much depends on the subject of the photograph. In some cases, it might be appropriate for the histogram to show a peak at one end or the other, or both.
1340
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>
1341
should be used to fix the photograph.
1348
<sect2 id="using-kapp-adjustingimage">
1349
<title>Adjusting a Photograph</title>
1351
<sect3 id="using-kapp-croppingimage">
1352
<title>Cropping a Photograph</title>
1354
<sect4 id="using-kapp-manualcrop">
1355
<title>Manual Crop</title>
1358
Cropping a photograph is a common operation and the Image Editor makes it very easy. To crop a photograph simple drag a rectangle over the image by holding down the left mouse button and moving the mouse. You will see a wire frame rectangle appear as you move the mouse.
1362
<title>The Current Image Selection in Image Editor</title>
1363
<graphic srccredit="The Current Image Selection in Image Editor"
1364
fileref="editorimageselection.png"/>
1368
When you release the button the area of the photograph that will be removed by a crop operation is darkened. This allows you to get a good view of how your photograph will look once you have cropped it. You can change the size if the cropped area by dragging the corners of the rectangle and you can create a new crop area simply by dragging out another rectangle.
1372
Once you are happy with the crop, click on the
1374
<imageobject><imagedata fileref="editorcropbutton.png" format="PNG"/></imageobject>
1375
<textobject> <phrase>The Image Editor Crop Button</phrase> </textobject>
1376
</inlinemediaobject>
1377
button on the Tool Bar and the photograph will be cropped. Use the
1378
<menuchoice><guimenu>File</guimenu>
1379
<guimenuitem>Save</guimenuitem></menuchoice> or
1380
<menuchoice><guimenu>File</guimenu>
1381
<guimenuitem>Save As</guimenuitem></menuchoice>
1382
entries in the File menu to safe the newly cropped photograph.
1387
<sect4 id="using-kapp-proportionalcrop">
1388
<title>Proportional Crop</title>
1390
<anchor id="ratiocroptool.anchor"/>
1393
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. 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).
1397
<title>The Aspect Ratio Crop Tool in Action</title>
1398
<graphic srccredit="The Aspect Ratio Crop Tool in Action"
1399
fileref="editorratiocroptool.png"/>
1403
The preview area lets you draw the cropping rectangle around the part you wish to use. It will keep the ratio value set in the bottom of dialog. You can always resize and move it with the mouse, it will keep the same ratio.
1407
In 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 number assigned to the <guilabel>Height</guilabel> and Landscape to the <guilabel>Width</guilabel>.
1411
Aspect Ratio Crop tool uses a relative ratio. That means it is the same if you use centimeters or inches and it doesn't specify the physical size. For example, you can see below a correspondance list of traditional photographic paper sizes and aspect ratio crop.
1414
<informaltable><tgroup cols="2">
1417
<entry>Standard Photograph Paper Size</entry>
1418
<entry>Aspect Ratio Crop</entry>
1424
10x15cms 20x30cms 30x45cms
1425
3.5x5" 4x6" 8x12" 12x18" 16x24" 20x30"
1435
6x8cms 15x20cms 18x24cms 30x40cms
1436
3.75x5" 4.5x6" 6x8" 7.5x10" 9x12"
1446
20x25cms 40x50cms
1457
15x21cms 30x42cms
1468
21x30cms 42x60cms
1478
</tgroup></informaltable>
1481
<guilabel>Show Rule of Thirds Lines</guilabel> line option is a guiding element to better compose your images. This guide is 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 used, often 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.
1485
<title>Photograph Composition Example Using Rule Third Lines</title>
1486
<graphic srccredit="Photograph Composition Example Using Rule Third Lines Example"
1487
fileref="rulethirdlinesexample.png"/>
1491
When first looking at an image, the eye of the viewer rarely settles at the centre of the image, but instead from the top left to right, and then to the lower left and 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.
1495
On the bottom of the dialog, the <guilabel>Max. Ratio</guilabel> button lets you set the selection area size to the maximum, accordingly with the current aspect ratio settings an orientation.
1502
<sect3 id="using-kapp-resizingimage">
1503
<title>Resizing a Photograph</title>
1505
<anchor id="resizetool.anchor"/>
1508
If the photograph has the wrong size you can scale it to the size you would like by using Transform Resize tool. Select
1509
<menuchoice><guimenu>Transform</guimenu>
1510
<guimenuitem>Resize</guimenuitem></menuchoice> and adjust the target values. The Resize tool dialog is available below.
1514
<title>The Resize Tool Dialog</title>
1515
<graphic srccredit="The Resize Tool Dialog" fileref="editorresizetool.png"/>
1520
<sect3 id="using-kapp-rotatingflippingimage">
1521
<title>Rotating or Flipping a Photograph</title>
1524
If the photograph is the wrong orientate you can <guilabel>Flip</guilabel> or <guilabel>Rotate</guilabel> it to the correct orientation you would like by using Transform Flip/Rotate tools available in
1525
<menuchoice><guimenu>Transform</guimenu>
1526
<guimenuitem>Rotate</guimenuitem></menuchoice>
1528
<menuchoice><guimenu>Transform</guimenu>
1529
<guimenuitem>Flip</guimenuitem></menuchoice>
1534
With flipping options, you can flip, turn over, the image horizontally or vertically like a card. With rotating options, you can rotate the image 90 degrees clockwise or counter-clockwise or by 180 degrees. Can be used to change mode to Portrait or Landscape. You can rotate more progressively by using the Free Rotation tool. It is a plug-in
1535
available from <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins
1536
project</ulink>, and you can access it by the
1537
<menuchoice><guimenu>Transform</guimenu>
1538
<guimenuitem>Free Rotation</guimenuitem></menuchoice> menu entry.
1539
See the dedicated <ulink url="help:/digikamimageplugins/freerotation.html">Free Rotation manual</ulink> for more information.
1544
<sect3 id="using-kapp-redeyecorrection">
1545
<title>Fix Red Eye in a Photograph</title>
1547
<anchor id="redeyecorrectiontool.anchor"/>
1550
Red Eye is caused when flash photography is used to take photographs of people. The red is the reflection from the back the eye which can be seen because the pupil can not react quickly enough to the flash. You can correct some of the worst effect of Red Eye by selecting the area of the eye on the photograph, in the same way as described for cropping above. Then select
1551
<menuchoice><guimenu>Fix</guimenu>
1552
<guimenuitem>Red Eye Reduction</guimenuitem></menuchoice>.
1556
<title>The Red Eyes Correction Tool in Action</title>
1557
<graphic srccredit="The Red Eyes Correction Tool in Action"
1558
fileref="editorredeyescorrection.png"/>
1565
<sect2 id="using-kapp-adjustsharpness">
1566
<title>Adjusting Sharpness</title>
1568
<anchor id="blursharpentool.anchor"/>
1571
<title>Unblurring a Photograph</title>
1574
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.
1578
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>
1579
<guimenuitem>Sharpen</guimenuitem></menuchoice> menu entry.
1583
<title>The Sharpen Tool in Action</title>
1584
<graphic srccredit="The Sharpen Tool in Action" fileref="editorsharpenplugin.png"/>
1588
You should be careful with this though, or the results will not look very natural: sharpening increases the apparent sharpness of edges in the photograph, but also amplifies noise. The generally most useful technique for sharpening a fuzzy photograph is called the Unsharp Mask. It is a plug-in available from <ulink url="http://extragear.kde.org/apps/digikamimageplugins">DigikamImagePlugins project</ulink>, and you can access it by the
1589
<menuchoice><guimenu>Fix</guimenu>
1590
<guimenuitem>Unsharp Mask</guimenuitem></menuchoice> menu entry.
1591
See the dedicated <ulink url="help:/digikamimageplugins/unsharp.html">Unsharp Mask
1592
manual</ulink> for more information.
1595
<title>The Unsharp Mask Image Editor Plugin in Action</title>
1596
<graphic srccredit="The Unsharp Mask Image Editor Plugin in Action"
1597
fileref="editorUnsharpmaskplugin.png"/>
1605
<title>Reducing Graininess In a Photograph</title>
1608
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
1609
<menuchoice><guimenu>Fix</guimenu>
1610
<guimenuitem>Noise Reduction</guimenuitem></menuchoice> menu entry.
1611
See the dedicated <ulink url="help:/digikamimageplugins/despeckle.html">Noise Reduction manual</ulink> for more information.
1615
<title>The Noise Reduction Image Editor Plugin in Action</title>
1616
<graphic srccredit="The Noise Reduction Image Editor Plugin in Action"
1617
fileref="editornoisereductionplugin.png"/>
1623
<title>Softening a Photograph</title>
1625
Sometimes you have the opposite problem: an image is too crisp. The solution is to blur it a bit: fortunately blurring an image is much easier than sharpening it. Select the Blur Tool, by the <menuchoice><guimenu>Fix</guimenu><guimenuitem>Blur</guimenuitem></menuchoice> menu entry and experiment with the level. The preview windows on the right of the dialogs show the effect of the operation of your photograph.
1629
<title>The Blur Tool in Action</title>
1630
<graphic srccredit="The Blur Tool in Action"
1631
fileref="editorblurplugin.png"/>
1638
<sect2 id="using-kapp-correctingcolor">
1639
<title>Correcting Colour</title>
1641
<anchor id="colorbalancetool.anchor"/>
1644
Digital cameras often have problems with lighting conditions and it is not unusual to want to correct the colour, contrast and brightness of a photograph. You can experiment with altering the levels of different aspects of your photographs using the tools under the
1645
<menuchoice><guimenu>Fix</guimenu>
1646
<guimenuitem>Colors</guimenuitem></menuchoice> menu.
1647
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.
1651
<title>The Color Balance Tool in Action</title>
1652
<graphic srccredit="The Color Balance Tool in Action" fileref="editorcolorbalance.png"/>
1655
<anchor id="hsladjusttool.anchor"/>
1658
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).
1662
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.
1666
<title>The Hue Saturation Lightness Tool in Action</title>
1667
<graphic srccredit="The Hue Saturation Lightness Tool in Action" fileref="editorhsladjust.png"/>
1671
The <guilabel>Normalize</guilabel>, <guilabel>Equalize</guilabel>, <guilabel>Auto Levels</guilabel>, and <guilabel>Stretch Contrast</guilabel> functions under the <guilabel>Fix</guilabel> 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.
1676
<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.
1678
<graphic srccredit="Normalize Colors Correction Preview" fileref="normalizepreview.png"/>
1683
<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.
1685
<graphic srccredit="Equalize Colors Correction Preview" fileref="equalizepreview.png"/>
1690
<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.
1692
<graphic srccredit="Auto Levels Correction Preview" fileref="autolevelspreview.png"/>
1697
<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.
1699
<graphic srccredit="Stretch Contrast Correction Preview" fileref="stretchcontrastpreview.png"/>
1708
The results of any adjustments you make will not be remembered until you save your photograph.
1712
<sect2 id="using-kapp-correctingexposure">
1713
<title>Correcting Exposure</title>
1715
<anchor id="bcgadjusttool.anchor"/>
1718
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.
1722
<title>The Brightness Contrast Gamma Tool in Action</title>
1723
<graphic srccredit="The Brightness Contrast Gamma Tool in Action" fileref="editorbcgadjust.png"/>
1727
If you have the Adjust Levels plugin installed (see the <link linkend="setupeditor">Setup Image Editor Section</link>) you will have additional entry in the Fix menu called
1728
<menuchoice><guimenu>Fix</guimenu>
1729
<guimenuitem>Colors</guimenuitem>
1730
<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.
1733
<title>The Adjust Levels Image Editor Plugin in Action</title>
1734
<graphic srccredit="The Adjust Levels Image Editor Plugin in Action"
1735
fileref="editoradjustlevels.png"/>
1741
A very powerful way of correcting exposure problems is to use the Adjust Curves plugin available by <menuchoice><guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem>
1742
<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.
1744
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 digiKam Adjust Curves to do just the same!
1747
<title>The Adjust Curves Image Editor Plugin in Action</title>
1748
<graphic srccredit="The Adjust Curves Image Editor Plugin in Action"
1749
fileref="editoradjustcurves.png"/>
1757
<title>Special Effects and Filters</title>
1760
By default &digikam; provides a couple of simple toning filters that you can use on your photographs. Under the Filters menu you will find classic Black and White chemical toning used in analog photography. Color toning changes the monochromatic tint of a basically black and white photograph. When applied it gives the picture a warm, antique feeling. Colors toning types available in &digikam; are listed below:
1763
<informaltable><tgroup cols="2">
1766
<entry>Preview</entry>
1773
<graphic srccredit="Black and White" fileref="convert_bw.png"/>
1777
Neutral Black and White conversion
1783
<graphic srccredit="Sepia" fileref="convert_sepia.png"/>
1787
Sepia conversion (typical for your grandmothers photographs)
1793
<graphic srccredit="Brown" fileref="convert_brown.png"/>
1797
Brown conversion (more neutral than Sepia)
1803
<graphic srccredit="Cold Tone" fileref="convert_cold.png"/>
1807
Cold Tone conversion
1813
<graphic srccredit="Platinum" fileref="convert_platinium.png"/>
1817
Platinum conversion (ultra cool)
1823
<graphic srccredit="Selenium" fileref="convert_selenium.png"/>
1833
</tgroup></informaltable>
1836
Many other filters and special effects are available if you have the additional Image Editor Plugins installed (see the <link linkend="setupeditor">Setup Image Editor Section</link>), like Film Grain, Rain Drops, Solarize, Charcoal Drawing, etc.
1840
<title>The Rain Drops Image Editor Plugin in Action</title>
1841
<graphic srccredit="The Adjust Levels Image Editor Plugin in Action"
1842
fileref="editorraindropsplugin.png"/>
1848
<title>Printing Image</title>
1851
When you want to print the current image, select
1852
<menuchoice><guimenu>File</guimenu>
1853
<guimenuitem>Print</guimenuitem></menuchoice> and you get the standard KDE Print dialog, where you can adjust the settings before printing your photograph.
1857
For more informations about advanced printing settings, please consult <ulink url="help:/kdeprint/index.html">KDEPrint manual</ulink>.
1864
<sect1 id="using-kapp-setup">
1865
<title>&digikam; Configuration</title>
1867
<anchor id="setupdialog.anchor"/>
1870
&digikam; tries to give you as much control on how it works as possible. There are many options that change the behaviour of &digikam;. To access these settings select
1871
<menuchoice><guimenu>Setting</guimenu>
1872
<guimenuitem>Configure &digikam;</guimenuitem></menuchoice> from the Menu Bar. The configuration dialog is separated into eight pages. You can change between these pages by clicking on the icons on the left-hand side of the dialog.
1875
<sect2 id="setupalbum">
1876
<title>Album Settings</title>
1879
The Album settings control how the main application will behave.
1883
<title>The Album Settings</title>
1884
<graphic srccredit="The Album Settings" fileref="setupalbum.png"/>
1888
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; will think 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.
1892
The <guilabel>Tag Settings</guilabel> are explained in the <link linkend="using-kapp-mytagsview">My Tags</link> section.
1896
The <guilabel>Extra Information in Thumbnail View</guilabel> options are described in the <link linkend="using-kapp-imageview">Images</link> section.
1900
The other settings of this dialog are self explanatory.
1905
<sect2 id="setupembeddedinfo">
1906
<title>Embedded Information Settings</title>
1909
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 EXIF information. Writing comments to the EXIF section is limited to JPEG images.
1913
<title>The Embedded Information Settings</title>
1914
<graphic srccredit="The Embedded Information Settings" fileref="setupembededinfo.png"/>
1918
These settings allow you to control how &digikam; will deal with this embedded information.
1922
<guilabel>Save Album Items' comments as EXIF Comments in JPEG images</guilabel> : this will synchronise 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;.
1926
<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.
1930
<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 taq 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.
1935
<sect2 id="setupcollection">
1936
<title>Collection Settings</title>
1939
This dialog manage your Collection types. Album Collections are described in detail in the <link linkend="using-kapp-myalbumsview">My Albums</link> section.
1943
<title>The Collection Settings</title>
1944
<graphic srccredit="The Collection Settings" fileref="setupcollections.png"/>
1949
<sect2 id="setupmimetype">
1950
<title>Mime Type Settings</title>
1953
&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 directories that do not match these extensions will be ignored by &digikam;.
1957
<title>The Mime Type Settings</title>
1958
<graphic srccredit="The Mime Type Settings" fileref="setupmimetypes.png"/>
1963
<sect2 id="setupeditor">
1964
<title>Image Editor Settings</title>
1967
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.
1971
<title>The Image Editor Settings</title>
1972
<graphic srccredit="The Image Editor Settings" fileref="setupimageeditor.png"/>
1976
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).
1980
With <guilabel>PNG compression</guilabel> option, you can reduce PNG image files size. This operation doesn't reduce image quality because PNG usees a lossless algorithm. The only effect is that image data needs more time to compress/decompress. If you have a fast computer you can change this value for to use a high compression factor (1: low compression / 9: high compression).
1984
With <guilabel>Using TIFF compression</guilabel> option, you can toogle to use <emphasis>Adobe Deflate</emphasis> compression algorithm with TIFF image files. This will reduce the TIFF image files size. This has no image quality effect because Adobe Deflate is a lossless algorithm.
1988
By default the Image Editor will use a black background behind photographs when they are displayed. If you prefer a different background colour you can select one here. You can also turn off the ToolBar when the Image Editor is in full screen mode.
1992
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.
1996
For more informations about advanced Image Editor plugins, you can consult the 'DigikamImagePlugins' project at <ulink url="http://extragear.kde.org/apps/digikamimageplugins">http://extragear.kde.org/apps/digikamimageplugins</ulink>.
2001
<sect2 id="setupkipi">
2002
<title>Kipi Plugins Settings</title>
2005
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.
2009
<title>The Kipi Plugins Settings</title>
2010
<graphic srccredit="The Kipi Plugins Settings" fileref="setupkipi.png"/>
2014
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.
2018
Keyboard shortcuts to actions that plugins perform can be set up in the
2019
<menuchoice><guimenu>Setting</guimenu>
2020
<guimenuitem>Configure Shortcuts</guimenuitem></menuchoice> menu.
2024
For more informations about Kipi plugins, you can consult the Kipi project at <ulink url="http://extragear.kde.org/apps/kipi">http://extragear.kde.org/apps/kipi</ulink>.
2029
<sect2 id="setupcamera">
2030
<title>Camera Settings</title>
2033
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 MassStorage.
2037
<title>The Camera Settings</title>
2038
<graphic srccredit="The Camera Settings" fileref="setupcamera.png"/>
2041
<anchor id="cameraselection.anchor"/>
2044
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. At the very bottom is where you set the path for a USB MassStorage Camera. This box becomes active once you select USB MassStorage Camera in the camera list. You need to enter here the path where you mount the camera, usually "/mnt/camera" or "/mnt/removable".
2048
<title>The Add Camera Dialog</title>
2049
<graphic srccredit="The Add Camera Dialog" fileref="addcamera.png"/>
2053
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.
2057
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, goto the "Cameras" menu in the main interface and you will see the camera listed in the menu.
2061
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.
2063
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.
2069
<sect2 id="setupmisc">
2070
<title>Miscellaneous Settings</title>
2073
Here you can control how digiKam will behave 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.
2077
You can also switch off the display of the splash screen when digiKam loads. This may speed up the start time of digiKam very slightly.
2081
<title>The Miscellaneous Settings</title>
2082
<graphic srccredit="The Miscellaneous Settings" fileref="setupmisc.png"/>
2091
<!-- *********************************************************************** -->
2093
<chapter id="menudescriptions">
2094
<title>Menu Descriptions</title>
2097
<title>The main &digikam; window</title>
2100
<title>The Album Menu</title>
2107
<shortcut><keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo></shortcut>
2108
<guimenu>Album</guimenu><guimenuitem>Back</guimenuitem>
2109
</menuchoice></term>
2110
<listitem><para><action>Go back to the previously visited Album using history.</action></para></listitem>
2115
<shortcut><keycombo><keycap>Alt</keycap><keycap>Right</keycap></keycombo></shortcut>
2116
<guimenu>Album</guimenu><guimenuitem>Forward</guimenuitem>
2117
</menuchoice></term>
2118
<listitem><para><action>Go forward to the previously visted Album using history. You can only go forward if you've just gone back.</action></para></listitem>
2123
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut>
2124
<guimenu>Album</guimenu><guimenuitem>New Album</guimenuitem>
2125
</menuchoice></term>
2126
<listitem><para><action>Create a new album folder.</action></para></listitem>
2131
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>F3</keycap></keycombo></shortcut>
2132
<guimenu>Album</guimenu><guimenuitem>Edit Album Properties</guimenuitem>
2133
</menuchoice></term>
2134
<listitem><para><action>Edit the currently selected album title, comments and collection.</action></para></listitem>
2139
<guimenu>Album</guimenu>
2140
<guimenuitem>Open in Konqueror</guimenuitem>
2141
</menuchoice></term>
2142
<listitem><para><action>Open Konqueror with the current Album path.</action></para></listitem>
2145
<!-- Import sub menu -->
2148
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>I</keycap></keycombo></shortcut>
2149
<guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Add Images</guimenuitem>
2150
</menuchoice></term>
2151
<listitem><para><action>Select images to be added to the currently selected Album.</action></para></listitem>
2156
<guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Import Folders</guimenuitem>
2157
</menuchoice></term>
2158
<listitem><para><action>Select folders to be imported like Albums to the currently selected Album</action></para></listitem>
2163
<guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Scan Images</guimenuitem>
2164
</menuchoice></term>
2167
Kipi plugin for image acquisition with a scanner.
2171
<ulink url="help:/kipi-plugins/acquireimages.html">Acquire Images manual</ulink>
2172
for more information.
2179
<guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Screenshot</guimenuitem>
2180
</menuchoice></term>
2183
Kipi plugin to take a screenshot.
2187
<ulink url="help:/kipi-plugins/acquireimages.html">Acquire Images manual</ulink>
2188
for more information.
2193
<!-- Export sub menu -->
2196
<guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>Archive to
2197
CD/DVD</guimenuitem>
2198
</menuchoice></term>
2201
Kipi plugin to archive Albums to CD or DVD using K3b.
2205
<ulink url="help:/kipi-plugins/cdarchiving.html">CD Archiving manual</ulink>
2206
for more information.
2213
<guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>HTML export</guimenuitem>
2214
</menuchoice></term>
2217
Kipi plugin to create a HTML gallery with Albums.
2221
<ulink url="help:/kipi-plugins/imagesgallery.html">Images Gallery manual</ulink>
2222
for more information.
2229
<guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>Print
2230
Wizard</guimenuitem>
2231
</menuchoice></term>
2234
Kipi plugin to print Album images.
2238
<ulink url="help:/kipi-plugins/printwizard.html">Print Wizard manual</ulink>
2239
for more information.
2246
<guimenu>Album</guimenu>
2247
<guimenuitem>Delete Album/Move Album to trash</guimenuitem>
2248
</menuchoice></term>
2249
<listitem><para><action>Delete/Move to trash selected Album and all items in it.</action></para></listitem>
2254
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo></shortcut>
2255
<guimenu>Album</guimenu><guimenuitem>Quit</guimenuitem>
2256
</menuchoice></term>
2257
<listitem><para><action>Quit &digikam;</action></para></listitem>
2265
<!-- *********************************************************************** -->
2268
<title>The Tag Menu</title>
2275
<guimenu>Tag</guimenu><guimenuitem>New Tag</guimenuitem>
2276
</menuchoice></term>
2277
<listitem><para><action>Create a new Tag entry in the Albums Database.</action></para></listitem>
2282
<guimenu>Tag</guimenu><guimenuitem>Edit Tag Properties</guimenuitem>
2283
</menuchoice></term>
2284
<listitem><para><action>Edit the properties of the currently selected Tag.</action></para></listitem>
2289
<guimenu>Tag</guimenu><guimenuitem>Delete Tag</guimenuitem>
2290
</menuchoice></term>
2291
<listitem><para><action>Remove the currently selected Tag from the Album's Database.</action></para></listitem>
2299
<!-- *********************************************************************** -->
2302
<title>The Image Menu</title>
2309
<shortcut><keycombo><keycap>F4</keycap></keycombo></shortcut>
2310
<guimenu>Image</guimenu><guimenuitem>View/Edit</guimenuitem>
2311
</menuchoice></term>
2312
<listitem><para><action>Open the currently selected image in the &digikam; image editor.</action></para></listitem>
2317
<shortcut><keycombo><keycap>F3</keycap></keycombo></shortcut>
2318
<guimenu>Image</guimenu><guimenuitem>Edit Image Comments and Tags</guimenuitem>
2319
</menuchoice></term>
2320
<listitem><para><action>Edit the comments and tags of the currently selected image.</action></para></listitem>
2325
<guimenu>Image</guimenu><guimenuitem>Correct EXIF Orientation Tag</guimenuitem>
2326
</menuchoice></term>
2327
<listitem><para><action>Manual EXIF Orientation Tag adjustment options of the currently selected image.</action></para></listitem>
2332
<shortcut><keycombo><keycap>Alt</keycap><keycap>Return</keycap></keycombo></shortcut>
2333
<guimenu>Image</guimenu><guimenuitem>Properties</guimenuitem>
2334
</menuchoice></term>
2335
<listitem><para><action>View General Properties, Permissions, embedded Meta-Data, EXIF information, and Histogram of the currently selected image.</action></para></listitem>
2340
<guimenu>Image</guimenu><guimenuitem>Auto Rotate/Flip using EXIF information</guimenuitem>
2341
</menuchoice></term>
2344
Kipi plugin menu entry to manually activate the auto rotate/flip feature for the currently selected images using the EXIF orientation tag.
2348
<ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink>
2349
for more information.
2356
<guimenu>Image</guimenu><guimenuitem>Rotate</guimenuitem>
2357
</menuchoice></term>
2360
Kipi plugin menu entry for rotating the currently selected images by 90/180/270 degrees.
2364
<ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink>
2365
for more information.
2372
<guimenu>Image</guimenu><guimenuitem>Flip</guimenuitem>
2373
</menuchoice></term>
2376
Kipi plugin menu entry for flipping the currently selected images horizontally or vertically.
2380
<ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink>
2381
for more information.
2388
<guimenu>Image</guimenu><guimenuitem>Convert to Black and White</guimenuitem>
2389
</menuchoice></term>
2392
Kipi plugin menu entry for converting the currently selected images to black and white.
2396
<ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink>
2397
for more information.
2404
<guimenu>Image</guimenu><guimenuitem>Email images</guimenuitem>
2405
</menuchoice></term>
2408
Kipi plugin for emailing images with your prefered mail agent.
2412
<ulink url="help:/kipi-plugins/sendimages.html">Send Images manual</ulink>
2413
for more information.
2420
<guimenu>Image</guimenu><guimenuitem>Adjust Time and Date</guimenuitem>
2421
</menuchoice></term>
2424
Kipi plugin for adjusting time and date of the currently selected images.
2428
<ulink url="help:/kipi-plugins/timeadjust.html">Time Adjust manual</ulink>
2429
for more information.
2436
<guimenu>Image</guimenu><guimenuitem>Set as Background</guimenuitem>
2437
</menuchoice></term>
2440
Kipi plugin for setting the currently selected image as the desktop background.
2444
<ulink url="help:/kipi-plugins/wallpaper.html">Wall Paper manual</ulink>
2445
for more information.
2452
<shortcut><keycombo><keycap>F2</keycap></keycombo></shortcut>
2453
<guimenu>Image</guimenu><guimenuitem>Rename</guimenuitem>
2454
</menuchoice></term>
2455
<listitem><para><action>Rename the currently selected image.</action></para></listitem>
2460
<shortcut><keycombo><keycap>Shift</keycap><keycap>Delete</keycap></keycombo></shortcut>
2461
<guimenu>Image</guimenu><guimenuitem>Delete/Move to trash</guimenuitem>
2462
</menuchoice></term>
2463
<listitem><para><action>Delete/Move the currently selected images to Trash.</action></para></listitem>
2471
<!-- *********************************************************************** -->
2474
<title>The Select Menu</title>
2481
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>A</keycap></keycombo></shortcut>
2482
<guimenu>Select</guimenu><guimenuitem>Select All</guimenuitem>
2483
</menuchoice></term>
2484
<listitem><para><action>Select all images currently shown</action></para></listitem>
2489
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>U</keycap></keycombo></shortcut>
2490
<guimenu>Select</guimenu><guimenuitem>Select None</guimenuitem>
2491
</menuchoice></term>
2492
<listitem><para><action>Unselect all items in the current view</action></para></listitem>
2497
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>*</keycap></keycombo></shortcut>
2498
<guimenu>Select</guimenu><guimenuitem>Invert Selection</guimenuitem>
2499
</menuchoice></term>
2500
<listitem><para><action>Invert the current selection</action></para></listitem>
2508
<!-- *********************************************************************** -->
2511
<title>The View Menu</title>
2518
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>+</keycap></keycombo></shortcut>
2519
<guimenu>View</guimenu><guimenuitem>Increase Thumbnail Size</guimenuitem>
2520
</menuchoice></term>
2521
<listitem><para><action>Increase the thumbnail size of the currently selected Album.</action></para></listitem>
2526
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>-</keycap></keycombo></shortcut>
2527
<guimenu>View</guimenu><guimenuitem>Decrease Thumbnail Size</guimenuitem>
2528
</menuchoice></term>
2529
<listitem><para><action>Decrease the thumbnail size of the currently selected Album.</action></para></listitem>
2534
<guimenu>Albums</guimenu><guimenuitem>Sort Albums</guimenuitem>
2535
</menuchoice></term>
2536
<listitem><para><action>Sort all &digikam; Albums by Folder, by Collection, or by Date.</action></para></listitem>
2541
<guimenu>View</guimenu><guimenuitem>Sort Images</guimenuitem>
2542
</menuchoice></term>
2543
<listitem><para><action>Sort all images in current Album by Name, by Path, by Date, or by File Size.</action></para></listitem>
2551
<!-- *********************************************************************** -->
2554
<title>The Tools Menu</title>
2561
<guimenu>Album</guimenu><guimenuitem>Find Duplicate Images</guimenuitem>
2562
</menuchoice></term>
2565
Kipi plugin to find duplicate images in Albums Database.
2569
<ulink url="help:/kipi-plugins/findduplicateimages.html">Find Duplicate Images manual</ulink>
2570
for more information.
2577
<guimenu>Tools</guimenu><guimenuitem>Gamma adjustment</guimenuitem>
2578
</menuchoice></term>
2581
Launch the screen Gamma Adjustment module from KDE Control Panel.
2585
<ulink url="help:/kgamma/index.html">KGamma manual</ulink>
2586
for more information.
2588
Another even better reference can be found here: <ulink url="http://www.ltlimagery.com/monitor_calibration.html#normankoren">Monitor Calibration</ulink>
2595
<guimenu>Tools</guimenu><guimenuitem>Create Calendar</guimenuitem>
2596
</menuchoice></term>
2599
Kipi plugin for creating a calendar with Album items.
2603
<ulink url="help:/kipi-plugins/calendar.html">Calendar manual</ulink>
2604
for more information.
2611
<guimenu>Tools</guimenu><guimenuitem>Create MPEG Slideshow</guimenuitem>
2612
</menuchoice></term>
2615
Kipi plugin for creating an MPEG Slideshow with Album items.
2619
<ulink url="help:/kipi-plugins/mpegencoder.html">MPEG Encoder manual</ulink>
2620
for more information.
2627
<guimenu>Tools</guimenu><guimenuitem>Slideshow</guimenuitem>
2628
</menuchoice></term>
2631
Kipi plugin for displaying a Slideshow with Album items.
2635
<ulink url="help:/kipi-plugins/slideshow.html">Slide Show manual</ulink>
2636
for more information.
2643
<guimenu>Tools</guimenu><guimenuitem>Raw Image Converter (single)</guimenuitem>
2644
</menuchoice></term>
2647
Kipi plugin for converting a single RAW image.
2651
<ulink url="help:/kipi-plugins/rawconverter.html">Raw Converter manual</ulink>
2652
for more information.
2659
<guimenu>Tools</guimenu><guimenuitem>Batch Processes</guimenuitem>
2660
</menuchoice></term>
2663
Kipi plugin menu entries for performing batch Processes on
2664
currently selected images.
2667
See the dedicated manuals for more informations:
2671
<ulink url="help:/kipi-plugins/borderimages.html">Border Images manual</ulink>
2675
<ulink url="help:/kipi-plugins/colorimages.html">Color Images manual</ulink>
2679
<ulink url="help:/kipi-plugins/convertimages.html">Convert Images manual</ulink>
2683
<ulink url="help:/kipi-plugins/effectimages.html">Effect Images manual</ulink>
2687
<ulink url="help:/kipi-plugins/filterimages.html">Filter Images manual</ulink>
2691
<ulink url="help:/kipi-plugins/recompressimages.html">Recompress Images manual</ulink>
2695
<ulink url="help:/kipi-plugins/renameimages.html">Rename Images manual</ulink>
2699
<ulink url="help:/kipi-plugins/resizeimages.html">Resize Images manual</ulink>
2703
<ulink url="help:/kipi-plugins/rawconverter.html">Raw Converter manual</ulink>
2715
<!-- *********************************************************************** -->
2718
<title>The Camera Menu</title>
2721
Any configured digital camera will be listed here. You can use the "Add Camera" menu entry
2722
to add a new camera to the list. Please, read the <link linkend="setupcamera">Setup Camera Section</link>
2723
for more information.
2728
<!-- *********************************************************************** -->
2731
<title>The Settings Menu</title>
2738
<guimenu>Settings</guimenu><guimenuitem>Show Toolbar</guimenuitem>
2739
</menuchoice></term>
2740
<listitem><para><action>Enable or disable the main &digikam; tool bar.</action></para></listitem>
2745
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>F</keycap></keycombo>
2747
<guimenu>View</guimenu><guimenuitem>Toggle Full Screen</guimenuitem>
2748
</menuchoice></term>
2749
<listitem><para><action>Toggles the graphic interface into full screen mode.</action></para></listitem>
2754
<guimenu>Settings</guimenu><guimenuitem>Themes</guimenuitem>
2755
</menuchoice></term>
2756
<listitem><para><action>Any available gui themes for the main interface will be listed here.
2757
Select one for changing the theme used by &digikam;.</action></para></listitem>
2762
<guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts</guimenuitem>
2763
</menuchoice></term>
2764
<listitem><para><action>Configure the &digikam; shortcuts.</action></para></listitem>
2769
<guimenu>Settings</guimenu><guimenuitem>Configure Toolbars</guimenuitem>
2770
</menuchoice></term>
2771
<listitem><para><action>Configure the &digikam; toolbars.</action></para></listitem>
2776
<guimenu>Settings</guimenu><guimenuitem>Configure &digikam;</guimenuitem>
2777
</menuchoice></term>
2778
<listitem><para><action>Configure the Camera and Album Settings.</action></para></listitem>
2786
<!-- *********************************************************************** -->
2789
<title>The Help Menu</title>
2790
&help.menu.documentation;
2792
<para>Additionally &digikam; offers these items:</para>
2798
<guimenu>Help</guimenu><guimenuitem>Tip of the Day</guimenuitem>
2799
</menuchoice></term>
2800
<listitem><para>This displays a dialog with useful hints for using &digikam;.</para></listitem>
2805
<guimenu>Help</guimenu><guimenuitem>Kipi' Plugins Handbooks</guimenuitem>
2806
</menuchoice></term>
2807
<listitem><para>Launch the KDE help interface with the Kipi's plugins handbooks.</para></listitem>
2816
<!-- *********************************************************************** -->
2819
<title>The Image Editor</title>
2822
<title>The File Menu</title>
2829
<shortcut><keycombo><keycap>PgUp</keycap></keycombo></shortcut>
2830
<guimenu>File</guimenu><guimenuitem>Previous</guimenuitem>
2831
</menuchoice></term>
2832
<listitem><para><action>Display the previous image of the current Album.</action></para></listitem>
2837
<shortcut><keycombo><keycap>PgDown</keycap></keycombo></shortcut>
2838
<guimenu>File</guimenu><guimenuitem>Next</guimenuitem>
2839
</menuchoice></term>
2840
<listitem><para><action>Display the next image of the current Album.</action></para></listitem>
2845
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>Home</keycap></keycombo></shortcut>
2846
<guimenu>File</guimenu><guimenuitem>First</guimenuitem>
2847
</menuchoice></term>
2848
<listitem><para><action>Display the first image of current Album.</action></para></listitem>
2853
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>End</keycap></keycombo></shortcut>
2854
<guimenu>File</guimenu><guimenuitem>First</guimenuitem>
2855
</menuchoice></term>
2856
<listitem><para><action>Display the first image of current Album.</action></para></listitem>
2861
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></shortcut>
2862
<guimenu>File</guimenu><guimenuitem>Save</guimenuitem>
2863
</menuchoice></term>
2864
<listitem><para><action>Save the current image if it has been modified.</action></para></listitem>
2869
<guimenu>File</guimenu><guimenuitem>Save As</guimenuitem>
2870
</menuchoice></term>
2871
<listitem><para><action>Save the current image in a new file.</action></para></listitem>
2876
<guimenu>File</guimenu><guimenuitem>Revert</guimenuitem>
2877
</menuchoice></term>
2878
<listitem><para><action>Restore the current image from the original file if it has been modified.</action></para></listitem>
2883
<shortcut><keycombo><keycap>Shift</keycap><keycap>Del</keycap></keycombo></shortcut>
2884
<guimenu>File</guimenu><guimenuitem>Delete File/Move to trash</guimenuitem>
2885
</menuchoice></term>
2886
<listitem><para><action>Delete/Move to trash the current image from the current
2887
Album.</action></para></listitem>
2892
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo></shortcut>
2893
<guimenu>File</guimenu><guimenuitem>Print Image</guimenuitem>
2894
</menuchoice></term>
2895
<listitem><para><action>Print the current image.</action></para></listitem>
2900
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo></shortcut>
2901
<guimenu>File</guimenu><guimenuitem>Quit</guimenuitem>
2902
</menuchoice></term>
2903
<listitem><para><action>Quit &digikam; Image Editor.</action></para></listitem>
2911
<!-- *********************************************************************** -->
2914
<title>The Edit Menu</title>
2921
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo></shortcut>
2922
<guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem>
2923
</menuchoice></term>
2924
<listitem><para><action>Copy the current image selection in the clipboard.</action></para></listitem>
2929
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo></shortcut>
2930
<guimenu>Edit</guimenu><guimenuitem>Cancel</guimenuitem>
2931
</menuchoice></term>
2932
<listitem><para><action>Cancel the last action applied to the current image using history.</action></para></listitem>
2940
<!-- *********************************************************************** -->
2943
<title>The Image Menu</title>
2950
<shortcut><keycombo><keycap>F3</keycap></keycombo></shortcut>
2951
<guimenu>Image</guimenu><guimenuitem>Edit Comments and Tags</guimenuitem>
2952
</menuchoice></term>
2953
<listitem><para><action>Edit the comments and tags of the currently
2954
selected image.</action></para></listitem>
2959
<shortcut><keycombo><keycap>Alt</keycap><keycap>Return</keycap></keycombo></shortcut>
2960
<guimenu>Image</guimenu><guimenuitem>Properties</guimenuitem>
2961
</menuchoice></term>
2962
<listitem><para><action>View General Properties, Permissions, embedded Meta-Data, EXIF information,
2963
and Histogram of the currently selected image.</action></para></listitem>
2968
<guimenu>Image</guimenu><guimenuitem>Add Border</guimenuitem>
2969
</menuchoice></term>
2972
Image Editor plugin to add a decorative border around the current image.
2976
<ulink url="help:/digikamimageplugins/border.html">Add Border manual</ulink>
2977
for more information.
2984
<guimenu>Image</guimenu><guimenuitem>Template Superimpose</guimenuitem>
2985
</menuchoice></term>
2988
Image Editor plugin for apply a template to the current image.
2992
<ulink url="help:/digikamimageplugins/superimpose.html">Template Superimpose manual</ulink>
2993
for more information.
3003
<!-- *********************************************************************** -->
3006
<title>The Fix Menu</title>
3013
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Levels
3014
Adjust</guimenuitem>
3015
</menuchoice></term>
3018
Image Editor plugin to adjust levels manually on the current image.
3022
<ulink url="help:/digikamimageplugins/adjustlevels.html">Adjust Levels manual</ulink>
3023
for more information.
3030
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem>
3031
<guimenuitem>Brightness/Contrast/Gamma</guimenuitem>
3032
</menuchoice></term>
3033
<listitem><para><action>Exposure correction of the current image by Brightness, Contrast, or Gamma
3034
adjustments.</action></para></listitem>
3039
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem>
3040
<guimenuitem>Hue/Saturation/Lightness</guimenuitem>
3041
</menuchoice></term>
3042
<listitem><para><action>Color correction of the current image by Hue, Saturation, or Lightness
3043
adjustments.</action></para></listitem>
3048
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Color
3049
Balance</guimenuitem>
3050
</menuchoice></term>
3051
<listitem><para><action>Color correction of the current image by Red, Green, or Blue
3052
adjustments.</action></para></listitem>
3057
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Normalize</guimenuitem>
3058
</menuchoice></term>
3059
<listitem><para><action>Automatic color correction of the current image by an histogram
3060
normalization.</action></para></listitem>
3065
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Equalize</guimenuitem>
3066
</menuchoice></term>
3067
<listitem><para><action>Automatic color correction of the current image by an histogram
3068
equalization.</action></para></listitem>
3073
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Auto
3074
Levels</guimenuitem>
3075
</menuchoice></term>
3076
<listitem><para><action>Automatic color correction of the current image by an histogram auto-levels
3077
adjustment.</action></para></listitem>
3082
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Stretch Contrast</guimenuitem>
3083
</menuchoice></term>
3084
<listitem><para><action>Automatic contrast enhance of the current image.</action></para></listitem>
3089
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Invert</guimenuitem>
3090
</menuchoice></term>
3091
<listitem><para><action>Invert image colors.</action></para></listitem>
3096
<guimenu>Fix</guimenu><guimenuitem>Colors</guimenuitem><guimenuitem>Curves
3097
Adjust</guimenuitem>
3098
</menuchoice></term>
3101
Image Editor plugin to adjust curves manually on the current image.
3105
<ulink url="help:/digikamimageplugins/adjustcurves.html">Adjust Curves manual</ulink>
3106
for more information.
3113
<guimenu>Fix</guimenu><guimenuitem>Blur</guimenuitem>
3114
</menuchoice></term>
3115
<listitem><para><action>Focus error correction of the current image by a blurring
3116
operation.</action></para></listitem>
3121
<guimenu>Fix</guimenu><guimenuitem>Sharpen</guimenuitem>
3122
</menuchoice></term>
3123
<listitem><para><action>Focus error correction of the current image by a sharping
3124
operation.</action></para></listitem>
3129
<guimenu>Fix</guimenu><guimenuitem>Red Eye Reduction</guimenuitem>
3130
</menuchoice></term>
3131
<listitem><para><action>Red Eye correction using the current selection of the current
3132
image.</action></para></listitem>
3137
<guimenu>Fix</guimenu><guimenuitem>Unsharp Mask</guimenuitem>
3138
</menuchoice></term>
3141
Image Editor plugin to operate an Unsharp mask on the current image.
3145
<ulink url="help:/digikamimageplugins/unsharp.html">Unsharp Mask manual</ulink>
3146
for more information.
3153
<guimenu>Fix</guimenu><guimenuitem>Lens Distortion Correction</guimenuitem>
3154
</menuchoice></term>
3157
Image Editor plugin to correct lens distortion of the current image.
3161
<ulink url="help:/digikamimageplugins/lensdistortion.html">Lens Distortion Correction manual</ulink>
3162
for more information.
3169
<guimenu>Fix</guimenu><guimenuitem>Noise Reduction</guimenuitem>
3170
</menuchoice></term>
3173
Image Editor plugin to reduce the noise on the current image with using a Despeckle
3178
<ulink url="help:/digikamimageplugins/despeckle.html">Noise Reduction manual</ulink>
3179
for more information.
3186
<guimenu>Fix</guimenu><guimenuitem>Anti Vignetting</guimenuitem>
3187
</menuchoice></term>
3190
Image Editor plugin to correct vignetting of the current image.
3194
<ulink url="help:/digikamimageplugins/antivignetting.html">Anti Vignetting manual</ulink>
3195
for more information.
3205
<!-- *********************************************************************** -->
3208
<title>The Transform Menu</title>
3215
<shortcut><keycombo><keycap>Shift</keycap><keycap>1</keycap></keycombo></shortcut>
3216
<guimenu>Transform</guimenu><guimenuitem>Rotate</guimenuitem><guimenuitem>90
3217
degrees</guimenuitem>
3218
</menuchoice></term>
3219
<listitem><para><action>90 degrees rotation of the current image.</action></para></listitem>
3224
<shortcut><keycombo><keycap>Shift</keycap><keycap>2</keycap></keycombo></shortcut>
3225
<guimenu>Transform</guimenu><guimenuitem>Rotate</guimenuitem><guimenuitem>180
3226
degrees</guimenuitem>
3227
</menuchoice></term>
3228
<listitem><para><action>180 degrees rotation of the current image.</action></para></listitem>
3233
<shortcut><keycombo><keycap>Shift</keycap><keycap>3</keycap></keycombo></shortcut>
3234
<guimenu>Transform</guimenu><guimenuitem>Rotate</guimenuitem><guimenuitem>270
3235
degrees</guimenuitem>
3236
</menuchoice></term>
3237
<listitem><para><action>270 degrees rotation of the current image.</action></para></listitem>
3242
<guimenu>Transform</guimenu><guimenuitem>Flip</guimenuitem><guimenuitem>Horizontally</guimenuitem>
3243
</menuchoice></term>
3244
<listitem><para><action>Horizontal flip of the current image.</action></para></listitem>
3249
<guimenu>Transform</guimenu><guimenuitem>Flip</guimenuitem><guimenuitem>Vertically</guimenuitem>
3250
</menuchoice></term>
3251
<listitem><para><action>Vertical flip of the current image.</action></para></listitem>
3256
<guimenu>Transform</guimenu><guimenuitem>Crop</guimenuitem>
3257
</menuchoice></term>
3258
<listitem><para><action>Crop the current image to the current selection.</action></para></listitem>
3263
<guimenu>Transform</guimenu><guimenuitem>Resize</guimenuitem>
3264
</menuchoice></term>
3265
<listitem><para><action>Resize the current image to the appropriate factor or dimensions.</action></para></listitem>
3270
<guimenu>Transform</guimenu><guimenuitem>Aspect Ratio Crop</guimenuitem>
3271
</menuchoice></term>
3272
<listitem><para><action>Crop the current image using an constrained aspect ratio.</action></para></listitem>
3277
<guimenu>Transform</guimenu><guimenuitem>Shear</guimenuitem>
3278
</menuchoice></term>
3281
Image Editor plugin to shear the current image.horizontally or vertically.
3285
<ulink url="help:/digikamimageplugins/sheartool.html">Shear Tool manual</ulink>
3286
for more information.
3293
<guimenu>Transform</guimenu><guimenuitem>Free Rotation</guimenuitem>
3294
</menuchoice></term>
3297
Image Editor plugin to rotate the current image by any angle in degrees.
3301
<ulink url="help:/digikamimageplugins/freerotation.html">Free Rotation manual</ulink>
3302
for more information.
3309
<guimenu>Transform</guimenu><guimenuitem>Perspective Adjustment</guimenuitem>
3310
</menuchoice></term>
3313
Image Editor plugin to adjust perspective of the current image.
3317
<ulink url="help:/digikamimageplugins/perspective.html">Perspective Adjustment manual</ulink>
3318
for more information.
3328
<!-- *********************************************************************** -->
3331
<title>The View Menu</title>
3338
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>+</keycap></keycombo></shortcut>
3339
<guimenu>View</guimenu><guimenuitem>Zoom In</guimenuitem>
3340
</menuchoice></term>
3341
<listitem><para><action>Increase the zoom factor on the current image.</action></para></listitem>
3346
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>-</keycap></keycombo></shortcut>
3347
<guimenu>View</guimenu><guimenuitem>Zoom Out</guimenuitem>
3348
</menuchoice></term>
3349
<listitem><para><action>Decrease the zoom factor on the current image.</action></para></listitem>
3354
<shortcut><keycombo><keycap>A</keycap></keycombo></shortcut>
3355
<guimenu>View</guimenu><guimenuitem>Zoom AutoFit</guimenuitem>
3356
</menuchoice></term>
3357
<listitem><para><action>Set the zoom factor for adapting the current image size to the Image Editors
3358
window size.</action></para></listitem>
3363
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>F</keycap></keycombo>
3365
<guimenu>View</guimenu><guimenuitem>Toggle Full Screen</guimenuitem>
3366
</menuchoice></term>
3367
<listitem><para><action>Toggles the graphic interface to full screen mode.</action></para></listitem>
3375
<!-- *********************************************************************** -->
3378
<title>The Filters Menu</title>
3385
<guimenu>Filters</guimenu><guimenuitem>Convert to</guimenuitem><guimenuitem>Neutral Black-White</guimenuitem>
3386
</menuchoice></term>
3387
<listitem><para><action>Convert the current image to Black and White mode.</action></para></listitem>
3392
<guimenu>Filters</guimenu><guimenuitem>Convert to</guimenuitem><guimenuitem>Brown</guimenuitem>
3393
</menuchoice></term>
3394
<listitem><para><action>Convert the current image to Brown mode.</action></para></listitem>
3399
<guimenu>Filters</guimenu><guimenuitem>Convert to</guimenuitem><guimenuitem>Sepia</guimenuitem>
3400
</menuchoice></term>
3401
<listitem><para><action>Convert the current image to Sepia mode.</action></para></listitem>
3406
<guimenu>Filters</guimenu><guimenuitem>Convert to</guimenuitem><guimenuitem>Cold Tone</guimenuitem>
3407
</menuchoice></term>
3408
<listitem><para><action>Convert the current image to Cold Tone mode.</action></para></listitem>
3413
<guimenu>Filters</guimenu><guimenuitem>Convert to</guimenuitem><guimenuitem>Platinum</guimenuitem>
3414
</menuchoice></term>
3415
<listitem><para><action>Convert the current image to Platinum mode.</action></para></listitem>
3420
<guimenu>Filters</guimenu><guimenuitem>Convert to</guimenuitem><guimenuitem>Selenium</guimenuitem>
3421
</menuchoice></term>
3422
<listitem><para><action>Convert the current image to Selenium mode.</action></para></listitem>
3427
<guimenu>Filters</guimenu><guimenuitem>Raindrops</guimenuitem>
3428
</menuchoice></term>
3431
Image Editor plugin to add Rain Drops on the current image.
3435
<ulink url="help:/digikamimageplugins/raindrops.html">Rain Drops manual</ulink>
3436
for more information.
3443
<guimenu>Filters</guimenu><guimenuitem>Oil paint</guimenuitem>
3444
</menuchoice></term>
3447
Image Editor plugin to simulate Oil Painting on the current image.
3451
<ulink url="help:/digikamimageplugins/oilpaint.html">Oil Paint manual</ulink>
3452
for more information.
3459
<guimenu>Filters</guimenu><guimenuitem>Emboss</guimenuitem>
3460
</menuchoice></term>
3463
Image Editor plugin to Emboss the current image.
3467
<ulink url="help:/digikamimageplugins/emboss.html">Emboss Image manual</ulink>
3468
for more information.
3475
<guimenu>Filters</guimenu><guimenuitem>Solarize Image</guimenuitem>
3476
</menuchoice></term>
3479
Image Editor plugin to Solarize the current image.
3483
<ulink url="help:/digikamimageplugins/solarizeimage.html">Solarize Image manual</ulink>
3484
for more information.
3491
<guimenu>Filters</guimenu><guimenuitem>Add Film Grain</guimenuitem>
3492
</menuchoice></term>
3495
Image Editor plugin for to adding Film Grain on the current image.
3499
<ulink url="help:/digikamimageplugins/filmgrain.html">Film Grain manual</ulink>
3500
for more information.
3507
<guimenu>Filters</guimenu><guimenuitem>Charcoal Drawing</guimenuitem>
3508
</menuchoice></term>
3511
Image Editor plugin to simulate Charcoal Drawing on the current image.
3515
<ulink url="help:/digikamimageplugins/charcoal.html">Charcoal Drawing manual</ulink>
3516
for more information.
3526
<!-- *********************************************************************** -->
3529
<title>The Help Menu</title>
3530
&help.menu.documentation;
3532
<para>Additionally &digikam; Image Editor offers this item:</para>
3538
<guimenu>Help</guimenu><guimenuitem>ImagePlugins' Handbooks</guimenuitem>
3539
</menuchoice></term>
3540
<listitem><para>Launch the KDE help interface with the &digikam; Image Editor
3541
plugins handbooks.</para></listitem>
3550
<!-- *********************************************************************** -->
3554
<chapter id="credits">
3556
<title>Credits and License</title>
3561
<imageobject><imagedata fileref="digikamlogo.png" format="PNG"/></imageobject>
3562
<textobject> <phrase>&digikam; logo</phrase> </textobject>
3563
</inlinemediaobject>
3568
Program copyright 2001-2005, &digikam; developers team
3574
Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email>:
3575
Coordinator, Main Developer.
3581
Caulier Gilles <email>caulier_dot_gilles_at free.fr</email>:
3582
Co-coordinator, Developer, French Translations.
3588
Joern Ahrens <email>kde_at_jokele.de</email>:
3595
Ralf Hoelzer <email>kde_at_ralfhoelzer.com</email>:
3605
Documentation copyrighted by:
3612
Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email>.
3620
<listitem><para>Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email></para></listitem>
3621
<listitem><para>Gilles Caulier <email>caulier_dot_gilles_at_free.fr</email></para></listitem>
3630
<listitem><para>Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email></para></listitem>
3631
<listitem><para>Gilles Caulier <email>caulier_dot_gilles_at_free.fr</email></para></listitem>
3632
<listitem><para>Richard Taylor
3633
<email>rjt-digicam_at_thegrindstone_dot_me_dot_uk</email></para></listitem>
3634
<listitem><para>Ralf Hoelzer <email>kde_at_ralfhoelzer.com</email></para></listitem>
3635
<listitem><para>Joern Ahrens <email>kde_at_jokele.de</email></para></listitem>
3636
<listitem><para>Oliver Doerr <email>oliver_at_doerr-privat.de</email></para></listitem>
3637
<listitem><para>Gerhard Kulzer <email>gerhard at kulzer.net</email></para></listitem>
3644
All Pictures copyrighted 2003-2005 by Gilles Caulier <email>caulier_dot_gilles_at_free.fr</email>.
3647
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
3655
<appendix id="installation">
3656
<title>Installation</title>
3658
<sect1 id="getting-kapp">
3659
<title>How to Obtain &digikam;</title>
3662
The website for &digikam; is at <ulink url="http://digikam.sourceforge.net">http://digikam.sourceforge.net</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>.
3666
Also you can checkout the <emphasis>digikam</emphasis> and <emphasis>kipi</emphasis> source code modules
3667
from KDE Extragear CVS repository like this:
3670
<prompt>%</prompt> <userinput>cvs -d:pserver:anonymous@anoncvs.kde.org:/home/kde login</userinput>
3671
<prompt>%</prompt> <userinput>cvs -z3 -d:pserver:anonymous@anoncvs.kde.org:/home/kde co
3672
kdeextragear-libs-1</userinput>
3673
<prompt>%</prompt> <userinput>cvs -z3 -d:pserver:anonymous@anoncvs.kde.org:/home/kde co
3674
kdeextragear-3</userinput>
3680
The last CVS snapshoots can be downloaded at this URL <ulink url="ftp://ftp.kde.org/pub/kde/unstable/snapshots/">
3681
ftp://ftp.kde.org/pub/kde/unstable/snapshots/</ulink>.
3686
<sect1 id="requirements">
3687
<title>Requirements</title>
3690
In order to successfully use &digikam;, you need the following:
3692
<listitem><para>AutoConf >= 2.5</para></listitem>
3693
<listitem><para>AutoMake >= 1.7.0</para></listitem>
3694
<listitem><para>KDE 3.x</para></listitem>
3695
<listitem><para>gphoto2 2.x</para></listitem>
3696
<listitem><para>imlib2 >= 1.1.0</para></listitem>
3697
<listitem><para>libgdbm >= 1.8.0</para></listitem>
3698
<listitem><para>libkipi >= 0.1</para></listitem>
3699
<listitem><para>libkexif >= 0.1</para></listitem>
3700
<listitem><para>libtiff >= 3.5.x</para></listitem>
3701
<listitem><para>DigikamImagePlugins >= 0.7.2 (optional)</para></listitem>
3706
KDE can be obtained from <ulink url="http://www.kde.org">KDE Home Page</ulink>.
3710
Gphoto2 can be obtained from <ulink url="http://www.gphoto.org">Gphoto Home Page</ulink>.
3714
libkipi can be obtained from <ulink url="http://extragear.kde.org/apps/kipi">
3715
http://extragear.kde.org/apps/kipi</ulink>.
3719
libkexif can be obtained from <ulink url="http://digikam.sourceforge.net">
3720
http://digikam.sourceforge.net</ulink>.
3724
DigikamImagePlugins can be obtained from <ulink url="http://extragear.kde.org/apps/digikamimageplugins">
3725
http://extragear.kde.org/apps/digikamimageplugins</ulink>.
3729
Most likely your distribution vendor might already have packaged and provided these packages.
3734
<sect1 id="compilation">
3735
<title>Compilation and Installation</title>
3738
In order to compile and install &digikam; on your system, type the following in the basedirectorys of the <emphasis>libkipi</emphasis> and <emphasis>digikam</emphasis> module distributions:
3741
<prompt>%</prompt> <userinput>export WANT_AUTOCONF_2_5=1</userinput>
3742
<prompt>%</prompt> <userinput>export KDEDIR=KDE_installation_dir_on_your_system</userinput>
3743
<prompt>%</prompt> <userinput>export
3744
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/path/to/installation/lib/pkgconfig</userinput>
3745
<prompt>%</prompt> <userinput>make -f Makefile.cvs</userinput>
3746
<prompt>%</prompt> <userinput>./configure</userinput>
3747
<prompt>%</prompt> <userinput>make</userinput>
3748
<prompt>%</prompt> <userinput>su</userinput>
3749
<prompt>%</prompt> <userinput>make install</userinput>
3754
<title>Important Notices</title>
3757
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.
3761
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.
3765
Use <emphasis>--enable-debug=full</emphasis> option with <emphasis>configure</emphasis> script for to provide a full informations bug report.
3769
Because &digikam; depends on <emphasis>libkipi</emphasis> and <emphasis>libkexif</emphasis>, you must build these libraries before you build &digikam;.
3775
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@lists.sourceforge.net</email>.
3782
&documentation.index;
3787
sgml-minimize-attributes:nil
3788
sgml-general-insert-case:lower
3790
sgml-indent-data:nil
b'\\ No newline at end of file'