diff options
Diffstat (limited to 'doc/en')
240 files changed, 10070 insertions, 0 deletions
diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am new file mode 100644 index 00000000..462f19fb --- /dev/null +++ b/doc/en/Makefile.am @@ -0,0 +1,2 @@ +SUBDIRS = $(AUTODIRS) + diff --git a/doc/en/digikam/2Greens.png b/doc/en/digikam/2Greens.png Binary files differnew file mode 100644 index 00000000..a06028d1 --- /dev/null +++ b/doc/en/digikam/2Greens.png diff --git a/doc/en/digikam/DAM-Metadata.png b/doc/en/digikam/DAM-Metadata.png Binary files differnew file mode 100644 index 00000000..5d807699 --- /dev/null +++ b/doc/en/digikam/DAM-Metadata.png diff --git a/doc/en/digikam/DAM-Workflow.png b/doc/en/digikam/DAM-Workflow.png Binary files differnew file mode 100644 index 00000000..58fbf898 --- /dev/null +++ b/doc/en/digikam/DAM-Workflow.png diff --git a/doc/en/digikam/DAM-errors.png b/doc/en/digikam/DAM-errors.png Binary files differnew file mode 100644 index 00000000..e88d48c7 --- /dev/null +++ b/doc/en/digikam/DAM-errors.png diff --git a/doc/en/digikam/DAM-pyramid.png b/doc/en/digikam/DAM-pyramid.png Binary files differnew file mode 100644 index 00000000..903ccd53 --- /dev/null +++ b/doc/en/digikam/DAM-pyramid.png diff --git a/doc/en/digikam/DAM-story.png b/doc/en/digikam/DAM-story.png Binary files differnew file mode 100644 index 00000000..cb7c4eeb --- /dev/null +++ b/doc/en/digikam/DAM-story.png diff --git a/doc/en/digikam/DAM-transmission.png b/doc/en/digikam/DAM-transmission.png Binary files differnew file mode 100644 index 00000000..eb3194b4 --- /dev/null +++ b/doc/en/digikam/DAM-transmission.png diff --git a/doc/en/digikam/ICCworkflowlogic.png b/doc/en/digikam/ICCworkflowlogic.png Binary files differnew file mode 100644 index 00000000..3535c69f --- /dev/null +++ b/doc/en/digikam/ICCworkflowlogic.png diff --git a/doc/en/digikam/Makefile.am b/doc/en/digikam/Makefile.am new file mode 100644 index 00000000..18e36ac7 --- /dev/null +++ b/doc/en/digikam/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = en +KDE_DOCS = digikam diff --git a/doc/en/digikam/README b/doc/en/digikam/README new file mode 100644 index 00000000..dbda8348 --- /dev/null +++ b/doc/en/digikam/README @@ -0,0 +1,44 @@ +Handbook README: +---------------- +The substructure of the help files that develop as a tree are created by <chapter> tags. + +>>> How to Make Screenshot for Manual with Alpha Blending 3D Border <<< + +- Never use advanced color theme to make screenshots. Always use KDE default color and icon set. + +- Use KSnapshot or Gimp Import to take a shot. Use region selection option to select only + important area. Remove buttons and dialog header to limit image file size. + _ALWAYS use PNG file format to save image. + +- Open your screenshot in Gimp 2.0 and make operations below: + + * Script-Fu/Decor/Add Border with this options : + -> Border X Size = 1 + -> Border Y Size = 1 + -> Border Color = black (R:0, G:0, B:0) + -> Delata Value on Color = 1 + * Image/Flatten Image + * Script-Fu/Shadow/Drop-Shadow with this options : + -> Offset X = 5 + -> Offset Y = 5 + -> Blur Radius = 10 + -> Color = black (R:0, G:0, B:0) + -> Opacity = 80 + -> Allow Resizing = On + * Save target image in PNG with max compression (Compression Level = 9) + +Note : A gimp2.[2,3] script from Gerhard Kulzer can be used to add Alpha Blending 3D Border around screenshots. + Always use default settings. Script can be downloaded from this url: + +http://digikam3rdparty.free.fr/Tools/kde-screenshot-dropshadow.scm + +!----------Important-------------! +Since the documentation is very good it is also very demanding in terms of volume, 99% whereof are screenshots. In order to limit the byte count to the minimum the following command chain shall be used to reduce the png file size. A factor of 2-4 can be gained. From within the folder where the png reside issue this command (requires pngnq and optipng to be installed on the system): + +pngnq -s 1 ./*.png && optipng *-nq8.png && rename -f s/-nq8\.png/.png/ *-nq8.png + + +Gilles Caulier <caulier dot gilles at gmail dot com> +Gerhard Kulzer <gerhard at kulzer dot net> + +
\ No newline at end of file diff --git a/doc/en/digikam/Shortcuts b/doc/en/digikam/Shortcuts new file mode 100644 index 00000000..1cf31973 --- /dev/null +++ b/doc/en/digikam/Shortcuts @@ -0,0 +1,52 @@ +m_HSLAction = new KAction(i18n("Hue/Saturation/Lightness..."), "adjusths +./imageplugins/imageplugin_core.cpp: CTRL+Key_U, // NOTE: Photoshop 7 use CTRL+U. +m_RGBAction = new KAction(i18n("Color Balance..."), "adjustrgb", +./imageplugins/imageplugin_core.cpp: CTRL+Key_B, // NOTE: Photoshop 7 use CTRL+B. +m_autoCorrectionAction = new KAction(i18n("Auto-Correction..."), "autocorrection", +./imageplugins/imageplugin_core.cpp: CTRL+SHIFT+Key_B, // NOTE: Photoshop 7 use CTRL+SHIFT+B with 'Auto-Color' option. +m_invertAction = new KAction(i18n("Invert"), "invertimage", +./imageplugins/imageplugin_core.cpp: CTRL+Key_I, // NOTE: Photoshop 7 use CTRL+I. +./digikam/digikamapp.cpp: m_accelerators->insert("Copy Album Items Selection CTRL+Key_C", i18n("Copy Album Items Selection"), +./digikam/digikamapp.cpp: CTRL+Key_C, this, TQ_SIGNAL(signalCopyAlbumItemsSelection()), +./digikam/digikamapp.cpp: m_accelerators->insert("Paste Album Items Selection CTRL+Key_V", i18n("Paste Album Items Selection"), +./digikam/digikamapp.cpp: CTRL+Key_V, this, TQ_SIGNAL(signalPasteAlbumItemsSelection()), +./digikam/digikamapp.cpp: CTRL+Key_I, +./digikam/digikamapp.cpp: CTRL+Key_A, +./digikam/digikamapp.cpp: CTRL+Key_U, +./digikam/digikamapp.cpp: CTRL+Key_Asterisk, +./digikam/digikamapp.cpp: CTRL+Key_Plus, +./digikam/digikamapp.cpp: CTRL+Key_Minus, +./digikam/digikamapp.cpp: CTRL+SHIFT+Key_F, +./digikam/digikamapp.cpp: m_0Star = new KAction(i18n("Assign Rating \"No Star\""), CTRL+Key_0, +./digikam/digikamapp.cpp: m_1Star = new KAction(i18n("Assign Rating \"One Star\""), CTRL+Key_1, +./digikam/digikamapp.cpp: m_2Star = new KAction(i18n("Assign Rating \"Two Stars\""), CTRL+Key_2, +./digikam/digikamapp.cpp: m_3Star = new KAction(i18n("Assign Rating \"Three Stars\""), CTRL+Key_3, +./digikam/digikamapp.cpp: m_4Star = new KAction(i18n("Assign Rating \"Four Stars\""), CTRL+Key_4, +./digikam/digikamapp.cpp: m_5Star = new KAction(i18n("Assign Rating \"Five Stars\""), CTRL+Key_5, +./showfoto/showfoto.cpp: CTRL+SHIFT+Key_O, +./showfoto/showfoto.cpp: CTRL+Key_T, +./utilities/imageeditor/editor/editorwindow.cpp: CTRL+Key_P, +./utilities/imageeditor/editor/editorwindow.cpp: CTRL+SHIFT+Key_A, this, TQ_SLOT(slotToggleAutoZoom()), +./utilities/imageeditor/editor/editorwindow.cpp: CTRL+SHIFT+Key_F, this, +./utilities/imageeditor/editor/editorwindow.cpp: CTRL+Key_X, +./utilities/imageeditor/editor/editorwindow.cpp: d->flipHorzAction = new KAction(i18n("Horizontally"), 0, CTRL+Key_Asterisk, +./utilities/imageeditor/editor/editorwindow.cpp: d->flipVertAction = new KAction(i18n("Vertically"), 0, CTRL+Key_Slash, +./utilities/imageeditor/editor/editorwindow.cpp: 0, CTRL+Key_9, m_canvas, TQ_SLOT(slotRotate90()), +./utilities/imageeditor/editor/editorwindow.cpp: 0, CTRL+Key_8, m_canvas, TQ_SLOT(slotRotate180()), +./utilities/imageeditor/editor/editorwindow.cpp: 0, CTRL+Key_7, m_canvas, TQ_SLOT(slotRotate270()), +./utilities/imageeditor/editor/imagewindow.cpp: d->star0 = new KAction(i18n("Assign Rating \"No Star\""), CTRL+Key_0, +./utilities/imageeditor/editor/imagewindow.cpp: d->star1 = new KAction(i18n("Assign Rating \"One Star\""), CTRL+Key_1, +./utilities/imageeditor/editor/imagewindow.cpp: d->star2 = new KAction(i18n("Assign Rating \"Two Stars\""), CTRL+Key_2, +./utilities/imageeditor/editor/imagewindow.cpp: d->star3 = new KAction(i18n("Assign Rating \"Three Stars\""), CTRL+Key_3, +./utilities/imageeditor/editor/imagewindow.cpp: d->star4 = new KAction(i18n("Assign Rating \"Four Stars\""), CTRL+Key_4, +./utilities/imageeditor/editor/imagewindow.cpp: d->star5 = new KAction(i18n("Assign Rating \"Five Stars\""), CTRL+Key_5, +./utilities/cameragui/cameraui.cpp: d->imageMenu->insertItem(i18n("Select &All"), d->view, TQ_SLOT(slotSelectAll()), CTRL+Key_A, 0); +./utilities/cameragui/cameraui.cpp: d->imageMenu->insertItem(i18n("Select N&one"), d->view, TQ_SLOT(slotSelectNone()), CTRL+Key_U, 1); +./utilities/cameragui/cameraui.cpp: d->imageMenu->insertItem(i18n("&Invert Selection"), d->view, TQ_SLOT(slotSelectInvert()), CTRL+Key_Asterisk, 2); +./utilities/cameragui/cameraui.cpp: d->imageMenu->insertItem(i18n("Increase Thumbs"), this, TQ_SLOT(slotIncreaseThumbSize()), CTRL+Key_Plus, 4); +./utilities/cameragui/cameraui.cpp: d->imageMenu->insertItem(i18n("Decrease Thumbs"), this, TQ_SLOT(slotDecreaseThumbSize()), CTRL+Key_Minus, 5); +./ChangeLog: rotate an image in editor, use CTRL+7, CTRL+8, CTRL+9 to prevent +./ChangeLog: - 2 keyboard shorcuts can be used to change thumbs size : CTRL+ +./ChangeLog: CTRL+0/1/2/3/4/5 from Image Editor +./ChangeLog: CTRL+0/1/2/3/4/5 from main interface +./ChangeLog: Rating image using keyboard shortcuts CTRL+0/1/2/3/4/5 from main diff --git a/doc/en/digikam/TODO b/doc/en/digikam/TODO new file mode 100644 index 00000000..fb8add94 --- /dev/null +++ b/doc/en/digikam/TODO @@ -0,0 +1,10 @@ +&digikam; handbook TODO list for 0.9.2 release +-------------------------------------------- + +- Red eye plugin +- Better descriptions of all startup operations (scan pictures) +- Updated image plugins dialog templates. + + +Gimp script to prepare screenshots for docbook: +Gimp : ftp://[email protected]/Tools/kde-screenshot-dropshadow.scm diff --git a/doc/en/digikam/adjustcurvesdialog.png b/doc/en/digikam/adjustcurvesdialog.png Binary files differnew file mode 100644 index 00000000..1c80915a --- /dev/null +++ b/doc/en/digikam/adjustcurvesdialog.png diff --git a/doc/en/digikam/adjustcurvespreview.png b/doc/en/digikam/adjustcurvespreview.png Binary files differnew file mode 100644 index 00000000..c63d7f03 --- /dev/null +++ b/doc/en/digikam/adjustcurvespreview.png diff --git a/doc/en/digikam/adjustlevelsdialog.png b/doc/en/digikam/adjustlevelsdialog.png Binary files differnew file mode 100644 index 00000000..58e37146 --- /dev/null +++ b/doc/en/digikam/adjustlevelsdialog.png diff --git a/doc/en/digikam/adjustlevelspreview.png b/doc/en/digikam/adjustlevelspreview.png Binary files differnew file mode 100644 index 00000000..95d71d68 --- /dev/null +++ b/doc/en/digikam/adjustlevelspreview.png diff --git a/doc/en/digikam/antivignettingdialog.png b/doc/en/digikam/antivignettingdialog.png Binary files differnew file mode 100644 index 00000000..24756326 --- /dev/null +++ b/doc/en/digikam/antivignettingdialog.png diff --git a/doc/en/digikam/antivignettingpreview.png b/doc/en/digikam/antivignettingpreview.png Binary files differnew file mode 100644 index 00000000..512a4711 --- /dev/null +++ b/doc/en/digikam/antivignettingpreview.png diff --git a/doc/en/digikam/blowupdialog.png b/doc/en/digikam/blowupdialog.png Binary files differnew file mode 100644 index 00000000..b3442753 --- /dev/null +++ b/doc/en/digikam/blowupdialog.png diff --git a/doc/en/digikam/blowuppreview.png b/doc/en/digikam/blowuppreview.png Binary files differnew file mode 100644 index 00000000..ff2089fb --- /dev/null +++ b/doc/en/digikam/blowuppreview.png diff --git a/doc/en/digikam/blowupsettings1.png b/doc/en/digikam/blowupsettings1.png Binary files differnew file mode 100644 index 00000000..af070cf3 --- /dev/null +++ b/doc/en/digikam/blowupsettings1.png diff --git a/doc/en/digikam/blowupsettings2.png b/doc/en/digikam/blowupsettings2.png Binary files differnew file mode 100644 index 00000000..15fc3a1f --- /dev/null +++ b/doc/en/digikam/blowupsettings2.png diff --git a/doc/en/digikam/blurfx_farblur.png b/doc/en/digikam/blurfx_farblur.png Binary files differnew file mode 100644 index 00000000..96cc78b8 --- /dev/null +++ b/doc/en/digikam/blurfx_farblur.png diff --git a/doc/en/digikam/blurfx_focusblur.png b/doc/en/digikam/blurfx_focusblur.png Binary files differnew file mode 100644 index 00000000..afb8b3cc --- /dev/null +++ b/doc/en/digikam/blurfx_focusblur.png diff --git a/doc/en/digikam/blurfx_frostglass.png b/doc/en/digikam/blurfx_frostglass.png Binary files differnew file mode 100644 index 00000000..1298c73a --- /dev/null +++ b/doc/en/digikam/blurfx_frostglass.png diff --git a/doc/en/digikam/blurfx_mosaic.png b/doc/en/digikam/blurfx_mosaic.png Binary files differnew file mode 100644 index 00000000..fa854121 --- /dev/null +++ b/doc/en/digikam/blurfx_mosaic.png diff --git a/doc/en/digikam/blurfx_motionblur.png b/doc/en/digikam/blurfx_motionblur.png Binary files differnew file mode 100644 index 00000000..bec924ad --- /dev/null +++ b/doc/en/digikam/blurfx_motionblur.png diff --git a/doc/en/digikam/blurfx_radialblur.png b/doc/en/digikam/blurfx_radialblur.png Binary files differnew file mode 100644 index 00000000..ea7f384f --- /dev/null +++ b/doc/en/digikam/blurfx_radialblur.png diff --git a/doc/en/digikam/blurfx_shakeblur.png b/doc/en/digikam/blurfx_shakeblur.png Binary files differnew file mode 100644 index 00000000..e9d6172e --- /dev/null +++ b/doc/en/digikam/blurfx_shakeblur.png diff --git a/doc/en/digikam/blurfx_smartblur.png b/doc/en/digikam/blurfx_smartblur.png Binary files differnew file mode 100644 index 00000000..376de74d --- /dev/null +++ b/doc/en/digikam/blurfx_smartblur.png diff --git a/doc/en/digikam/blurfx_softenerblur.png b/doc/en/digikam/blurfx_softenerblur.png Binary files differnew file mode 100644 index 00000000..9744c9ce --- /dev/null +++ b/doc/en/digikam/blurfx_softenerblur.png diff --git a/doc/en/digikam/blurfx_zoomblur.png b/doc/en/digikam/blurfx_zoomblur.png Binary files differnew file mode 100644 index 00000000..f19d0203 --- /dev/null +++ b/doc/en/digikam/blurfx_zoomblur.png diff --git a/doc/en/digikam/blurfxpreview.png b/doc/en/digikam/blurfxpreview.png Binary files differnew file mode 100644 index 00000000..757df190 --- /dev/null +++ b/doc/en/digikam/blurfxpreview.png diff --git a/doc/en/digikam/borderpreview.png b/doc/en/digikam/borderpreview.png Binary files differnew file mode 100644 index 00000000..89d5cd03 --- /dev/null +++ b/doc/en/digikam/borderpreview.png diff --git a/doc/en/digikam/cameraclient.png b/doc/en/digikam/cameraclient.png Binary files differnew file mode 100644 index 00000000..a21b678b --- /dev/null +++ b/doc/en/digikam/cameraclient.png diff --git a/doc/en/digikam/cameraclientdownload.png b/doc/en/digikam/cameraclientdownload.png Binary files differnew file mode 100644 index 00000000..c57ffdfc --- /dev/null +++ b/doc/en/digikam/cameraclientdownload.png diff --git a/doc/en/digikam/cameraclientidentity.png b/doc/en/digikam/cameraclientidentity.png Binary files differnew file mode 100644 index 00000000..74703efb --- /dev/null +++ b/doc/en/digikam/cameraclientidentity.png diff --git a/doc/en/digikam/cameraclientitemproperties.png b/doc/en/digikam/cameraclientitemproperties.png Binary files differnew file mode 100644 index 00000000..d4b6ae53 --- /dev/null +++ b/doc/en/digikam/cameraclientitemproperties.png diff --git a/doc/en/digikam/cameraclientsetting1.png b/doc/en/digikam/cameraclientsetting1.png Binary files differnew file mode 100644 index 00000000..5aa6c87e --- /dev/null +++ b/doc/en/digikam/cameraclientsetting1.png diff --git a/doc/en/digikam/cameraclientsetting2.png b/doc/en/digikam/cameraclientsetting2.png Binary files differnew file mode 100644 index 00000000..48bbad6b --- /dev/null +++ b/doc/en/digikam/cameraclientsetting2.png diff --git a/doc/en/digikam/cameraclientsetting3.png b/doc/en/digikam/cameraclientsetting3.png Binary files differnew file mode 100644 index 00000000..7c758633 --- /dev/null +++ b/doc/en/digikam/cameraclientsetting3.png diff --git a/doc/en/digikam/camerafolderselectiondialog.png b/doc/en/digikam/camerafolderselectiondialog.png Binary files differnew file mode 100644 index 00000000..f34012ae --- /dev/null +++ b/doc/en/digikam/camerafolderselectiondialog.png diff --git a/doc/en/digikam/cameratargetalbumdialog.png b/doc/en/digikam/cameratargetalbumdialog.png Binary files differnew file mode 100644 index 00000000..ff1d8b28 --- /dev/null +++ b/doc/en/digikam/cameratargetalbumdialog.png diff --git a/doc/en/digikam/channelmixerdialog.png b/doc/en/digikam/channelmixerdialog.png Binary files differnew file mode 100644 index 00000000..019b3de6 --- /dev/null +++ b/doc/en/digikam/channelmixerdialog.png diff --git a/doc/en/digikam/channelmixerpreview.png b/doc/en/digikam/channelmixerpreview.png Binary files differnew file mode 100644 index 00000000..646126a5 --- /dev/null +++ b/doc/en/digikam/channelmixerpreview.png diff --git a/doc/en/digikam/charcoalpreview.png b/doc/en/digikam/charcoalpreview.png Binary files differnew file mode 100644 index 00000000..e703a3bc --- /dev/null +++ b/doc/en/digikam/charcoalpreview.png diff --git a/doc/en/digikam/cimg-logo.png b/doc/en/digikam/cimg-logo.png Binary files differnew file mode 100644 index 00000000..8383ff41 --- /dev/null +++ b/doc/en/digikam/cimg-logo.png diff --git a/doc/en/digikam/colormanagement.png b/doc/en/digikam/colormanagement.png Binary files differnew file mode 100644 index 00000000..cc241f39 --- /dev/null +++ b/doc/en/digikam/colormanagement.png diff --git a/doc/en/digikam/credits-annex.docbook b/doc/en/digikam/credits-annex.docbook new file mode 100644 index 00000000..bf064d74 --- /dev/null +++ b/doc/en/digikam/credits-annex.docbook @@ -0,0 +1,218 @@ +<chapter id="credits"> <title>Credits and License</title> + +<para> + + <inlinemediaobject> + <imageobject><imagedata fileref="&path;digikamlogo.png" format="PNG"/></imageobject> + <textobject> <phrase>&digikam; logo</phrase> </textobject> + </inlinemediaobject> + +</para> + +<para> +Program copyright 2001-2006, &digikam; developers team + + <itemizedlist> + + <listitem> + <para> + Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email>: + Coordinator, Main Developer. + </para> + </listitem> + + <listitem> + <para> + Caulier Gilles <email>caulier_dot_gilles_at_gmail_dot_com</email>: + Co-coordinator, Developer, French Translations. + </para> + </listitem> + + <listitem> + <para> + Joern Ahrens <email>kde_at_jokele.de</email>: + Developer. + </para> + </listitem> + + <listitem> + <para> + Tom Albers <email>tomalbers_at_kde.nl</email>: + Developer. + </para> + </listitem> + + <listitem> + <para> + Ralf Hoelzer <email>kde_at_ralfhoelzer.com</email>: + Developer. + </para> + </listitem> + + </itemizedlist> + +</para> + +<para> +Documentation copyrighted by: + + <itemizedlist> + + <listitem> + <para> + 2001-2002 + Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email>. + </para> + </listitem> + + <listitem> + <para> + 2002-2003 + <itemizedlist> + <listitem><para>Gilles Caulier <email>caulier_dot_gilles_at_gmail_dot_com</email></para></listitem> + <listitem><para>Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email></para></listitem> + </itemizedlist> + </para> + </listitem> + + <listitem> + <para> + 2003-2005 + <itemizedlist> + <listitem><para>Gilles Caulier <email>caulier_dot_gilles_at_gmail_dot_com</email></para></listitem> + <listitem><para>Renchi Raju <email>renchi_at_pooh.tam.uiuc.edu</email></para></listitem> + <listitem><para>Richard Taylor + <email>rjt-digicam_at_thegrindstone_dot_me_dot_uk</email></para></listitem> + <listitem><para>Ralf Hoelzer <email>kde_at_ralfhoelzer.com</email></para></listitem> + <listitem><para>Joern Ahrens <email>kde_at_jokele.de</email></para></listitem> + <listitem><para>Oliver Doerr <email>oliver_at_doerr-privat.de</email></para></listitem> + <listitem><para>Gerhard Kulzer <email>gerhard at kulzer.net</email></para></listitem> + </itemizedlist> + 2005-2007 + <itemizedlist> + <listitem><para>Gilles Caulier <email>caulier_dot_gilles_at_gmail_dot_com</email></para></listitem> + <listitem><para>Gerhard Kulzer <email>gerhard at kulzer.net</email></para></listitem> + </itemizedlist> + </para> + </listitem> + + </itemizedlist> + +All Images copyrighted 2003-2007 by Gilles Caulier <email>caulier_dot_gilles_at_gmail_dot_com</email> and Gerhard Kulzer <email>gerhard_at_kulzer_dot_net</email>. +</para> + +<!-- TRANS:CREDIT_FOR_TRANSLATORS --> + +&underFDL; + +&underGPL; + +</chapter> + +<appendix id="installation"> <title>Installation</title> + +<sect1 id="getting-kapp"> <title>How to Obtain &digikam;</title> + +<para> +The website for &digikam; is at <ulink url="http://www.digikam.org">http://www.digikam.org</ulink>. Please check it regularly to get the latest news about &digikam;. &digikam; can be obtained in binary and source format from <ulink url="http://sourceforge.net/project/showfiles.php?group_id=42641">http://sourceforge.net/project/showfiles.php?group_id=42641</ulink>. +</para> + +<para> +Also you can checkout the <emphasis>digikam</emphasis> and <emphasis>kipi</emphasis> source code modules +from &kde; Extragear SVN repository like this: + +<screen width="40"> + <prompt>%</prompt> <userinput>svn co -N svn://anonsvn.kde.org/home/kde/trunk/extragear/graphics</userinput> + <prompt>%</prompt> <userinput>cd graphics</userinput> + <prompt>%</prompt> <userinput>svn up digikam</userinput> + <prompt>%</prompt> <userinput>svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/kde-common/admin</userinput> +</screen> + +</para> + +<para> +The last SVN snapshoots can be downloaded at this &URL; <ulink url="ftp://ftp.kde.org/pub/kde/unstable/snapshots/"> +ftp://ftp.kde.org/pub/kde/unstable/snapshots/</ulink>. +</para> + +</sect1> + +<sect1 id="requirements"> <title>Requirements</title> + +<para> +In order to successfully use &digikam;, you need the following: +<itemizedlist> + <listitem><para>AutoConf >= 2.5 <ulink url="http://www.gnu.org/software/autoconf">GNU autoconf</ulink></para></listitem> + <listitem><para>AutoMake >= 1.7.0 <ulink url="http://www.gnu.org/software/automake">GNU automake</ulink></para></listitem> + <listitem><para>&kde; 3.x <ulink url="http://www.kde.org">&kde; Home Page</ulink></para></listitem> + <listitem><para>libtqt >= 3.3.x <ulink url="http://www.trolltech.com">Trolltech</ulink></para></listitem> + <listitem><para>libsqlite >= 3.x <ulink url="http://www.sqlite.org">SQlite3</ulink></para></listitem> + <listitem><para>gphoto2 >= 2.x <ulink url="http://www.gphoto.org">Gphoto Home Page</ulink></para></listitem> + <listitem><para>libgdbm >= 1.8.0</para></listitem> + <listitem><para>libkipi >= 0.1 <ulink url="http://www.kipi-plugins.org">www.kipi-plugins.org</ulink></para></listitem> + <listitem><para>libkexiv2 >= 0.1 <ulink url="http://www.kipi-plugins.org">www.kipi-plugins.org</ulink></para></listitem> + <listitem><para>libdcraw >= 0.1.5 <ulink url="http://www.kipi-plugins.org">www.kipi-plugins.org</ulink></para></listitem> + <listitem><para>libtiff >= 3.6.x (>=3.8.2 recommended) <ulink url="http://www.remotesensing.org/libtiff">www.remotesensing.org</ulink></para></listitem> + <listitem><para>libpng >= 1.2.0 <ulink url="http://www.libpng.org/pub/png/libpng.html">www.libpng.org</ulink></para></listitem> + <listitem><para>liblcms >= 1.14.x <ulink url="http://www.littlecms.com">Little CMS Home Page</ulink></para></listitem> + <listitem><para>libjasper >= 1.7 <ulink url="http://www.ece.uvic.ca/~mdadams/jasper">Jasper site</ulink></para></listitem> + <listitem><para>exiv2 >= 0.12 (>=0.14 recommended) <ulink url="http://www.exiv2.org">Exiv2.org</ulink></para></listitem> +</itemizedlist> +All library dependencies require development and binary packages installed on your +computer to compile &digikam;. +</para> + +<para> +Most likely your distribution vendor might already have packaged and provided these packages. +</para> + +</sect1> + +<sect1 id="compilation"> <title>Compilation and Installation</title> + +<para> +In order to compile and install &digikam; on your system, type the following in the base folder of the <emphasis>libkipi</emphasis> and <emphasis>digikam</emphasis> module distributions: + +<screen width="40"> + <prompt>%</prompt> <userinput>export WANT_AUTOCONF_2_5=1</userinput> + <prompt>%</prompt> <userinput>export KDEDIR=KDE_installation_dir_on_your_system</userinput> + <prompt>%</prompt> <userinput>export + PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/path/to/installation/lib/pkgconfig</userinput> + <prompt>%</prompt> <userinput>make -f Makefile.cvs</userinput> + <prompt>%</prompt> <userinput>./configure</userinput> + <prompt>%</prompt> <userinput>make</userinput> + <prompt>%</prompt> <userinput>su</userinput> + <prompt>%</prompt> <userinput>make install</userinput> +</screen> +</para> + +<note> +<title>Important Notes</title> + +<para> +Stage 3 is required if you are installing libkipi/libkexiv2 in a non-standard location, and you must let pkg-config know about their paths. +</para> + +<para> +More specific compilation and installation options can be passed to the <emphasis>configure</emphasis> script. Use <userinput>./configure --help</userinput> on the command line to view these options. +</para> + +<para> +Use <emphasis>--enable-debug=full</emphasis> option with <emphasis>configure</emphasis> script for to provide a full information bug report. +</para> + +<para> +Because &digikam; depends on <emphasis>libkipi</emphasis> and <emphasis>libkexif</emphasis>, you must build these libraries before you build &digikam;. +</para> + +</note> + +<para> +Since &digikam; uses autoconf and automake you should not have trouble compiling it. If you run into problems please report them to <email>[email protected]</email>. +</para> + +</sect1> + +</appendix> + +&documentation.index; diff --git a/doc/en/digikam/digikamlogo.png b/doc/en/digikam/digikamlogo.png Binary files differnew file mode 100644 index 00000000..bd141649 --- /dev/null +++ b/doc/en/digikam/digikamlogo.png diff --git a/doc/en/digikam/distortionfx_blockwaves1.png b/doc/en/digikam/distortionfx_blockwaves1.png Binary files differnew file mode 100644 index 00000000..f3d37fb9 --- /dev/null +++ b/doc/en/digikam/distortionfx_blockwaves1.png diff --git a/doc/en/digikam/distortionfx_blockwaves2.png b/doc/en/digikam/distortionfx_blockwaves2.png Binary files differnew file mode 100644 index 00000000..e8efe0da --- /dev/null +++ b/doc/en/digikam/distortionfx_blockwaves2.png diff --git a/doc/en/digikam/distortionfx_caricature.png b/doc/en/digikam/distortionfx_caricature.png Binary files differnew file mode 100644 index 00000000..5a25a03b --- /dev/null +++ b/doc/en/digikam/distortionfx_caricature.png diff --git a/doc/en/digikam/distortionfx_circularwaves1.png b/doc/en/digikam/distortionfx_circularwaves1.png Binary files differnew file mode 100644 index 00000000..3c5ec781 --- /dev/null +++ b/doc/en/digikam/distortionfx_circularwaves1.png diff --git a/doc/en/digikam/distortionfx_circularwaves2.png b/doc/en/digikam/distortionfx_circularwaves2.png Binary files differnew file mode 100644 index 00000000..0ccd25c6 --- /dev/null +++ b/doc/en/digikam/distortionfx_circularwaves2.png diff --git a/doc/en/digikam/distortionfx_corners.png b/doc/en/digikam/distortionfx_corners.png Binary files differnew file mode 100644 index 00000000..283fa4c9 --- /dev/null +++ b/doc/en/digikam/distortionfx_corners.png diff --git a/doc/en/digikam/distortionfx_cylinderh.png b/doc/en/digikam/distortionfx_cylinderh.png Binary files differnew file mode 100644 index 00000000..93cf1aa9 --- /dev/null +++ b/doc/en/digikam/distortionfx_cylinderh.png diff --git a/doc/en/digikam/distortionfx_cylinderhv.png b/doc/en/digikam/distortionfx_cylinderhv.png Binary files differnew file mode 100644 index 00000000..c9edca25 --- /dev/null +++ b/doc/en/digikam/distortionfx_cylinderhv.png diff --git a/doc/en/digikam/distortionfx_cylinderv.png b/doc/en/digikam/distortionfx_cylinderv.png Binary files differnew file mode 100644 index 00000000..507adc3c --- /dev/null +++ b/doc/en/digikam/distortionfx_cylinderv.png diff --git a/doc/en/digikam/distortionfx_fisheyes.png b/doc/en/digikam/distortionfx_fisheyes.png Binary files differnew file mode 100644 index 00000000..5208b75b --- /dev/null +++ b/doc/en/digikam/distortionfx_fisheyes.png diff --git a/doc/en/digikam/distortionfx_polarcoord.png b/doc/en/digikam/distortionfx_polarcoord.png Binary files differnew file mode 100644 index 00000000..e87998f7 --- /dev/null +++ b/doc/en/digikam/distortionfx_polarcoord.png diff --git a/doc/en/digikam/distortionfx_tiles.png b/doc/en/digikam/distortionfx_tiles.png Binary files differnew file mode 100644 index 00000000..3984881f --- /dev/null +++ b/doc/en/digikam/distortionfx_tiles.png diff --git a/doc/en/digikam/distortionfx_twirl.png b/doc/en/digikam/distortionfx_twirl.png Binary files differnew file mode 100644 index 00000000..4dc7e9ea --- /dev/null +++ b/doc/en/digikam/distortionfx_twirl.png diff --git a/doc/en/digikam/distortionfx_unpolarcoord.png b/doc/en/digikam/distortionfx_unpolarcoord.png Binary files differnew file mode 100644 index 00000000..cd01c670 --- /dev/null +++ b/doc/en/digikam/distortionfx_unpolarcoord.png diff --git a/doc/en/digikam/distortionfx_wavesh.png b/doc/en/digikam/distortionfx_wavesh.png Binary files differnew file mode 100644 index 00000000..041956cc --- /dev/null +++ b/doc/en/digikam/distortionfx_wavesh.png diff --git a/doc/en/digikam/distortionfx_wavesv.png b/doc/en/digikam/distortionfx_wavesv.png Binary files differnew file mode 100644 index 00000000..dc37d0d6 --- /dev/null +++ b/doc/en/digikam/distortionfx_wavesv.png diff --git a/doc/en/digikam/distortionfxpreview.png b/doc/en/digikam/distortionfxpreview.png Binary files differnew file mode 100644 index 00000000..2983aca4 --- /dev/null +++ b/doc/en/digikam/distortionfxpreview.png diff --git a/doc/en/digikam/distortions.png b/doc/en/digikam/distortions.png Binary files differnew file mode 100644 index 00000000..25e9494b --- /dev/null +++ b/doc/en/digikam/distortions.png diff --git a/doc/en/digikam/editor-color.docbook b/doc/en/digikam/editor-color.docbook new file mode 100644 index 00000000..62c4da9c --- /dev/null +++ b/doc/en/digikam/editor-color.docbook @@ -0,0 +1,1052 @@ +<sect2> <title>Color editing tools</title> + +<sect3 id="auto-correction"> +<sect3info> <title>Auto-Correction Tools</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> + <para> + This tool set provides five automatic correction levels that will improve an image in most cases. Use this tool before going into the more involved manual adjustments. + </para> + </abstract> +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> +<title>Introduction</title> + <anchor id="autocolorcorrectiontool.anchor"/> + + <para> + The <guilabel>Normalize</guilabel>, <guilabel>Equalize</guilabel>, <guilabel>Auto Levels</guilabel>, and <guilabel>Stretch Contrast</guilabel> available from <menuchoice><guilabel>Correct</guilabel><guimenuitem>Auto-Correction</guimenuitem></menuchoice> menu entry menu will attempt to work out the best color levels automatically. You will need to experiment with the effects of these functions to see what works best with your photograph. + + <itemizedlist> + + <listitem><para> + <guilabel>Normalize</guilabel>: this method scales brightness values across the selected image so that the darkest point becomes black, and the brightest point becomes as bright as possible without altering its hue. This is often a "magic fix" for images that are dim or washed out. + + <example><title>Normalize Colors Correction Preview</title> <screenshot><screeninfo>Normalize Colors Correction Preview</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editornormalize.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </para></listitem> + + <listitem><para> + <guilabel>Equalize</guilabel>: this method adjusts the brightness of colors across the selected image so that the histogram for the Value channel is as flat as possible, that is, so that each possible brightness value appears at about the same number of pixels as each other value. Sometimes Equalize works wonderfully at enhancing the contrasts of an image. Other times it gives garbage. It is a very powerful operation, which can either work miracles on a image or destroy it. + + <example><title>Equalize Colors Correction Preview</title> <screenshot><screeninfo>Equalize Colors Correction Preview</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorequalize.png" format="PNG" /> </imageobject></mediaobject></screenshot> </example> + + </para></listitem> + + <listitem><para> + <guilabel>Auto-levels</guilabel>: this method maximizes the tonal range in the Red, Green, and Blue channels. It determines the image shadow and highlight limit values and adjust the Red, Green, and Blue channels to a full histogram range. + + <example><title>Auto Levels Correction Preview</title> <screenshot><screeninfo>Auto Levels Correction Preview</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorautolevels.png" format="PNG" /> </imageobject></mediaobject></screenshot> </example> + + </para></listitem> + + <listitem><para> + <guilabel>Stretch Contrast</guilabel>: this method enhances the contrast and brightness of the RGB values of an image by stretching the lowest and highest values to their fullest range, adjusting everything in between. This is noticeable only with washed-out images and can be a good fix-it tool for bad photographs. + + <example><title>Stretch Contrast Correction</title> <screenshot><screeninfo>Stretch Contrast Correction Preview</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorstretchcontrast.png" format="PNG" /> </imageobject></mediaobject></screenshot> </example> + + </para></listitem> + + </itemizedlist> + + </para> + + <para> + The results of any adjustments you make will not be remembered until you save your photograph. + </para> +</sect3> + +<sect3 id="whitebalance"> +<sect3info> + +<title>White Balance</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>White Balance</emphasis> is a semi-automatic tool to adjust the white-balance of a photograph. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +White Balance setting is a common hurdle for digital still cameras. In the 'good old time' of film rolls, the white balance was done by the photolab. Nowadays the poor little camera has to guess what is white and what is black. Most of the time, what the camera chooses as the white point, is not of the correct shade or hue. Using this tool it is easy to correct this problem. It provides a variery of parameters that can be trimmed to obtain a better result. +</para> + +<note><para> +The whitebalance correction is somewhat limited by the fact that we operate in 8bit per channel color space. So if you depart too much from the original, over exposure zones may appear. If you can adjust the whitebalance in raw conversion mode (which is done in 16 bit space), the margin for correction will be greater. +</para></note> + +<para> +This tool is based on a white color balance algorithm copyrighted by Pawel T. Jochym. Launch it from the <menuchoice><guimenu>Color</guimenu><guimenuitem>White Balance</guimenuitem></menuchoice> Image Editor menu. +</para> + +<sect4 id="using-whitebalance"> <title>Using the Whitebalance Tool</title> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;whitebalancedialog.png" format="PNG" /> </imageobject> + <textobject><phrase>The White Balance Tool Dialog</phrase></textobject></inlinemediaobject> + </para> + +<para> +The preview window can be resized. To the left, both an original and a target preview tab is shown. The target preview is updated dynamically according to the tool's settings. If you want to see the orginal whitebalance, just click on that tab. +</para> + +<para> +The target photo preview has a red marker available. The luminosity value of the pixel under the marker is shown as a vertical line in the histogram . +</para> + +<para> +To the top right, the widget displays a histogram that is dynamically updated when changing the parameters. This histogram is very instructive as it shows that even in well exposed photos, most of the pixels have very small luminosity. With a button you can select to show either one of the 3 colors (or the sum of it which is called luminosity). +</para> + +<para> +With <guilabel>Exposure</guilabel> you can digitally change the original photo exposure. Increasing the exposure is has the risk of making the pixel noise more visible and to blow out the highlights. Check the <guilabel>Over exposure indicator</guilabel> at the lower right to see if you run into saturation problems. +The <guilabel>Black Point</guilabel> adjustment can be used to cut the histogram from the left. If your photograph looks foggy (histogram has empty space on the left, black side), you probably need to use this option. The <guilabel>Exposure</guilabel> and <guilabel>Black Point</guilabel> adjustments can be automatically estimated by pressing the <guilabel>Auto Exposure Adjustments</guilabel> button. This sets the black point quite accurately. +</para> + +<para> +The contrast of your output depends on <guilabel>Shadows</guilabel>, <guilabel>Saturation</guilabel>, and <guilabel>Gamma</guilabel> parameters. The <guilabel>Shadows</guilabel> adjustment lets you enhance or diminish the shadow details in your photo. +</para> + +<para> +Increasing the contrast of your photograph can have the side effect of reducing the apparent <guilabel>Saturation</guilabel> of the photo. Use a value larger than 1 to increase the saturation and a value of less than 1 to desaturate the photo. A value of 0 will give you a black and white photo. Don't be shy to bump up the saturation of your photos a little. The general rule is that for higher Contrast (lower <guilabel>Gamma</guilabel>) you need to apply more <guilabel>Saturation</guilabel>. +</para> + +<para> +The next set of options is the mainstay of White Balance settings, which controls the ratio between the three color channels. Here you can set the color <guilabel>Temperature</guilabel>, making your image warmer or colder. Higher temperature will result in a warmer tint. Setting the ratio between the three color channels requires two adjustments. Since the temperature adjustment mostly controls the ratio between the red and the blue channels, it is natural that the second adjustment will control the intensity of the <guilabel>Green</guilabel> channel. +</para> + +<para> +Instead of fiddling around with the above controls, you can simply use the <guilabel>Temperature Tone Color Picker</guilabel> button. Press on this button and click anywhere on the original preview image to get the output color of that area to calculate the white color balance temperature settings. This way, <guilabel>Temperature</guilabel> and <guilabel>Green</guilabel> values are automatically computed. +</para> + +<para> +In addition you can set the White Balance using the preset list. These are the white color balance temperature presets available: +</para> + +<para> + +<informaltable><tgroup cols="3"> + +<thead> + <row> + <entry>Color Temperature</entry> + <entry>Description</entry> + <entry>Kelvin</entry> + </row> +</thead> + +<tbody> + + <row> + <entry> + <guilabel>40W</guilabel> + </entry> + + <entry> + 40 Watt incandescent lamp. + </entry> + + <entry> + <guilabel>2680</guilabel> + </entry> + </row> + + <row> + <entry> + <guilabel>200W</guilabel> + </entry> + + <entry> + 200 Watt incandescent lamp, studio lights, photo floods. + </entry> + + <entry> + <guilabel>3000</guilabel> + </entry> + </row> + + <row> + <entry> + <guilabel>Sunrise</guilabel> + </entry> + + <entry> + Sunrise or sunset light. + </entry> + + <entry> + <guilabel>3200</guilabel> + </entry> + </row> + + <row> + <entry> + <guilabel>Tungsten</guilabel> + </entry> + + <entry> + Tungsten lamp or light at 1 hour from dusk or dawn. + </entry> + + <entry> + <guilabel>3400</guilabel> + </entry> + </row> + + <row> + <entry> + <guilabel>Neutral</guilabel> + </entry> + + <entry> + Neutral color temperature. + </entry> + + <entry> + <guilabel>4750</guilabel> + </entry> + </row> + + <row> + <entry> + <guilabel>Xenon</guilabel> + </entry> + + <entry> + Xenon lamp or light arc. + </entry> + + <entry> + <guilabel>5000</guilabel> + </entry> + </row> + + <row> + <entry> + <guilabel>Sun</guilabel> + </entry> + + <entry> + Sunny daylight around noon. + </entry> + + <entry> + <guilabel>5500</guilabel> + </entry> + </row> + + <row> + <entry> + <guilabel>Flash</guilabel> + </entry> + + <entry> + Electronic photo flash. + </entry> + + <entry> + <guilabel>5600</guilabel> + </entry> + </row> + + <row> + <entry> + <guilabel>Sky</guilabel> + </entry> + + <entry> + Overcast sky light. + </entry> + + <entry> + <guilabel>6500</guilabel> + </entry> + </row> + +</tbody> + +</tgroup></informaltable> + +</para> + +<para> +<guilabel>Color Temperature</guilabel> is a simplified way to characterize the spectral properties of a light source. While in reality the color of light is determined by how much each point on the spectral curve contributes to its output, the result can still be summarized on a linear scale. This value is useful e.g. for determining the correct the white balance in digital photography, and for specifying the right light source types in architectural lighting design. Note, however, that light sources of the same color (metamers) can vary widely in the quality of light emitted. +</para> + +<para> +Low <guilabel>Color Temperature</guilabel> implies more yellow-red light while high color temperature implies more blue light. Daylight has a rather low color temperature near dawn, and a higher one during the day. Therefore it can be useful to install an electrical lighting system that can supply cooler light to supplement daylight when needed, and fill in with warmer light at night. This also correlates with human feelings towards the warm colors of light coming from candles or an open fireplace at night. Standard unit for color temperature is Kelvin (K). +</para> + +<para> +<guilabel>Over Exposure Indicator</guilabel> option adds up the colors if more than one channel in a pixel is over-exposed, and you will see the combined color resulting of White Color Balance controls settings. This rule is applied to target preview area as an indication only and has no effect on the final rendering. +</para> + +<para> +<guilabel>Save As</guilabel> and <guilabel>Load</guilabel> buttons are used to do just that. Any White Color Balance settings that you have set can be saved to the filesystem in a text file and loaded later. +</para> + +<para> +<guilabel>Reset All</guilabel> button resets all filter settings to default values corresponding to Neutral White Balance color. (Attention, even the neutral setting might be different from your original photograph. If you save it, the white balance will be changed.) +</para> + +</sect4> + +</sect3> + +<sect3 id="encoding-depth"> <title>Encoding Depth</title> + <para>Here you can change the encoding depth per color channel of the edited image. 8 bit encoding is the common JPEG format, 16 bit encoding is better suited for high quality images, but this format needs more storage space, calculation time and is currently available with PNG, PNM, TIFF, and DNG formats only.</para> +</sect3> + +<sect3 id="color-management"> <title>Color Management</title> + <para>This tool opens the same dialog as when editing RAW images. Its use is the change and assignment of color profiles. Tone mapping can also be done from the lightness adlustment tab (bottom tab). For detailed instructions on the use of color profiles, please refer to <ulink url="help:/digikam/using-setup.html#setup-iccprofiles">CM chapter</ulink>.</para> +</sect3> + +<sect3 id="exposure-correct"> <title>Correcting Exposure</title> + + <anchor id="bcgadjusttool.anchor"/> + + <para> + The simplest tool to use is the Brightness/Contrast/Gamma tool. It is also the least powerful, but in many cases it does everything you need. This tool is often useful for images that are overexposed or underexposed; it is not useful for correcting color casts. The tool gives you three sliders to adjust, for "Brightness", "Contrast" and "Gamma". You can see any adjustments you make reflected in the preview image. When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect. + </para> + + <example> <title>The Brightness Contrast Gamma Tool in Action</title> + <screenshot><screeninfo>The Brightness Contrast Gamma Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorbcgadjust.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + Another important tool is called + <menuchoice><guimenu>Color</guimenu> + <guimenuitem>Levels Adjust</guimenuitem></menuchoice>. This tool provides an integrated way of seeing the results of adjusting multiple levels and also enables you to save level settings for application to multiple photographs. This can be useful if your camera or scanner often makes the same mistakes and you want to apply the same corrections. See the dedicated <link linkend="using-adjustlevels">Adjust Levels manual</link> for more information. + </para> + + <para> + A very powerful way of correcting exposure problems is to use the Adjust Curves tool available by <menuchoice><guimenu>Color</guimenu> + <guimenuitem>Curves Adjust</guimenuitem></menuchoice> menu entry. + </para> + +</sect3> + +<sect3 id="coloreffects"> + +<sect3info> +<title>Solarize Image</title> + +<authorgroup> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Color Effects</emphasis>tool provides four color effects: a solarization effect, a velvia filter, neon effect and edge filter. +on images. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +<keyword>Solarization</keyword> +<keyword>Velvia</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +In the age of chemical image processing, solarizing (also known as Sabatier) was an effect created by +exposing a partially developed print to a brief flash of light, then completing the development. +The colored, darker areas shield the additional light from the sensitive photo layers, which has +the net effect of making the lighter areas darker and colors being inverted during the second exposure. +The result resembles a partially negative image. The tool allows to adjust the interesting effect smoothly. +</para> + +<sect4 id="using-solarize"> <title>Using Solarization</title> + +<para> +The <guilabel>Intensity</guilabel> control helps to preview the solarization by simply increasing it. +At about 50% intensity the image shows what was once chemically possible. If you further increase the +effect it will finally become a negative image, a stage of inversion not achievable on photographic paper. +</para> +</sect4> + +<sect4 id="inaction-solarize"> <title>Solarisation in action</title> + +<para> +This is an example of solarization effect. The original image is (1) and the corrected image is (2). +The <guilabel>Intensity</guilabel> level applied is 30%. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;solarizepreview.png" format="PNG" /> </imageobject> + <textobject><phrase>Solarize Image Effect Preview</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +<sect4> <title>The Vivid Effect (Velivia filter)</title> + <para> + The vivid filter simulates what is known as "Velvia" effect. It is different from saturation in that it has a more pronounced contrast effect that bring colors brilliantly alive and glowing. Try it, it renders beautiful for many subjects! + </para> + <para> + Velvia is a brand of daylight-balanced color reversal film produced by the Japanese company Fujifilm. The name is a contraction of "Velvet Media", a reference to its smooth image structure. Velvia has very saturated colors under daylight, high contrast. These characteristics make it the slide film of choice for most nature photographers. Velvia's highly saturated colors are, however, considered overdone by some photographers, especially those who don't primarily shoot landscapes. + </para> + <example> <title>Original versus Vivid filter</title> + <screenshot><screeninfo>Original versus Vivid filter</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorvivid.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + +</sect4> + +<sect4> <title>The Neon Effect</title> + <para>The neon filter simulates neon light along the contrast edges. The level parameter controls the lightness of the result, whereas the interation slider determines the thickness of the neon light. With big images, the filter might eat the CPU time for a moment. + </para> + <example> <title>The neon filter</title> + <screenshot><screeninfo>The neon filter</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorneon.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + +</sect4> + +<sect4> <title>The Edge Effect</title> + <para>TODO + </para> +</sect4> + +</sect3> + +<sect3 id="using-correctingcolor"> <title>Correcting Color</title> + + <anchor id="colorbalancetool.anchor"/> + + <para> + Digital cameras often have problems with lighting conditions and it is not unusual to want to correct the color contrast and brightness of a photograph. You can experiment with altering the levels of different aspects of your photographs using the tools under the + <menuchoice><guimenu>Color</guimenu> + </menuchoice> menu. + You can see any adjustments you make reflected in the preview. When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect. + </para> + + <example> <title>The Color Balance Tool in Action</title> + <screenshot><screeninfo>The Color Balance Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorcolorbalance.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <anchor id="hsladjusttool.anchor"/> + + <para> + If your image is washed out (which can easily happen when you take images in bright light) try the Hue/Saturation/Lightness tool, which gives you three sliders to manipulate, for Hue, Saturation, and Lightness. Raising the saturation will probably make the image look better. In some cases, it is useful to adjust the lightness at the same time. ("Lightness" here is similar to "Brightness" in the Brightness/Contrast/Gamma tool, except that they are formed from different combinations of the red, green, and blue channels). + </para> + + <para> + When you take images in low light conditions, you could get the opposite problem: too much saturation. In this case the Hue/Saturation tool is again a good one to use, only by reducing the saturation instead of increasing it. You can see any adjustments you make reflected in the preview image. When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect. + </para> + + <example> <title>The Hue Saturation Lightness Tool in Action</title> + <screenshot><screeninfo>The Hue Saturation Lightness Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorhsladjust.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </sect3> + +<sect3 id="adjustlevels"> +<sect3info> + +<title>Adjust Levels</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Adjust Levels</emphasis> is a tool to manually adjust the histogram channels of an image. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +Situated between the more sophisticated Adjust Curves tool and the simpler Brightness/Contrast/Gamma Image Editor tool is this Adjust Levels tool for improving exposure. Allthough the dialog for this tool looks very complicated, for the basic usage we have in mind here, the only part you need to deal with is the +<guilabel>Input Levels</guilabel> area, concretely the 3 sliders that appear below the histogram. +</para> + +<para> +This widget contains a visual graph of the intensity values of the active layer or selection (histogram). +Below the graph are five sliders that can be clicked into and dragged to constrain and change the intensity +level for the image. The left sliders position represents the dark areas and similarly, +the right position represents the light areas. +</para> + +<sect4 id="using-adjustlevels"> +<title>Using the Adjustlevel tool</title> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;adjustlevelsdialog.png" format="PNG" /> </imageobject> + <textobject><phrase>The Adjust Levels Tool Dialog</phrase></textobject></inlinemediaobject> + </para> + +<para> +Actually the easiest way to learn how to use it is to experiment by moving the three sliders around, +and watching how the image is affected. +</para> + +<para> +On the right, both an original and a target preview image is available. The target preview is updated dynamically according to the slider positions. On the left, the following options are available: + +<itemizedlist> + + <listitem><para> + Modify levels for <guilabel>Channel</guilabel> : this combo box allows the selection of the specific + channel that will be modified by the tool: + + <itemizedlist> + <listitem><para><guilabel>Luminosity</guilabel>: this option makes intensity changes against + all pixels in the image.</para></listitem> + <listitem><para><guilabel>Red</guilabel>: this option makes Red saturation changes against + all pixels in the image.</para></listitem> + <listitem><para><guilabel>Green</guilabel>: this option makes Green saturation changes against + all pixels in the image.</para></listitem> + <listitem><para><guilabel>Blue</guilabel>: this option makes Blue saturation changes against + all pixels in the image.</para></listitem> + <listitem><para><guilabel>Alpha</guilabel>: this option makes transparency changes against + all pixels in the image.</para></listitem> + </itemizedlist> + + </para></listitem> + + <listitem><para>Set <guilabel>Scale</guilabel> for channel : this combo controls whether the histogram + will be displayed using a linear or logarithmic amplitude. For images taken with a digital camera, the linear + mode is usually the most useful. However, for images that contain substantial areas of constant color a + linear histogram will often be dominated by a single bar. In this case a logarithmic histogram will often + be more useful.</para></listitem> + + <listitem><para><guilabel>Input Levels</guilabel>: the input levels allow manual adjustments to + be selected for each of the ranges. The main area is a graphic representation of image dark, mid and light tones content. They are on abscissa from level 0 (black) to level 255 (white). + Pixel number for a level is on ordinate axis. The curve surface represents all the pixels of the image for the selected channel (histogram). A well balanced image is an image with levels + (tones) distributed all over the whole range. An image with a predominant blue color, for example, + will produce a histogram shifted to the left in Green and Red channels, manifested by green and + red color lacking on highlights. The level ranges can be modified in three ways: + <itemizedlist> + <listitem><para> + Three sliders: the first on the top for dark tones, the second one for light tones, and the last one on the bottom for midtones (often called Gamma value). + </para></listitem> + <listitem><para> + Three input boxes to enter values directly. + </para></listitem> + <listitem><para> + Three Color Picker buttons using the original photo preview to automatically adjust inputs levels settings for shadow, midtone and highlights. There is also a fully automated adjustment button available next to the reset button. + </para></listitem> + </itemizedlist> + </para></listitem> + + <listitem><para><guilabel>Output Levels</guilabel>: the output levels allow manual selection + of a narrowed-down output level range. There are also two sliders located here that can be used + to interactively change the output levels like <guilabel>Input Levels</guilabel>. + This ouput level compression may, for example, be used to create a bleached image as a background for some other subject to put into the foreground.</para></listitem> + + <listitem><para><guilabel>Auto</guilabel>: this button performs an automatic setting of the + levels based on the pixel intensities of the image.</para></listitem> + + <listitem><para><guilabel>Save As</guilabel> and <guilabel>Load</guilabel>: these buttons are used + to do just that. Any Levels that you have set can be saved to the filesystem and loaded later. + The used file format is The Gimp Levels format.</para></listitem> + + <listitem><para><guilabel>Reset All</guilabel>: this button reset all + <guilabel>Input Levels</guilabel> and <guilabel>Output Levels</guilabel> values for all + channels.</para></listitem> + +</itemizedlist> +</para> + +<para> +The Adjust Levels tool has several features to facilitate the positioning input levels sliders. Clicking the mouse button in the original image preview area produces a vertical doted bar in the graph area of the histogram. The bar position corresponds to the pixel value under the mouse cursor in the image window. Clicking and dragging the mouse button interactively updates the position of the vertical bar. In this way it is possible to see where different pixel values in the image are located on the input levels sliders and helps to discover the locations of shadow, midtone, and highlight pixels. +</para> + +<para> +Using in this mode and the three <guilabel>Color Picker</guilabel> buttons will automatically adjust input levels settings in all channels for shadow, middle, and highlight tones. Enable the color picker button that you want use, and click on the original image preview area to set input levels on each of the Red, Green, Blue, and Luminosity histogram channels. +</para> + +<para> +<guilabel>Over Exposure Indicator</guilabel> option checks all color channel to see if more than one channel in a pixel is over-exposed, and you will see the combined color resulting of channel level settings. This feature is available as an indicator in the target preview area and has no effect on final rendering. +</para> + +</sect4> + +<sect4 id="inaction-adjustlevels"> +<title>The Adjustlevel tool in action</title> + +<para> +Below, you can see an <guilabel>Input levels</guilabel> adjustment example applied to a color image for the Red/Green/Blue channels. Intensity/Alpha channels and <guilabel>Output Levels</guilabel> are unchanged. The original image is (1), the corrected image (2). +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;adjustlevelspreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Adjust Levels Tool in Action</phrase></textobject></inlinemediaobject> + </para> + +</sect4> +</sect3> + +<sect3 id="adjustcurves"> +<sect3info> + +<title>Adjust Curves</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> + <para> + The &digikam; <emphasis>Adjust Curves</emphasis> is a tool to non-linearly adjust luminosity graduation and color channels. + </para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> + The Curves tool is the most sophisticated tool available to adjust the images' tonality. Start it from the <menuchoice><guimenu>Color</guimenu> <guimenuitem>Curves Adjust</guimenuitem></menuchoice> Image Editor menu. + It 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 tool, though it is more powerful than either one of them. + + But this tool can do more for you, it helps you to improve the tonal quality of your photographs to very finely stepped gray scales. And do not forget that the better the photographs are (good exposure, lossless format, 24 or 32 bit deep) the more you can improve them. Navigate to the "Achieving ultimate tonal quality" section of this instructive page: <ulink url="http://www.normankoren.com/digital_tonality.html">Tonal quality and dynamic range in digital cameras by Norman Koren</ulink>. Use Adjust Curves tool to do just the same! +</para> +<para> + This tool provides visual curves to modify the intensity values of the active layer displayed as a histogram non-linearily. In <guilabel>Smooth</guilabel> curve edition mode, you change the curves shape by adding new points to the curve or by moving end point positions. Another mode is to draw all the curve manually in <guilabel>Free</guilabel> curve edition mode. In both cases the effect is immediately displayed in the image preview area to the left, where the preview can be configured by clicking on the top left icons. +</para> + +<sect4 id="using-adjustcurves"> +<title>Using Adjustcurves</title> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;adjustcurvesdialog.png" format="PNG" /> </imageobject> + <textobject><phrase>The Adjust Curves Tool Dialog</phrase></textobject></inlinemediaobject> + </para> + +<para> +To the left, half of the original and the target preview image is shown. The target preview is updated dynamically according to the widget settings. On the right side the following options are available: + +<itemizedlist> + + <listitem><para> + Modify <guilabel>Channel</guilabel> : with this combo box you can select the specific channel to be modified by the tool: + + <itemizedlist> + <listitem><para><guilabel>Luminosity</guilabel>: changes the intensity of all pixels.</para></listitem> + <listitem><para><guilabel>Red</guilabel>: changes the Red saturation of all pixels.</para></listitem> + <listitem><para><guilabel>Green</guilabel>: changes the Green saturation of all pixels .</para></listitem> + <listitem><para><guilabel>Blue</guilabel>: changes the Blue saturation of all pixels.</para></listitem> + <listitem><para><guilabel>Alpha</guilabel>: changes the transparency of all pixels.</para></listitem> + </itemizedlist> + + </para></listitem> + + <listitem><para> + Next to this box are two icons to select linear or logarithmic histogram display. For images taken with a digital camera the linear mode is usually the most useful. However, for images containing substantial areas of constant color, a linear histogram will often be dominated by a single bar. In this case a logarithmic histogram will be more appropriate. + </para></listitem> + + <listitem><para> + Main Curves Editing Area: the horizontal bar (x-axis) represents input values (they are value levels from 0 to 255). The vertical bar (y-axis) is only a scale for output colors of the selected channel. The control curve is drawn on a grid and crosses the histogram diagonally. The pointer x/y position is permanently displayed above the grid. If you click on the curve, a control point is created. You can move it to bend the curve. If you click outside the curve, a control point is also created, and the curve includes it automatically. So each point of the curve represents an 'x' translated into a 'y' output level. + </para></listitem> + + <listitem><para> + Curve <guilabel>Type</guilabel> for channel : below the editing area are several icons that determine whether the curve can be edited using a <guilabel>Smooth</guilabel> curve or a <guilabel>Free</guilabel> hand mode curve. Smooth mode constrains the curve type to a smooth line with tension and provides a realistic rendering. Free mode lets you draw your curve free-hand with the mouse. With curve segments scattered all over the grid, result will be surprising but hardly repeatable. A reset-to-defaults button is also available. + </para></listitem> + + <listitem><para> + If, for example, you move a curve segment to the right, i.e. to highlights, you can see that these highlights are corresponding to darker output tones and that image pixels corresponding to this curve segment will go darker. + </para></listitem> + + <listitem><para> + With color channels, moving right will decrease saturation up to reaching complementary color. To delete all control points (apart from both end points), click on the <guilabel>Reset Values</guilabel> button. To delete only one point, move it onto another point. Just ply with the curves and watch the results. You even can solarize the image on part of its tonal range. This happens when the curve is inverted in some part. + </para></listitem> + + <listitem><para> + The original photo preview has a red marker on it. If you place this marker to a zone you want to modify, a corresponding line will be drawn on the curve grid indicating the original value. Create a point on that line and move it up or down to adjust it to your pleasing. + </para></listitem> + + <listitem><para> + <guilabel>Save As</guilabel> and <guilabel>Load</guilabel>: these buttons are used to do just that. Any curves that you have set can be saved to the filesystem and loaded later. The used file format is The Gimp Curves format. + </para></listitem> + + <listitem><para> + <guilabel>Reset All</guilabel>: this button resets all curve values for all channels. + </para></listitem> + +</itemizedlist> + +</para> + +<para> +The curves tool has several features that facilitate the positioning of points on the control curves. Clicking the mouse button in the original image preview area produces a vertical doted bar in the graph area of the curves tool. The bar position corresponds to the pixel value the mouse cursor is over in the image window. Clicking and dragging the mouse button interactively updates the position of the vertical bar. In this way, it is possible to see where different pixel values in the image are located on the control curve and helps to discover the locations of shadow, midtone, and highlight pixels. +</para> + +<para> +Using this way and the three <guilabel>Color Picker</guilabel> buttons will automatically create control points on the curve in all channels for shadow, middle, and highlight tones. Enable the color picker button that you want to use, and click on the original image preview area to produce control points on each of the Red, Green, Blue, and Luminosity control curves. +</para> + +<para> +<guilabel>Over Exposure Indicator</guilabel> option adds up all color channels and indicates the blown-out highlights. If more than one channel in a pixel is over-exposed you will see the combined color resulting from the curve settings. The display is an indicator only and has no effect on the final rendering. +</para> + +</sect4> + +<sect4 id="inaction-adjustcurves"> +<title>The Adjustcurves in action</title> + +<para> +Below you can see a black and white photograph corrected in <guilabel>Luminosity</guilabel> channel. Shadow and highlight tone picker tool have been use to determined the curves to apply from original. The original image is (1), the corrected image (2). +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;adjustcurvespreview.png" format="PNG" /> + </imageobject> + <textobject><phrase>The Adjust Curves Tool in Action</phrase></textobject></inlinemediaobject> + </para> + + +</sect4> +</sect3> + +<sect3 id="channelmixer"> +<sect3info> + +<title>Channel Mixer</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; image <emphasis>Channel Mixer</emphasis> is a tool to remix the color channels to improve or modify the photograph color shades. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +The Channel Mixer is an another sophisticated tool to refine the images' tonality. Start it from the <menuchoice><guimenu>Color</guimenu><guimenuitem>Channel Mixer</guimenuitem></menuchoice> Image Editor menu. +</para> + +<sect4 id="using-channelmixer"> +<title>Using the Channel Mixer</title> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;channelmixerdialog.png" format="PNG" /> </imageobject> + <textobject><phrase>The Channel Mixer Tool Dialog</phrase></textobject></inlinemediaobject> + </para> + +<para> +With the channel combo box you select and display the histogram per color. It gives a first hint of how to correct the channels by their relative distribution and amplitude. The left half of the dialog window always shows a preview of what you are doing. The orignal for comparison can be seen when selecting its own window tab. +</para> + +<para> +The target photo preview has a red marker available. If you place this marker somewherer in the image, a corresponding vertical bar will be drawn in the histogram indicating the color level value in the current channel selected. +</para> + +<para> +Now the controls are to the lower right: <guilabel>Red</guilabel>, <guilabel>Green</guilabel> and <guilabel>Blue</guilabel> slider controls enable you to mix the channels. If you check <guilabel>Preserve Luminosity</guilabel> the image will retain its overall luminosity despite you changing its color components. This feature is particularly useful when you also ticked the <guilabel>Monochrome</guilabel> box. Because the channel mixer is THE tool to make great black and white conversions of your photographs. Try to reduce the green channel for black and white portraits. +</para> + +<note><para> +Sometimes, especially when doing monochrome mixing, reducing one color channel may increase visible noise, which actually originates in the chroma noise. Chroma noise means that the little noise specs do not appear at the same location in all the color channels, but the noise patterns looks different in every channel. If that is the case you can improve the monochrome conversion by reducing the chroma noise first. +</para></note> + +<para> +<guilabel>Save As</guilabel> and <guilabel>Load</guilabel> buttons are used to do just that. Any mixer settings that you have set can be saved to the filesystem and loaded later. The used file format is The Gimp channel mixer format. +</para> + +<para> +<guilabel>Over Exposure Indicator</guilabel> option adds up the colors if more than one channel in a pixel is over-exposed, and you will see the combined color resulting of channel gain settings. This rule is applying to target preview area and haven't effect to final rendering. +</para> + +<para> +<guilabel>Reset All</guilabel> button resets all channel mixer settings to default values. +</para> + +</sect4> + +<sect4 id="inaction-channelmixer"> +<title>The channel mixer in action</title> + +<para> +Below, you can see a photograph color tone adjustments for the <guilabel>Blue</guilabel> channel. <guilabel>Preserve luminosity</guilabel> option is on. The original image is (1), the corrected image (2). +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;channelmixerpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Channel Mixer in Action</phrase></textobject></inlinemediaobject> + </para> + +</sect4> +</sect3> + +<sect3 id="blackandwhite-conversion"> +<sect3info> <title>Black and White Conversion Filters</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> + <para> + Black & White photography has always been fascinating in its abstraction cabability. With the advent of digital photography, B&W has almost become a desktop activity, as color images can be easily converted on the computer into black and white, even providing a set of vintage film roll profiles. + </para> + </abstract> +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> +<title>Introduction</title> + <anchor id="blackandwhitetool.anchor"/> + <para> + &digikam; comes with a couple of black & white filters that you can use on your photographs. Under the <menuchoice><guimenuitem>Filters</guimenuitem><guimenuitem>Black & White</guimenuitem></menuchoice> menu you will find classic black & white chemical toning used in analog photography. The controls come on three tabs: <emphasis>Film, Lens Filters, Tone</emphasis> and <emphasis>Lightness</emphasis> as shown on the screenshot below. Film, filters and color toning can be applied independently of each other (on top of each other). The filters actually influence the RGB channel mixing, whereas the toning purely adds a uniform monochromatic tint to the black & white photograph. In the lightness tab you will find a tonal adjustment tool (like curve adjust), a contrast tool and an over-exposure indicator to improve the b&w rendering. + </para> + <example> <title>The Black & White Filter tool in Action</title> + <screenshot><screeninfo>The B&W Filter tool in Action" </screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorbwfilter.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para>The table below shows in more detail the effect of all filters and tints.</para> + + <informaltable><tgroup cols="2"> + + <thead><row> + <entry>Preview</entry> <entry>Photographic Film Emulation</entry> + </row></thead> + <tbody> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_bwred.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + <para>Specific settings to emulate a number of famous black & white photographic films are available:</para> + <para>Agfa 200X, Agfa Pan 25, Agfa Pan 100, Agfa Pan 400</para> + <para>Ilford Delta 100, Ilford Delta 400, Ilford Delta 400 Pro 3200, Ilford FP4 Plus, Ilford HP5 Plus, Ilford PanF Plus, Ilford XP2 Super</para> + <para>Kodak Tmax 100, Kodak Tmax 400, Kodak TriX</para> + </entry> + </row> + </tbody> + </tgroup></informaltable> + + <informaltable><tgroup cols="2"> + <thead><row> + <entry>Preview</entry> + <entry>Lens Filter Type</entry> + </row></thead> + <tbody> + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_original.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Original color image taken in New Zealand landscapes. + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_bw.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Neutral: simulate black & white neutral film exposure. + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_bwgreen.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Green Filter: simulates black & white film exposure with green lens filter. This comes good with all scenic images, especially suited for portraits taken against the sky (similar to 004 Cokin(tm) Green filter). + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_bworange.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Orange Filter: simulates black & white film exposure with an orange lens filter. This will enhance landscapes, marine scenes and aerial photography (similar to 002 Cokin(tm) Orange filter). + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_bwred.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Red Filter: simulates black & white film exposure with red lens filter. Creates dramatic sky effects and can simulate moonlight scenes in daytime (similar to 003 Cokin(tm) Red filter). + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_bwyellow.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Yellow Filter: simulates black & white film exposure with yellow lens filter. Most natural tonal correction, improves contrast. Ideal for landscapes (similar to 001 Cokin(tm) Yellow filter). + </entry> + </row> + + </tbody> + + </tgroup></informaltable> + + <informaltable><tgroup cols="2"> + + <thead><row> + <entry>Preview</entry> <entry>Color Tint</entry> + </row></thead> + + <tbody> + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_sepia.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Sepia Tone: gives a warm highlight and mid-tone while adding a bit of coolness to the shadows - very similar to the process of bleaching a print and re-developing in a sepia toner (typical for your grandmothers photographs). Similar to 005 Cokin(tm) Sepia filter. + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_brown.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Brown Tone: similar to Sepia Tone filter, but less pronounced. + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_cold.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Cold Tone: start subtle and replicate printing on a cold tone black & white paper such as a bromide enlarging paper. + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_platinium.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Platinum Tone: effect that replicates traditional platinum chemical toning done in the darkroom. + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;editorconvert_selenium.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Selenium Tone: effect that replicates traditional selenium chemical toning done in the darkroom. + </entry> + </row> + + </tbody> + + </tgroup></informaltable> + +</sect3> +</sect2> diff --git a/doc/en/digikam/editor-decorate.docbook b/doc/en/digikam/editor-decorate.docbook new file mode 100644 index 00000000..efa548e5 --- /dev/null +++ b/doc/en/digikam/editor-decorate.docbook @@ -0,0 +1,324 @@ +<sect2> <title>Adding decorative elements</title> +<sect3 id="texture"> +<sect3info> + +<title>Apply Texture</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Apply Texture</emphasis> is a tool for applying decorative textures to an image. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +By adding texture to your image, whether color or black and white, you can make it look like an oil painting on canvas, an Old Masters etching, a Pop Art portrait composed of enlarged half-tone dots, or even a mural on a brick wall. The <menuchoice><guimenu>Image</guimenu> +<guimenuitem>Apply Texture</guimenuitem></menuchoice> Image Editor menu can be used for that. +</para> + +<sect4 id="using-texture"> +<title>Using the Texture Tool</title> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;texturedialog.png" format="PNG" /> </imageobject> + <textobject><phrase>The Apply Texture Tool Dialog</phrase></textobject></inlinemediaobject> + </para> + +<para> +Two options give you control over the texture applying on image: +</para> + +<para> +<guilabel>Type</guilabel>: this option specifies the decorative texture style to apply under the image. +</para> + +<para> +<guilabel>Relief</guilabel>: dragging this option to the right increases the appearance of depth or three-dimensionality of the texture on image. +</para> + +</sect4> + +<sect4 id="inaction-texture"> +<title>The Texture tool in action</title> + +<para> +A <guilabel>Paper</guilabel> texture effect apply to a photograph is available below. The original image is (1), the target image is (2). <guilabel>Relief</guilabel> factor used is 200. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;texturepreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Texture Effect Preview</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="border"> +<sect3info> + +<title>Add Border</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Add Border</emphasis> is a tool to frame an image with decorative borders. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +Keeping the viewer's interest within the confines of the edges of a photograph is not a simple task. One of the simplest ways to hold the attention on a image is to incorporate a decorative frame around an image. It acts as a kind of psychological barrier to the straying eye. The <menuchoice><guimenu>Image</guimenu> +<guimenuitem>Add Border</guimenuitem></menuchoice> Image Editor menu can be used for that. +</para> + +<sect4 id="using-border"> +<title>Using the Add-border tool</title> + +<para> +Four options give you control over the decorative frame rendering: +</para> + +<para> +<guilabel>Type</guilabel>: this option specifies the decorative frame style to apply around the image. <guilabel>Solid</guilabel> style just surrounds the image with a colored line, <guilabel>Niepce</guilabel> style surrounds the image with a fine line and a large border (ideal for black and white images), <guilabel>Beveled</guilabel> style adds a neat dimension to your image (ideal to create a button effect), and <guilabel>Decorative</guilabel> style adds an ornamental border using patterns. +</para> + +<para> +<guilabel>Width</guilabel>: this option specifies the border width in percents of image size. The border is added around the image. The width range is limited between 1% and 50%. +</para> + +<para> +<guilabel>First</guilabel>: this option specifies the first color to use with the current border type. +</para> + +<para> +<guilabel>Second</guilabel>: this option specifies the second color to use with the current border type. +</para> + +<para> +Click on the <guilabel>OK</guilabel> button to apply the border around the current image. +</para> + +<note><para> + The border decorated target image will be bigger than the original, but it will retain the same aspect ratio. This is important for printing images, especially if you have used the Aspect Ratio Crop tool before. +</para></note> + +</sect4> + +<sect4 id="inaction-border"> +<title>The Add-border tool in action</title> + +<para> +The Add Border dialog tool in action is available below. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;borderpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Add Border Tool Dialog in Action</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="inserttext"> +<sect3info> + +<title>Insert Text</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Insert Text</emphasis> is a tool for adding text to an image. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +This is a handy tool as it lets you add formatted text easily to an image wherever you want, at several places when needed. +</para> + +<sect4 id="using-inserttext"> +<title>Using the Insert Text tool</title> + +<para> +This tool seems very intuitive to use. Type in your text and place it with the mouse. Use the block settings as you please. Choose the orientation, color from a color space, and fonts with all their properties. You will have to scale the font size to the image size, the larger the image, the larger the font has to be! +Finally choose to add a border around the text and/or a semitransparent background. Voilà, it's finished! +</para> + +<para> +Any text setting you have chosen can always be changed as long as you don't click the OK button. In saved and reloaded images the text has become part of the image, it can't be changed anymore. +</para> + +</sect4> + +<sect4 id="inaction-inserttext"> +<title>The Insert Text tool in action</title> + +<para> +The Insert Text dialog tool in action is shown below. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;inserttextpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Insert Text Tool Dialog in Action</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="superimpose"> +<sect3info> + +<title>Template Superimpose</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Template Superimpose</emphasis> is a masking tool to superimpose templates to an image. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +This tool allows to combine two images by superimposing them very easily. You can use this tool to re-frame your photographs and the story they tell. + +Existing images or artificially created graphics can be used as PNG template files containing borders, frames, gradients, and composite images that can be added to or superimposed on other images. Template files aren't installed along with the &digikam; but can be found at <ulink url="http://digikam3rdparty.free.fr/Templates/">this URL</ulink>. Download the content to the &digikam; album database and set the <guilabel>Root Template Directory</guilabel>. +</para> + +<para> +The <menuchoice><guimenu>Image</guimenu> +<guimenuitem>Template Superimpose</guimenuitem></menuchoice> Image Editor menu is used to apply templates to an image. +</para> + +<sect4 id="using-template-creation"> +<title>To create new templates</title> + +<para> +New templates can be created using any paint program, and the template must be stored on disk. Colored areas in the image will become a mask that will later be superimposed on another selected image. PNG template files must be created in RGB mode with Alpha channel. The alpha channel represents transparent areas in the template that will not show in the superposition. The selected image upon which the template file is superimposed will appear in place of the transparent areas in the template. +</para> + +<para> +There is no restriction on template size and orientation, but you must use PNG file format with max. compression (9) to reduce the template file size. If you want to add your template creation to the &digikam; templates database, please send a mail to this &digikam; mailing-list <email>[email protected]</email>. +</para> + +</sect4> + +<sect4 id="using-superimpose"> +<title>Using the Superimpose Tool</title> + +<para> +If you are using the tool for the first time, you must set your local templates directory using the <guilabel>Root Directory</guilabel> button in the dialog. Select the folder where you have copied the template files. The widget remembers this setting at the next instance. +</para> + +<para> +When the root template directory is set, a folder tree view is created which displays the template directories structure. Selecting one will update the templates preview bar automatically. +</para> + +<para> +Below the preview area, three buttons give you control over the template zoom and position on your image: +</para> + +<para> +<guilabel>Zoom In</guilabel>: this button increases the underlying image's zoom factor. The image is centered to the current mouse position. Validate with the left mouse button. +</para> + +<para> +<guilabel>Zoom Out</guilabel>: this button decreases the zoom factor. The image is centered to the current mouse position. If you want to apply the template to the full image you have to zoom out fully. Validate with the left mouse button. +</para> + +<para> +<guilabel>Move</guilabel>: use this button to pan the underlying image. Click and drag the image with the right mouse button. +</para> + +<para> +Click on the <guilabel>OK</guilabel> button to apply the template to the current image, which in turn will be automatically resized to the preview size. +</para> + +</sect4> + +<sect4 id="inaction-superimpose"> +<title>The Superimpose in action</title> + +<para> +The Template Superimpose dialog tool in action is available below. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;superimposepreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Template Superimpose Tool Dialog</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +</sect2> diff --git a/doc/en/digikam/editor-enhance.docbook b/doc/en/digikam/editor-enhance.docbook new file mode 100644 index 00000000..538c1734 --- /dev/null +++ b/doc/en/digikam/editor-enhance.docbook @@ -0,0 +1,1352 @@ +<sect2 id="editor-correct-tools" > + <title>Image enhancement</title> + <sect3 id="sharpening" > + <sect3info> + <title>Image Sharpening</title> + <authorgroup> + <author> + <firstname>Gilles</firstname> + <surname>Caulier</surname> + <affiliation> + <address> + <email>caulier_dot_gilles_at_gmail_dot_com</email> + </address> + </affiliation> + </author> + <author> + <firstname>Gerhard</firstname> + <surname>Kulzer</surname> + <affiliation> + <address> + <email>gerhard at kulzer dot net</email> + </address> + </affiliation> + </author> + </authorgroup> + <abstract> + <para> +&digikam; provides three different tools for sharpening, with each having <link linkend="comparison-refocus" >merits</link> in a different area. + <itemizedlist> + <listitem> + <para> + <link linkend="using-adjustsharpness" >Sharpen</link> is a traditional sharpening tool, which is very fast and easy, but may quickly produce grainy images, in particular in dark areas. + </para> + </listitem> + <listitem> + <para> + <link linkend="using-unsharp" >Unsharp Mask</link> works on the edge contrast to make an image appear sharper, but it actually does not sharpen at all, it works rather psychovisually. It can be used to remove atmospheric haze, and here it does a real good job. The algorithm was taken from the Gimp, and it is copyrighted by Winston Chang. + </para> + </listitem> + <listitem> + <para> + <link linkend="refocus" >Refocus</link> is probably the best of the three because it actually improves sharpness. It is a bit more involved in its application as is has several parameters to play with. + </para> + </listitem> + </itemizedlist> + </para> + </abstract> + <keywordset> + <keyword>KDE</keyword> + <keyword>Digikam</keyword> + <keyword>Refocus</keyword> + <keyword>Unsharp mask</keyword> + </keywordset> + </sect3info> + <title>Introduction</title> + <para> + Out-of-focus photographs, as well as most digitized images, need correction of sharpness. This is due to the digitizing process that must chop up a color continuum in points with slightly different colors: elements thinner than sampling frequency will be averaged into an uniform color. Thus, sharp borders are rendered a little blurred. The same phenomenon appears when printing color dots on paper. SLR cameras need even more sharpening on a regular basis than consumer cameras. + </para> + <para> + Whereas JPEG images have some camera-internal sharpening applied, RAW format images always need sharpening in their workflow. + </para> + <para> + Some scanners apply a sharpen filter while scanning. It's worth to disable it so that you keep control over your image. + </para> + <sect4 id="using-adjustsharpness" > + <title>Adjusting Sharpness</title> + <anchor id="sharpentool.anchor" /> + <sect5> + <title>Unblurring a Photograph</title> + <para> +&digikam; + If the camera focus is not set perfectly or if the camera is moving when the image is taken the result is a blurred photograph. If there is a lot of blurring, you probably will not be able to do much about it with any technique. If there is only a moderate amount, you should be able to improve the image. Many good SLR cameras apply less image processing to the images than simpler cameras (which tend to artificially increase the contrast to make the images look crisp). This kind of slight blur can be easily improved with tools. + </para> + <para> + In some situations, you may be able to get useful results by sharpening an photograph using the Sharpen tool by the <menuchoice> + <guimenu>Enhance</guimenu> + <guimenuitem>Sharpen</guimenuitem> + </menuchoice> menu entry. + </para> + <example> + <title>The Sharpen Tool in Action</title> + <screenshot> + <screeninfo>The Sharpen Tool in Action</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="editorsharpenplugin.png" format="PNG" /> + </imageobject> + </mediaobject> + </screenshot> + </example> + <para> + You should be careful with this though, or the results will not look very natural: sharpening increases the apparent sharpness of edges in the photograph, but also amplifies noise. Generally, the most useful technique for sharpening a fuzzy photograph is the Refocus tool. You can access it with the + <menuchoice> + <guimenu>Enhance</guimenu> + <guimenuitem>Refocus</guimenuitem> + </menuchoice> menu entry. + Look at <link linkend="refocus" >Refocus</link> for more information and a comparison of all the sharpening techniques. + </para> + </sect5> + <sect5> + <title>Reducing Graininess In a Photograph</title> + <para> + When you take a photograph in low-light conditions or with a very fast exposure time, the camera does not get enough data to make good estimates of the true color at each pixel, and consequently the resulting photograph looks grainy. You can "smooth out" the graininess by blurring the image, but then you will also lose sharpness. Probably the best approach - if the graininess is not too bad - is to use the filter <link linkend="noisereduction" >Noise Reduction</link> tool, and you can access it by the + <menuchoice> + <guimenu>Enhance</guimenu> + <guimenuitem>Noise Reduction</guimenuitem> + </menuchoice> menu entry. + </para> + </sect5> + <sect5> + <title>Softening a Photograph</title> + <para> + Sometimes you have the opposite problem: an image is too crisp. The solution is to blur it a bit: fortunately blurring an image is much easier than sharpening it. Select the <link linkend="using-blurfilter" >Blur Tool</link> with the <menuchoice> + <guimenu>Enhance</guimenu> + <guimenuitem>Blur</guimenuitem> + </menuchoice> menu entry and experiment with the level. The preview window on the right of the dialog shows the effect of the operation on your photograph. + </para> + </sect5> + </sect4> + <sect4 id="using-unsharp" > + <title>The Unsharp Masking Filter</title> + <note> + <para> + The Unsharp Mask filter is an excellent tool to remove haze from your photographs, see <ulink url="http://www.gimpguru.org/Tutorials/RemovingHaze" >this url</ulink> for a demonstration. + </para> + </note> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="unsharpdialog.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>Unsharp Mask Dialog</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> + The image panel and the original preview help you to pan within the image. The preview window shows the filter output using the current settings. + </para> + <para> + There are two important parameters, <guilabel>Radius</guilabel> and <guilabel>Amount</guilabel>. The default values often work pretty well, so you should try them first. Increasing either the <guilabel>Radius</guilabel> or the <guilabel>Amount</guilabel> increases the strength of the effect. Don't get carried away, though: if you make the unsharp mask too strong, it will amplify noise in the image and create the impressions of ridges next to sharp edges. + </para> + <para> + The <guilabel>Radius</guilabel> allows you to set how many pixels on either side of an edge that will be affected by sharpening. High resolution images allow higher radius. You'd better always sharpen an image at its final resolution. + </para> + <para> + The <guilabel>Amount</guilabel> control is the percentage of the difference between the original and the blur image that is added back into the original. It allows you to set strength of sharpening. + </para> + <para> + The <guilabel>Threshold</guilabel> control is a fraction of the maximum RGB value, needed to apply the difference amount. It allows you to set the minimum difference in pixel values that indicates an edge where sharpening should be applied. That way, you can protect areas of smooth tonal transition from sharpening, and avoid creation of blemishes in face, sky or water surface. + </para> + <sect5 id="inaction-unsharp" > + <title>The Unsharp Mask in action</title> + <para> + This is an example of how the Unsharp Mask can change your life. The original image is (1) and the corrected image is (2). The unsharp mask was applied with <guilabel>Radius</guilabel> = 6.0, <guilabel>Amount</guilabel> = 0.5, + <guilabel>Threshold</guilabel> = 0.0. + </para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="unsharppreview.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>Unsharp Mask Tool in Action</phrase> + </textobject> + </inlinemediaobject> + </para> + </sect5> + </sect4> + <sect4 id="refocus" > + <title>Refocus a Photograph</title> + <para> +&digikam; + The <emphasis>Refocus</emphasis> is a tool to refocus an image by enhancing the sharpness. It uses the <emphasis>Deconvolution Filter</emphasis> algorithm copyrighted by Ernst Lippe. + </para> + <para> + This tool attempts to "refocus" an image by undoing the defocussing. This is better than just trying to sharpen a photograph. It is employing a technique called <emphasis>FIR Wiener Filtering</emphasis>. The traditional technique for sharpening images is to use unsharp masking. Refocus generally produces better results than Unsharp masking. Start it from the <menuchoice> + <guimenu>Enhance</guimenu> + <guimenuitem>Sharpen</guimenuitem> + <guimenuitem>Refocus</guimenuitem> + </menuchoice> Image Editor menu. + </para> + <para> + The Refocus technique works differently from <link linkend="using-unsharp" >Unsharp Mask</link> and is also unlike the <link linkend="using-adjustsharpness" >Sharpen Filter</link> which both increase the contrast of the edges of an image. Refocus rather reverses the process by which the image got blurred by the circular aperture of the camera. This method gives you as much of the original "in focus" image as possible. Refocus uses a very powerful deconvolution algorithm that will reclaim the data that has been mixed up. In mathmatical terms, blurring is usually the result of a convolution, a deconvolution will reverse the process, this is exactly what Refocus is doing. Furthermore, the FIR filter technique allows to remove much of the noise and granularity that often gets accentuated in the sharpening process of all sharpening filters. + </para> + <sect5 id="using-refocus" > + <title>Using the Refocus Tool</title> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="refocusdialog.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>Refocus Dialog</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> + The image panel and the original preview help you to pan within the image. The preview window shows the filter output using the current settings. + </para> + <para> + In most cases (blurring by camera) a circular convolution caused the image degradation, but there are two convolutions available: + + <itemizedlist> + <listitem> + <para>The circular convolution: this one spreads each source point uniformly across a small disk with a fixed radius. Technically this describes the effects of using a (ideal) lens that is not correctly focused.</para> + </listitem> + <listitem> + <para>The Gaussian convolution: this one is mathematically similar to the normal distribution, with its bell-shaped curve. Originates rather from unnatural blurring (software blurring). From a theoretical point of view the mathematical justification for using the Gaussian convolution is that when you a apply a large number of independent random convolutions the results will always approach a Gaussian convolution.</para> + </listitem> + </itemizedlist> + + The refocus tool supports both the Circular and the Gaussian convolution plus mixtures of both. + </para> + <para> + In practice, in most cases the Circular convolution works much better than the Gaussian convolution. The Gaussian convolution has a very long tail, so mathematically the result of the convolution also depends on source pixels at a large distance from the original source pixel. The FIR Wiener inverse of a Gaussian convolution in most cases is heavily influenced by source pixels at a large distances, and in most cases this produces undesirable results. + </para> + <para>To set correctly the deconvolution filter, the plug-in has the following parameters: + + <itemizedlist> + <listitem> + <para> + <guilabel>Circular Sharpness</guilabel>: This is the radius of the Circular convolution filter. It is the most important parameter for using the plug-in. With most images the default value of 1 should give good results. Select a higher value when your image is very blurred, but beware of producing halos.</para> + </listitem> + <listitem> + <para> + <guilabel>Correlation</guilabel>: Increasing the <guilabel>Correlation</guilabel> may help reducing artifacts. The correlation can range from 0-1. Useful values are 0.5 and values close to 1, e.g. 0.95 and 0.99. Using a high value for the correlation will reduce the sharpening effect of the plug-in.</para> + </listitem> + <listitem> + <para> + <guilabel>Noise filter</guilabel>: Increasing the <guilabel>Noise filter</guilabel> parameter helps reducing artifacts. The Noise can range from 0-1 but values higher than 0.1 are rarely helpful. When the Noise value is too low, e.g. 0 the image quality will be horrible. A useful value is 0.03. Using a high value for the Noise will even blur the image further.</para> + </listitem> + <listitem> + <para> + <guilabel>Gaussian Sharpness</guilabel>: This is the radius for the Gaussian convolution filter. Use this parameter when your blurring is Gaussian (mostly due to previous blur filtering). In most cases you should leave this parameter to 0, because it causes nasty artifacts. When you use non-zero values you will probably have to increase the <guilabel>Correlation</guilabel> and/or <guilabel>Noise filter</guilabel> parameters, too.</para> + </listitem> + <listitem> + <para> + <guilabel>Matrix size</guilabel>: This parameter determines the size of the transformation matrix. Increasing the <guilabel>Matrix Size</guilabel> may give better results, especially when you have chosen large values for <guilabel>Circular Sharpness</guilabel> or <guilabel>Gaussian Sharpness</guilabel>. Note that the plug-in will become very slow when you select large values for this parameter. In most cases you should select a value in the range 3-10.</para> + </listitem> + <listitem> + <para> + <guilabel>Save As</guilabel> and <guilabel>Load</guilabel>: these buttons are used to do just that. Any Refocus parameters that you have set can be saved to the filesystem and loaded later.</para> + </listitem> + <listitem> + <para> + <guilabel>Defaults</guilabel>: this button resets all settings to default values.</para> + </listitem> + </itemizedlist> + </para> + <para>Below, you can see few hints to help you work with the refocus plug-in: + + <itemizedlist> + <listitem> + <para>Preferrably perform all cropping, color and intensity curve corrections on the image before using this plug-in.</para> + </listitem> + <listitem> + <para>Otherwise use this plug-in before performing any other operations on the image. The reason is that many operations on the image will leave boundaries that are not immediately visible but that will leave nasty artifacts.</para> + </listitem> + <listitem> + <para>When you are scanning images and compress them, e.g. to JPEG, you should use the plug-in on the uncompressed image.</para> + </listitem> + </itemizedlist> + </para> + </sect5> + </sect4> + <sect4 id="comparison-refocus" > + <title>Refocus comparison with other techniques</title> + <para>Comparison to two other techniques frequently used to enhance images are: + <itemizedlist> + <listitem> + <para> + <link linkend="using-adjustsharpness" >Sharpen Filter</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="using-unsharp" >Unsharp Mask</link> + </para> + </listitem> + </itemizedlist> + </para> + <para> + Sharpening applies a small convolution matrix that increases the difference between a source pixel and its immediate neighbors. FIR Wiener filtering is a more general technique because it allows a much larger neighborhood and better parameterizations. Sharpening only works when your images are very slightly blurred. Furthermore, for high values of the sharpening parameter the results frequently looks "noisy". With FIR Wiener filtering this noise can be greatly reduced by selecting higher values for the <guilabel>Correlation</guilabel> and <guilabel>Noise filter</guilabel> parameters. + </para> + <para> + Unsharp masking is another very popular image enhancement technique. From a mathematical point of view its justification is a bit obscure but many people are very fond of it. The first step is to creat a blurred copy of the source image. Then the difference between the source image and the blurred image is subtracted from the source image, hence the name unsharp masking. If fact, unsharp masking is more of a contrast enhancement on the important image feature than a sharpening. It does not undo the aperture pattern interference of the camera diaphragm as refocus does. + </para> + <para> + In general, unsharp masking produces better results than sharpening. This is probably caused by the fact that unsharp masking uses a larger neighborhood than sharpening. + </para> + <para> + From a theoretical point of view unsharp masking must always introduce artifacts. Even under optimal circumstances it can never completely undo the effect of blurring. For Wiener filtering it is possible to prove that it is the optimal linear filter. In practice, in all cases the results of the FIR Wiener filter were at least as good as those of unsharp masking. The FIR Wiener filter is frequently better in restoring small details. + </para> + <para>Below, you can see a comparison of different filter apply on a small unfocused image: + + <informaltable> + <tgroup cols="2" > + <thead> + <row> + <entry>Preview</entry> + <entry>Type</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="refocus-notsharpened.png" format="PNG" /> + </imageobject> + </inlinemediaobject> + </para> + </entry> + <entry> + Original blured color image to fix. This image have been taken with an analog still camera. The unfocusing result of an insuffisant light for the auto-focus lens. + </entry> + </row> + <row> + <entry> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="refocus-sharped.png" format="PNG" /> + </imageobject> + </inlinemediaobject> + </para> + </entry> + <entry> + Fixed image using simple sharpening filter. Sharpness setting is 80. + </entry> + </row> + <row> + <entry> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="refocus-unsharpmask.png" format="PNG" /> + </imageobject> + </inlinemediaobject> + </para> + </entry> + <entry> + Fixed image using unsharp mask filter. Settings are Radius=50, Amount = 5, and Threshold=0. + </entry> + </row> + <row> + <entry> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="refocus-refocus.png" format="PNG" /> + </imageobject> + </inlinemediaobject> + </para> + </entry> + <entry> + Fixed image using Refocus filter. Settings are Circular Sharpness=1.3, Correlation=0.5, Noise Filter=0.020, Gaussian Sharpness=0 and Matrix Size=5. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <note> + <para> + For more information about correction of sharpness methods used in digital imagery, you can find a technical comparison at <ulink url="http://www.bialith.com/Research/BARclockblur.htm" >this url</ulink>. + </para> + </note> + </sect4> + </sect3> + <sect3 id="using-redeyecorrection" > + <title>Remove Red Eyes in a Photograph</title> + <anchor id="redeyecorrectiontool.anchor" /> + <para> + Red eyes are caused when the camera flashlight is used to take photographs of people. The red is the reflection from the back the eye which can be seen because the pupil cannot react quickly enough to the flash. By the way, with a separate flash light the red eye effect is less likely because of the different viewing angle of flash and lens. You can correct some of the worst effect of Red Eye by selecting the area of the eye on the photograph, in the same way as described for cropping above. Then select + <menuchoice> + <guimenu>Enhance</guimenu> + <guimenuitem>Red Eye Reduction</guimenuitem> + </menuchoice>. + </para> + <para>How it works + <itemizedlist> + <listitem><para>Set the preview mode to your liking</para></listitem> + <listitem><para>The <guilabel>Sensitivity</guilabel> setting adjusts the amount of red eyes removal (agressive or not)</para></listitem> + <listitem><para>The <guilabel>Smooth</guilabel> slider sets the blurring of the area that has been darkened to render the pupil more natural</para></listitem> + <listitem><para>The <guilabel>Color Tint</guilabel> sets a custom colorization for the pupil. If you want blue eyes instead of dark ones, here you can do it</para></listitem> + <listitem><para>The <guilabel>Tint Level</guilabel> adjusts the luminosity of set pupil color</para></listitem> + </itemizedlist> + </para> + <example> + <title>The Red Eyes Correction Tool in Action</title> + <screenshot> + <screeninfo>The Red Eyes Correction Tool in Action </screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="editor-redeyes-correction.png" format="PNG" /> + </imageobject> + </mediaobject> + </screenshot> + </example> + </sect3> + <sect3 id="inpainting" > + <sect3info> + <title>Photograph Inpainting</title> + <authorgroup> + <author> + <firstname>Gilles</firstname> + <surname>Caulier</surname> + <affiliation> + <address> + <email>caulier_dot_gilles_at_gmail_dot_com</email> + </address> + </affiliation> + </author> + <author> + <firstname>Gerhard</firstname> + <surname>Kulzer</surname> + <affiliation> + <address> + <email>gerhard at kulzer dot net</email> + </address> + </affiliation> + </author> + </authorgroup> + <abstract> + <para> + <ulink url="http://cimg.sourceforge.net" > + <inlinemediaobject> + <imageobject> + <imagedata fileref="cimg-logo.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>cimglogo</phrase> + </textobject> + </inlinemediaobject> + </ulink> + </para> + <para> + The <emphasis>Photograph Inpainting</emphasis> tool is definitely one of the most advanced tools to remove unwanted artifacts with unprecedented performance. +</para> + </abstract> + <keywordset> + <keyword>KDE</keyword> + <keyword>Digikam</keyword> + </keywordset> + </sect3info> + <title>Introduction</title> + <para/> + <para> +The inpainting algorithm has been developed by the IMAGE team of GREC CNRS lab in Caen/France and is a part of the <ulink url="http://cimg.sourceforge.net" >CImg project</ulink>. +</para> + <sect4 id="using-inpainting" > + <title>Using the Inpainting tool</title> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="inpaintingdialog.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Photograph Inpainting Dialog</phrase> + </textobject> + </inlinemediaobject> + </para> + <para>The tool comes with several presets as starting points and to simplify the restoration. The preset settings available are listed below: + +<itemizedlist> + <listitem> + <para> + <guilabel>None</guilabel>: Using most common default filter settings not optimized for any particular purpose.</para> + </listitem> + <listitem> + <para> + <guilabel>Remove Small Area</guilabel>: .</para> + </listitem> + <listitem> + <para> + <guilabel>Remove Medium Area</guilabel>: .</para> + </listitem> + <listitem> + <para> + <guilabel>Remove Large Area</guilabel>: .</para> + </listitem> + </itemizedlist> + </para> + <para>If you want to set filter parameters for finer adjustments, use <guilabel>Smoothing Settings</guilabel> and <guilabel>Advanced Settings</guilabel> tabs:</para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="inpaintingsettings1.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Inpainting Smoothing Settings</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> + <itemizedlist> + <listitem> + <para> + <guilabel>Detail Preservation</guilabel> p [0, 100]: this controls the preservation of the curvatures (features). A low value forces an equal smoothing across the image, whereas bigger values preferably smooth the homogeneous regions and leaves the details sharper. A value of 0.9 should well preserve details so that no sharpening is required afterwards. Note that <guilabel>Detail Preservation</guilabel> must be always inferior to <guilabel>Anisotropy</guilabel>.</para> + </listitem> + <listitem> + <para> + <guilabel>Anisotropy</guilabel> alpha [0, 100]: a low value smooths equally in all directions, whereas a value close to 1 smooths in one direction only. If you have film grain or CCD kind of noise a high value will result in wave-like pattern, whereas JPEG artifacts are suited for values close to 1. </para> + </listitem> + <listitem> + <para> + <guilabel>Smoothing</guilabel> [0, 500]: this sets the maximum overall smoothing factor (when p defines the relative smoothing). Set it according to the noise level.</para> + </listitem> + <listitem> + <para> + <guilabel>Regularity</guilabel> [0, 100]: this parameter is concerned with the bigger structures. The bigger this value, the more even the overall smoothing will be. This is necessary when much noise is present since it is then difficult to estimate the geometry. Also if you want to achieve a 'van Gogh' turbulence effect, setting it higher than 3 is recommended.</para> + </listitem> + <listitem> + <para> + <guilabel>Filter Iterations</guilabel>: number of times the blurring algorithm is applied. Usually 1 or 2 is sufficient.</para> + </listitem> + </itemizedlist> + </para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="inpaintingsettings2.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Inpainting Advanced Settings</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> + <itemizedlist> + <listitem> + <para> + <guilabel>Angular Step</guilabel> da [5, 90]: angular integration of the anisotropy alpha. If alpha is chosen small, da should also be chosen small. But beware, small angles result in long runs! Choose it as large as you can accept. </para> + </listitem> + <listitem> + <para> + <guilabel>Integral Step</guilabel> [0.1, 10]: spatial integration step width in terms of pixels. Should remain less than 1 (sub-pixel smoothing) and never be higher than 2.</para> + </listitem> + <listitem> + <para> + <guilabel>Use Linear Interpolation</guilabel>: The gain in quality if you select this option is only marginal and you lose a factor of 2 in speed. Our recommendation is to leave it off.</para> + </listitem> + </itemizedlist> + </para> + <para> + <guilabel>Save As</guilabel> and <guilabel>Load</guilabel> buttons are used to do just that. Any Photograph Inpainting filter settings that you have set can be saved to the filesystem in a text file and loaded later. +</para> + <warning> + <para> +Photograph Inpainting is (comparatively) very fast in what it is doing, but it can take a long time to run and cause high CPU load. You may always abort computation by pressing <guilabel>Cancel</guilabel> button during rendering. +</para> + </warning> + </sect4> + <sect4 id="inaction-inpainting" > + <title>The Inpainting tool in action</title> + <para> +Below, you can see a <guilabel>Remove Small Area</guilabel> Inpainting type applied to a color photograph taken at Guatemala city with an analog camera. Look like there is a strange black artifacts on the face front, resulting of a bad film stockage during the travel. The original image is (1), the corrected image (2). +</para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="inpaintingpreview.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Inpainting Filter Preview</phrase> + </textobject> + </inlinemediaobject> + </para> + </sect4> + </sect3> + <sect3 id="noisereduction" > + <sect3info> + <title>Noise Reduction</title> + <authorgroup> + <author> + <firstname>Gilles</firstname> + <surname>Caulier</surname> + <affiliation> + <address> + <email>caulier_dot_gilles_at_gmail_dot_com</email> + </address> + </affiliation> + </author> + <author> + <firstname>Gerhard</firstname> + <surname>Kulzer</surname> + <affiliation> + <address> + <email>gerhard at kulzer dot net</email> + </address> + </affiliation> + </author> + </authorgroup> + <abstract> + <para> +&digikam; +The <emphasis>Noise Reduction</emphasis> is a powerful tool to reduce the image noise. +It uses an algorithm copyrighted by Peter Heckert. +</para> + </abstract> + <keywordset> + <keyword>KDE</keyword> + <keyword>Digikam</keyword> + <keyword>Noise reduction</keyword> + <keyword>Blur</keyword> + </keywordset> + </sect3info> + <title>Introduction</title> + <para> + This tool provides selectable image filters to remove specks or other artifacts caused by junk such as dust or hair on the lens. It also can be used to remove <emphasis>Sensor Noise</emphasis> from the camera that maybe caused by high ISO settings, as well as the so-called <emphasis> +Moiré Patterns</emphasis> on scanned images from books or magazines. +</para> + <para> + If you want more information about what's digital camera sensor noise, please take a look in this <ulink url="http://www.cambridgeincolour.com/tutorials/noise.htm" >tutorial</ulink>. +</para> + <sect4 id="using-noisereduction" > + <title>Using the Noisereduction Tool</title> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="noisereductiondialog.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Noise Reduction Dialog</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> +The above screenshot shows a typical scene taken with an digital camera using a high sensitivity ISO setting. It shows grainy noise which can be reduced successfully with this tool. +</para> + <para> +The re-sizeable image panel with the original preview helps you to pan within the image. Move the red rectangle around to select the area that lets you judge on the optimal filter settings. The preview window shows the filter output using the current settings. It can be rearranged in four different combinations as depicted in the icons below the original preview. This screenshot shows the first arrangement where the same cutout is shown for comparison. On the bottom of preview area, you can see <guilabel>Zoom Factor</guilabel> settings to magnify an area of the image. +</para> + <para> +You can see below a full description of all parameters. In most cases only <guilabel>Details</guilabel> tab is needed and the other parameters available into <guilabel>Advanced</guilabel> tab can be left at their default setting. + +<itemizedlist> + <listitem> + <para> + <guilabel>Radius</guilabel>: this control selects the gliding window size used for the filter. Larger values do not increase the amount of time needed to filter each pixel in the image but can cause blurring. This window moves across the image, and the color in it is smoothed to remove imperfections. In any case it must be about the same size as noise granularity or somewhat more. If it is set higher than necessary, then it can cause unwanted blur. +</para> + </listitem> + <listitem> + <para> + <guilabel>Threshold</guilabel>: use the slider for coarse adjustment, and the spin control for fine adjustment. This controls edge detection sensitivity. This value should be set so that edges and details are clearly visible and noise is smoothed out. This value is not bound to any intensity value, it is bound to the second derivative of intensity values. Simply adjust it and watch the preview. Adjustment must be made carefully, because the gap between noisy, smooth, and blur is very small. Adjust it as carefully as you would adjust the focus of a camera. +</para> + </listitem> + <listitem> + <para> + <guilabel>Texture</guilabel>: this control set the texture accuracy. This value can be used, to get more or less texture accuracy. When decreased, then noise and texture are blurred out, when increased then texture is amplified, but also noise will increase. It has almost no effect to image edges, opposed to filter <guilabel>Edge</guilabel>, which would blur edges, when increased. If <guilabel>Edge</guilabel> is adjusted in away so that edges are sharp, and there is still too much area noise, then <guilabel>Texture</guilabel> detail could be used to reduce noise without blurring edges. Another way would be to decrease <guilabel>Radius</guilabel> and to increase <guilabel>Edge</guilabel>. +</para> + </listitem> + <listitem> + <para> + <guilabel>Sharpness</guilabel>: this control set the sharpness level. this value defines the pixel distance in which the filter looks ahead for luminance variations. When this value is increased, then spikenoise is erased. You can eventually readjust filter <guilabel>Edge</guilabel>, when you changed this setting. When this value is to high, then the adaptive filter cannot longer accurately track image details, and noise can reappear or blur can occur. +</para> + </listitem> + <listitem> + <para> + <guilabel>Edge</guilabel>: this control set the edge accuracy for sharpness. This value improves the frequency response for the filter. When it is too strong then not all noise can be removed, or spike noise may appear. Set it near to maximum, if you want to remove weak noise or JPEG-artifacts, without loosing detail. +</para> + </listitem> + <listitem> + <para> + <guilabel>Erosion</guilabel>: this control set the phase shift for edges. This value can be used to erodes singular spikes and it has a smooth effect to edges, and sharpens edges by erosion, so noise at edges is eroded. The effect is dependant from <guilabel>Sharpness</guilabel>, <guilabel>Damping</guilabel>, and <guilabel>Edges</guilabel>. Set it to minimum, if you want to remove weak noise or JPEG-artifacts. When this value is increased, then also increasing <guilabel>Damping</guilabel> is often useful. This setting can provides sharpening and antialiasing effect to edges when spike noise is corrected. +</para> + </listitem> + <listitem> + <para> + <guilabel>Luminance</guilabel>: this control set the luminance tolerance of image. It's recommended to use only <guilabel>Color</guilabel> or <guilabel>Luminance</guilabel> tolerance settings to make an image correction, not the both at the same time. This settings don't influence the main smoothing process controlled by <guilabel>Details</guilabel> settings. +</para> + </listitem> + <listitem> + <para> + <guilabel>Color</guilabel>: this control set the color tolerance of image. It's recommended to use only <guilabel>Color</guilabel> or <guilabel>Luminance</guilabel> tolerance settings to make an image correction, not the both at the same time. This settings don't influence the main smoothing process controlled by <guilabel>Details</guilabel> settings. +</para> + </listitem> + <listitem> + <para> + <guilabel>Gamma</guilabel>: this control set the gamma tolerance of image. This value can be used to increase the tolerance values for darker areas (which commonly are more noisy). This results in more blur for shadow areas. +</para> + </listitem> + <listitem> + <para> + <guilabel>Damping</guilabel>: this control set the phase jitter damping adjustment. This value defines how fast the adaptive filter-radius reacts to luminance variations. If increased, then edges appear smoother, if too high, then blur may occur. If at minimum then noise and phase jitter at edges can occur. It can suppress spike noise when increased and this is the preferred method to remove it. +</para> + </listitem> + <listitem> + <para> + <guilabel>Save As</guilabel> and <guilabel>Load</guilabel>: these buttons are used to do just that. Any Noise Reduction parameters that you have set can be saved to the filesystem and loaded later. +</para> + </listitem> + <listitem> + <para> + <guilabel>Defaults</guilabel>: this button resets all settings to default values. +</para> + </listitem> + </itemizedlist> + </para> + <sect5 id="inaction-noisereduction" > + <title>Noisereduction in action</title> + <para> + This is an example of how the noise reduction can change your life. The original image is (1) and the corrected image is (2). The noise reduction was applied using default settings. + </para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="noisereductionpreview.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Noise Reduction in Action</phrase> + </textobject> + </inlinemediaobject> + </para> + </sect5> + <sect5 id="using-blurfilter" > + <title>Softening a Photograph</title> + <para> + Sometimes an image is too crisp for your purposes. The solution is to blur it a bit: fortunately blurring an image is much easier than sharpening it. Select the Blur Tool with the <menuchoice> + <guimenu>Enhance</guimenu> + <guimenuitem>Blur</guimenuitem> + </menuchoice> menu entry and experiment with the level. The preview window on the right of the dialog shows the effect of the operation on your photograph. + </para> + <example> + <title>The Blur Tool in Action</title> + <screenshot> + <screeninfo>The Blur Tool in Action" </screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="editorblurplugin.png" format="PNG" /> + </imageobject> + </mediaobject> + </screenshot> + </example> + </sect5> + </sect4> + </sect3> + <sect3 id="restoration" > + <sect3info> + <title>Photograph Restoration</title> + <authorgroup> + <author> + <firstname>Gilles</firstname> + <surname>Caulier</surname> + <affiliation> + <address> + <email>caulier_dot_gilles_at_gmail_dot_com</email> + </address> + </affiliation> + </author> + <author> + <firstname>Gerhard</firstname> + <surname>Kulzer</surname> + <affiliation> + <address> + <email>gerhard at kulzer dot net</email> + </address> + </affiliation> + </author> + </authorgroup> + <abstract> + <para> + <ulink url="http://cimg.sourceforge.net" > + <inlinemediaobject> + <imageobject> + <imagedata fileref="cimg-logo.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>cimglogo</phrase> + </textobject> + </inlinemediaobject> + </ulink> + </para> + <para> +&digikam; +The <emphasis>Photograph Restoration</emphasis> is definitely one of the most advanced tools to reduce photograph artifacts. +</para> + </abstract> + <keywordset> + <keyword>KDE</keyword> + <keyword>Digikam</keyword> + </keywordset> + </sect3info> + <title>Introduction</title> + <para> +This fantastic restoration filter is a new development providing unprecedented possibilities in the public domain to remove lots of unwanted stuff from your images. It is well adapted to deal with degraded images suffering from Gaussian noise, film grain, scratches or compression artifacts and local degradations usually encountered in digital (original or digitized) images. The smoothing happens along the image curvatures, thus preserving the meaningful content much alike our human eye would want it. +</para> + <para> +The same algorithm can be used for colorization and texture replacement which is covered by another tool (inpainting). The restoration algorithm has been developed by the IMAGE team of GREC CNRS lab in Caen/France and is a part of the <ulink url="http://cimg.sourceforge.net" >CImg project</ulink>. +</para> + <sect4 id="using-restoration" > + <title>Using the Restoration tool</title> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="restorationdialog.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>Photograph Restoration Dialog</phrase> + </textobject> + </inlinemediaobject> + </para> + <para>The tool comes with several presets as starting points and to simplify the restoration. The preset settings available are listed below: + +<itemizedlist> + <listitem> + <para> + <guilabel>None</guilabel>: Using most common default filter settings not optimized for any particular purpose.</para> + </listitem> + <listitem> + <para> + <guilabel>Reduce Uniform Noise</guilabel>: Optimum settings for image noise due to sensors.</para> + </listitem> + <listitem> + <para> + <guilabel>Reduce JPEG Artifacts</guilabel>: JPEG's compression is not perfect, in fact for some types of images it is far from it. As a lossy compression algorithm, there are some compression "artifacts" - slight defaults showing in the decompressed image. This setting aims at correcting this problem.</para> + </listitem> + <listitem> + <para> + <guilabel>Reduce Texturing</guilabel>: Optimized to remove artifacts from scanning, digitizing or Moire patterns.</para> + </listitem> + </itemizedlist> + </para> + <para>If you want to set filter parameters for finer adjustments, use <guilabel>Smoothing Settings</guilabel> and <guilabel>Advanced Settings</guilabel> tabs:</para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="restorationsettings1.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Restoration Smoothing Settings</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> + <itemizedlist> + <listitem> + <para> + <guilabel>Detail Preservation</guilabel> p [0, 100]: this controls the preservation of the curvatures (features). A low value forces an equal smoothing across the image, whereas bigger values preferably smooth the homogeneous regions and leaves the details sharper. A value of 0.9 should well preserve details so that no sharpening is required afterwards. Note that <guilabel>Detail Preservation</guilabel> must be always inferior to <guilabel>Anisotropy</guilabel>.</para> + </listitem> + <listitem> + <para> + <guilabel>Anisotropy</guilabel> alpha [0, 100]: a low value smooths equally in all directions, whereas a value close to 1 smooths in one direction only. If you have film grain or CCD kind of noise a high value will result in wave-like pattern, whereas JPEG artifacts are suited for values close to 1. </para> + </listitem> + <listitem> + <para> + <guilabel>Smoothing</guilabel> [0, 500]: this sets the maximum overall smoothing factor (when p defines the relative smoothing). Set it according to the noise level.</para> + </listitem> + <listitem> + <para> + <guilabel>Regularity</guilabel> [0, 100]: this parameter is concerned with the uniformity of the smoothing. Imagine the smoothing process as a combing of the image. Then the Regularity would correspond to the size of the comb. The bigger this value, the more even the overall smoothing will be. This is necessary when much noise is present since it is then difficult to estimate the local geometry. Also if you want to achieve a 'van Gogh' turbulence effect, setting it higher than 3 is recommended.</para> + </listitem> + <listitem> + <para> + <guilabel>Filter Iterations</guilabel>: number of times the blurring algorithm is applied. Usually 1 or 2 is sufficient.</para> + </listitem> + </itemizedlist> + </para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="restorationsettings2.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Restoration Advanced Settings</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> + <itemizedlist> + <listitem> + <para> + <guilabel>Angular Step</guilabel> da [5, 90]: angular integration of the anisotropy alpha. If alpha is chosen small, da should also be chosen small. But beware, small angles result in long runs! Choose it as large as you can accept. </para> + </listitem> + <listitem> + <para> + <guilabel>Integral Step</guilabel> [0.1, 10]: spatial integration step width in terms of pixels. Should remain less than 1 (sub-pixel smoothing) and never be higher than 2.</para> + </listitem> + <listitem> + <para> + <guilabel>Use Linear Interpolation</guilabel>: The gain in quality if you select this option is only marginal and you lose a factor of 2 in speed. Our recommendation is to leave it off.</para> + </listitem> + </itemizedlist> + </para> + <para> + <guilabel>Save As</guilabel> and <guilabel>Load</guilabel> buttons are used to do just that. Any Photograph Restoration filter settings that you have set can be saved to the filesystem in a text file and loaded later. +</para> + <warning> + <para> +Photograph restoration is (comparatively) very fast in what it is doing, but it can take a long time to run and cause high CPU load. You may always abort computation by pressing <guilabel>Abort</guilabel> button during preview rendering. +</para> + </warning> + </sect4> + <sect4 id="inaction-restoration" > + <title>The Restoration tool in action</title> + <para> +Below, you can see a <guilabel>Reduce Uniform Noise</guilabel> Restoration type applied to a Black and White photograph taken with a Minolta(tm) 700Si camera using Ilford(tm) HP-5 film set at 3200 ISO sensitivity. You see the very prominent film grain on the faces. The original image is (1), the corrected image (2). +</para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="restorationpreview.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>Reduce Uniform Noise Restoration Preview</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> +Below, you can see an another Photograph Restoration example using <guilabel>Reduce Texturing</guilabel> Restoration type applied to an old color photograph acquire with a digital flat scanner. You see the very prominent artifacts resulting of scanner light on plastic photograph paper. The original image is (1), the corrected image (2). +</para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="restorationpreview2.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>Reduce Texturing Restoration Preview</phrase> + </textobject> + </inlinemediaobject> + </para> + </sect4> + </sect3> + <sect3 id="hotpixels" > + <sect3info> + <title>Hot Pixels Correction</title> + <authorgroup> + <author> + <firstname>Gilles</firstname> + <surname>Caulier</surname> + <affiliation> + <address> + <email>caulier_dot_gilles_at_gmail_dot_com</email> + </address> + </affiliation> + </author> + <author> + <firstname>Unai</firstname> + <surname>Garro</surname> + <affiliation> + <address> + <email>ugarro at telefonica dot net</email> + </address> + </affiliation> + </author> + </authorgroup> + <abstract> + <para> +&digikam; +The <emphasis>Hot Pixels</emphasis> tool facilitates removing hot pixels from photographs taken with a CCD camera. It uses algorithms from the JPEGPixi project which are copyrighted by Martin Dickopp. +</para> + </abstract> + <keywordset> + <keyword>KDE</keyword> + <keyword>digiKam</keyword> + </keywordset> + </sect3info> + <title>Introduction</title> + <para> +Most current digital cameras produce images with several brightly colored "bad pixels" when using slow shutter speeds. Night images can be ruined by these "bad pixels". There are three different types of "bad pixels": + +<itemizedlist> + <listitem> + <para>Stuck pixels: it's a pixel that always reads high or is always on to maximum power on all exposures. This produces a bright pixel usually of red, blue or green color in the final image. A stuck pixel will occur regardless of shutter speed, aperture size or any other user settings. It will occur on a normal exposure and tends to be more obvious under bright condition.</para> + </listitem> + <listitem> + <para>Dead pixels: it's a pixel that reads zero or is always off on all exposures. This state produces a black pixel in the final image. Similar to stuck pixel, a dead pixel will occur regardless of shutter speed, aperture size or any other user settings.</para> + </listitem> + <listitem> + <para>Hot pixels: it's a pixel that reads high (bright) on longer exposures as white, red, or green color. The longer the exposure time, the more visible hot pixels will become. These pixels will not be visible in bright conditions.</para> + </listitem> + </itemizedlist> + +Note that stuck or dead pixels will occur at the same location for all images. If the location of the stuck or dead pixel occurs at different locations, it may be a Hot Pixel. +</para> + <para> + +Stuck, dead or hot pixels are a problem in particular when shooting in high quality raw mode since many cameras have built-in hot pixel suppression applied automatically when JPEG compression is used (which is mostly the case). +</para> + <para> +This tool can be used to fix the "Hot pixels" and "Stuck Pixels" on a photograph using a black frame subtraction method. There is no yet a manual editor to select bad pixels. +</para> + <sect4 id="using-blackframecreation" > + <title>Create the Black Frames</title> + <para> +The Black Frame substraction method is the most accurate "Hot Pixels" and "Stuck Pixels" removal. First you have to create a "Black Frame" as a reference. This is easy to do. When you finish taking your long exposure shots, put a lens cap on the camera and take one "dark" image with the same exposure time as the images before. This image will be all dark, but with close examination you will see that it has the Hot and Stuck Pixels (colored dots). These are positioned at the same places as on your previous shots. +</para> + <para> +Load this file to the widget using the <guilabel>Black Frame</guilabel> button. The toll will process an automatic detection of Hot and Stuck Pixels. They will be highlighted in the control panel preview areas. +</para> + <warning> + <para> +If you use an old digital camera, it is important to re-shoot the Black Frame next time you are taking a long exposure images to detect new Hot and Stuck Pixels on CCD defects. +</para> + </warning> + </sect4> + <sect4 id="using-hotpixels" > + <title>Using the hotpixel tool</title> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="hotpixelsdialog.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Hot Pixels Dialog</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> +At first, as explained in the previous section, you need to load a Black Frame corresponding to the image to correct. An automatic parsing will be processed on the Black Frame to find bad pixels. Note that the widget will remember the previous Black Frame used on the last session and it will be re-opened automatically with the next session. +</para> + <para> +The image panel and the original preview help you to pan within the image. The preview window shows the filter output using the current settings. Bad Pixels are highlighted on all preview areas. +</para> + <para> +Select an area to see bad pixels on preview and the filter result using 'Separate View' options of image panel. Choose the best <guilabel>Filter</guilabel> method to interpolate pixels or pixel blocks. These are the available filters: + +<itemizedlist> + <listitem> + <para>Average: the pixels adjacent to the pixel block are averaged. The resulting color is assigned to all pixels in the block. For 1-dimensional interpolation, this is done separately for one pixel-wide, horizontal or vertical stripes.</para> + </listitem> + <listitem> + <para>Linear: the pixels which have a distance of 1 from the pixel block are used to calculate a bi-linear surface (2-dim), or a group of linear curves (1-dim), which is then used to assign interpolated colors to the pixels in the block.</para> + </listitem> + <listitem> + <para>Quadratic: this is the default filtering method. The pixels which have a distance of 2 or less from the pixel block are used to calculate a bi-quadratic surface (2-dim), or a group of quadratic curves (1-dim), which is then used to assign interpolated colors to the pixels in the block.</para> + </listitem> + <listitem> + <para>Cubic: the pixels which have a distance of 3 or less from the pixel block are used to calculate a bi-cubic surface (2-dim), or a group of cubic curves (1-dim), which is then used to assign interpolated colors to the pixels in the block.</para> + </listitem> + </itemizedlist> + </para> + </sect4> + <sect4 id="inaction-hotpixels" > + <title>The hotpixels tool in action</title> + <para> +Below, you can see the Hot Pixels Correction tool applied to a color photograph taken with a deficient digital camera at 200 ISO sensitivity with a long exposure shot. The original image magnified to 300% is (1), the corrected image (2). +</para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="hotpixelspreview.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Pixels Correction Preview</phrase> + </textobject> + </inlinemediaobject> + </para> + </sect4> + </sect3> + <sect3 id="antivignetting" > + <sect3info> + <title>Anti Vignetting</title> + <authorgroup> + <author> + <firstname>Gilles</firstname> + <surname>Caulier</surname> + <affiliation> + <address> + <email>caulier_dot_gilles_at_gmail_dot_com</email> + </address> + </affiliation> + </author> + <author> + <firstname>Gerhard</firstname> + <surname>Kulzer</surname> + <affiliation> + <address> + <email>gerhard at kulzer dot net</email> + </address> + </affiliation> + </author> + </authorgroup> + <abstract> + <para> +&digikam; +The <emphasis>Anti Vignetting</emphasis> is a tool to correct image vignetting (under-exposure in the corners). +</para> + </abstract> + <keywordset> + <keyword>KDE</keyword> + <keyword>Digikam</keyword> + <keyword>Anti-Vignetting</keyword> + </keywordset> + </sect3info> + <title>Introduction</title> + <para> + Wide angle lenses, especially those used in medium and large format photography, frequently do not uniformly illuminate the entire sensor plane. Instead, they "vignette" (shade) the edges and corners of the image, substantially reducing the light reaching the sensor there. But telelenses may show vignetting too. +</para> + <para> + The traditional solution for this is to attach a "center filter" to the lens. This is a neutral density filter with maximum density at the optical axis of the lens, clear at the periphery, with density varying inversely to the vignetting of the lens. A center filter has many advantages: not only does it automatically correct for full-frame images but, since it's fixed to the front of the lens, it also compensates for the off-center vignetting which occurs when camera movements are employed for perspective or plane of focus adjustment. +</para> + <para> + But there are disadvantages as well. Many center filters require a 1.5 or 2 f-stop filter factor adjustment, which may in turn necessitate a shutter speed so slow (since wide angle lenses, even with center filters, are best used at apertures of f/16 or smaller) that hand-holding the camera is impossible and motion blur becomes a problem when photographing moving objects. +</para> + <para> + With the wide exposure range of present-day film and the color (or grey-scale) depth of digital camera or film scanners, it is possible to simulate the effect of a center filter by applying an equivalent transform to a raw image taken without the filter. This antivignetting tool applies a center filter transformation to an image employing an algorithm copyrighted by John Walker. +</para> + <sect4 id="using-antivignetting" > + <title>Using the Anti-vignetting tool</title> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="antivignettingdialog.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Anti Vignetting Dialog</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> +Three sliders give you control over the vignetting correction filter, and three more over the target image exposure: +</para> + <para> + <guilabel>Density</guilabel>: this option controls the degree of luminosity attenuation by the filter at its point of maximum density. The default density is 2.0, which corresponds to an optical filter with a 1 f-stop filter factor (or, by no coincidence, a factor of 2 in luminosity). Increase the density to compensate for a greater degree of vignetting; reduce it for less. +</para> + <para> + <guilabel>Power</guilabel>: this option determines the rate at which the filter intensity falls off from the point of maximum density toward the edges, expressed as a power factor. The default of 1 yields a linear reduction in filter density with distance from the center. Power factors greater than 1.0 cause a faster fall-off (for example, a power of 2 causes the density to decrease as the square of the distance from the center) and causes the effect of the filter to be concentrated near the center. Powers less than 1 spread out the density of the filter toward the edges; a power of 0.5 causes the density to fall as the square root of the distance from the center. +</para> + <para> + <guilabel>Radius</guilabel>: this option specifies the radius, as a multiple of the half diagonal measure of the image, at which the density of the filter falls off to zero (or, in other words, becomes transparent). The default value of 1.0 specifies a filter which is transparent at its corners. A radius specification greater than 1 extends the effect of the center filter beyond the edges of the image, while a radius less than one limits the filter's action to a region smaller than the image. When compensating for vignetting by lenses used with large format and some medium format cameras, the default radius factor of 1 is rarely correct! These lenses often "cover" an image circle substantially larger than the film to permit camera movements to control perspective and focus, and consequently have a vignetting pattern which extends well beyond the edges of the film, requiring a radius setting greater than 1 to simulate a center filter covering the entire image circle. +</para> + <para> +The only way to be sure which settings of <guilabel>Density</guilabel>, <guilabel>Power</guilabel>, and <guilabel>Radius</guilabel> best compensate for the actual optical characteristics of a given lens is to expose a uniformly illuminated scene (for example, a grey card lit by diffuse light) and perform densitometry on the resulting image (for example with Adjust Level tool histogram position bar). Failing that, or specifications by the lens manufacturer giving the precise degree of vignetting at one or more working apertures, you may have to experiment with different settings to find those which work best for each of your lenses. For help you in this task, the widget dialog provide a thumbnail mask rendering applied on the image. Fortunately, the response of the human eye is logarithmic, not linear like most digital imaging sensors, so you needn't precisely compensate for the actual vignetting to create images which viewers will perceive as uniformly illuminated. +</para> + <para> + <guilabel>Brightness</guilabel>, <guilabel>Contrast</guilabel>, and <guilabel>Gamma</guilabel> settings: processing an image with this antivignetting tool reduces the luminosity of pixels. You need to re-adjust the target image exposure with these options. These sliders give only positive values because you need only to increase this setting. +</para> + <note> + <para> +&digikam; +If you want a finer exposure re-adjustment of the target image, leave the Brightness/Contrast/Gamma values at zero and use the Adjust Curve tool from Image Editor available under <menuchoice> + <guimenu>Color</guimenu> + <guimenuitem>Adjust Curve</guimenuitem> + </menuchoice> menu entry. +</para> + </note> + </sect4> + <sect4 id="inaction-antivignetting" > + <title>The anti-vignetting tool in action</title> + <para> +This is an example of an anti vignetting correction applied to an image. The original image (1) shows vignetting in the corners, the corrected image (2) much less. A brightness and contrast correction is also applied to the target image by this tool. +</para> + <para> +The values used for this example are: +<itemizedlist> + <listitem> + <para>Density = 2.6.</para> + </listitem> + <listitem> + <para>Power = 0.9.</para> + </listitem> + <listitem> + <para>Radius = 1.1.</para> + </listitem> + <listitem> + <para>Brightness = 20.</para> + </listitem> + <listitem> + <para>Contrast = 50.</para> + </listitem> + <listitem> + <para>Gamma = 20.</para> + </listitem> + </itemizedlist> + </para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="antivignettingpreview.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>The Anti Vignetting Image Editor Tool in Action</phrase> + </textobject> + </inlinemediaobject> + </para> + </sect4> + </sect3> + <sect3 id="lensdistortion" > + <sect3info> + <title>Lens Distortion Correction</title> + <authorgroup> + <author> + <firstname>Gilles</firstname> + <surname>Caulier</surname> + <affiliation> + <address> + <email>caulier_dot_gilles_at_gmail_dot_com</email> + </address> + </affiliation> + </author> + <author> + <firstname>Gerhard</firstname> + <surname>Kulzer</surname> + <affiliation> + <address> + <email>gerhard at kulzer dot net</email> + </address> + </affiliation> + </author> + </authorgroup> + <abstract> + <para> +&digikam; +The <emphasis>Lens Distortion</emphasis> is a tool to correct spherical lens aberrations on the photos. It uses an algorithm copyrighted by David Hodson. +</para> + </abstract> + <keywordset> + <keyword>KDE</keyword> + <keyword>Digikam</keyword> + </keywordset> + </sect3info> + <title>Introduction</title> + <anchor id="lensdistortion.anchor" /> + <para> + <emphasis>Barrel distortion</emphasis> is associated with wide angle (or minimal zoom) lenses. It causes the images to appear slightly spherical (curved outward) like a barrel. You can notice this when you have straight features close to the image's peripheral sides. <emphasis>Pincushion distortion</emphasis> is the opposite defect and is associated with Telephoto lenses (maximum zoom) or underwater images. The images appear pinched (bent inward) toward the center. The Pincushion is often less noticeable than barrel but are equally visible near the edges. These distortions can easily be eliminated without visible loss in quality with this tool. +</para> + <note> + <para> +This tool treats the geometrical distortions. Chromatic abberations will not be corrected by this tool. +</para> + </note> + <para> +The following figures explain the main types of geometrical distortions: +<itemizedlist> + <listitem> + <para>(1): pincushion distortion.</para> + </listitem> + <listitem> + <para>(2): no distortion.</para> + </listitem> + <listitem> + <para>(3): barrel distortion.</para> + </listitem> + </itemizedlist> + </para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="distortions.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>Lens Distortion Types</phrase> + </textobject> + </inlinemediaobject> + </para> + <para/> + <sect4 id="using-lensdistortion" > + <title>Using the lens distortion tool</title> + <note> + <para> +A bit of explanation first. The geometrical corrections use 4th-order polynominal coefficients. + <itemizedlist> + <listitem> + <para>The 1st-order coefficient changes the size of the image. The tool calls this <guilabel>Zoom</guilabel>.</para> + </listitem> + <listitem> + <para>The 2nd-order coefficient treats the main geometrical distortion of lenses and can correct the convex or concave shape of the image.</para> + </listitem> + <listitem> + <para>The 3rd-order coefficient has a similar rounding effect but levels off towards the edges. This correction is not employed in the tool.</para> + </listitem> + <listitem> + <para>The 4th-order coefficient corrects the far edges inversely to the 2nd-order rounding. Combining it with the 2nd-order correction the geometrical distortions can be almost completely eliminated.</para> + </listitem> + </itemizedlist> + </para> + </note> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="lensdistortiondialog.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>Lens Distortion Correction Dialog</phrase> + </textobject> + </inlinemediaobject> + </para> + <para> +Four sliders let you set the distortion correction filter: +</para> + <para> + <guilabel>Main</guilabel>: this value controls the amount of 2nd-order distortion. Negative values correct barrel distortions, while positive values correct pincushion distortion. +</para> + <para> + <guilabel>Edge</guilabel>: this value controls the amount of 4th-order distortion. The Edge control has more effect at the edges of the image than at the center. For most lenses, the <guilabel>Edge</guilabel> parameter has the opposite sign of the <guilabel>Main</guilabel> parameter. +</para> + <para> + <guilabel>Zoom</guilabel>: this value rescales the overall image size (1st-order correction). Negative values zoom out of the image, while positive values zoom in. +</para> + <para> + <guilabel>Brighten</guilabel>: this control adjusts the brightness in image corners. Negative values decrease the brightness image corners, while positive values increase it. +</para> + <para> +To help you to choose the best filter settings, the widget dialog illustrates with a thumbnail preview the distortion correction applied to a crossed mesh pattern. The values you apply to your image will be saved and come up with the same values as default the next time you call the tool. +</para> + <note> + <para> +The barrel-pincushion correction should be done before any crop or size changes (including perspective correction). In fact the Barrel-Pincushion corrections should be the very first step on the original image. If you crop the image and then use barrel correction the effect would be obviously wrong. +</para> + </note> + <para> +To help you finding the best correction the tool provides a vertical and horizontal guide. Move the mouse cursor in the image preview to display the dashed lines guide. Move the cursor to an important place in the image like the sea level or a building border and press the left mouse button for freeze the dashed lines position. Now, adjust the barrel/pincushion correction to align with the guide. +</para> + <para> +When using pincushion correction the resulting image will have a black border in the corner. You will need to cut this out with a crop tool available in <menuchoice> + <guimenu>Transform</guimenu> + <guimenuitem>Crop</guimenuitem> + </menuchoice> Image Editor menu or via the zoom slider of this dialog. +</para> + <para> +On most images using the barrel correction is enough, however with some shots such as front images, frames, paintings, the next logical step is to use perspective correction to make all the angles 90 degrees. Note that when you hold your camera by hand you almost always introduce some kind of slight perspective distortion. +</para> + </sect4> + <sect4 id="inaction-lensdistortion" > + <title>The lens distortion tool in action</title> + <para> +This is an example of a barrel correction applied to church in north Norway. The original image is (1), the corrected image (2). +</para> + <para> +The values used for this example are: +<itemizedlist> + <listitem> + <para>Main = -40.</para> + </listitem> + <listitem> + <para>Edge = 0.</para> + </listitem> + <listitem> + <para>Zoom = -20.</para> + </listitem> + <listitem> + <para>Brighten = 0.</para> + </listitem> + </itemizedlist> + </para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="lensdistortionpreview.png" format="PNG" /> + </imageobject> + <textobject> + <phrase>Lens Distortion Correction Preview</phrase> + </textobject> + </inlinemediaobject> + </para> + </sect4> + </sect3> +</sect2> diff --git a/doc/en/digikam/editor-filters.docbook b/doc/en/digikam/editor-filters.docbook new file mode 100644 index 00000000..fc56e866 --- /dev/null +++ b/doc/en/digikam/editor-filters.docbook @@ -0,0 +1,827 @@ +<sect2> <title>Special Effects (Filters)</title> +<sect3 id="infrared"> +<sect3info> + +<title>Simulate Infrared Film</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Infrared Film</emphasis> filter simulates traditional infrared film material. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +Simulating classical infrared film material (the effect is rendered in black and white) is an interesting alienation effect that is even stronger and more dramatic than pure black and white conversion. Contrast and an abstract touch are improved, which can underpin the expression of the photographer as an artists. + +It is like taking a image in black and white with a red filter on the camera lenses. Areas which reflect little red light, e.g. the sky, will show as low density, dark areas. Areas which are excellent reflectors of red light, e.g. most green foliage, will be high density areas. And snow landscapes are really dramatic. +</para> + +<para> +The algorithm is based on the method of the 'Simulate Infrared Film' tutorial of the GimpGuru.org web site available at <ulink url="http://www.gimpguru.org/Tutorials/SimulatedInfrared">this url</ulink>. +The filter tries to reproduce the famous Ilford(tm) SFX200 infrared film, cf. <ulink url="www.ilford.com/html/us_english/prod_html/sfx200/sfx200.html">this url</ulink>. This film has a sensitivity range of 200-800 ISO. +</para> + +<sect4 id="using-infrared"> +<title>Using the Infrared Filter</title> + +<para> +The left part of the dialog window lets you select the region to be shown in the preview section. Move the red rectangle with the mouse around to show the effect on different parts of the image. +</para> + +<para> +The lower part provides the two controls, Film Grain and ISO sensitivity. Check the <guilabel>Add Film Grain</guilabel> box if you want to simulate the grainy texture of a high sensitivity film. The ISO-level slider modifies the amount of filmgrain added and the predominance of green color (chlorophyll in nature) in the conversion mixer. Green pastures will become white as snow! Try it out. +</para> + +<note><para> +Because the filter mixes color channels to reproduce infrared film (with emphasis on green channel), one can not simulate infrared effect from black and white original photograph, since the color information is missing. +</para></note> + +</sect4> + +<sect4 id="inaction-infrared"> +<title>The filter in action</title> + +<para> +This is an example of the infrared film effect applied to a color image taken in New Zealand's landscapes. The original image is (1) and the converted image is (2). The film sensitivity used to simulate the infrared film is ISO-400. Higher ISO values will create a kind of aura in the highlights. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;infraredpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Infrared filter in Action</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="filmgrain"> +<sect3info> + +<title>Film Grain</title> + +<authorgroup> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Filmgrain</emphasis> filter reproduces traditional film grain techniques +of high speed films. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +The &digikam; <emphasis>Filmgrain</emphasis> filter is an easy tool to produce film grain on your +images as known from classical high speed film material as, for example, the famous B/W KodaK Tri-X. +In order to increase film sensitivity, manufacturers employed larger silver grains in the photo emulsion. +</para> + +<para> +The film grain effect gives your shot a particular mood or seems to transport it in time. The treated +image acquires a timeless atmosphere, detached from every day life. If you want that gritty, art-house, +street-photography grainy film look, especially in monochromatic photos, use this filter. +</para> + +<sect4 id="using-filmgrain"> +<title>Using the Filmgrain filter</title> + +<para> +There is a slider calibrated in ISO-sensitivity to control the grain intensity and granularity. The +default is set to ISO-2400, although higher values are often required. If you still want more grain, +apply the filter several times. +</para> + +</sect4> + +<sect4 id="inaction-filmgrain"> +<title>The filter in action</title> + +<para> +This is an example of the film grain effect applied on a black and white image. The original +image is (1) and the corrected image is (2). The film sensitivity used for simulate the film +graininess is ISO-1600. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;filmgrainpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Film Grain Filter in Action</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="oilpaint"> +<sect3info> + +<title>Oil Paint</title> + +<authorgroup> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Oil Paint</emphasis> filter gives your image the look of an oilpainting. +It uses an algorithm copyrighted by Pieter Voloshyn. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +The &digikam; <emphasis>Oil Paint</emphasis> filter gives your digital images a nice +oilpainting-like look. Images of nature and still lifes are well suited for this effect. +</para> + +<sect4 id="using-oilpaint"> +<title>Using the Oil Paint filter</title> + +<para> +There are two sliders to control the effect. The upper slider selects the <guilabel>Brush Size</guilabel> +between 1 and 5. Bigger brushes are better suited for large images. <guilabel>Smooth</guilabel> controls +the smoothness or, seen from the other end, the jaggedness. +</para> + +</sect4> + +<sect4 id="inaction-oilpaint"> +<title>The Oil Paint filter in action</title> + +<para> +This is an example of the oil paint filter effect. The original image is (1) and the transformed +image is (2). <guilabel>Brush Size</guilabel> for this 640 pixel size image is 1, +<guilabel>Smooth</guilabel> is 17. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;oilpaintpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>Oil Paint Image Effect Preview</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="charcoal"> +<sect3info> + +<title>Charcoal Drawing</title> + +<authorgroup> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Charcoal</emphasis> is an effect filter that creates a charcoal sketch-like result. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +The &digikam; <emphasis>Charcoal</emphasis> filter uses the gradients of color and luminosity to +produce a grey scale charcoal sketch. The lines defining the outline of the image are pronounced. +Images with slowly changing gradients are not ideal for this effect. It is helpful to imagine what +scene you would pick to do as a hand sketch yourself, in order to choose the image to start with. +</para> + +<sect4 id="using-charcoal"> +<title>Using the Charcoal filter</title> + +<para> +There are two sliders to control the effect on a scale of 1-100. The upper slider selects the pencil size, +whereas the second slider adjusts the contrast (smoothness). +</para> + +</sect4> + +<sect4 id="inaction-charcoal"> +<title>The Charcoal filter in action</title> + +<para> +This is an example of the charcoal filter. The original image is (1) and the transformed image is (2). +Default values of 30 and 10 where applied. The result can be improved by adjusting the luminosity levels. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;charcoalpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Charcoal filter in Action</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="emboss"> +<sect3info> + +<title>Emboss Image</title> + +<authorgroup> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Emboss</emphasis> filter sculptures your image into 3-D as if it were stamped into wax. It uses an algorithm copyrighted by Pieter Voloshyn. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> <title>Introduction</title> + +<para> +The &digikam; <emphasis>Emboss</emphasis> filter is a quick tool to render your images in a 3-D effect. +It works particularly well on images with simple structure where color is not the most important content. +The filter uses the difference between colors and luminosity to convert it into a grey, moon-like landscape +lit from 10 o'clock. +</para> + +<sect4 id="using-emboss"> <title>Using the Emboss filter</title> + +<para> +The <guilabel>Depth</guilabel> control allows to define the contrast of the filtering. +A value of 30 (10%) is the standard. +</para> + +</sect4> + +<sect4 id="inaction-emboss"> <title>The Emboss filter in action</title> + +<para> +This is an example of the emboss filter. The original image is (1) and the transformed image is (2). +The <guilabel>Depth</guilabel> applied is 10%. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;embosspreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Emboss filter in Action</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="distortionfx"> +<sect3info> + +<title>Distortion FX</title> + +<authorgroup> + + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> + +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Distortion FX</emphasis> is a series of distorting effects for digital still images. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +With this filter set, you can transform an ordinary photograph into a work of art suitable for framing using distorting operations. It uses algorithms copyrighted by Pieter Voloshyn. +</para> + +<sect4 id="using-distortionfx"> +<title>Using the filter</title> + +<para> +These are the distorting effects available: +</para> + +<para> + +<informaltable><tgroup cols="2"> + +<thead> + <row> + <entry>Type</entry> + <entry>Preview</entry> + </row> +</thead> + +<tbody> + + <row> + <entry> + <guilabel>Fish Eyes</guilabel>: warps the photograph around a 3D spherical shape to reproduce the common photograh 'Fish Eyes' effect. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_fisheyes.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Twirl</guilabel>: spins the photograph to produce a Twirl pattern. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_twirl.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Cylinder Horizontal</guilabel>: warps the photograph around a horizontal cylinder. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_cylinderh.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Cylinder Vertical</guilabel>: warps the photograph around a vertical cylinder. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_cylinderv.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Cylinder H/V</guilabel>: warps the photograph around a 2 cylinders, vertical and horizontal. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_cylinderhv.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Caricature</guilabel>: distorts photograph with 'Fish Eyes' effect inverted. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_caricature.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Multiple Corners</guilabel>: splits the photograph like a multiple corners pattern. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_corners.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Waves Horizontal</guilabel>: distorts the photograph with horizontal waves. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_wavesh.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Waves Vertical</guilabel>: distorts the photograph with vertical waves. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_wavesv.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Block Waves 1</guilabel>: divides the image into cells and makes it look as if it is being viewed through glass blocks. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_blockwaves1.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Block Waves 2</guilabel>: like Block Waves 1 but with another version of glass blocks distorsion. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_blockwaves2.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Circular Waves 1</guilabel>: distorts the photograph with circular waves. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_circularwaves1.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Circular Waves 2</guilabel>: other variation of Circular Waves effect. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_circularwaves2.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Polar Coordinates</guilabel>: converts the photograph from rectangular to polar coordinates. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_polarcoord.png" format="PNG" /> </imageobject></inlinemediaobject></para> </entry> + </row> + + <row> + <entry> + <guilabel>Unpolar Coordinates</guilabel>: Polar Coordinate effect inverted. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_unpolarcoord.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Tiles</guilabel>: splits the photograph into square blocks and move them randomly inside the image. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;distortionfx_tiles.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + +</tbody> + +</tgroup></informaltable> + +</para> + +<warning><para> +Some effects can take a long time to run and cause high CPU load. You can always abort an effect by pressing <guilabel>Abort</guilabel> button during preview rendering. +</para></warning> + +</sect4> + +<sect4 id="inaction-distortionfx"> +<title>The Distortion filter in action</title> + +<para> +The Distortion FX dialog tool in action is available below. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;distortionfxpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Distortion FX Dialog Tool Preview</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="blurfx"> +<sect3info> + +<title>Blur FX</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Blur FX</emphasis> is a series of blurring effects for digital still images. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +With this filter set, you can transform an ordinary photograph into a work of art suitable for framing using blurring operations. It uses algorithms copyrighted by Pieter Voloshyn. +</para> + +<sect4 id="using-blurfx"> +<title>Using the Blurfx</title> + +<para> +These are the blurring effects available: +</para> + +<para> + +<informaltable><tgroup cols="2"> + +<thead> + <row> + <entry>Type</entry> + <entry>Preview</entry> + </row> +</thead> + +<tbody> + + <row> + <entry> + <guilabel>Zoom Blur</guilabel>: blurs the image along radial lines starting from a specified center point. This simulates the blur of a zooming camera, thereby giving the photograph a dynamic expression as often seen in sport photography. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_zoomblur.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Radial Blur</guilabel>: blurs the image by rotating the pixels around the specified center point. This simulates the blur of a rotating camera. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_radialblur.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Far Blur</guilabel>: blurs the image to simulate the effect of an unfocused camera lens. The subject seems to recede into the background. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_farblur.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Motion Blur</guilabel>: blurs the image by swishing the pixels horizontally. This simulates the blur of a linearly moving camera, i.e. like a shot taken from a car or train. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_motionblur.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Focus Blur</guilabel>: blurs the image corners to reproduce the astigmatism distortion of a lens. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_focusblur.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Softener Blur</guilabel>: blurs the image softly in the darker tones and strongly in the high lights. This gives photographs a dreamy and glossy soft focus effect (Hamilton effect). It's ideal for creating romantic portraits, glamour photography, or addding a warm and subtle glow. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_softenerblur.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Shake Blur</guilabel>: blurs the image by randomly moving the pixels simulating the blur of an arbitrarily moving camera. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_shakeblur.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Smart Blur</guilabel>: finds the edges of color in photograph and blurs them without muddying the rest of the image. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_smartblur.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Frost Glass</guilabel>: blurs the image by simulating randomly dispersing light filtering through hoarse frosted glass. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_frostglass.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + + <row> + <entry> + <guilabel>Mosaic</guilabel>: blurs the image by dividing the photograph into rectangular cells and then recreates it by filling those cells with average pixel value. + </entry> + + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;blurfx_mosaic.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + </row> + +</tbody> + +</tgroup></informaltable> + +</para> + +<warning><para> +Some effects can take a long time to run and cause high CPU load. You can always abort an effect by pressing the <guilabel>Abort</guilabel> button during preview rendering. +</para></warning> + +</sect4> + +<sect4 id="inaction-blurfx"> +<title>The Blurfx in action</title> + +<para> +An example of the Blur FX dialog in action is shown below. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;blurfxpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Blur FX Dialog Tool Preview</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="raindrops"> +<sect3info> + +<title>Rain Drops</title> + +<authorgroup> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Raindrops</emphasis> filter puts beautiful raindrops on your image. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +The <emphasis>Raindrops</emphasis> is nice little tool to put raindrops onto your images. Naturally, it renders your image in a kind of wet look. It uses an algorithm copyrighted by Pieter Voloshyn. +</para> + +<sect4 id="using-raindrops"> +<title>Using the Raindrops filter</title> + +<para> +Three sliders give you control over the effect filter: +</para> + +<para> +<guilabel>Drop size</guilabel> obviously allows to change the size of the drops. As the drop size doesn't +automatically scale with the image size it is often necessary to reduce the size for small images. +<guilabel>Number</guilabel> changes the number and densitiy of drops. +<guilabel>Fish eye</guilabel> changes the optical effect of the drops across the image. +</para> + +<note><para> +You can keep a zone clear of raindrops with the &digikam; Image Editor <guilabel>Select</guilabel> tool. +Selecting the area to avoid (for example a face) before launching the <emphasis>RainDrops</emphasis> +filter will keep it free from rain drops. +</para></note> + +</sect4> + +<sect4 id="inaction-raindrops"> +<title>The Raindrops filter in action</title> + +<para> +This is an example of the raindrops filter. The original image (1) shows a quiet sunset, +the transformed image (2) indicates a sunset after a thunderstorm. Default values have been +used for this example. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;raindropspreview.png" format="PNG" /> </imageobject> + <textobject><phrase>Rain Drops Image Effect Preview</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +</sect2> diff --git a/doc/en/digikam/editor-redeyes-correction.png b/doc/en/digikam/editor-redeyes-correction.png Binary files differnew file mode 100644 index 00000000..6ebace07 --- /dev/null +++ b/doc/en/digikam/editor-redeyes-correction.png diff --git a/doc/en/digikam/editor-transform.docbook b/doc/en/digikam/editor-transform.docbook new file mode 100644 index 00000000..949934ea --- /dev/null +++ b/doc/en/digikam/editor-transform.docbook @@ -0,0 +1,683 @@ +<sect2> <title>Image transformation tools</title> + <sect3 id="using-rotatingflippingimage"> + <title>Rotating or Flipping a Photograph</title> + + <para> + If the photograph shows a wrong orientation you can <guilabel>Flip</guilabel> or <guilabel>Rotate</guilabel> it to the orientation you would like by using Transform Flip/Rotate tools available in + <menuchoice><guimenu>Transform</guimenu> <guimenuitem>Rotate</guimenuitem></menuchoice> and <menuchoice><guimenu>Transform</guimenu> <guimenuitem>Flip</guimenuitem></menuchoice> menus. + </para> + + <para> + With flipping options, you can flip or turn over the image horizontally or vertically like a card deck. With the rotating options, you can rotate the image in 90 degrees steps clockwise. It can be used to change the display mode to Portrait or Landscape. Be aware that this rotation is not lossless when using JPEG format. You also can rotate more accurately to a finer degree by using the Free Rotation tool. You can access it by the + <menuchoice><guimenu>Transform</guimenu> + <guimenuitem>Free Rotation</guimenuitem></menuchoice> menu entry. + See the dedicated <link linkend="using-freerotation">Free Rotation manual</link> for more information. + </para> + + </sect3> + +<sect3 id="resize"> +<sect3info> + +<title>Change the image size</title> + +<authorgroup> + + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> + +</authorgroup> + +<abstract> + +<para> +<ulink url="http://cimg.sourceforge.net"><inlinemediaobject> +<imageobject><imagedata fileref="&path;cimg-logo.png" format="PNG"/></imageobject> +<textobject><phrase>cimglogo</phrase></textobject> +</inlinemediaobject></ulink> +</para> + +<para> +The &digikam; <emphasis>Blowup Photograph</emphasis> is definitely one of the most advanced tools to increase a photograph's size with minimal loss in image quality. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +<keyword>Cimg</keyword> +<keyword>Greycstoration</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para>Rescaling an image to make it smaller is easy. The big question is: how can you blow up an image and keep the details sharp? How can one zoom in when the resolution boundary has been reached? How can one reinvent or guess the missing information to fill in the necessarily coarse image after upsizing? Well, the CImg algorithm we use here does an excellent job, try it out and see for yourself! +</para> + + <sect4 id="using-resizingimage"> <title>Resizing a Photograph</title> + + <anchor id="resizetool.anchor"/> + <para> + If the photograph has the wrong size, you can scale it to the size you would like by using Transform Resize tool. Select <menuchoice><guimenu>Transform</guimenu><guimenuitem>Resize</guimenuitem></menuchoice> and adjust the target values. The Resize tool dialog is available below. + </para> + + <example> <title>The Resize Tool Dialog</title> + <screenshot><screeninfo>The Resize Tool Dialog</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorresizetool.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + This image resizing tool uses a standard linear interpolation method to approximate pixels. If you want to up-size a small image with a better quality, try the Blowup tool. + </para> + + </sect4> + + +<sect4 id="using-blowup"> <title>Increasing image size (blow-up)</title> + <para> + Many image editing programs use some kind of interpolation ⪚ spline interpolation to scale-up an image. &digikam; uses a more sophisticated approach. The algorithm underlying <emphasis>Blowup Photograph</emphasis> has been developed by the IMAGE team of GREC CNRS lab in Caen/France and is a part of the <ulink url="http://cimg.sourceforge.net">CImg project</ulink>. + </para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;blowupdialog.png" format="PNG" /> </imageobject> + <textobject><phrase>Blowup Photograph Dialog</phrase></textobject></inlinemediaobject> + </para> + +<para>You have to tell the tool about the resizing you want to do. These settings are available in <guilabel>New Size</guilabel> tab and are listed below: + +<itemizedlist> + + <listitem><para><guilabel>Maintain Aspect Ratio</guilabel>: if this option is enabled, setting the new image size will preserve the aspect ratio of the original image.</para></listitem> + <listitem><para><guilabel>Width</guilabel>: the new image width to use for blowing up.</para></listitem> + <listitem><para><guilabel>Height</guilabel>: the new image height to use for blowing up.</para></listitem> + +</itemizedlist> +</para> + +<para>If you want to set filter parameters for finer adjustments, use <guilabel>Smoothing Settings</guilabel> and <guilabel>Advanced Settings</guilabel> tabs:</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;blowupsettings1.png" format="PNG" /> </imageobject> + <textobject><phrase>Photograp Blowup Smoothing Settings</phrase></textobject></inlinemediaobject> + </para> + +<para> +<itemizedlist> + + <listitem><para><guilabel>Detail Preservation</guilabel> p [0, 100]: this controls the preservation of the curvatures (features). A low value forces an equal smoothing across the image, whereas bigger values preferably smooth the homogeneous regions and leaves the details sharper. A value of 0.9 should well preserve details so that no sharpening is required afterwards. Note that <guilabel>Detail Preservation</guilabel> must be always inferior to <guilabel>Anisotropy</guilabel>.</para></listitem> + <listitem><para><guilabel>Anisotropy</guilabel> alpha [0, 100]: a low value smooths equally in all directions, whereas a value close to 1 smooths in one direction only. If you have film grain or CCD kind of noise a high value will result in wave-like pattern, whereas JPEG artifacts are suited for values close to 1. </para></listitem> + <listitem><para><guilabel>Smoothing</guilabel> [0, 500]: this sets the maximum overall smoothing factor (when p defines the relative smoothing). Set it according to the noise level.</para></listitem> + <listitem><para><guilabel>Regularity</guilabel> [0, 100]: this parameter is concerned with the bigger structures. The bigger this value, the more even the overall smoothing will be. This is necessary when much noise is present since it is then difficult to estimate the geometry. Also if you want to achieve a 'van Gogh' turbulence effect, setting it higher than 3 is recommended.</para></listitem> + <listitem><para><guilabel>Filter Iterations</guilabel>: number of times the blurring algorithm is applied. Usually 1 or 2 is sufficient.</para></listitem> + +</itemizedlist> + +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;blowupsettings2.png" format="PNG" /> </imageobject> + <textobject><phrase>Photograph Blowup Advanced Settings</phrase></textobject></inlinemediaobject> + </para> + +<para> +<itemizedlist> + + <listitem><para><guilabel>Angular Step</guilabel> da [5, 90]: angular integration of the anisotropy alpha. If alpha is chosen small, da should also be chosen small. But beware, small angles result in long runs! Choose it as large as you can accept. </para></listitem> + <listitem><para><guilabel>Integral Step</guilabel> [0.1, 10]: spatial integration step width in terms of pixels. Should remain less than 1 (sub-pixel smoothing) and never be higher than 2.</para></listitem> +<listitem><para><guilabel>Use Linear Interpolation</guilabel>: The gain in quality if you select this option is only marginal and you lose a factor of 2 in speed. Our recommendation is to leave it off.</para></listitem> + +</itemizedlist> + +</para> + +<para> +<guilabel>Save As</guilabel> and <guilabel>Load</guilabel> buttons are used to do just that. Any Blowup Photograph filter settings that you have set can be saved to the filesystem in a text file and loaded later. +</para> + +<warning><para> +Blowup Photograph is very fast in what it is doing, but it can take a long time to run and cause high CPU load. You may always abort computation by pressing <guilabel>Cancel</guilabel> button during rendering. +</para></warning> + +</sect4> + +<sect4 id="inaction-blowup"> +<title>The blow-up tool in action</title> + +<para> +You can see below an Blowup Photograph example applied to a small color image area resized to x2. The original is (1), the Blowup result (3). The (2) preview is the result given to standard linear resizing method to compare. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;blowuppreview.png" format="PNG" /> </imageobject> + <textobject><phrase>Blowup Photograph Filter Preview</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="aspect-ratio-crop"> <title>Cropping a Photograph</title> + + <sect4 id="using-manualcrop"> <title>Manual Crop</title> + + <para> + Cropping a photograph is not only a common operation, but an often underestimated photographer's tool to compose an image. The Image Editor makes it very easy. To crop a photograph simply drag a rectangle over the image by holding down the &LMB; and moving the mouse. You will see a wire frame rectangle appear as you move the mouse. + </para> + + <example> <title>The Current Image Selection in Image Editor</title> + <screenshot><screeninfo>The Current Image Selection in Image Editor</screeninfo> + <mediaobject><imageobject> <imagedata fileref="&path;editorimageselection.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + When you release the button the area of the photograph that will be removed by a crop operation is greyed out. This allows you to get a good view of how your photograph will look once you have cropped it. You can change the size of the cropped area by dragging the corners of the rectangle, and you can create a new crop area simply by dragging out another rectangle. + </para> + + <para> + Once you are happy with the crop, click on the + <inlinemediaobject> + <imageobject><imagedata fileref="&path;editorcropbutton.png" format="PNG"/></imageobject> + <textobject> <phrase>The Image Editor Crop Button</phrase> </textobject> + </inlinemediaobject> + button on the toolbar and the photograph will be cropped (&Ctrl;+X). Use the + <menuchoice><guimenu>File</guimenu> + <guimenuitem>Save</guimenuitem></menuchoice> or + <menuchoice><guimenu>File</guimenu> + <guimenuitem>Save As</guimenuitem></menuchoice> + entries in the File menu to safe the newly cropped photograph. + </para> + + </sect4> + + <sect4 id="using-proportionalcrop"> <title>Proportional Crop</title> + + <anchor id="ratiocroptool.anchor"/> + + <para> + The Aspect Ratio Crop tool goes further. While you are editing digital images, it is often necessary to create a compatible format with, for example, your photo album or paper formats. If you print an image from your digital camera and then try to put it in your photo album, you may notice that the camera has a different width or height ratio than a normal photographic film format so you need to crop your digital images in a predefined ratio (for example 5:7 or 2:3 which is a standard photo ratio). + </para> + + <example> <title>The Aspect Ratio Crop Tool Dialog</title> + <screenshot><screeninfo>The Aspect Ratio Crop Tool Dialog</screeninfo> + <mediaobject><imageobject> <imagedata fileref="&path;editorratiocroptool.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + In the preview area you can resize the cropping rectangle by moving the corners with the mouse. It will keep the ratio value set in the bottom of dialog. + </para> + + <para> + In the Aspect Ratio Crop tool settings, you specify the <guilabel>Orientation</guilabel> as <guilabel>Portrait</guilabel> or <guilabel>Landscape</guilabel>. Portrait will always have the larger size assigned to the <guilabel>Height</guilabel> and Landscape to the <guilabel>Width</guilabel>. + </para> + + <para> + Aspect Ratio Crop tool uses a relative ratio. That means it is the same if you use centimeters or inches and it doesn't specify the physical size. For example, you can see below a correspondence list of traditional photographic paper sizes and aspect ratio crop. + </para> + + <informaltable><tgroup cols="2"> + + <thead><row> + <entry>Standard Photograph Paper Size</entry> + <entry>Aspect Ratio Crop</entry> + </row></thead> + + <tbody> + <row> +<entry> +10x15cm 20x30cm 30x45cm +3.5x5" 4x6" 8x12" 12x18" 16x24" 20x30" +</entry> + +<entry> +2:3 +</entry> + </row> + + <row> +<entry> +6x8cm 15x20cm 18x24cm 30x40cm +3.75x5" 4.5x6" 6x8" 7.5x10" 9x12" +</entry> + +<entry> +3:4 +</entry> + </row> + + <row> +<entry> +20x25cm 40x50cm +8x10" 16x20" +</entry> + +<entry> +4:5 +</entry> + </row> + + <row> +<entry> +15x21cm 30x42cm +5x7" +</entry> + +<entry> +5:7 +</entry> + </row> + + <row> +<entry> +21x30cm 42x60cm +</entry> + +<entry> +7:10 +</entry> + </row> + + </tbody> + + </tgroup></informaltable> + + <para> + At the far right of the dialog two buttons are available to move the crop selection automatically to the horizontal or vertical center of the image. + </para> + + <para> + At the very bottom line of the dialog, the <guilabel>Max. Ratio</guilabel> button lets you set the crop area size to the maximum size according to the current aspect ratio settings and orientation. + </para> + + <note><para> + The Aspect Ratio Crop tool remembers the settings depending on image orientation (horizontal or vertical). When you use the crop tool next time, these settings will be used as default values depending on the image orientation. The changed image dimensions are stored into the EXIF tables so that the EXIF data reflects the cropped image and not the original one. + </para></note> + + </sect4> + + <sect4 id="using-compositionguides"> <title>Composition Guide</title> + + <para> + When first looking at an image, the eye of the viewer rarely settles at the center of the image, but moves instead from the top left to the right, and then from the lower left to the right again. This pattern is unconscious but has been well documented. It is probably associated with the western reading pattern. From the photographer's point of view, the goal then becomes to guide the gaze of the viewer to the subject, being aware of the way many people perceive an image. + </para> + + <para> + The <guilabel>Composition Guide</guilabel> settings provides guiding elements to better compose your images. These guides are: + + <itemizedlist> + + <listitem> + <para> + <guilabel>Rule of Thirds</guilabel>: a grid that divides the image into thirds in every direction (that makes for 9 parts). These proportions are close to the golden rule and are derived from the field of view of the human eye. They are often used with slight variations throughout a large number of commonly used objects. Within that frame there are precise areas where the important parts of the image should be placed. The same principle is used to determine the position of the horizon and the proportion of ground to sky. + </para> + + <para> + Many photographers and artists are aware of the Rule of Thirds, where a image is divided into three sections vertically and horizontally and the points of intersection represent places to position important visual elements. Moving a horizon in a landscape to the position of one third is often more effective than placing it in the middle, but it could also be placed near the bottom one quarter or sixth. There is nothing obligatory about applying the Rule of Thirds. In placing visual elements for effective composition, one must assess many factors including color, dominance, size and balance together with proportion. Often a certain amount of image balance or tension can make a composition more effective. + </para> + + <example> <title>Image Composition Example Using Rules of Third</title> + <screenshot><screeninfo>Image Composition Example Using Rules of Third + </screeninfo><mediaobject><imageobject> <imagedata fileref="&path;editorrulethirdlinesexample.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + </listitem> + + <listitem> + + <para> + <guilabel>Harmonious Triangles</guilabel>: Harmonious divisions rely on the principle of similarity. Like the Rule of Thirds guide, Harmonious Triangles are another division of the image using a rectangle into equiangular harmonious triangles aligned with the diagonal. + </para> + + <example> <title>Photograph Composition Example Using Harmonious Triangles</title> + <screenshot><screeninfo>Photograph Composition Example Using Harmonious Triangles" </screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorharmonioustrianglesexample.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + + </listitem> + + <listitem> + + <para> + <guilabel>Golden Mean</guilabel>: The Golden Mean is a ratio underlying numerous growth patterns throughout nature (from the spiral of a Nautilus shell to the petals of a sunflower), it has an uncanny way of showing up in all kinds of things we deem beautiful. + </para> + + <para> + The Golden Ratio is the irrational number 1.618033988..., and it is usage dates back to the ancient Egyptians and Greeks who used it in the construction of their temples and pyramids. Artists and architects throughout time have used the Golden Ratio when composing their paintings, buildings, and even photographs, in order to give their creations a sense of natural order and beauty. + </para> + + <para> + The ratio is inherent in the Fibonacci series: 1, 1, 2, 3, 5, 8, 13, 21, 34 &etc;., where each succeeding number after 1 is equal to the sum of the two preceding numbers. The ratio formed 1:1.618 is the Golden Mean. A composition following this rule is considered visually harmonious. + </para> + + <para> + The Golden Mean provides more fluid guidelines when used to compose an image. These guides are listed below: + + <itemizedlist> + + <listitem> + + <para> + The <guilabel>Golden Spiral</guilabel> guide will increase your odds of getting captivating results in your photographs. As opposed to Rule of Thirds, the Golden Spiral forms a fluid line for the eye to trace through the image. This style of composition will invite the viewer's gaze into the image along the line of the spiral, creating a more symmetrical visual flow, and an overall compelling viewing experience. + </para> + + <example> <title>Image Composition example using Golden Spiral</title> + <screenshot><screeninfo>Image Composition Example Using Golden Spiral </screeninfo><mediaobject><imageobject> <imagedata fileref="&path;editorgoldenspiralexample.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </listitem> + + <listitem> + + <para> + One more rule is a <guilabel>Golden Spiral Sections</guilabel> (or Golden Rectangles). These rectangles are used to build the Golden Spiral. There should be something leading the eye to the center of the composition. It could be a line or several subjects. This "something" could just be there without leading the eyes, but it would make its job. + </para> + + <example> <title>Image Composition example using Golden Spiral Sections</title> + <screenshot><screeninfo>Image Composition Example Using Golden Spiral Sections </screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorgoldenspiralsectionsexample.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </listitem> + + <listitem> + + <para> + The <guilabel>Golden Triangles</guilabel> is a derivative of the Golden Spiral discussed above. Its vertices are the midpoints of the sides of the Golden Rectangle. Note that unlike Harmonious Triangles, Golden Triangles aren't equiangular triangles. Placing diagonals along these lines can make an otherwise static subject appear more dynamic. + </para> + + <para> + When you use Golden Triangles to break up your frame, you're creating an effect professional photographic experts call Dynamic Symmetry. Try to keep your focal subject on one of the intersecting points, and place other visual information into the triangles you've already divided out. The result will be a very attractive composition you may not have otherwise attained. + </para> + + <example> <title>Photograph Composition Example Using Golden Triangle</title> + <screenshot><screeninfo>Photograph Composition Example Using Golden Triangles </screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorgoldentrianglesexample.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </listitem> + + <listitem> + + <para> + Like the Rule of Thirds the <guilabel>Golden Sections</guilabel> affects the ratio of a image size as well as the placement of the main subjects on the photo. This ratio is close to the 35mm ratio, so you don't need to change the size of the photo in most cases. But you need to consider the composition: the main subject should lie on one of the four lines or four intersections (subject's eye for example). Truthfully speaking, these rules are not the same. Rule of Thirds is a simplified version of the Golden Mean. + </para> + + <example> <title>Image Composition example using Golden Sections</title> + <screenshot><screeninfo>Photograph Composition Example Using Golden Sections </screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorgoldensectionsexample.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </listitem> + + </itemizedlist> + </para> + + </listitem> + + </itemizedlist> + + </para> + + <para> + The <guilabel>Flip Horizontal</guilabel> and <guilabel>Flip Vertical</guilabel> options can be used to apply flip transformation to the harmonious divisions. + </para> + + <para> + The <guilabel>Color</guilabel> button lets you set the guidelines color. If you have an high color contrast image, the guidelines may become invisible. By the way, you can adapt the color guide to the current image. + </para> + + </sect4> + +</sect3> + +<sect3 id="freerotation"> +<sect3info> + +<title>Free Rotation</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Free Rotation</emphasis> is a tool for image rotation by any arbitrary angle. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +When taking a image it is all too easy to hold the camera not quite perfectly vertical or horizontal, resulting in a image where things are tilted at an angle. The way to fix this with the &digikam; Image Editor is to use the Free Rotation tool. Select +<menuchoice><guimenu>Transform</guimenu> +<guimenuitem>Free Rotation</guimenuitem></menuchoice> and adjust to the target angle. +</para> + +<sect4 id="using-freerotation"> <title>Free Rotation Tool</title> + +<para> +Rotate your image by using the <guilabel>Angle</guilabel> slider (value in degrees). Press to <guilabel>Reset Values</guilabel> for reset the slider to zero. A rotating effect preview is available on the right side of the dialog. The new target image dimensions in pixels are shown. +</para> + +<para> +For better orientation, the Free Rotation tool provides a vertical and horizontal guide. Move the mouse cursor under image preview to display the dashed line guide. Move the cursor to an supposedly vertical or horizontal feature in the image like the sea or a building border +and press the left mouse button for freeze the dashed lines position. Now, adjust the angle accordinly with the guide. +</para> + +<warning><para> +After rorating the image, you often find that things are better but not quite perfect. One solution is to rotate a bit more, but there is a disadvantage to that approach. Each time you rotate an image, because the rotated pixels don't line up precisely with the original pixels, the image inevitably gets blurred a little bit. For a single rotation, the amount of blurring is quite small, but two rotations cause twice as much blurring as one, and there is no reason to blur things more than you have to. Sure, the guide tool available in the Free Rotation preview can help you to apply correctly at the first time an angle adjustment to an image. +</para></warning> + +</sect4> + +<sect4 id="inaction-freerotation"> +<title>Free Rotation action</title> + +<para> +The Free Rotation dialog tool in action is available below. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;freerotationpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Free Rotation Tool Dialog</phrase></textobject></inlinemediaobject> + </para> + +<para> +After you have rotated an image, there will be unpleasant triangular "holes" at the corners. +One way to fix them is to crop the image with <menuchoice><guimenu>Transform</guimenu> +<guimenuitem>Crop</guimenuitem></menuchoice> Image Editor menu. +</para> + +<para>A more elegant way to crop the rotated image is to use the <guilabel>Auto-crop</guilabel> function. Choose anyone of the following options from the combo-box to your preference:</para> + +<itemizedlist> + + <listitem><para><guilabel>Widest area</guilabel> This option crops the rotated image to the widest possible (width) rectangular section.</para></listitem> + + <listitem><para><guilabel>Largest area</guilabel> This options crops the rotated image to the biggest surface.</para></listitem> + +</itemizedlist> + +<para>Hold the mouse over the combo-box and scroll with the wheel between the two possibilities.</para> + +<para>The <guilabel>Anti-aliasing</guilabel> checkbox will smooth the image a bit after rotation. Please read the warning above. +</para> + +</sect4> + +</sect3> + +<sect3 id="perspective"> +<sect3info> + +<title>Perspective Adjustment</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Perspective Adjustment</emphasis> is a tool for adjusting the image's perspective. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +With this tool you can work on the the perspective in a photograph. This is very useful when working with photographs that contain keystone distortion. Keystone distortion occurs when an object is photographed from an angle rather than from a straight-on view. For example, if you take a image of a a tall building from ground level, the edges of the building appear to meet each other at the far end. +On the other hand you can use this tool to introduce a new perspective that is not a face-on view but to give the image a creative spin. +</para> + +<sect4 id="using-perspective"> +<title>Using the Perspective Adjustment</title> + +<para> +All perspective transformations are performed around a fixed point called the reference point. This point is at the center of the item you are transforming and is displayed by a red circle. +</para> + +<para> +To change the perspective, use the square areas at the image corners for dragging. The perspective preview is rendered automatically. On the right of the dialog you'll find a set of informations witch help you to control the perspective change: + +<itemizedlist> + <listitem><para><guilabel>New Width</guilabel>: show the new image width in pixels including the empty area around the image resulting from the geometrical transformation.</para></listitem> + <listitem><para><guilabel>New Height</guilabel>: show the new image height in pixels including the empty area around the image resulting from the geometrical transformation.</para></listitem> + <listitem><para><guilabel>Top Left Angle</guilabel>: show the current angle in degrees at the top left corner of the perspective area.</para></listitem> + <listitem><para><guilabel>Top Right Angle</guilabel>: show the current angle in degrees at the top right corner of the perspective area.</para></listitem> + <listitem><para><guilabel>Bottom Left Angle</guilabel>: show the current angle in degrees at the bottom left corner of the perspective area.</para></listitem> + <listitem><para><guilabel>Bottom Right Angle</guilabel>: show the current angle in degrees at the bottom right corner of the perspective area.</para></listitem> +</itemizedlist> +</para> + +<warning><para> +After applying the perspective adjustment, the image inevitably gets blurred a little bit. For a single adjustment, the amount of blurring is quite small, but two adjustments cause twice as much blurring as one, and there is no reason to blur things more than you have to. +</para></warning> + +<para> +After you have adjusted the perspective of an image there will be unpleasant triangular "holes" at the corners. +One way to fix them is to crop the image with <menuchoice><guimenu>Transform</guimenu> +<guimenuitem>Crop</guimenuitem></menuchoice> Image Editor menu. +</para> + +</sect4> + +<sect4 id="inaction-perspective"> +<title>The Perspective Adjustment in action</title> + +<para> +The Perspective Adjustment dialog in action is shown below. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;perspectivepreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Perspective Adjustment Dialog</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +<sect3 id="sheartool"> +<sect3info> + +<title>Shearing Image</title> + +<authorgroup> + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> +</authorgroup> + +<abstract> +<para> +The &digikam; <emphasis>Shearing Image</emphasis> is a tool for shearing an image horizontally +or vertically. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Digikam</keyword> +</keywordset> + +</sect3info> + +<title>Introduction</title> + +<para> +The Shear tool is used to shift one part of an image to one direction and the other part to the opposite direction. For instance, a horizontal shearing will shift the upper part to the right and the lower part to the left. This is not a rotation: the image is distorted. In other words, it will turn a rectangle into a parallelogram. This tool is available from <menuchoice><guimenu>Transform</guimenu><guimenuitem>Shear</guimenuitem></menuchoice> menu. +</para> + +<sect4 id="using-sheartool"> +<title>Using the Sheartool</title> + +<para> +Shear your image by using the <guilabel>Horizontal Angle</guilabel> and <guilabel>Vertical Angle</guilabel> sliders (values in degrees). You can shear along either Horizontally and vertically at the same time. Click on the <guilabel>Reset Values</guilabel> reset. A shearing effect preview is shown on the center of dialog window. The new target image dimensions in pixels are displayed at the right side of dialog. +</para> + +<para> +To assist you in aligning, the tool provides a vertical and horizontal guide. Move the mouse cursor under image preview for display the dashed lines guide. Move the cursor to an important place in the image like the sea or a building border and press the left mouse button for freeze the dashed lines position. Now, adjust the shear correction according with the guide. +</para> + +<warning><para> +After applying a shearing adjustment, the image inevitably gets blurred a little bit. For a single shearing, the amount of blurring is quite small, but two shears cause twice as much blurring as one, and there is no reason to blur things more than you have to. +</para></warning> + +<para> +After you have sheared an image, there will be unpleasant triangular "holes" at the corners. +One way to fix them is to crop the image with <menuchoice><guimenu>Transform</guimenu> +<guimenuitem>Crop</guimenuitem></menuchoice> Image Editor menu. +</para> + +</sect4> + +<sect4 id="inaction-sheartool"> +<title>The Sheartool in action</title> + +<para> +The Shear Tool dialog in action is available below. +</para> + + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;sheartoolpreview.png" format="PNG" /> </imageobject> + <textobject><phrase>The Shear Tool Dialog</phrase></textobject></inlinemediaobject> + </para> + +</sect4> + +</sect3> + +</sect2> diff --git a/doc/en/digikam/editorautolevels.png b/doc/en/digikam/editorautolevels.png Binary files differnew file mode 100644 index 00000000..c43d15f0 --- /dev/null +++ b/doc/en/digikam/editorautolevels.png diff --git a/doc/en/digikam/editorautosizebutton.png b/doc/en/digikam/editorautosizebutton.png Binary files differnew file mode 100644 index 00000000..b3e9139e --- /dev/null +++ b/doc/en/digikam/editorautosizebutton.png diff --git a/doc/en/digikam/editorbcgadjust.png b/doc/en/digikam/editorbcgadjust.png Binary files differnew file mode 100644 index 00000000..807c8f34 --- /dev/null +++ b/doc/en/digikam/editorbcgadjust.png diff --git a/doc/en/digikam/editorblurplugin.png b/doc/en/digikam/editorblurplugin.png Binary files differnew file mode 100644 index 00000000..d6a8072d --- /dev/null +++ b/doc/en/digikam/editorblurplugin.png diff --git a/doc/en/digikam/editorbwfilter.png b/doc/en/digikam/editorbwfilter.png Binary files differnew file mode 100644 index 00000000..fa26f6a9 --- /dev/null +++ b/doc/en/digikam/editorbwfilter.png diff --git a/doc/en/digikam/editorcolorbalance.png b/doc/en/digikam/editorcolorbalance.png Binary files differnew file mode 100644 index 00000000..8640ede2 --- /dev/null +++ b/doc/en/digikam/editorcolorbalance.png diff --git a/doc/en/digikam/editorcommondialogtools.png b/doc/en/digikam/editorcommondialogtools.png Binary files differnew file mode 100644 index 00000000..600bfb01 --- /dev/null +++ b/doc/en/digikam/editorcommondialogtools.png diff --git a/doc/en/digikam/editorconvert_brown.png b/doc/en/digikam/editorconvert_brown.png Binary files differnew file mode 100644 index 00000000..36c58533 --- /dev/null +++ b/doc/en/digikam/editorconvert_brown.png diff --git a/doc/en/digikam/editorconvert_bw.png b/doc/en/digikam/editorconvert_bw.png Binary files differnew file mode 100644 index 00000000..cb54fd1a --- /dev/null +++ b/doc/en/digikam/editorconvert_bw.png diff --git a/doc/en/digikam/editorconvert_bwgreen.png b/doc/en/digikam/editorconvert_bwgreen.png Binary files differnew file mode 100644 index 00000000..cc2739d0 --- /dev/null +++ b/doc/en/digikam/editorconvert_bwgreen.png diff --git a/doc/en/digikam/editorconvert_bworange.png b/doc/en/digikam/editorconvert_bworange.png Binary files differnew file mode 100644 index 00000000..924a04e5 --- /dev/null +++ b/doc/en/digikam/editorconvert_bworange.png diff --git a/doc/en/digikam/editorconvert_bwred.png b/doc/en/digikam/editorconvert_bwred.png Binary files differnew file mode 100644 index 00000000..35b82753 --- /dev/null +++ b/doc/en/digikam/editorconvert_bwred.png diff --git a/doc/en/digikam/editorconvert_bwyellow.png b/doc/en/digikam/editorconvert_bwyellow.png Binary files differnew file mode 100644 index 00000000..ee63bff2 --- /dev/null +++ b/doc/en/digikam/editorconvert_bwyellow.png diff --git a/doc/en/digikam/editorconvert_cold.png b/doc/en/digikam/editorconvert_cold.png Binary files differnew file mode 100644 index 00000000..376f052e --- /dev/null +++ b/doc/en/digikam/editorconvert_cold.png diff --git a/doc/en/digikam/editorconvert_original.png b/doc/en/digikam/editorconvert_original.png Binary files differnew file mode 100644 index 00000000..ed24a7bc --- /dev/null +++ b/doc/en/digikam/editorconvert_original.png diff --git a/doc/en/digikam/editorconvert_platinium.png b/doc/en/digikam/editorconvert_platinium.png Binary files differnew file mode 100644 index 00000000..a94a3801 --- /dev/null +++ b/doc/en/digikam/editorconvert_platinium.png diff --git a/doc/en/digikam/editorconvert_selenium.png b/doc/en/digikam/editorconvert_selenium.png Binary files differnew file mode 100644 index 00000000..791c5519 --- /dev/null +++ b/doc/en/digikam/editorconvert_selenium.png diff --git a/doc/en/digikam/editorconvert_sepia.png b/doc/en/digikam/editorconvert_sepia.png Binary files differnew file mode 100644 index 00000000..f7521b4b --- /dev/null +++ b/doc/en/digikam/editorconvert_sepia.png diff --git a/doc/en/digikam/editorcropbutton.png b/doc/en/digikam/editorcropbutton.png Binary files differnew file mode 100644 index 00000000..54cb8477 --- /dev/null +++ b/doc/en/digikam/editorcropbutton.png diff --git a/doc/en/digikam/editorequalize.png b/doc/en/digikam/editorequalize.png Binary files differnew file mode 100644 index 00000000..08ee2014 --- /dev/null +++ b/doc/en/digikam/editorequalize.png diff --git a/doc/en/digikam/editorgoldensectionsexample.png b/doc/en/digikam/editorgoldensectionsexample.png Binary files differnew file mode 100644 index 00000000..94dea2dc --- /dev/null +++ b/doc/en/digikam/editorgoldensectionsexample.png diff --git a/doc/en/digikam/editorgoldenspiralexample.png b/doc/en/digikam/editorgoldenspiralexample.png Binary files differnew file mode 100644 index 00000000..02930a27 --- /dev/null +++ b/doc/en/digikam/editorgoldenspiralexample.png diff --git a/doc/en/digikam/editorgoldenspiralsectionsexample.png b/doc/en/digikam/editorgoldenspiralsectionsexample.png Binary files differnew file mode 100644 index 00000000..d74c4ec8 --- /dev/null +++ b/doc/en/digikam/editorgoldenspiralsectionsexample.png diff --git a/doc/en/digikam/editorgoldentrianglesexample.png b/doc/en/digikam/editorgoldentrianglesexample.png Binary files differnew file mode 100644 index 00000000..6878c7e1 --- /dev/null +++ b/doc/en/digikam/editorgoldentrianglesexample.png diff --git a/doc/en/digikam/editorharmonioustrianglesexample.png b/doc/en/digikam/editorharmonioustrianglesexample.png Binary files differnew file mode 100644 index 00000000..98e1568a --- /dev/null +++ b/doc/en/digikam/editorharmonioustrianglesexample.png diff --git a/doc/en/digikam/editorhistogramdescription.png b/doc/en/digikam/editorhistogramdescription.png Binary files differnew file mode 100644 index 00000000..39ce47de --- /dev/null +++ b/doc/en/digikam/editorhistogramdescription.png diff --git a/doc/en/digikam/editorhistogramsample1.png b/doc/en/digikam/editorhistogramsample1.png Binary files differnew file mode 100644 index 00000000..0a739c68 --- /dev/null +++ b/doc/en/digikam/editorhistogramsample1.png diff --git a/doc/en/digikam/editorhistogramsample2.png b/doc/en/digikam/editorhistogramsample2.png Binary files differnew file mode 100644 index 00000000..bd3fd917 --- /dev/null +++ b/doc/en/digikam/editorhistogramsample2.png diff --git a/doc/en/digikam/editorhistogramsample3.png b/doc/en/digikam/editorhistogramsample3.png Binary files differnew file mode 100644 index 00000000..7595dfe0 --- /dev/null +++ b/doc/en/digikam/editorhistogramsample3.png diff --git a/doc/en/digikam/editorhsladjust.png b/doc/en/digikam/editorhsladjust.png Binary files differnew file mode 100644 index 00000000..39dce4d9 --- /dev/null +++ b/doc/en/digikam/editorhsladjust.png diff --git a/doc/en/digikam/editoriccprofile.png b/doc/en/digikam/editoriccprofile.png Binary files differnew file mode 100644 index 00000000..1904227e --- /dev/null +++ b/doc/en/digikam/editoriccprofile.png diff --git a/doc/en/digikam/editorimageselection.png b/doc/en/digikam/editorimageselection.png Binary files differnew file mode 100644 index 00000000..377dc53d --- /dev/null +++ b/doc/en/digikam/editorimageselection.png diff --git a/doc/en/digikam/editorneon.png b/doc/en/digikam/editorneon.png Binary files differnew file mode 100644 index 00000000..af2f88f5 --- /dev/null +++ b/doc/en/digikam/editorneon.png diff --git a/doc/en/digikam/editornoisereductionplugin.png b/doc/en/digikam/editornoisereductionplugin.png Binary files differnew file mode 100644 index 00000000..d672cc43 --- /dev/null +++ b/doc/en/digikam/editornoisereductionplugin.png diff --git a/doc/en/digikam/editornormalize.png b/doc/en/digikam/editornormalize.png Binary files differnew file mode 100644 index 00000000..33265297 --- /dev/null +++ b/doc/en/digikam/editornormalize.png diff --git a/doc/en/digikam/editorpreview.png b/doc/en/digikam/editorpreview.png Binary files differnew file mode 100644 index 00000000..95fa65f5 --- /dev/null +++ b/doc/en/digikam/editorpreview.png diff --git a/doc/en/digikam/editorraindropsplugin.png b/doc/en/digikam/editorraindropsplugin.png Binary files differnew file mode 100644 index 00000000..fdfb939e --- /dev/null +++ b/doc/en/digikam/editorraindropsplugin.png diff --git a/doc/en/digikam/editorratiocroptool.png b/doc/en/digikam/editorratiocroptool.png Binary files differnew file mode 100644 index 00000000..f72e4d70 --- /dev/null +++ b/doc/en/digikam/editorratiocroptool.png diff --git a/doc/en/digikam/editorresizetool.png b/doc/en/digikam/editorresizetool.png Binary files differnew file mode 100644 index 00000000..694fd70f --- /dev/null +++ b/doc/en/digikam/editorresizetool.png diff --git a/doc/en/digikam/editorrevertbutton.png b/doc/en/digikam/editorrevertbutton.png Binary files differnew file mode 100644 index 00000000..d8313f87 --- /dev/null +++ b/doc/en/digikam/editorrevertbutton.png diff --git a/doc/en/digikam/editorrulethirdlinesexample.png b/doc/en/digikam/editorrulethirdlinesexample.png Binary files differnew file mode 100644 index 00000000..4c3ecb34 --- /dev/null +++ b/doc/en/digikam/editorrulethirdlinesexample.png diff --git a/doc/en/digikam/editorsharpenplugin.png b/doc/en/digikam/editorsharpenplugin.png Binary files differnew file mode 100644 index 00000000..987c7eb0 --- /dev/null +++ b/doc/en/digikam/editorsharpenplugin.png diff --git a/doc/en/digikam/editorstretchcontrast.png b/doc/en/digikam/editorstretchcontrast.png Binary files differnew file mode 100644 index 00000000..8602ca8e --- /dev/null +++ b/doc/en/digikam/editorstretchcontrast.png diff --git a/doc/en/digikam/editortoolbar.png b/doc/en/digikam/editortoolbar.png Binary files differnew file mode 100644 index 00000000..350dd855 --- /dev/null +++ b/doc/en/digikam/editortoolbar.png diff --git a/doc/en/digikam/editorunsharpedmaskplugin.png b/doc/en/digikam/editorunsharpedmaskplugin.png Binary files differnew file mode 100644 index 00000000..416817ba --- /dev/null +++ b/doc/en/digikam/editorunsharpedmaskplugin.png diff --git a/doc/en/digikam/editorvivid.png b/doc/en/digikam/editorvivid.png Binary files differnew file mode 100644 index 00000000..65b10944 --- /dev/null +++ b/doc/en/digikam/editorvivid.png diff --git a/doc/en/digikam/editorzoombuttons.png b/doc/en/digikam/editorzoombuttons.png Binary files differnew file mode 100644 index 00000000..60084fc6 --- /dev/null +++ b/doc/en/digikam/editorzoombuttons.png diff --git a/doc/en/digikam/embosspreview.png b/doc/en/digikam/embosspreview.png Binary files differnew file mode 100644 index 00000000..c12b215b --- /dev/null +++ b/doc/en/digikam/embosspreview.png diff --git a/doc/en/digikam/file-formats.docbook b/doc/en/digikam/file-formats.docbook new file mode 100644 index 00000000..ec21c2ef --- /dev/null +++ b/doc/en/digikam/file-formats.docbook @@ -0,0 +1,226 @@ + <sect1 id="using-fileformatsupport"> <title>Supported File Formats</title> + + <para> + &digikam; relies on a number of libraries and support packages to load and save image formats. Which image formats are available will depend on the availability of these libraries on your system and, in some cases, on the way that those libraries have been compiled. On most distributions you will find that a wide range of image formats are viewable within &digikam;. + </para> + + <para> + This dependence on other libraries means that it is not possible to give a definitive list of all of the formats that will be available on your system. At the very least JPEG, PNG, and TIFF should be available. + </para> + + <para> + &digikam; only displays files that are in formats that it understands. It does this by looking at the file extension on the files and checking this against a predefined list. If the file extension is in the list &digikam; will show the file in the Image View. You can change the list of file extensions that &digikam; will accept, see the <link linkend="using-setup">Configuration</link> section for more details. + </para> + + <sect2> <title>Still Photograph Formats</title> + + <sect3> <title>Introduction</title> + + <para> + Almost all digital cameras store photographs in one of two formats: JPEG or TIFF. Many cameras enable you to select which of these formats to use. A full description of these formats can be found at the <ulink url="http://en.wikipedia.org/wiki/Graphics_file_format">Wikipedia</ulink>. &digikam; supports both of these formats. + </para> + + </sect3> + + <sect3> <title>Still Image Compression</title> + + <para> + Image compression is the application of data compression schemes on digital images. It is done through reducing redundancy of the image data in order to be able to store or transmit data in an efficient form. + </para> + + <para> + Image compression can be lossy or lossless. Lossless compression methods are always preferred for their high preservation value for archival purposes before applying transformations like cropping, resizing, color corrections, &etc;. This is because lossy compression methods, especially when used at low bit rates, introduce compression artifacts. Lossy methods are suitable for natural images such as photos in applications where minor (sometimes imperceptible) loss of fidelity is acceptable to achieve a substantial reduction in file size. Lossy compression is good for image publishing on the Internet. + </para> + + </sect3> + + <sect3> <title>JPEG</title> + <para> + JPEG is a compressed format, that trades some of the image quality to keep file sizes small. In fact, most cameras save their images in this format unless you specify otherwise. A JPEG image is stored using lossy compression and you can vary the amount of compression. This allows you to choose between lower compression and higher image quality or greater compression and poorer quality. The only reason to choose higher compression is because it creates smaller file so you can store more images, and it's easier to send them by e-mail, or post them on the Web. Most cameras give you two or three choices equivalent to good, better, best although the names vary. + </para> + <para> + JPEG 2000 is supported as well. It provides for the same compression ratio the better (smoother) results compared to JPEG. The 2000 version has the option of being lossless if so specified in the settings. + </para> + + </sect3> + + <sect3> <title>TIFF</title> + <para> + TIFF has been widely accepted and widely supported as an image format. Commonly, TIFF may be stored by the camera in uncompressed form or using lossless compression algorithm (Deflate). It maintains higher image quality but at the expense of much larger file sizes. Some cameras let you save your images in this format and it is a popular format because of its lossless compression algorithm. The problem is that the format has been altered by so many people that there are now 50 or more flavors and not all are recognizable by programs. + </para> + + </sect3> + + <sect3> <title>PNG</title> + <para> + PNG is an image format that was developed as a replacement for a number of older, in the 1990's widely used, image file formats. It is a lossless format like TIFF but it is much more compact and saves disk space. Although your camera is unlikely to support PNG, some people like to convert their photographs to PNG as soon as they get them on their computer. Unlike JPEG, PNG images do not lose quality every time you re-encode them after modification. &digikam; fully supports PNG images and the Batch Processing Images Plugin can convert a batch of images from any supported format to PNG in one step. See the <link linkend="using-setup">Configuration</link> section for information about using plugins with &digikam;. + </para> + + <para> + PNG is an extensible file format for the lossless, portable, well-compressed storage of raster images. PNG provides a patent-free replacement for &GIF; and can also replace many common uses of TIFF. PNG is designed to work well in on-line viewing applications, such as the World Wide Web, so it is fully streamable with a progressive display option. Also, PNG can store gamma and chromaticity data for improved color matching on heterogeneous platforms. PNG supports 8 and 16 bits / colors /pixels depth. It's the perfect file format to archive your photographs. For more information about the PNG format see the <ulink url="http://www.libpng.org/pub/png/">PNG homepage</ulink>. + </para> + + </sect3> + + <sect3> <title>RAW</title> + + <para> + Some, typically more expensive, cameras allow you to store images in RAW format. RAW format is not really an image standard at all. It is different for every make of camera. RAW format images contain all the data that is taken directly from the camera's image sensor before the software in the camera applies things like white balance, sharpening &etc;. Storing photographs in a camera's RAW format allows you to alter settings, such as white balance, after the photograph has been taken. Most professional photographers use RAW format, because it offers them maximum flexibility. The downside is that RAW image files can be very large indeed. + </para> + + <para> + If you want to learn more about RAW image format visit the very helpful guides<ulink url="http://en.wikipedia.org/wiki/RAW_image_format"> Wikipedia,</ulink> <ulink url="http://www.luminous-landscape.com/tutorials/understanding-series/u-raw-files.shtml"> The Luminous Landscape,</ulink> and <ulink url="http://www.cambridgeincolour.com/tutorials/RAW-file-format.htm"> Cambridge in Colour</ulink>. You can convert RAW format images into JPEG or TIFF in &digikam; using the <ulink url="help:/kipi-plugins/rawconverter.html">RAW Image Converter plugin</ulink>. See the <link linkend="using-setup">Configuration</link> section for information about using plugins with &digikam;. + </para> + + <para> + &digikam; supports RAW image loading only; relying on the <ulink url="http://www.cybercom.net/~dcoffin/dcraw"> DCRAW program</ulink> which is included in &digikam; core and supports over 200 RAW file formats. All supported cameras are listed at the bottom of <ulink url="http://www.cybercom.net/~dcoffin/dcraw"> Dave Coffin's</ulink> web page. The table below shows a short list of camera RAW files supported by &digikam;: + + <informaltable><tgroup cols="2"> + + <thead><row> + <entry>RAW File Format</entry> + <entry>Description</entry> + </row></thead> + <tbody> + <row><entry> + CRW, CR2 + </entry><entry> + Canon digital camera RAW file formats + </entry></row> + + <!-- ************************ --> + <row><entry> + NEF + </entry><entry> + Nikon digital camera RAW file format + </entry></row> + + <!-- ************************ --> + + <row><entry> + ORF + </entry><entry> + Olympus digital camera RAW file format + </entry></row> + + <!-- ************************ --> + + <row><entry> + RAF + </entry><entry> + Fuji digital camera RAW file format + </entry></row> + + <!-- ************************ --> + + <row><entry> + PEF, PTX + </entry><entry> + Pentax digital camera RAW file format + </entry></row> + + <!-- ************************ --> + + <row><entry> + X3F + </entry><entry> + Sigma digital camera RAW file format + </entry></row> + + <!-- ************************ --> + + <row><entry> + DCR, KDC, DC2, K25 + </entry><entry> + Kodak digital camera RAW file format + </entry></row> + + <!-- ************************ --> + + <row><entry> + SRF, ARW, MRW, MDC + </entry><entry> + Sony/Minolta digital camera RAW file format + </entry></row> + + <!-- ************************ --> + + <row><entry> + RAW + </entry><entry> + Panasonic, Casio, Leica digital camera RAW file format + </entry></row> + + <!-- ************************ --> + + <row><entry> + DNG (CS1, HDR) + </entry><entry> + Adobe RAW file format (Digital Negative) + </entry></row> + + <!-- ************************ --> + + <row><entry> + BAY + </entry><entry> + Casio RAW (Bayer) + </entry></row> + + <!-- ************************ --> + + <row><entry> + ERF + </entry><entry> + Epson digital camera RAW file format + </entry></row> + + <!-- ************************ --> + + <row><entry> + FFF + </entry><entry> + Imacon/Hasselblad RAW format + </entry></row> + + <!-- ************************ --> + + <row><entry> + MOS + </entry><entry> + CREO Photo RAW + </entry></row> + + <!-- ************************ --> + <row><entry> + PXN + </entry><entry> + Fotoman RAW + </entry></row> + + <!-- ************************ --> + <row><entry> + RDC + </entry><entry> + Ricoh RAW format + </entry></row> + + + </tbody> + + </tgroup></informaltable> + + </para> + + </sect3> + + </sect2> + + <sect2> <title>Moving Image Formats (Videos)</title> + + <para> + Many digital cameras support taking of short movie clips. These clips are usually stored in AVI or MPEG format. &digikam; understands these formats and will generate thumbnails for the movie files. However, &digikam; is not a movie editing application and it does not have any built-in movie viewing or editing capabilities. If you double click on a movie file &digikam; will use your &kde; settings to choose a viewing application to use. + </para> + </sect2> + + </sect1> diff --git a/doc/en/digikam/filmgrainpreview.png b/doc/en/digikam/filmgrainpreview.png Binary files differnew file mode 100644 index 00000000..ce37551b --- /dev/null +++ b/doc/en/digikam/filmgrainpreview.png diff --git a/doc/en/digikam/freerotationpreview.png b/doc/en/digikam/freerotationpreview.png Binary files differnew file mode 100644 index 00000000..e756924b --- /dev/null +++ b/doc/en/digikam/freerotationpreview.png diff --git a/doc/en/digikam/handheld_gps.png b/doc/en/digikam/handheld_gps.png Binary files differnew file mode 100644 index 00000000..5cd8069e --- /dev/null +++ b/doc/en/digikam/handheld_gps.png diff --git a/doc/en/digikam/hotpixelsdialog.png b/doc/en/digikam/hotpixelsdialog.png Binary files differnew file mode 100644 index 00000000..1dadcd62 --- /dev/null +++ b/doc/en/digikam/hotpixelsdialog.png diff --git a/doc/en/digikam/hotpixelspreview.png b/doc/en/digikam/hotpixelspreview.png Binary files differnew file mode 100644 index 00000000..c2aa9040 --- /dev/null +++ b/doc/en/digikam/hotpixelspreview.png diff --git a/doc/en/digikam/ie-menu.docbook b/doc/en/digikam/ie-menu.docbook new file mode 100644 index 00000000..b1d1b8dd --- /dev/null +++ b/doc/en/digikam/ie-menu.docbook @@ -0,0 +1,732 @@ +<sect1 id="image-editor-menu"> <title>The Image Editor</title> + + <sect2> <title>The File Menu</title> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="press"><keycap>PgUp</keycap></keycombo> </shortcut> + <guimenu>File</guimenu><guimenuitem>Back</guimenuitem> + </menuchoice></term> + <listitem><para><action>Display the previous image of the current Album.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="press"><keycap>PgDown</keycap></keycombo> </shortcut> + <guimenu>File</guimenu><guimenuitem>Forward</guimenuitem> + </menuchoice></term> + <listitem><para><action>Display the next image of the current Album.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>Home</keycap></keycombo> </shortcut> + <guimenu>File</guimenu><guimenuitem>First</guimenuitem> + </menuchoice></term> + <listitem><para><action>Display the first image of current Album.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>End</keycap></keycombo> </shortcut> + <guimenu>File</guimenu><guimenuitem>Last</guimenuitem> + </menuchoice></term> + <listitem><para><action>Display the last image of current Album.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>S</keycap></keycombo> </shortcut> + <guimenu>File</guimenu><guimenuitem>Save</guimenuitem> + </menuchoice></term> + <listitem><para><action>Save the current image if it has been modified.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>File</guimenu><guimenuitem>Save As</guimenuitem> + </menuchoice></term> + <listitem><para><action>Save the current image in a new file.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>File</guimenu><guimenuitem>Revert</guimenuitem> + </menuchoice></term> + <listitem><para><action>Restore the current image from the original file if it has been modified.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo><keycap>&Shift;</keycap><keycap>Del</keycap></keycombo> </shortcut> + <guimenu>File</guimenu><guimenuitem>Delete File/Move to trash</guimenuitem> + </menuchoice></term> + <listitem><para><action>Delete/Move to trash the current image from the current + Album.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>P</keycap></keycombo> </shortcut> + <guimenu>File</guimenu><guimenuitem>Print Image</guimenuitem> + </menuchoice></term> + <listitem><para><action>Print the current image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo ><keycap>&Ctrl;</keycap><keycap>Q</keycap></keycombo> </shortcut> + <guimenu>File</guimenu><guimenuitem>Quit</guimenuitem> + </menuchoice></term> + <listitem><para><action>Quit &digikam; Image Editor.</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Edit Menu</title> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>C</keycap></keycombo> </shortcut> + <guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem> + </menuchoice></term> + <listitem><para><action>Copy the current image selection in the clipboard.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>Z</keycap></keycombo> </shortcut> + <guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem> + </menuchoice></term> + <listitem><para><action>Cancel the last action applied to the current image using history.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>Z</keycap></keycombo> </shortcut> + <guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem> + </menuchoice></term> + <listitem><para><action>Redo the last action applied to the current image using history.</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Color Menu</title> + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>B</keycap></keycombo> </shortcut> + <guimenu>Color</guimenu><guimenuitem>Auto-Correction</guimenuitem> + </menuchoice></term> + <listitem><para><action>Automatic color/exposure correction of the current image by an histogram manipulation <link linkend="autocolorcorrectiontool.anchor">(help)</link>.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Color</guimenu><guimenuitem>White Balance</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor tool to adjust white color balance on the current image <link linkend="using-whitebalance">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Color</guimenu> + <guimenuitem>Brightness/Contrast/Gamma</guimenuitem> + </menuchoice></term> + <listitem><para><action>Exposure correction of the current image by Brightness, Contrast, or Gamma + adjustments <link linkend="bcgadjusttool.anchor">(help)</link>.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>U</keycap></keycombo> </shortcut> + <guimenu>Color</guimenu> + <guimenuitem>Hue/Saturation/Lightness</guimenuitem> + </menuchoice></term> + <listitem><para><action>Color correction of the current image by Hue, Saturation, or Lightness + adjustments<link linkend="colorbalancetool.anchor">(help)</link>.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Color</guimenu><guimenuitem>Color Effects</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Set of four Image Editor tools: Solarize, Vivid (Velvia), Neon and Edge <link linkend="coloreffects">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>B</keycap></keycombo> </shortcut> + <guimenu>Color</guimenu><guimenuitem>Color Balance</guimenuitem> + </menuchoice></term> + <listitem><para><action>Color correction of the current image by Red, Green, or Blue + adjustments <link linkend="colorbalancetool.anchor">(help)</link></action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Enhance</guimenu><guimenuitem>Curves Adjust</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor plugin to adjust curves manually on the current image <link linkend="adjustcurves">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Color</guimenu><guimenuitem>Levels Adjust</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor plugin to adjust levels manually on the current image <link linkend="adjustlevels">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Color</guimenu><guimenuitem>Channel Mixer</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + <link linkend="using-channelmixer">Image Editor tool </link>to mix color channels on the current image. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>I</keycap></keycombo> </shortcut> + <guimenu>Color</guimenu><guimenuitem>Invert</guimenuitem> + </menuchoice></term> + <listitem><para><action>Invert image colors.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Filter</guimenu><guimenuitem>Black & White</guimenuitem> + </menuchoice></term> + <listitem><para><action>Open the <link linkend="blackandwhite-conversion">Black & White </link>filter dialog for the current image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Color</guimenu><guimenuitem>Color Management</guimenuitem> + </menuchoice></term> + <listitem><para><action>Invokes the interactive <link linkend="using-iccprofile">Color Management</link> editor.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Color</guimenu><guimenuitem>Depth</guimenuitem> + </menuchoice></term> + <listitem><para><action>Toggle between 8 bit and 16 bit format on color channels.</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Enhance Menu</title> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <guimenu>Enhance</guimenu><guimenuitem>Sharpen</guimenuitem> + </menuchoice></term> + <listitem><para><action>Classical image sharping operation <link linkend="sharpening">(help)</link>.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Enhance</guimenu><guimenuitem>Blur</guimenuitem> + </menuchoice></term> + <listitem><para><action>Image softening operation by blurring <link linkend="using-blurfilter">(help)</link>.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Enhance</guimenu><guimenuitem>Red Eye Reduction</guimenuitem> + </menuchoice></term> + <listitem><para><action>Red Eye correction tool using the current selection <link linkend="redeyecorrectiontool.anchor">(help)</link>.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Enhance</guimenu><guimenuitem>Inpainting</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor tool to remove unwanted areas and specs <link linkend="inpainting">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Enhance</guimenu><guimenuitem>Noise Reduction</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor tool to reduce the noise with a Despeckle filter <link linkend="noisereduction">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Enhance</guimenu><guimenuitem>Restoration</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor tool to reduce artifacts on the current image <link linkend="restoration">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Enhance</guimenu><guimenuitem>Hot Pixels Correction</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor tool to remove hot pixels on the current image <link linkend="hotpixels">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Enhance</guimenu><guimenuitem>Anti Vignetting</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor plugin to correct vignetting of the current image <link linkend="antivignetting">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Enhance</guimenu><guimenuitem>Lens Distortion Correction</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor plugin to correct lens distortion of the current image <link linkend="lensdistortion.anchor">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Transform Menu</title> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>Left</keycap></keycombo> </shortcut> + <guimenu>Transform</guimenu><guimenuitem>Rotate</guimenuitem><guimenuitem>-90 + degrees</guimenuitem> + </menuchoice></term> + <listitem><para><action>Left rotation of the current image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>Right</keycap></keycombo> </shortcut> + <guimenu>Transform</guimenu><guimenuitem>Rotate</guimenuitem><guimenuitem>90 + degrees</guimenuitem> + </menuchoice></term> + <listitem><para><action>90 degrees rotation of the current image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Transform</guimenu><guimenuitem>Free Rotation</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor plugin to rotate the current image by any angle in degrees <link linkend="freerotation">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>*</keycap></keycombo> </shortcut> + <guimenu>Transform</guimenu><guimenuitem>Flip</guimenuitem><guimenuitem>Horizontally</guimenuitem> + </menuchoice></term> + <listitem><para><action>Horizontal flip of the current image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>/</keycap></keycombo> </shortcut> + <guimenu>Transform</guimenu><guimenuitem>Flip</guimenuitem><guimenuitem>Vertically</guimenuitem> + </menuchoice></term> + <listitem><para><action>Vertical flip of the current image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>X</keycap></keycombo> </shortcut> + <guimenu>Transform</guimenu><guimenuitem>Crop</guimenuitem> + </menuchoice></term> + <listitem><para><action>Crop image to the current selection.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Transform</guimenu><guimenuitem>Resize</guimenuitem> + </menuchoice></term> + <listitem><para><action>Resize (reduce or blow-up) the current image to the appropriate factor or dimensions <link linkend="resize">(help)</link>.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Transform</guimenu><guimenuitem>Aspect Ratio Crop</guimenuitem> + </menuchoice></term> + <listitem><para><action>Crop the current image using an constrained aspect ratio <link linkend="aspect-ratio-crop">(help)</link>.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Transform</guimenu><guimenuitem>Shear</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor plugin to shear the current image horizontally or vertically <link linkend="sheartool">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Transform</guimenu><guimenuitem>Perspective Adjustment</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor plugin to adjust perspective of the current image <link linkend="perspective">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Decoration Menu</title> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <guimenu>Decoration</guimenu><guimenuitem>Apply Texture</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor tool to apply decorative texture to the current image. + </action></para> + <para> + See the dedicated <link linkend="using-texture">Apply Texture manual</link> for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Decoration</guimenu><guimenuitem>Add Border</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor plugin to add a decorative border around the current image <link linkend="border">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Decoration</guimenu><guimenuitem>Insert Text</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor plugin to insert text in the current image <link linkend="inserttext">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Decoration</guimenu><guimenuitem>Template Superimpose</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor plugin for apply a template to the current image <link linkend="superimpose">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- ********************************************************************** --> + + <sect2> <title>The View Menu</title> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>+</keycap></keycombo> </shortcut> + <guimenu>View</guimenu><guimenuitem>Zoom In</guimenuitem> + </menuchoice></term> + <listitem><para><action>Increase the zoom factor on the current image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>-</keycap></keycombo> </shortcut> + <guimenu>View</guimenu><guimenuitem>Zoom Out</guimenuitem> + </menuchoice></term> + <listitem><para><action>Decrease the zoom factor on the current image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>A</keycap></keycombo> </shortcut> + <guimenu>View</guimenu><guimenuitem>Fit to Window</guimenuitem> + </menuchoice></term> + <listitem><para><action>Toggle between fit-to-window zoom or 100% image zoom size.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>S</keycap></keycombo> </shortcut> + <guimenu>View</guimenu><guimenuitem>Fit to Selection</guimenuitem> + </menuchoice></term> + <listitem><para><action>Make the selection fit the window.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>View</guimenu><guimenuitem>Histogram</guimenuitem> + </menuchoice></term> + <listitem><para><action>Display superposed histogram on current image (Luminosity, Red, Green, Blue, Alpha).</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>View</guimenu><guimenuitem>Slideshow</guimenuitem> + </menuchoice></term> + <listitem><para><action>Start a slideshow of the current album.</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2 id="filters-menu"> <title>The Filter Menu</title> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <guimenu>Filter</guimenu><guimenuitem>Infrared Film</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor filter to simulate infrared film <link linkend="infrared">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Filter</guimenu><guimenuitem>Add Film Grain</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor filter for to adding Film Grain <link linkend="filmgrain">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Filter</guimenu><guimenuitem>Oil paint</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor filter to simulate Oil Painting <link linkend="oilpaint">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Filter</guimenu><guimenuitem>Charcoal Drawing</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor filter to simulate Charcoal Drawing <link linkend="charcoal">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Filter</guimenu><guimenuitem>Emboss</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor Emboss filter <link linkend="emboss">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Filter</guimenu><guimenuitem>Distortion Effects</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor filter set with distortion special effects <link linkend="distortionfx">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Filter</guimenu><guimenuitem>Blur Effects</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor filter set with blurring special effects on <link linkend="blurfx">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Filter</guimenu><guimenuitem>Raindrops</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Image Editor filter to add Rain Drops <link linkend="raindrops">(help)</link>. + </action></para> + </listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Settings Menu</title> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>F</keycap></keycombo> + </shortcut> + <guimenu>Settings</guimenu><guimenuitem>Full Screen Mode</guimenuitem> + </menuchoice></term> + <listitem><para><action>Toggles the graphic interface to full screen mode.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts</guimenuitem> + </menuchoice></term> + <listitem><para><action>Configure the &digikam; image editor shortcuts.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Settings</guimenu><guimenuitem>Configure Toolbars</guimenuitem> + </menuchoice></term> + <listitem><para><action>Configure the &digikam; image editor toolbars.</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Help Menu</title> + &help.menu.documentation; + + <para>Additionally &digikam; Image Editor offers this item:</para> + + <variablelist> + + <varlistentry> + <term><menuchoice> + <guimenu>Help</guimenu><guimenuitem>ImagePlugins' Handbooks</guimenuitem> + </menuchoice></term> + <listitem><para>Launch the &kde; help interface with the &digikam; Image Editor + plugins handbooks.</para></listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> diff --git a/doc/en/digikam/index.docbook b/doc/en/digikam/index.docbook new file mode 100644 index 00000000..5f2c7bb0 --- /dev/null +++ b/doc/en/digikam/index.docbook @@ -0,0 +1,2615 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kappname "&digikam;"><!-- replace kapp here, do *not* replace kappname--> + <!ENTITY package "extragear-graphics"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE"><!-- change language only here --> + <!ENTITY digikam '<application>digiKam</application>'> +<!-- relative path to snapshots for digikam and showfoto --> + <!ENTITY path ""> + <!ENTITY doc-file-formats SYSTEM "file-formats.docbook"> + <!ENTITY doc-sidebar SYSTEM "sidebar.docbook"> +<!-- image editor --> + <!ENTITY doc-photo-editing SYSTEM "photo-editing.docbook"> + <!ENTITY doc-editor-color SYSTEM "editor-color.docbook"> + <!ENTITY doc-editor-enhance SYSTEM "editor-enhance.docbook"> + <!ENTITY doc-editor-transform SYSTEM "editor-transform.docbook"> + <!ENTITY doc-editor-filters SYSTEM "editor-filters.docbook"> + <!ENTITY doc-editor-decorate SYSTEM "editor-decorate.docbook"> +<!-- menus --> + <!ENTITY doc-menu-descriptions SYSTEM "menu-descriptions.docbook"> + <!ENTITY doc-ie-menu SYSTEM "ie-menu.docbook"> + <!ENTITY doc-credits-annexes SYSTEM "credits-annex.docbook"> +]> + +<book lang="&language;"> + +<bookinfo> + +<title>The &digikam; Handbook</title> + +<authorgroup> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation> + </author> + + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Richard</firstname><surname>Taylor</surname> + <affiliation><address><email>rjt-digicam_at_thegrindstone_dot_me_dot_uk</email></address></affiliation> + </author> + + <author> + <firstname>Ralf</firstname><surname>Hoelzer</surname> + <affiliation><address><email>kde_at_ralfhoelzer.com</email></address></affiliation> + </author> + + <author> + <firstname>Joern</firstname><surname>Ahrens</surname> + <affiliation><address><email>joern.ahrens_at_kdemail_dot_net</email></address></affiliation> + </author> + + <author> + <firstname>Oliver</firstname><surname>Doerr</surname> + <affiliation><address><email>oliver_at_doerr-privat.de</email></address></affiliation> + </author> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + + + +<copyright> + <year>2001</year> + <year>2008</year> + <holder>The &digikam; developers team</holder> +</copyright> + +<!-- Translators: put here the copyright notice of the translation --> +<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook + and in the FDL itself on how to use it. --> +<legalnotice>&FDLNotice;</legalnotice> + +<date>2008-01-30</date> +<releaseinfo>0.9.3</releaseinfo> + +<abstract> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;digikamlogo.png" format="PNG"/></imageobject> + <textobject> <phrase>&digikam; logo</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + &digikam; is a &kde; Photo Management Application with support for Digital Cameras. + </para> + +</abstract> + +<keywordset> + <keyword>KDE</keyword> + <keyword>Digital Camera</keyword> + <keyword>digiKam</keyword> + <keyword>gphoto</keyword> + <keyword>Graphics</keyword> + <keyword>Color Management</keyword> + <keyword>exiv2</keyword> + <keyword>dcraw</keyword> + <keyword>RAW format</keyword> +</keywordset> + +</bookinfo> + +<!-- *********************************************************************** --> + +<chapter id="introduction"> <title>Introduction</title> + + <sect1 id="using-background"> <title>Background</title> + + <sect2 id="using-about"> + <title>About &digikam;</title> + + <para> + &digikam; is an advanced digital photo management application for the &kde; desktop. It provides a simple interface which makes importing and organizing digital photographs a "snap". &digikam; enables you to manage large numbers of digital photographs in Albums and to organize these photographs for easy retrieval using tags, captions, collections, dates and searches. It has many features for viewing, organizing, processing and sharing your images. + </para> + + <para> + An easy-to-use Camera interface is provided, that will connect to your digital camera and download photographs directly into &digikam; Albums. More than <ulink url="http://www.gphoto.org/proj/libgphoto2/support.php">900 digital cameras</ulink> are supported by the gphoto2 library. Of course, any media or card reader supported by your operating system will interface with &digikam;. + </para> + + <para>&digikam; incorporates a fast Image Editor with many image editing tools. You can use the Image Editor to view your photographs, comment and rate them, correct, enhance and alter them. The editing power can be easily extended by a set of plugins, the <ulink url="http://www.kipi-plugins.org">Kde Image Plugins Interface</ulink> (<ulink url="help:/kipi-plugins/index.html">manual</ulink>) + </para> + + <para>While &digikam; remains easy to use, it provides professional level features by the dozens. It is fully 16 bit enabled including all available plugins, supports RAW format conversion through David Coffins dcraw and ICC color management <link linkend="rawprocessing.anchor">work flow</link>. + </para> + + </sect2> + + <sect2> + <title>Reporting Bugs</title> + + <para> + Like the rest of &kde;, &digikam; is an Open Source project. This means that it relies on its users to play their part by, at least, reporting problems and suggesting possible improvements. + </para> + + <para> + &digikam; makes it as easy as possible for you to report bugs or suggest improvements. Wherever you are in the application the Help menu will include a Report Bugs option. This will display a message box with a highlighted link. Click on the link and your web browser will open the page for the reporting system. All the information required will already be filled in, just follow the instructions for completing your report. + </para> + </sect2> + + <sect2> + <title>Support</title> + + <para> + &digikam; is a community supported project, which means that users and developers support one another. If you become a regular user of &digikam; you are encouraged to join the &digikam; Users Mailing List. You can start off by asking questions of other &digikam; users and hopefully soon you will be answering the support questions of others. + </para> + + <para> + <ulink url="https://mail.kde.org/mailman/listinfo/digikam-users">&digikam; Users Mailing + List joining instructions.</ulink> + </para> + + <para> + You can also visit the <ulink url="http://www.digikam.org">&digikam; Home Page.</ulink> for news of new releases and other &digikam; related information. + </para> + </sect2> + + <sect2> + <title>Getting Involved</title> + + <para> + There are many ways that you can get involved with the continued development of &digikam;. You do not need to be a software developer. You can help with documentation, translation and user interface design or just contribute really good ideas to the wish-list. You can also get involved by testing early development code as it is being developed and providing feedback to the developers. Of course, if you are a software developer then you can help to make &digikam; the best digital photograph application there is. + </para> + + <para> + The best way to start getting involved with &digikam; is to join the Developers Mailing List. + <ulink url="https://mail.kde.org/mailman/listinfo/digikam-devel">&digikam; Developer Mailing + List joining instructions.</ulink> + </para> + </sect2> + + </sect1> + + <sect1 id="using-firstrun"> <title>Getting Started</title> + + <sect2> <title></title> + <para></para> + <sect3 id="firstrundialog"> <title>The First Run Dialog</title> + <para> + <inlinemediaobject><imageobject> + <imagedata fileref="&path;introductionfirstrundialog.png" format="PNG" /> </imageobject> + </inlinemediaobject></para> + + <para> + When you start &digikam; for the very first time it will ask you where you store your photographs. You can type in the path name of a folder or click on the <guilabel>folder</guilabel> icon + <inlinemediaobject> + <imageobject><imagedata fileref="&path;introductionfoldericon.png" format="PNG"/></imageobject> + <textobject> <phrase>Folder Icon</phrase> </textobject> + </inlinemediaobject> + to select a folder from the dialog. + </para> + </sect3> + + <sect3> <title>The Scan Items Dialog</title> + <para> + If you already have a collection of photographs on your hard disk, you can enter the top-level folder containing the photographs, this is called the Albums Library folder. &digikam; will treat each sub-folder of the folder you've entered as an Album. None of the photographs will be altered. During folders parsing you can see a progress dialog like this: + </para> + <para> + <inlinemediaobject> <imageobject> + <imagedata fileref="&path;introductionscandialog.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + </sect3> + + <sect3> <title>The Albums Missing Dialog</title> + <para> + This parsing for modifications happens at every application start-up, but it can be disabled in the <guilabel>Settings</guilabel> under <guilabel>Miscellaneous</guilabel> + </para> + <para> + As &digikam; uses your folders on your hard disk directly, other applications like file managers can remove any albums outside a &digikam; session. In this case &digikam; will tell you at the next session if all albums that have been removed from the &digikam; photographs root path shall be deleted from albums database. If you want to move folders around and do not want to do that in &digikam;, we suggest you do that while &digikam; is running, so the database will be kept in sync and you do not lose any metadata. + </para> + <para><inlinemediaobject><imageobject> + <imagedata fileref="&path;introductionalbumsmissingdialog.png" format="PNG" /> + </imageobject> + <textobject><phrase>The Albums Missing Dialog</phrase></textobject></inlinemediaobject> + </para> + + <para> + When you use an existing folder of photographs, as the Album Library folder, you will notice that the Albums in the Album list do not have photographs as their icons. You can change that by dragging any photograph in the Album onto the folder icon in the left sidebar and use this as the Album icon. See the <link linkend="using-myalbumsview">Album</link> section for details of how to change the Album icon. + </para> + + <para> + If you have previously accessed your photograph collection with another application, that has created thumbnails in non-standard sub-folders, &digikam; will show these thumbnail folders as separate Albums. &digikam; follows the <ulink url="http://www.freedesktop.org/">freedesktop.org</ulink> standards for thumbnail folders. There is no way of hiding non-standard thumbnail folders from the "Albums" list. If you want to keep them you could create an Album Collection that just contains all the thumbnail Folders and then view your Albums in By Collection order. See the <link linkend="using-myalbumsview">Album</link> section for more about Album Collections. + </para> + + <para> + Once you have configured the Album Library Folder you can set up &digikam; to work with your digital camera. Then learn how to use <link linkend="using-myalbumsview">Albums</link> and <link linkend="using-mytagsview">Tags</link> to arrange your photograph Albums. + </para> + </sect3> + </sect2> + </sect1> + + &doc-file-formats; + + <sect1 id="using-camerasupport"> <title>Supported Digital Still Cameras</title> + <anchor id="digitalstillcamera.anchor"/> + + <note><para> + RAW file support: if you are using RAW shooting mode with your camera, &digikam; is probably well able to deal with it. RAW support depends on the <ulink url="http://www.cybercom.net/~dcoffin/dcraw"> Dave Coffin's</ulink> dcraw program. To find out if your particular camera is supported, bring up the list of supported RAW cameras from the <menuchoice><guimenu>Help</guimenu><guimenuitem>RAW camera support</guimenuitem></menuchoice> menu. + </para> + <para> + How to setup and work with RAW files is described in <link linkend="setup-raw-decoder">RAW Decoder Settings</link> and <link linkend="raw-workflow">RAW Workflow</link>.</para> + </note> + + <para> + An easy-to-use Camera interface is provided, that will connect to your digital camera and download photographs directly into &digikam; Albums. More than <ulink url="http://www.gphoto.org/proj/libgphoto2/support.php">900 digital cameras</ulink> are supported by the gphoto2 library. Of course, any media or card reader supported by your operating system will interface with &digikam;. + </para> + <para> + Current digital cameras are characterized by the use of <emphasis>Compact &Flash; Memory</emphasis> cards and <emphasis>USB</emphasis> or <emphasis>FireWire (IEEE-1394 or i-link)</emphasis> for data transmission. The actual transfers to a host computer are commonly carried out using the <emphasis>USB Mass Storage</emphasis> device class (so that the camera appears as a disk drive) or using the <emphasis>Picture Transfer Protocol (PTP)</emphasis> and its derivatives. Older cameras may use the <emphasis>Serial Port (RS-232)</emphasis> connection. + </para> + + <informaltable><tgroup cols="2"> + + <thead><row> + <entry>Preview Example</entry> + <entry>Connector Type</entry> + </row></thead> + + <tbody> + <row> + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;introductionfirewireconnector.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + + <entry> + FireWire (IEEE-1394 or i-link) connector from a professional digital still camera + </entry> + </row> + + <row> + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;introductionusbconnector.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + + <entry> + Universal Serial Bus (USB) connector from a consumer digital still camera + </entry> + </row> + + <row> + <entry> + <para><inlinemediaobject><imageobject><imagedata fileref="&path;introductionserialconnector.png" format="PNG" /> </imageobject></inlinemediaobject></para> + </entry> + + <entry> + Serial Port (RS-232) connector from an old digital still camera + </entry> + </row> + + </tbody> + + </tgroup></informaltable> + + <para><guilabel>Transfers using gPhoto2: PTP and RS-232 Serial Port</guilabel></para> + + <para> + &digikam; employs the <emphasis>gPhoto2</emphasis> program to communicate with digital still cameras. gPhoto2 is a free, redistributable set of digital camera software applications which supports a growing number of over 800 cameras. gPhoto2 has support for the <emphasis>Picture Transfer Protocol</emphasis>, which is a widely supported protocol developed by the International Imaging Industry Association to allow the transfer of images from digital cameras to computers and other peripheral devices without the need of additional device drivers. + </para> + + <para> + Many old digital still cameras used <emphasis>Serial Port</emphasis> to communicate with host computer. Because photographs are big files and serial port transfers are slow, this connection is now obsolete. &digikam; supports these cameras and performs image transfers using the gPhoto2 program. You can find a complete list of supported digital cameras at this <ulink url="http://www.gphoto.org/proj/libgphoto2/support.php">url</ulink>. + </para> + + + <para> <guilabel>Transfers using Mass Storage device</guilabel></para> + + <para> + Of the devices that are not directly supported by gPhoto2, there is support for the <emphasis>Mass Storage</emphasis> protocol, which is well supported under &GNU;/&Linux;. This includes many digital cameras and Memory Card Readers. Mass Storage interfaces are: + + <itemizedlist> + <listitem><para><emphasis>USB Mass Storage</emphasis>: a computer interface using communication protocols defined by the USB Implementers Forum that run on the Universal Serial Bus. This standard provides an interface to a variety of storage devices, including digital cameras.</para></listitem> + + <listitem><para><emphasis>FireWire Mass Storage</emphasis>: a computer interface using communication protocols developed primarily by Apple Computer in the 1990s. FireWire offers high-speed communications and isochronous real-time data services. Like USB Mass Storage, this standard provides an interface to a variety of storage devices, including digital still cameras. Almost all recent digital cameras support USB version 1 and eventually will support USB version 2; a very few support FireWire. + </para></listitem> + + </itemizedlist> + + To use a generic Mass Storage device with &digikam;, select <guilabel>Mounted Camera</guilabel> item in <link linkend="cameraselection.anchor">Camera Setup</link> list and set the correct mount point path. + </para> + + </sect1> + + <sect1 id="using-pluginssupport"> <title>Supported Plugins</title> + + <para> + One of the nicest things about &digikam; is how easily its functionality can be extended, by using plugins: + + <itemizedlist> + + <listitem><para><emphasis>Kipi Plugins</emphasis>: the <ulink url="http://www.kipi-plugins.org">Kde Image Plugins Interface project (Kipi)</ulink> (<ulink url="help:/kipi-plugins/index.html">manual</ulink>) is an effort to develop a common plugin structure for &digikam;, <application>KPhotoAlbum</application>, <application>Showimg</application> and <application>Gwenview</application>. Its aim is to share image plugins among graphical applications. Kipi-Plugins setup is described in this <link linkend="setup-kipiplugins">section</link>.</para></listitem> + + </itemizedlist> + + <inlinemediaobject> + <imageobject><imagedata fileref="&path;introductionplugininterfaces.png" format="PNG"/></imageobject> + <textobject> <phrase>The &digikam; plugins interface</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + Plugins can manipulate images in almost any way that users can. Their advantage is, that it is much easier to add a capability to &digikam; by writing a small plugin than by modifying the &digikam; core. + </para> + + </sect1> + +</chapter> + +<!-- *********************************************************************** --> + +<chapter id="using-kapp"> <title>Using &digikam;</title> + + + <sect1 id="using-mainwindow"> <title>The Main &digikam; Window</title> + + <sect2 id="using-mainwindow-intro"> + <title>Introduction to the Main Window</title> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;maininterfacepreview.png" format="PNG" /> </imageobject> + </inlinemediaobject> + </para> + + <para>&digikam;'s main window has four areas. The first one is a sidebar in the left margin that lets you switch between 4 views: <guibutton>Albums</guibutton>, <guibutton>Dates</guibutton>, <guibutton>Tags</guibutton> and <guibutton>Searches</guibutton>. Then there is a tree navigator panel showing the selected view. The main image window is right in the center. And on the right hand side there is another <link linkend="using-sidebar">sidebar</link> shown. This one can be used to show all information about your images. You can use all these views to organize and find your photographs. + </para> + <para>To unclutter the interface, either toggle the sidebars away with a &LMB;, or use the full screen view mode (F11, Ctrl+Shift+F).</para> + <para>Drag and Drop of images works about everywhere: d&d an image into another branch of the album tree, across the horizontal album separation line, or to another application window. The only restriction is that you cannot d&d into tag, date or searches.</para> + + <anchor id="maininterface-statusbar"/> + <para>The status bar at the bottom shows in all four views: + <itemizedlist> + <listitem><para>the file name when selecting a single file</para></listitem> + <listitem><para>selection information when several items are selected</para></listitem> + <listitem><para>progress bar for batch processes, ⪚ assigning tags</para></listitem> + <listitem><para>Quick filters:</para> + <para>- search string field: live filter on file names, captions (comments), and tags</para> + <para>- a file type selector lets you single out the most common ones: JPEG, PNG, TIFF, RAW, movies and audio</para> + <para>- a rating filter to select images rated with the clicked number of stars</para> + </listitem> + <listitem><para>a thumbnail size slider</para></listitem> + <listitem><para>a navigation bar that leads through the images in the main view</para></listitem> + </itemizedlist> + </para> + + <para> + The window top shows the menu bar and the main toolbar below. + </para> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;maininterfacetoolbar.png" format="PNG"/></imageobject> + <textobject> <phrase>The Default Main Toolbar</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + + <itemizedlist> + + <listitem><para>(1) : Go one view backwards in the main window view history (Alt+Left)</para> </listitem> + + <listitem><para>(2) : Go one view forwards in the main window view history (Alt+Right)</para> </listitem> + + <listitem><para>(3) : Add images, import function (Ctrl+I)</para></listitem> + + <listitem><para>(4) : Create a new Album (Ctrl+N)</para></listitem> + + <listitem><para>(5) : Edit Album properties</para></listitem> + + <listitem><para>(6) : Quick Search tool (Ctrl+F)</para></listitem> + + <listitem><para>(7) : View image (F3)</para></listitem> + + <listitem><para>(8) : Open in Image Editor (F4)</para></listitem> + + <listitem><para>(9) : Rename Image (F2)</para></listitem> + + <listitem><para>(10) : Toggle Full Screen (Ctrl+Shift+F)</para></listitem> + + <listitem><para>(11) : Slide Show (F9)</para></listitem> + + </itemizedlist> + + </para> + + </sect2> + + <sect2 id="using-myalbumsview"> + <title>"Albums" View</title> + + <para> + The "Albums" tree provides an organized view of your photograph albums. All photographs that are managed by &digikam; are stored in a single folder branch. The albums can be sorted by their folder layout on the hard disk, by the Collection name that has been set in the Album Properties or by the Date of that Albums (this date can also be changed in the Properties of each Album). + </para> + + <para> + You can switch between these sort orders using <guimenuitem>Sort Albums</guimenuitem> from the <guimenu>View</guimenu> menu. + </para> + + <sect3 id="using-createnewalbum"> + <title>Creating a New Album</title> + + <para> + There are a number of ways to create a new Album. You can create a new Album when you upload new photographs from the Camera using the Camera Tool. You can also create a new empty Album by clicking the <menuchoice><guimenu>View</guimenu> </menuchoice> button on the tool bar. As an additional option, you can create a new Album by importing an existing folder of photographs from your computer; just select <menuchoice><guimenu>Album</guimenu> <guimenuitem>Import</guimenuitem> <guimenuitem>Import Folders</guimenuitem></menuchoice> from the menu bar and select the folder that you want to import. An Album will be created with the same name as the hard disk folder. You can use drag and drop to import a folder. Drag a folder icon, for example from a &konqueror; window. Then drop it on the album list on the left. A menu will appear that gives you the option to move or copy the folder into &digikam;. + </para> + + </sect3> + + <sect3 id="using-deletealbum"> + <title>Deleting an Album</title> + + <para> + When you delete an Album from &digikam; it will be moved into the &kde; Trash Can. As an option you could change this behavior, so that delete really did remove the Album and all of the photographs in it. This can be changed by selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &digikam;</guimenuitem></menuchoice> and selecting the Miscellaneous page. At the top of this page are the settings that control what happens when a photograph is deleted. To delete an Album right-click the Album in the "Albums" tree and select Delete Album from Hard Disk from the context menu. + </para> + + </sect3> + + <sect3 id="using-addphototoalbum"> + <title>Adding a Photograph to an Album</title> + + <para> + Most of the time you will create new Albums and populate them with photographs directly from your camera using the Camera Tool. However, sometimes you may want to add a photograph that you already have on your computer to an existing Album. To add a photograph to an Album, make sure that the Album is selected. Then, either click the <guilabel>Add Images</guilabel> icon in the tool bar or select <menuchoice><guimenu>Album</guimenu> <guimenuitem>Import</guimenuitem> <guimenuitem>Add Images</guimenuitem></menuchoice> from the menu bar. Select the photographs that you want to add from the file dialog and click <guilabel>Open</guilabel>. The photographs will be copied into the Album. Additionally, you can use drag and drop to import photographs. Drag the photographs icons, for example from a &konqueror; window. Than drop it on the image list on the right hand side. + </para> + + <para> + If you have a scanner configured, you can also scan a photograph straight into an Album. Select + <menuchoice><guimenu>Album</guimenu> + <guimenuitem>Import</guimenuitem> + <guimenuitem>Scan Images</guimenuitem></menuchoice>. + You can also take a screenshot and add this directly to an Album. Select + <menuchoice><guimenu>Album</guimenu> + <guimenuitem>Import</guimenuitem> + <guimenuitem>Screenshot</guimenuitem></menuchoice>. + </para> + + </sect3> + + <sect3 id="using-movecopyitem"> + <title>Moving or Copying Photographs Between Albums</title> + + <para> + Simply drag the photograph and drop it on the destination Album to move or copy it from one Album to another. A menu will appear that gives you the option to <guilabel>Move</guilabel> or <guilabel>Copy</guilabel> the photograph. You can move or copy multiple photographs the same way, just select all the photographs that you want to move and drag them on to the destination Album. + </para> + + </sect3> + + <sect3 id="using-managealbums"> + <title>Managing Albums</title> + + <anchor id="albumpropsedit.anchor"/> + + <para> + An Album contains a set of photographs. Album Properties allows you to set information about this set. To access the Album Properties right-click on an Album and select <guilabel>Edit Album Properties</guilabel> from the context menu. + </para> + + <para>The Album Properties dialog allows you to set:</para> + + <example> + <title>The Album Properties Dialog</title> + <screenshot><mediaobject><imageobject><imagedata fileref="&path;maininterfacealbumproperties.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <itemizedlist> + + <listitem><para>The Album <guilabel>Title</guilabel> : this will be used in the "Albums" list. + </para></listitem> + + <listitem><para>The Album <guilabel>Collection</guilabel> : this is a way of grouping your Albums together by a common label. The Collection you set will be used to order your albums when you select <guilabel>By Collection</guilabel> from the drop down box in the tool bar or using <menuchoice><guimenu>View</guimenu><guimenuitem>Sort Albums</guimenuitem><guimenuitem>By Collection</guimenuitem></menuchoice>. If you want to add and delete Collection labels, use the <link linkend="setup-collection">Collection Settings</link> dialog. + </para></listitem> + + <listitem><para>The <guilabel>Comments</guilabel> for the Album : this will be shown in the banner at the top of the main Image Window. + </para></listitem> + + <listitem><para>The Album <guilabel>Date</guilabel> : this will be used when you order your Albums by date using <menuchoice><guimenu>View</guimenu><guimenuitem>Sort Albums</guimenuitem><guimenuitem>By Date</guimenuitem></menuchoice>. + </para></listitem> + + <listitem><para><guilabel>Oldest, Average, Newest</guilabel> buttons : these will set the <guilabel>Date</guilabel> to the oldest, average or latest date of the images in that album. It will first try to calculate the average date of the images in the album based on the EXIF-headers. If that fails it will fall back to the modification date of the files in that folder. + </para></listitem> + + </itemizedlist> + + </sect3> + + <sect3 id="using-setalbumicon"> + <title>Setting the Album Icon</title> + + <para> + When you first view an Album, &digikam; selects the first photograph in the Album as the icon to display in the "Albums" list. This helps you remember what kind of photographs are contained in an Album. Sometimes the first photograph in the Album is not the most representative and you want to select a different one as the Album icon. + </para> + + <para> + To select a different photograph as the Album icon, right-click on the photograph that you want to use as the Album icon and select "Set as Album Thumbnail" from the context menu. Additionally you can use drag and drop to set the Album icon. Drag the photographs icon and drop it on the currently selected Album in the Album list. + </para> + + <note> + <para> + An Album can only be in one Album Collection and Album Collections cannot be nested. + </para> + + <para> + &digikam; also supports tagging individual photographs using the "My Tags" area at the left of the main window. Album Collections are different from photograph tagging because the Album Collection applies to all the photographs in an Album rather than to individual photographs. You can use both Album Collections and tagging to organize your photographs. + </para> + + </note> + + </sect3> + + </sect2> + + <sect2 id="using-imageview"> + <title>Image View</title> + + <sect3> + <title>Introduction</title> + + <para> + The Image Window provides the main view of your images. When you select an Album the images contained in that Album will be displayed in the Image Window. Each image is displayed as a thumbnail. You can alter the size of the thumbnails using the magnifier slider in the lower right of the status bar. + <inlinemediaobject> + <imageobject><imagedata fileref="&path;editorzoombuttons.png" format="PNG"/></imageobject> + <textobject> <phrase>The thumbnail size slider</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + The first time you select an Album you may have to wait briefly while the thumbnails are generated, unless you used the + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Rebuild all Thumbnails...</guimenuitem> + </menuchoice> menu item beforehand. + </para> + + <para> + Information about each photograph is displayed below each thumbnail. You can control what information is displayed from the + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure &digikam;</guimenuitem> + </menuchoice> + dialog. Select the Albums page and look for the <guilabel>Extra Information in Thumbnail View</guilabel> section. + </para> + + <para> + The thumbnails have Tool Tips which will pop up if you allow the mouse to dwell over a thumbnail for a moment. The Tool Tip shows the most important properties of the photograph including any tags that you have applied. The screenshot at the top of the <link linkend="using-mainwindow-intro">Introduction to the Main Window</link> section shows a Tool Tip being displayed. + </para> + + </sect3> + + <sect3> + <title>Image Management</title> + + <para> + Photographs are what &digikam; is all about. Albums and Tags allow you to organize and find your photographs in a way that suits you. You can access all of the functions that &digikam; can perform on a photograph by right-clicking the thumbnail (context menu) or by selecting from the Image menu in the menu bar. You have the choice between viewing the images, viewing by slide show, or of editing the images. + </para> + + </sect3> + + <sect3 id="using-imageviewing"> + <title>Viewing an image</title> + + <para> + There are several possibilities to view an image. You can either click on it, push + <menuchoice> + <shortcut><keycombo action="press"><keycap>F3</keycap></keycombo></shortcut> + <guimenu>Image</guimenu><guimenuitem>View...</guimenuitem> + </menuchoice> or + <menuchoice> + <shortcut><keycombo action="press"><keycap>Enter</keycap></keycombo></shortcut> + <guimenu></guimenu></menuchoice> + or select <menuchoice><guimenu>View</guimenu></menuchoice> from the context menu. The image will take the whole central space of the main window. For viewing it larger, click the sidebars away (by just clicking on them). While viewing images you can take action from the context menu at any time. To get back to the album view, just click again or press + <menuchoice> + <shortcut><keycombo action="press"><keycap>Esc</keycap></keycombo></shortcut> + <guimenu></guimenu></menuchoice> or + <menuchoice> + <shortcut><keycombo action="press"><keycap>F3</keycap></keycombo></shortcut> + <guimenu></guimenu></menuchoice> puts you back into the main window. + </para> + + </sect3> + + <sect3 id="using-imageediting"> + <title>Editing a Photograph</title> + + <para> + You can open the Image Editor on a photograph either using + <menuchoice> + <shortcut><keycap>F4</keycap></shortcut> + <guimenu>Image</guimenu><guimenuitem>Edit...</guimenuitem> + </menuchoice> + or by right-clicking and selecting <guilabel>Edit</guilabel> from the context menu. See the <link linkend="using-imageeditor">&digikam; Image Editor</link> section for instructions on how to edit your photographs. The Image Editor lets you view your photographs and make a number of adjustments to them. + </para> + + </sect3> + + <sect3 id="using-externalapp"> + <title>Viewing or Editing a Photograph With Another Application</title> + + <para> + Sometimes &digikam; may not provide all of the capabilities you need. You can open a photograph in another application by right-clicking on it and selecting from the <guilabel>Open With</guilabel> sub-menu. The list of applications that appear in this menu is controlled by the standard &kde; file associations for the image format type of this photograph. Consult the &kde; manual for instructions on changing these file associations if the application that you need is not listed. + </para> + + <para> + Note that there can be a problem with meta-data embedded in photographs when they are edited by other image manipulation applications. Some applications do not retain the photograph's meta-data when you save a modified image. This means that if you modify a photograph using one of these programs you will lose information such as orientation, aperture &etc;. that are stored in the EXIF and IPCT tags. + </para> + + </sect3> + + <sect3 id="using-rotateimage"> + <title>Lossless Image Rotation</title> + + <note><para> + You will need to have the Kipi JPEG Lossless Plugin installed for the rotation features. If you do not have this plugin installed you can still rotate your photographs, but you have use the Image Editor. The Image Editor uses a different method of rotating an image, you may not notice any difference but the Image Editor method can cause some loss of quality in the photograph when saving the picture as JPEG. The rotation methods described here uses the Kipi JPEG Lossless Plugin which preserve the quality in the original photograph. + </para></note> + + <para> + &digikam; provides two ways to get your photographs the right way up. The simplest method is to right-click the thumbnail and select <guilabel>Rotate</guilabel> and then pick the correct amount of rotation needed. + </para> + + <para> + Many digital cameras now have an orientation sensor. This sensor can detect how you hold the camera while taking a image. 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 image on disk according to this orientation information. + </para> + + <para> + The photograph is rotated without loss of quality and the orientation information is set to normal, so that other EXIF-aware applications will handle it correctly. To use this feature, right-click on the thumbnail and select + <menuchoice> + <guimenu>Image</guimenu><guimenuitem>Auto Rotate/Flip Using EXIF Information</guimenuitem> + </menuchoice> + . The Camera Tool can perform this operation automatically when it uploads the photographs from your camera which will ensure that your photographs are always the right way up. The rotate operation will do nothing if your camera does not include this information in the photos. + </para> + + </sect3> + + <sect3 id="using-renameimage"> + <title>Renaming a Photograph</title> + + <para> + You can change the filename for a photograph by right-clicking a thumbnail and selecting + <menuchoice> + <shortcut><keycap>F2</keycap></shortcut> + <guimenu>Rename</guimenu> + </menuchoice>. Remember to keep the file extension (.jpg, .tif, &etc;). + </para> + + </sect3> + + <sect3 id="using-deleteimage"> + <title>Deleting a Photograph</title> + + <para> + When you delete a photograph from &digikam; it will be moved to the &kde; Trash Can. + <menuchoice> + <shortcut><keycombo action="simul"><keycap>F8</keycap></keycombo> </shortcut> + <guimenu>Image</guimenu><guimenuitem>Delete</guimenuitem> + </menuchoice> or + <menuchoice> + <shortcut><keycap>Delete</keycap> </shortcut><guimenu></guimenu> + </menuchoice> + If you prefer that Delete really removes the photograph completely, than you can do that by + <menuchoice> + <shortcut><keycap>&Shift;</keycap><keycap> Delete</keycap> </shortcut> + <guimenu></guimenu> + </menuchoice> + </para> + + </sect3> + + </sect2> + + <sect2 id="using-mydatesview"> <title>"Dates" View from Main Window</title> + + <para><inlinemediaobject><imageobject><imagedata fileref="&path;maininterfacedateview.png" format="PNG" /> </imageobject> + <textobject><phrase>Dates View from Main Window</phrase></textobject></inlinemediaobject> + </para> + + <para> + The "Dates" view organizes your photographs based on their dates. &digikam; uses either the + EXIF date or, if no EXIF date is available, the last modification time of the file. + </para> + + <para> + When you select a month from the list, all images from that month are displayed in the Image View. + You can select days or weeks in the date sheet at the bottom of the Date View to show only the images + from the selected dates. + </para> + + </sect2> + + <sect2 id="using-mytagsview"> <title>"Tags" View</title> + + <para> + (Hierarchical) tagging provides a flexible and powerful way to organize and catalog your images. Tags are labels that can be applied to individual images or whole groups. Once a tag has been set to an image it can be found again by selecting the tag or doing a search. + </para> + + <example> <title>Selecting a tag and applying a new one</title> + <screenshot><mediaobject><imageobject><imagedata fileref="&path;maininterfacetagsview.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para>When a tag is selected, all of the images that are marked with that tag are displayed. </para> + + <para> + Tags can be arranged in a hierarchical tree. This allows you to organize your tags in a logical manner. One can collapse parts of the tree in the "Tags" list so that one can easily find the tags that you are looking for. + </para> + + <tip> + <para>Tags are stored in a database for fast access, and, the applied tags are written into IPTC data fields of the image (at least for JPEG). So can use your tags with other programs or, in case of loss of that data in the database, the tags will be re-imported when the image is noticed by &digikam;.</para></tip> + + <sect3 id="using-managetags"> <title>Managing Tags</title> + + <para> + You can add new tags by right-clicking on either the "Tags" label or an existing tag and selecting <guilabel>New Tag</guilabel>. If you add a new tag by right-clicking on an existing tag, your new tag will be created as a sub-tag. + </para> + + <para> + You can delete a Tag by right-clicking on the Tag you want to delete and selecting <guilabel>Delete</guilabel> Tag. When you delete a tag, the photographs themselves are not deleted. Simply the tag is removed from those photographs. + </para> + + <para> + You can move the position of a Tag within the tree by dragging it to the position that you want and dropping it there. A menu will appear that gives you the option to + <guilabel>Move</guilabel> the tag. This works from the left and right sidebar. A tag can only be in one place in the tree at a time. + </para> + + <para> + You can set the Tag Properties by right-clicking on a Tab and selecting <guilabel>Edit Tag Properties</guilabel>. The Tag Properties allow you to change the name of the tag and the icon used in the "Tags" tree. + </para> + + <para> + To select a different photograph as the tag icon, right-click on the photograph that you want to use as the tag icon and select "Set as Tag Thumbnail" from the context menu. Additionally you can use drag and drop to set the tag icon. Drag the images icon and drop it on the currently selected tag in the tag list. + </para> + + </sect3> + + <sect3 id="using-taggingimages"> <title>Tagging Photographs</title> + + <para> + Before you can get the most out of &digikam;'s Tagging capabilities, you must first tag your photographs. There are two methods of tagging photographs. Once you have identified the photographs that you want to tag you can either drag and drop them onto the Tag in the "My Tags" tree or, by right-clicking on the selected photographs in the Image Window, you can use the <guilabel>Assign Tag</guilabel> menu to select the Tags you wish to set. + </para> + + <para> + You can label a photograph with as many tags as you like. The photograph will appear when you select any of the tags that are set against it. This way you can set a tag for each person in a photograph, as well as the place the photograph was taken, the event it was taken at, &etc;. + </para> + + <example> <title>Tagging Image with context menu, or with drag&drop from either sidebar</title> + <screenshot><mediaobject><imageobject><imagedata fileref="&path;maininterfaceassigntags.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + Once you have tagged a photograph, the tag name will appear under the thumbnail in the Image Window. + </para> + + <para> + You can remove a tag from a photograph by right-clicking on the photograph and using the <guilabel>Remove</guilabel> Tag menu. This menu will only show those tags that have been set on this photograph. + </para> + + </sect3> + + </sect2> + + + <sect2 id="using-mysearchesview"> <title>"Searches" View</title> + + <sect3> + <title>The Quick Search Tool</title> + <anchor id="quicksearchtool.anchor"/> + + <para> + Quick Search provides you with a simple search form to search all data fields in the album library with a single query. You can enter any arguments in the <guilabel>Search</guilabel> text field and it will be used to determine the results. For instance, you can enter the string 'birthday' to search the complete album library for occurrences of the word 'birthday' in all photograph descriptions, or '05.png' to search for a specific image file name '05.png' (no escaping as in regexpressions needed). + </para> + + <para>Search Properties:<itemizedlist> + <listitem><para>searches are case insensitive</para></listitem> + <listitem><para>blank separated search terms are boolean AND combinations</para></listitem> + <listitem><para>special characters are literal and not interpreted ( . * ? / &etc;)</para></listitem> + <listitem><para>include all elements of the database: names, rating, keywords, tags, albums, collections, dates (and more in the future)</para></listitem> + </itemizedlist> + </para> + + <para> + The Quick Search really works intuitively. If you want to search images from a certain date, you can simply type <userinput>2005</userinput>, but it is even possible to search for a certain month. Just enter the name of the month in your local language. If it is Dutch, you can enter <userinput>Maart</userinput>, to see the images of March. The combination of 'Maart 2006' means 'Maart AND 2006' and therefore is equivalent to '2006 Maart'. Or look for 'Maart 2007 cr2' to find all RAW files of March 2007. + </para> + + <example> + <title>Quick Search Tool Dialog in Action</title> + <screenshot><mediaobject><imageobject><imagedata fileref="&path;maininterfacequicksearch.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + + <para> + When you are satisfied with your selection, click on the <guilabel>Ok</guilabel> button, and the search will be carried out, and the results displayed in "My Search" view from the main window. The <guilabel>Save search as</guilabel> text field will be used to label your query in "My Search" list. If you want to modify your selection after performing a search, simply right click on the item from "My Search" view and select an option from the pop-up menu. + </para> + + <para> + If you select <guilabel>Edit Search</guilabel>, the search form will re-appear, containing your previous search information. If you select <guilabel>Edit as Advanced Search</guilabel>, the advanced search tool dialog will be come up to modify your previous search information using more elaborate search rules. See the <link linkend="using-mainwindow-advancedsearchtool">The Advanced Search Tool</link> section for more information. + </para> + + <para> + If you want to remove an existing search from the list, just select <guilabel>Delete Search</guilabel> from the pop-up menu. + </para> + + <example> + <title>Search View from Main Window</title> + <screenshot><mediaobject><imageobject><imagedata fileref="&path;maininterfacesearchview.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </sect3> + + <sect3 id="using-mainwindow-advancedsearchtool"> + <title>The Advanced Search Tool</title> + <anchor id="advancedsearchtool.anchor"/> + + <para> + Advanced Search tool provides an extended search form which can be used to search in specific fields of the &digikam; albums database. + </para> + + <para> + The <guilabel>Search Rules</guilabel> list is used to set all options to process a search query in the albums database. All rules are listed vertically and separated by an operator. An option can be added or deleted to the list using <guilabel>Add/Delete Option</guilabel> or grouped/ungrouped together using <guilabel>Group/Ungroup Options</guilabel>. Each option can be combined with another one using <guilabel>As well as</guilabel> or <guilabel>Or</guilabel> logical operator. + </para> + + <tip> + <para> + If you made a rule with <guilabel>As well as</guilabel> and you realize that it should have been <guilabel>Or</guilabel>, you can easily switch to that by double clicking on the text <guilabel>As well as</guilabel> in the rules area. + </para> + </tip> + + <para> + An option is composed by four fields: + + <example> + <title>A Query Option Detail</title> + <screenshot><mediaobject><imageobject><imagedata fileref="&path;maininterfaceadvancedsearchoption.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <itemizedlist> + + <listitem><para>(1): the item used to search in the database, which can be an album, a name, a tag, an image, a keyword, &etc;. + </para></listitem> + + <listitem><para>(2): the logical operator to process the item which depends on the item type. + </para></listitem> + + <listitem><para>(3): the operator argument which can be a string or a name already set by database. + </para></listitem> + + <listitem><para>(4): a checked box to manage the option using Add/Delete and Group/Ungroup controls. + </para></listitem> + + </itemizedlist> + + </para> + + <para> + For instance, you can set an advanced query to search all items in the database using these options: + + <itemizedlist> + + <listitem><para>All album names contains the string 'adrien' and all image captions contains the string 'an'. + </para></listitem> + + <listitem><para>Or all item which have the tag 'Peoples'. + </para></listitem> + + <listitem><para>Or all keywords contains the string 'gilles'. + </para></listitem> + + </itemizedlist> + + <example> + <title>Advanced Search Tool Dialog in Action</title> + <screenshot><mediaobject><imageobject><imagedata fileref="&path;maininterfaceadvancedsearch.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </para> + + <para> + If you want to group options together, just check the option box at the end of the rule and press <guilabel>Group</guilabel> button. Options will be appear in the list like this: + + <example> + <title>A Query Grouped Options Example</title> + <screenshot><mediaobject><imageobject><imagedata fileref="&path;maininterfaceadvancedsearchoptiongroup.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </para> + + <para> + When you are satisfied with your search settings, click on the <guilabel>OK</guilabel> button. The advanced search will be carried out, and the results displayed in the "My Search" view from the main window. The <guilabel>Save search as</guilabel> text field will be used to name your advanced query in the "My Search" list. If you want to modify your selection after performing an advanced search, simply right click on one item from "My Search" view and select <guilabel>Edit Search</guilabel> from the pop-up menu. + </para> + + </sect3> + + </sect2> + + </sect1> + + <sect1 id="using-lighttable"> <title>The &digikam; Light Table</title> + <para> + &digikam; features a light table in a separate window to easily compare images. It works with all supported image formats including RAW files. + </para> + <para> + Select one or several images in any view from the main window, call + <menuchoice> <shortcut><keycombo><keycap>F6</keycap></keycombo> </shortcut> + <guimenu>Add to Light Table</guimenu> + </menuchoice> + from the context menu. The selection will be added to the light table, and its separate window will open. When you are back to the &digikam; main window you can quickly access the light table with <menuchoice> <shortcut> + <keycombo action="press"><keycap>&Alt;</keycap><keycap>F6</keycap></keycombo> </shortcut> + <guimenu>Tools</guimenu><guimenuitem>Light Table</guimenuitem> </menuchoice>. + </para> + + <para> + From the thumbbar drag & drop images to the left and right comparison pane below. A little arrow will indicate which copy is shown in which pane. If you choose <guilabel>Synchronize Preview</guilabel> from the toolbar, any zoom and panning in one window will be synchronously executed in the other pane, so that you can compare the same areas of two images. + </para> + + <para> + Another mode is better suited for quickly culling from a series of images. If you choose <guilabel>Navigate by Pair</guilabel> from the toolbar, the first two images will be automatically inserted into the comparison panes. Click on any thumbnail to make it the left side preview, the adjacent thumbnail to the right will be inserted into the right pane. That make it easy to sift through a series of similar images. + </para> + <para> + Of course, the usual delete actions work from the light table directly as well as + <menuchoice> <shortcut><keycombo action="press"><keycap>F4</keycap></keycombo> </shortcut> + <guimenu>File</guimenu><guimenuitem>Edit...</guimenuitem> + </menuchoice>. + </para> + + <para> + All image information from the main window right sidebar is available for each of the two previews in the light table. This makes it easy to link visual differences to exposure data for example. + </para> + <para> + In the lower right corner of each pane there you find a built-in panning action (crossed arrows). Click on it and keep the &LMB; pressed to pan across the image (in synchronous mode both images will show the same viewing port). + </para> + <para> + Zooming works the same as in other views: use indifferently the zoom slider below the panes or <keycombo action="press"><keycap>&Ctrl;</keycap><keycap>scroll wheel</keycap></keycombo> to zoom in and out, with both images when in synchronous mode. + </para> + <example> + <title>The Light Table in Action</title> + <screenshot><mediaobject><imageobject><imagedata fileref="&path;lighttable.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </sect1> + + <sect1 id="using-sidebar"> <title>&digikam; sidebar</title> + <anchor id="sidebar.anchor"/> + + <sect2> + <title>Introduction to the right sidebar</title> + <para> + The &digikam; main window has a sidebar at the right border providing important information and actions of the selected images. This same sidebar is also available in the <link linkend="using-imageeditor">Image Editor</link> view. It can be displayed by respectively clicking on one of the five tabs: + </para> + + <para> + <itemizedlist> + + <listitem><para><link linkend="using-sidebarfileproperties">Properties</link> : File and image properties, key shooting parameters (EXIF tags)</para></listitem> + + <listitem><para><link linkend="using-sidebarmetadata">Metadata</link> : EXIF, Makernotes, IPTC and GPS data (these properties can be edited by two Kipi-plugins</para></listitem> + + <listitem><para><link linkend="using-sidebarcolors">Colors</link> : Histograms and embedded ICC profiles</para></listitem> + + <listitem><para><link linkend="using-sidebarcommentstags">Comments & Tags</link> : Comments, Date & Time setting, Rating, Tags</para></listitem> + + <listitem><para><link linkend="using-sidebartagfilters">Tag Filters</link> : Tag filters applied to main window selection</para></listitem> + + </itemizedlist> + Clicking successively onto the same tab will make the sidebar pop up or fold back into the border. + </para> + </sect2> + + &doc-sidebar; + + <sect2 id="using-sidebarcommentstags"> + <title>Comments & Tags</title> + <para> + This sidebar tab serves to apply and edit image attributes like captions, rating, date and tags. The attributes are stored in the associated database, in the IPTC and EXIF data fields and become part of the image. All attributes are accessible in one sidebar view as shown in the screenshot below. During image reading the order of priority is a) database b) IPTC and c) EXIF. So if there is a discrepancy between any of the three, this priority will take effect and a synchronization will take place. This sidebar has a first-previous-next-last arrow navigator field on top if shown in the main application. + </para> + + <example> <title>sidebar Comments & Tags example</title> + <screenshot><screeninfo>sidebar Comments & Tags Example</screeninfo><mediaobject><imageobject><imagedata fileref="&path;sidebarcommentstags.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <sect3> + <title>Comment View</title> + <para> + The caption view can be used to type or paste in a caption of unlimited size (see note below). The text is UTF-8 compatible, meaning that all special characters are allowed. The captions are copied to EXIF and IPTC fields to be used by other applications. + </para> + <caution><para> + IPTC data only supports ASCII characters and is limited to 2000 characters (old American norm). All texts will be truncated after 2000 chars, and special characters will be malformed. If you intend to use the IPTC caption field in other applications you should be compliant with these restrictions. + </para></caution> + + </sect3> + + <sect3> + <title>Date & Time</title> + + <para> + In the Date & Time section, which reflects the time of taking the photograph, you can change all values. From the date combo-box a calender opens, and the time setting spin-box can also be written by directly typing the time. The dating is copied to the EXIF 'Date and Time' field. If you need to change a number of images for their creating time & date, there is a more comfortable method available (requiring the Kipi-plugins). This latter option can be found under <menuchoice><guimenuitem>Image</guimenuitem><guimenuitem>Adjust time & date...</guimenuitem></menuchoice>. Select the images to be changed in the main view and call the plugin. + </para> + </sect3> + + <sect3> + <title>Rating</title> + + <para> + The Rating section displays a 0...5 star rating scheme that can be used in searches and sort orders. It can be applied by a single mouse click to the 5 stars in the sidebar or with a keyboard short-cut Ctrl+0...5. The rating from the sidebar is always applied to one image at a time. To rate a number of images, select them and pop-up the context menu (right-click) to apply a common rating. + </para> + <para>The rating is then transcribed into the IPTC 'urgency' data field. The transcoding follows the scheme in this table: + </para> + + <informaltable><tgroup cols="2"> + <thead><row> + <entry>&digikam; Rating</entry> + <entry>IPTC Urgency</entry> + </row></thead> + + <tbody> + <row> <entry>-</entry> <entry>8</entry> </row> + + <row> <entry>*</entry> <entry>7</entry> </row> + + <row> <entry>*</entry> <entry>6</entry> </row> + + <row> <entry>**</entry> <entry>5</entry> </row> + + <row> <entry>***</entry> <entry>4</entry> </row> + + <row> <entry>****</entry> <entry>3</entry> </row> + + <row> <entry>****</entry> <entry>2</entry> </row> + + <row> <entry>*****</entry> <entry>1</entry> </row> + </tbody> + + </tgroup></informaltable> + + </sect3> + + <sect3> + <title>Tag Tree</title> + + <para> + The tag view shows an adaptive filter tag search box, the tag tree and a combo-box containing the tags previously applied in this &digikam; session. + </para> + <para> + The tag tree will be adapted dynamically as a function of the search word as you type into the box. So it is easy to quickly reduce the number of possibilities when searching for a tag. Of course, this feature is only useful if you have many tags. + </para> + + <para> + The combo-box at the bottom is another ergonomic feature for easy tagging of an image series. As you apply different tags they will be memorized in this box for quick access. + </para> + + <para> + Otherwise tags are simply applied by checking the respective boxes in the tree. All tags of an image are transcribed into the IPTC 'keyword' data field. + </para> + <note><para> + In case you have selected a number of images in the main view and you check a tag in the tag tree, this one is only applied to the highlighted image, and not to the whole selection. If you want to tag selections, refer to the <link linkend="using-sidebartagfilters">Tag filters</link> section. + </para></note> + + </sect3> + + </sect2> + + + <sect2 id="using-sidebartagfilters"> + <title>Tag Filters</title> + <para> + The tag filter sidebar is used to modify the set of images displayed in the main window view. Normally one uses the left sidebar with its Album, Date, Tags and Searches view. When additionally one or more tags on right sidebar tag filter is checked, only the cross-section of these two selections will be displayed. All created tags are available. + </para> + <para> + To give an example, suppose you have a tag called 'public' which tags all images except your private ones. Then you can check this 'public' tag in the right sidebar to hide the private images (all those not having 'public' tag). Whatever view mode you chose from the left sidebar, 'public' only image will be displayed. Another typical example is the selection of a subset of tags in a hierarchical tree. Suppose you want to display 'red' and 'green' from a tag tree containing 7 different colors as sub-tags. Simply click on the 'color' tag of the main view and check 'red' and 'green' from the right sidebar. + </para> + <para>Another use is <emphasis>drag-and-drop tagging</emphasis>. Lets say you selected in the main view a number of images to tag them. If the tag already exists, simply drag it from the right sidebar onto the selection (any one of the highlighted images). A dialog will pop-up and ask if this tag should be applied. + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;sidebartagfilters.png" format="PNG" /> </imageobject><textobject><phrase>Sidebar Tag Filters</phrase></textobject></inlinemediaobject> + </para> + + <para> + In the above example the main window shows the images from a calender date, the tag filter is set to 'not tagged', which reduces the set to 3 images. They have been selected with Ctrl+a, then a tag is dragged from the right tag tree over the selection and dropped. A pop-up dialog asks if the tag shall be applied. + </para> + + </sect2> + + </sect1> + + + <sect1 id="dam"> <title>Digital Asset Management (DAM) with &digikam;</title> + + <para><link linkend="build-dam">Build a system to organize and find your photographs</link></para> + <itemizedlist> + <listitem><para><link linkend="case-for-digikam">A case for doing DAM with &digikam;</link></para></listitem> + <listitem><para><link linkend="build-archive">Build the archive: Folder organization, physical layout as information</link></para></listitem> + <listitem><para><link linkend="automatic-metadata">Automatic metadata generation</link></para></listitem> + <listitem><para><link linkend="ranking">Rating/Ranking</link></para></listitem> + <listitem><para><link linkend="keywords">Tagging, Keyword assignment</link></para></listitem> + <listitem><para><link linkend="captions">Captions/Comments</link></para></listitem> + <listitem><para><link linkend="geotagging">Geolocation (geo-tagging)</link></para></listitem> + </itemizedlist> + <para><link linkend="copyright-protect">Protect your authorship and copyright/left</link></para> + <itemizedlist> + <listitem><para><link linkend="watermarking">Digital Watermarking (DW)</link></para></listitem> + </itemizedlist> + <para><link linkend="data-corruption">Protect your images from data corruption and loss</link></para> + <itemizedlist> + <listitem><para><link linkend="physical-deterioation">Physical deterioation</link></para></listitem> + <listitem><para><link linkend="logical-errors">Logical errors</link></para></listitem> + <listitem><para><link linkend="human-errors">Human errors</link></para></listitem> + <listitem><para><link linkend="myths-dispelled">Common myths dispelled</link></para></listitem> + <listitem><para><link linkend="storage-budget">Make your budget: Data size, required storage volume estimation</link></para></listitem> + <listitem><para><link linkend="backup">Back it up, backup, backup, recover!</link></para></listitem> + <listitem><para><link linkend="technology-review">Preserve your images through the changes of technology and owners</link></para></listitem> + <listitem><para><link linkend="best-practice">Best practice: Data protection</link></para></listitem> + </itemizedlist> + <para><link linkend="dam-workflow">A typical DAM workflow</link></para> + + <sect2> <title>Introduction</title> + <epigraph><para><emphasis>...in the end, photographs need a lot of care.</emphasis> I hope it's you who said this.</para></epigraph> + + <para>Can you find your digital photographs when you need them? Or do you spend more time sifting through your hard drive and file cabinets than you would like? Do you have a systematic approach for assigning and tracking content data on your photos? If you make a living as a photographer, do your images bear your copyright and contact information, or do they circulate in the marketplace unprotected? Do you want your future grandchildren to admire your photographs you have taken yesterday? How do you ensure backup and the correctness of your data? How to prepare to change your computer, your hard disk, the software, the operating system and still manage to find your pictures or movies?</para> + <para>What is digital asset management - apart from a buzz word? Digital Asset Management (DAM) refers to every part of the process that follows the taking of the picture, all the way through the final output and permanent storage. Anyone who shoots, scans or stores digital photographs is practicing some form of DAM, but most of us are not doing so in a systematic or efficient way.</para> + <para>We present a tool, a plan and practical advice on how to file, find, protect and re-use photographs, focusing on best practices for digital photographers using &digikam;. We cover downloading, renaming, culling, converting, grouping, backing-up, rating, tagging, archiving, optimizing, maintaining and exporting image files.</para> + <para>A generic definition: <blockquote><para>"<emphasis>Digital Asset Management</emphasis> ingests, indexes, categorizes, secures, searches, transforms, assembles and exports content that has monetary or cultural value."</para></blockquote></para> + <para>And since we're at it another important one: <blockquote><para>Metadata is defined as <emphasis>data about data</emphasis>. Metadata is definitional data that provides information about or documentation of other data managed within an application or environment.</para></blockquote></para> + <para>In our context here it stands for all information <emphasis>about</emphasis> a photograph.</para> + <para>&digikam; with its libraries and plugins is a unique and comprehensive tool to cover most of DAM tasks, and it does it fast and transparently. Based on open standards on all fronts it will not confine you to a platform or application, rather it puts you into a fast track to manage and find your photographs and to move on if you so please to any other platform, application, system without losing any of your work be it as an occasional user, enthusiast or professional.</para> + <para>The one thing that differentiates the archiving capabilities of film vs digital is that with digital you can make as many new originals as you want. With film you only have one original. All copies will have a slightly lower quality, and both originals and copies are more or less slowly aging and disappearing. The only way to keep it "forever fresh" is to make a digital copy of it. And that is also the only way to protect it from all hazards. </para> + <para>Even if digital media today may last shorter than film it is just up to you to make new copies every year, 5, 10 years or whenever necessary, and to always keep at least 2-3 copies of the files, preferably in different physical locations. You never had that opportunity with film. It could always be damaged in a fire, floods or similar - or even be stolen. The good and bad news then is this: if you lose digital images/data it is only your own laxity. </para> + </sect2> + + <sect2 id="build-dam"><title>Build a system to organize and find your photographs</title> + <para> Themes: hierarchy, tags, rating, captions, geolocation, date, albums, filenames, versioning, exporting</para> + <para>I dare-say if you have more than 1000 photographs on your computer in no-DAM fashion it takes you too long to find any particular image. And if you don't know how many images are in your files you're surely not using &digikam;. The dual approach to store metadata in a database<emphasis> and </emphasis>in the image files guarantees ultra fast searching and secure archiving freely accessible to other applications, platforms and formats.</para> + <para>But as much as there is no such thing as a free lunch, there is no free cataloging or DAM - those who spend the initial time of building a systematic method of their own will be better off as time passes and the number of photographs multiplies. The ROI (return on investment) of DAM has been estimated in different studies to be better than 10. Keep in mind to be <command>concise, plan for the future (30-50y), do it once</command>. The upcoming semantic web will totally integrate into and add value to a DAM environment.</para> + + <sect3 id="case-for-digikam"> <title>A case for doing DAM with &digikam;</title> + <para>&digikam; provides a number of methods to classify photographs: filenames, albums, collections, date + time, tags, rating, GPS position and captions. As if this was not enough, in the KDE4 version of &digikam; you can search many standard metadata items like camera model, lens, coordinates, image size and many more. Metadata categories as listed here are in fact different 'views' of your photo library. Combining these views is<emphasis> the </emphasis>very powerful method to narrow down the search for a file and to find it quickly. Imagine having 800 photos of your loved one. Searching for 'Mary', having more than '***' rating, shot in 'France' will surely leave you with very few candidates. In terms of selection criteria for a DAM system, &digikam; fares very well in terms of completeness, versatility, speed, scalability, accuracy and openness.</para> + <para>The key thing to remember is that you don't know how you or somebody else will try to find an image 2 years ahead of our time. You will remember past events in a different context, it's a fact of life. So if can narrow down your search by remembering place or time or camera or theme or rating or owner you stand an infinitely better chance to find it quickly than by just one of those criteria or none. At the beginning, at the time of taking a photograph, all metadata is in your head (except for the EXIF data). If you do not transcribe some of it into your DAM system, it will be lost eventually as much as every event fades into oblivion over time.</para> + <para>One distinction has to be interjected here between <command>private</command> and <command>public metadata</command>. One could say that all file-embedded attributes are potentially public since the images may be exported, sold, and copied to other places and people. On the other hand all non-embedded metadata in the database can be considered private as they stay in the database and go nowhere else. By adjusting &digikam;'s settings accordingly you can control what kind of data remains private and what will be embedded and eventually become public.</para> + </sect3> + + <sect3 id="build-archive"> <title>Build the archive: Folder organization, physical layout as information</title> + <para>The first thing to do and to know before you put anything onto your system is a to build an information structure (as opposed to data structure). Your image files have to be somehow organized within the computer, you have to decide if others should have access to your photographs (sharing), if you put them on a dedicated drive, on a network drive etc. Keep in mind that you have to migrate one day onto some bigger volume. </para> + <para>The organization should be simple, unified and scalable, and it should be independent of the storage medium on which you host them. Do not make the folders too small, several thousand images in one folder is not too much to ask for, but keep them small enough so that they can fit into a backup medium like a DVD 4.7 of 9.4 GB for double sided ones. Remember that the archive will grow all the time! The concrete type of structure depends on your use case of course: Lets take a simple yet frequent example: you are a casual photographer taking pictures of your private life, your family, holidays and so on. It could be efficient to create a structure based on years plus some holiday and export containers. It could look like this:</para> +<blockquote><screen>2006 +2007 +2008 +Holidays + - A + - B + - C +Export +Fun stuff +</screen></blockquote> + + <para>Maybe you'll be happy with this structure. Holiday pictures can be quickly found by its location (unless you go to the same place every year), the rest will be organized by date. If you shoot enough pictures you want to create sub folders below the years as months e.g. 2008-01, 2008-02 etc. 'Export' would be a container for images to print or to put onto a website.</para> + <para>The more professional photographer will have very different needs as there will be versions of photographs, archives, workflows, a constant influx of images of diverging themes, and a large quantity of everything. Within 10 year you'll have 95% archives and 5% work space files and you don't want to organize your structure around content!</para> + <para>The consideration are these:</para> +<itemizedlist> + <listitem><para>what kind of files go together? Segregation of file type makes batch processing easier. Keep new and old files separate.</para></listitem> + <listitem><para>How can you make that structure scalable?</para></listitem> + <listitem><para>Segregation of original and working files makes it easier to allocate the backup strategy and migration. You will always know if you look for an original or a derivative.</para></listitem> +</itemizedlist> + <para>TBC</para> + </sect3> + + <sect3 id="automatic-metadata"> <title>Automatic metadata generation</title> + <para>How to go about all this metadata business? Firstly, there are already a lot of <command>automatically generated metadata</command>: EXIF data and Makernotes. If you have configured &digikam; with your identity section all imported images will be imprinted with this data set which includes copyrights, all automatic. If you have a GPS track recorded in parallel to your taking the photographs, you can geolocate those images in a single action using the Geolocation plugin. Even if you brought back 1000 images from a shooting session, so far you'll not have spent more than 10 minutes to do all that. And by now you have all camera settings of every shot, lens data like zoom, focus, aperture etc., date and time, shooting location, copyrights, authorship, program used, and more. Not bad, isn't it? But we could have done more during the importing, we could have changed the file names to include the date, or place or theme, we could have changed the format to a lossless 16 bit per channel format, we could have automatically separated JPEG and RAW files into their folders. I actually recommend to auto-rename to match an event, a place or a theme. &digikam; provides all date/calendar related grouping so that there's hardly a need for coding the date into the file name. Unless you'd like to do just that to browse your albums with another application that is not calendar savvy. You will buy a new camera one day or you have a second one already, sooner than you believe. The numbering scheme of that new camera will start over at typically IMG_0001.JPG again, creating identical file names to the ones you have already if you do not rename them. By renaming you lessen the chance of inadvertently overwriting them at a later date. Keep the new names clean, use alphanumerics, dashes, underscores and a single period prior to the file extension.</para> + <para>I also recommend to switch-on the 'save metadata' options in the &digikam; settings page for metadata. This will ensure that EXIF and IPTC data is written into the file. If you forgot to do that you can always catch up by copying the metadata in the database to the files in one go (from the album menu).</para> + <para>Now we have a lot of stuff already in our database, but what if I need to change some of it? &digikam; provides a metadata editor for a selected number of attributes, the most important ones of course. </para> + <para>The real works begins here as we will apply tags, captions and a rating to every photograph. Of course, all images requiring the same attribute can be treated as a selection in one action. Lets start with rating or ranking. It's best to start with ranking because for further work you can concentrate on the good shots.</para> + + </sect3> + + <sect3 id="ranking"> <title>Rating/Ranking</title> + <para>A ranking systematic is implemented in &digikam; by the 5 star rating tool. In fact there are 6 levels, zero through five stars (*) can be attributed (when saving them into IPTC metadata a translation of levels ensures compatibility with other programs). Rating is rapidly applied with &digikam; using keyboard shortcuts or the mouse on single photographs or whole selections. The rating can then be entered as a search criterion or directly from the status bar quick filters. However, before you start attributing stars everywhere take a moment to establish personal criteria for ranking. Best practice is to write down your personal match of stars to some qualitative expression, that will define what you actually mean when giving 5 stars. Generally there should be much less images rated with increasing star assignment. A ratio of 3-10 between each level has proven useful. That will get you quite far in distinguishing your rating pyramid. Say, you choose a ratio of 7 between levels. For every 5 star image you'll then have 7 4 stars, 49 3 stars and so on, resulting in almost 20000 pictures. Amazing? Yes, and 16807 of them you didn't have to rate at all! You even can define a different rating scheme depending on the kind of use, 2 stars for commercial use, may mean something else than 2 stars holiday photos. It is also a good practice to define a neutral rating, everything below is actually a negative rating. This will help you culling and thinning your collection very efficiently. Or you could define purposes to ratings, say 0 stars for 'can throw away', 1 star for images in quarantine (decide later), 2 stars for gallery export, 3 stars for printing, 4 stars for selling, 5 stars for 'have to work on', as you please. It must suit<emphasis> your </emphasis>needs. The following table illustrates a possible evolution for a professional photographer using a ranking ratio of roughly 7 over the next 12 years. It is evident that the good shots can be easily found, even within millions of photos.</para> + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;DAM-pyramid.png" format="PNG"/></imageobject> + <textobject> <phrase>Ranking</phrase> </textobject> + </inlinemediaobject> + </para> + + + <para>Lets continue with tags (or keywords as called by other applications, or categories, they are all synonymous).</para> + </sect3> + + <sect3 id="keywords"> <title>Tagging, Keyword assignment</title> + <para>Tags are a hierarchical labeling system that you create as you add to it. The important thing to do is to create a system that suits your needs and habits. Are you a (semi)professional who wants to sell photographs to agencies, do you want to publish on a web gallery, or are you just the occasional amateur managing the visual family memory? For all these different use cases you want to design a tag structure that is adapted to it. If you configure it so, &digikam; will write the whole hierarchy into IPTC fields so that they can be used by your photographic agency using a different application of to automatically create title and caption for web exports. In any case it will serve you well to quickly find a specific picture again.</para> + <para>The hierarchy will provide you with automatic groupings. For example, if you start a typical private use hierarchy with 'Activities', 'People', 'Places', 'Themes' and 'Projects' on the top level, everything you tag with a sub-tag of these will be grouped together into a virtual album. &digikam; has a dedicated view in the left sidebar for these virtual albums. But it comes even better! As you continue adding sub-tags into the hierarchies, not only will you be able to search and quick-filter for them, the right sidebar tag filter allows you to select combinations of tag groups. Lets say in the left sidebar tag panel you select the virtual album 'People' and you have 12 different tags for people in there, then you can combine it with the right sidebar and just choose 'Peter', 'Paul' and 'Mary' out of the 12.</para> + <para>In the long run you will not remember the details of your pictures and their subject (essentially the metadata in you brain will break down). It is therefore paramount that you <command>choose general and generic categories</command>. You will aways remember that a particular shot was set at a river bank in a country or continent (-> river, continent), but you'll have forgotten which river it was. Instead of only tagging it with 'Okavango' you tag it with river/Africa or river/South Africa. The details you can either put into a tag as well or into the captions. A trick may help you: How would you search for that river with an internet search engine? That's the way to go!</para> + <para>Another categorization might be task-oriented as in 'print jobs', 'web export', 'personal', 'galleryXYZ', 'clients', 'slideshow' etc. Create groups as you need them but not more, you should be able to remember by heart the top level tags at least, otherwise the differentiation will become useless. Don't forget that you have all the other attributes to narrow down the search. The right sidebar tag filter combines with any view of left sidebar (albums, calendar, timeline, tag and search).</para> + <para>When you import cataloged images from other sources having embedded tags already, &digikam; will automatically create the trees for you, respectively insert it into the right place. Rearranging the hierarchy within the tree is no problem, you can do that easily by dragging and dropping a sub-tree to another place in the hierarchy. The changed tags will be updated as &digikam; ripples down the branches.</para> + <para>The graphics here shows how different metadata overlap. This is a very coarse representation, as each block of metadata will in itself be subdivided into many sections. File names and calendar data are properties of all images.</para> + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;DAM-Metadata.png" format="PNG"/></imageobject> + <textobject> <phrase>Ranking</phrase> </textobject> + </inlinemediaobject> + </para> + + <para>Enough of tags - lets move on to captions or comments, the third major tool for metadata cataloging. </para> + </sect3> + + <sect3 id="captions"> <title>Captions/Comments</title> + <para>This is already the 4th kind of metadata we present here. What is the distinction of captions compared to tags (comments can be used synonymously, but the IPTC vocabulary stipulates the term 'caption'), keywords? Where tags owe to a hierarchical and generalized description, captions are the opposite: prose description, details, anecdotal stuff. Tags foremostly serve the finding, retrieval and grouping of assets, whereas captions shall entertain, inform, touch the beholder. Naturally they can also be used to filter the catalog, but this is just a byproduct. Captions are to remember the story, the event, the emotions, it's what makes photographs much more interesting to look at, captions put photographs into a context and meaning. If the pictures are an aesthetic statement, caption should be the emotional and informational complement.</para> + <para>You rarely want nobody to see your photographs. You rather want to share them with friends, your family, other photographers, agencies, put them onto the internet. And don't tell me you're not interested as to how your photos are being received! </para> + <para>So you might have to most beautiful portrait, sunset or landscape and nobody seems to care. Why is that? Look at some good photographs yourself without reading the title, comment or background information. How many of you are interested in depth of field, exposure time, white balance etc.? Some, of course. But anybody will be interested in the story the pictures tell, you want to remember a photograph, meaningless images bombard us too much anyways. You have to give the viewer something that explains it all.</para> + <para>Lets look at this panorama. From far it is not even a nice beach panorama. If you go closer you start to see some details, people, the space.</para> + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;DAM-story.png" format="PNG"/></imageobject> + <textobject> <phrase>Ranking</phrase> </textobject> + </inlinemediaobject> + </para> + + <para>And now I tell you that this is the Allies landing site "Omaha Beach" in the French Normandie 60 years after the disembarkation. Wow! One starts to dream, have associations, memories, the historical time span is present, you may hear the silence. The caption has totally reframed to perception of this panorama. </para> + <para>For others to appreciate your photographs, the title is probably more important than the image itself for the interest it creates. When you show pictures, tell a story. Remember that the key is to convey the meaning to viewers, to help them understand what you understand about the subject and what moved you.</para> +<itemizedlist> + <listitem><para>let people know what you understand about the subject, why you love it</para></listitem> + <listitem><para>create a red line between the photographs</para></listitem> + <listitem><para>oppose or relate them to different epochs</para></listitem> + <listitem><para>take notes shortly after shooting to remember</para></listitem> + <listitem><para>contemplate, research, watch, and talk - but mostly listen.</para></listitem> + <listitem><para> it's okay if the image is less than perfect because it has the strength to stand on its own merit described in the caption.</para></listitem> +</itemizedlist> + <para>With &digikam; you can enter unlimited amounts of text using internationalized alphabet (UTF-8) as caption. You can enter it for a selection of photos at the same time. KDE even provides a spell checker. When you export images to web galleries, the captions will be exported at choice into either/or/and caption/title of the web gallery system, no need to re-write the story for publishing.</para> + </sect3> + + <sect3 id="geotagging"> <title>Geolocation (geo-tagging)</title> + <para>Do you still remember the times before GPS? When you would find your way to another city without navigation system? Wasn't the earth a dull blue ball before GoogleEarth? Well then, with images, the train of spatial representation is running at cruising speed alright. </para> + <para>A few cameras have a GPS receiver built-in, the images come tagged with 3-dimensional coordinates. And with almost any GPS device you're able to extract a trace (of course the receiver needs to be switched-on and carried with you whilst taking the photographs, and for good matching the camera time must be accurately set) and save it onto a computer. You have to store it in gpx format, that's easily done with gpsbabel, gpsman and other tools. You then can automatically match a whole bunch of photos with that track using &digikam;. The coordinates are written into the JFIF part of JPG files (settings choice) and into the database. The KDE4 version will enable searches based on locations and coordinates, you can create virtual albums of geographical areas! In the right sidebar under the metadata tab you'll find your image located on a local zoom of the world map. A further click brings on anyone of several mapping services on the web, zooming in on details. Even if you don't have a GPS trace you can geo-tag multiple images with a geo-editor. Just navigate on the map to the spot of shooting and click to fix it as a geo-tag. </para> + <para>e.g. conversion of a Garmin track with file name 'xyz':</para> +<blockquote><screen>$ gpsbabel -w -i mapsource -f xyz.mps -o gpx -F xyz.gpx</screen></blockquote> + <para>The possibilities of exploiting this geolocation are already innumerable and will become pervasive in the future. I'm sure one day not too far away we can revisit in a virtual reality our travels through geo-tagged pictures. The &digikam; features include exporting to kml files that can be opened by GoogleEarth (which in turn will show the photos on their shooting site), exporting to gallery2, picasaweb, flickr etc. with GoogleMaps viewer and more.</para> + </sect3> + </sect2> + + <sect2 id="copyright-protect"> <title>Protect your authorship and copyleft/right</title> + <para>Themes: watermarking, IPTC and XMP authorship data, export size</para> + <para>This will be the last chapter and step to mark your digital library with authorship, ownership and copyright or -left information. More than in 'the good(?) old days' of paper copies, the ubiquitous internet makes it just too easy to 'steal' a picture from a web site. At the very least, for all images that will be exported and/or published in any form, the authorship and copyright information should be part of their metadata. Nothing more simple to do with &digikam;: you can setup the default identity, and any images ingested be &digikam; will be automatically informed. I put copyleft in the title for a reason (citation from wikipedia):</para> +<blockquote><para>"Copyleft is a play on the word copyright and is the practice of using copyright law to remove restrictions on distributing copies and modified versions of a work for others and requiring that the same freedoms be preserved in modified versions.</para> + <para>Copyleft is a form of licensing and may be used to modify copyrights for works such as ... music, and art. In general, copyright law allows an author to prohibit others from reproducing, adapting, or distributing copies of the author's work. In contrast, an author may, through a copyleft licensing scheme, give every person who receives a copy of a work permission to reproduce, adapt or distribute the work as long as any resulting copies or adaptations are also bound by the same copyleft licensing scheme. A widely used and originating copyleft license is the GNU General Public License. Similar licenses are available through Creative Commons - called Share-alike."</para></blockquote> + <para>And here follows a description of what should be supplied to &digikam;'s setup page as information:</para> + <para><command>Author</command> (synonymous with Creator and By-line): This field should contain your name, or the name of the person who created the photograph. If it is not appropriate to add the name of the photographer (for example, if the identity of the photographer needs to be protected) the name of a company or organization can also be used. Once saved, this field should not be changed by anyone. This field does not support the use of commas or semi-colons as separator.</para> + <para><command>Author title</command> (synonymous with By-line title): Linked to Author. This field should contain the job title of the photographer. Examples might include titles such as: Staff Photographer, Freelance Photographer, or Independent Commercial Photographer. Since this is a qualifier for the Author field, the Author field must also be filled out.</para> + <para><command>Credit</command> (synonymous to Provider): Use the Provider field to identify who is providing the photograph. This does not necessarily have to be the author. If a photographer is working for a news agency such as Reuters or the Associated Press, these organizations could be listed here as they are 'providing' the image for use by others. If the image is a stock photograph, then the group (agency) involved in supplying the image should be listed here.</para> + <para><command>Source</command>: The Source field should be used to identify the original owner or copyright holder of the photograph. The value of this field should never be changed after the information is entered following the image's creation. You should consider this to be a write-once field. The source could be an individual, an agency, or a member of an agency. To aid in later searches, I suggest to separate any slashes '/' with a blank space. Use the form 'photographer / agency' rather than 'photographer/agency.' Source may also be different from Creator and from the names listed in the Copyright Notice.</para> + <para><command>Copyright Notice</command>: The Copyright Notice should contain any necessary copyright notice for claiming the intellectual property, and should identify the current owner(s) of the copyright for the photograph. Usually, this would be the photographer, but if the image was done by an employee or as work-for-hire, then the agency or company should be listed. Use the form appropriate to your country. For the United States you would typically follow the form of © {date of first publication} name of copyright owner, as in 'copr 2005 John Doe.' The word 'copyright' or the abbreviation 'copr' shall be used in place of the © symbol as ASCII characters only are allowed. In some foreign countries only the copyright symbol is recognized and the abbreviation does not work. Using something like (c) where the parentheses form a partial circle is not sufficient. For additional protection worldwide, use of the phrase, 'all rights reserved' following the notice above is encouraged. In Europe you would use: Copyright {Year} {copyright owner}, all rights reserved. In Japan, for maximum protection, the following three items should appear in the copyright field of the IPTC Core: (a) the word, Copyright; (b) year of the first publication; and (c) name of the author. You may also wish to include the phrase 'all rights reserved.'</para> + <para>Whereas it is paramount to fill-in the author and copyright sections, they represent no protection against fraud. Anyone with a bit more than basic computer knowledge is able to delete or modify image embedded metadata. The solution to this problem is called 'digital watermarking'. To private persons this might be of little interest for the majority of photographs, but for professionals ans semi-professionals this protection is really important.</para> + <sect3 id="watermarking"> <title>Digital Watermarking (DW)</title> + <para>Digital Watermarking refers to an invisible digital watermark that is being impressed on photographs as an element of digital rights management (DRM). The watermark contains the same information of authorship and copyright as described above, but the metadata is encrypted and saved in the actual image data (as opposed to the metadata section which is a separate section within the image file). This invisible imprint has holographic properties so that modifications done to an image (size, color, crop, up to a certain limit) will not destroy the copyright information. Only when an image is resized to a very small fraction like a thumbnail will the embedded information be lost, but then the image is of no value anymore to the copyright infringing party. </para> + <para>The digital watermark will be unique per image. &digikam; will provide a plugin for DW in the near future that features batch processing.</para> + </sect3> + </sect2> + + <sect2 id="data-corruption"> <title>Protect your images from data corruption and loss</title> + <para>Themes: disk errors, disk failures, power surges, ECC, transmission errors, storage media deterioration, recovery, redundancy, disaster prevention, lifetime, temperature, data size, common myths</para> + + <sect3> <title>What are then the main factors of digital data loss?</title> + <para>Of course we're not talking about losing CDs on the road or in a fire - that kind of loss is just the same as traditional paper copies or negatives. We are talking about problems with the so called "New Media".</para> + <para>Problems with digital data can roughly be categorized into the following areas of concern:</para> + <orderedlist> + <listitem><para>the physical deterioration of the media (all media deteriorate at different time scales)</para></listitem> + <listitem><para>undetected transmission errors during data transfer</para></listitem> + <listitem><para>the lack of support for long-date, undoubtedly proprietary, digital formats</para></listitem> + <listitem><para>ancient hardware. </para></listitem> + </orderedlist> + <para>Kroll Ontrack, the worlds largest data recovery firm, have some interesting statistics on what actually causes data loss.</para> +<informaltable> +<tgroup cols="3"> +<tbody> +<row> +<entry>Cause of data loss</entry> +<entry>Perception</entry> +<entry>Reality</entry> +</row> +<row> +<entry>Hardware or system problem</entry> +<entry>78%</entry> +<entry>56%</entry> +</row> +<row> +<entry>Human error</entry> +<entry>11%</entry> +<entry>26%</entry> +</row> +<row> +<entry>Software corruption or problem </entry> +<entry>7%</entry> +<entry>9%</entry> +</row> +<row> +<entry>Computer viruses</entry> +<entry>2%</entry> +<entry>4%</entry> +</row> +<row> +<entry>Disaster</entry> +<entry>1-2%</entry> +<entry>1-2%</entry> +</row> +</tbody> +</tgroup> +</informaltable> + <para>So let us analyze those cases step by step!</para> + </sect3> + + <sect3 id="physical-deterioation"> <title>Physical deterioration</title> + <sect4> <title>CD, DVD, optical drives</title> + <para>Physical deterioration of the media happens more rapidly with paper and CD-Rs than the average of film. Yet while film lasts longer (sometimes decades longer) than other forms of media, the right kind of backup of digital media never loses anything. Film decays - digital 1's and 0's do not, and film starts to decay the moment it's created and developed. It will never have the same color, contrast, etc. that it did have a moment before. Digital doesn't do that. However, digital is susceptible to corruption! And yes, physical media such as floppies and magnetic hard drives are also susceptible to the decay of the medium, just like CDs are. They just last longer. </para> + <para>To combat the problem of CDs/DVDs, they need to be properly cared for and not trusted for more than a few years. Thankfully you can purchase archive-quality CDs and DVDs which last longer, though they are much more difficult to obtain and are much more expensive. There are offers out there for gold-plated DVDs, $2 a piece claiming 100 years storage life (if you care to believe it).</para> + <para>CD/DVD disks may become unreadable, but you can reduce the risk using good disks and a good recorder, and storing them in a correct way. The best DVD recorders are not much more expensive than the cheapest, but they write in a much more reliable way. It's a matter of choosing the right one.</para> + <para>Essentially, CDs and DVDs are very prone to errors, even in a freshly written state. That's why they are heavily protected with a checksum mechanism (75% of data are effective data, the rest is formating and checksum overhead). But even with that massive amount of protection they will suffer deterioration from chemical aging, ultra-violet exposure, scratches, dust, etc.</para> + <para>For damaged CDs and DVDs, there is an inexpensive program called <ulink url="http://www.isobuster.com/">IsoBuster</ulink> from which will do seeming miracles on CDs and DVDs. It runs on Windows and &Linux;; but not (yet) on Macs. Similarly, there are applications designed to get data from damaged floppies, hard drives, flash media such as camera memory and USB drives, and so forth. </para> + <para>Optical media: Blu-ray disks seem to win the format war against 'HD DVD'. A dual-layer Blu-ray disc can store 50 GB, almost six times the capacity of a dual layer DVD at 8.5 GB. Everything that has been said about CDs/DVDs applies to Blu-ray disks as well.</para> + <para>Best practice:</para> + <para>Burn them slowly with a good recorder on archive quality media in an open, non-proprietary format, read the data back to verify, label them with some descriptive text + date & author, lock them away where it is clean, dark, animal safe and dry. And do not forget to copy them over to the next generation of media before you throw away your last piece of hardware or software able to read them.</para> + </sect4> + <sect4> <title>Hard disks (hard drives, HDD)</title> + <para>Disk manufacturers keep their statistics to themselves. A manufacturer guaranty buys you a new disk, but no data. Google for one has done a large scale study on HDD failure mechanisms: <ulink url="http://research.google.com/archive/disk_failures.pdf">Disk Failures study</ulink></para> + <para>In a nutshell: Disks run longest when operating between 35°C and 45°C, at lower temperatures the error rates increases dramatically. Controller parts (electronics) are the foremost sources of failure, SMART does not diagnose any of this. Some SMART errors are indicative of imminent failure, in particular scan errors and relocation counts. Lifetime expectancy is 4-5 years. </para> + <para>But all depends much on the real use case and some luck. For example I have a Fujitsu notebook that is running 24/7 since 1998, almost ten years without the slightest hick up. Just luck? In general and contrary to intuition or ecological considerations, running a hard drive permanently results in a longer lifetime than switching it on and off all the time. It has even been reported that aggressive power management spinning down the drive can harm it quickly. Making it working hard shortens the lifetime somewhat. The worst factors for HDD probably are vibrations, shocks, and cold temperatures.</para> + <para>If your disk is making weird noises, normal file recovery software isn’t going to work. Do a quick backup if that is going to happen to you. (Use dd utility if possible, not a normal file backup since dd reads in a smooth, spiraling stream from beginning to end and doesn't stress the mechanics). The are specialist companies that can recover data from otherwise destroyed drive, but they are costly, plan for 2000$ minimum charge.</para> + </sect4> + <sect4> <title>Power surges</title> + <para>As much as 1% of all computers are affected by lightning and power surges every year.</para> + <para>(This is about total data loss due to power surges. Off course you can have the occasional data loss due to power loss before saving files. But those losses can normally be restored without major difficulty.)</para> + <para>You don’t have to wait for the next thunderstorm to be concerned about how a sudden fluctuation in electric power may affect your computer system. Recent statistics have shown that as much as 63 percent of all electronics casualties are due to power problems, and most computers are subject to two or more power anomalies a day. Since power surges or blackouts can occur anywhere and at any time, it only makes sense to protect your computer by investing in some sort of surge protection device.</para> + + <sect5> <title>How surges happen</title> + <para>A power surge occurs when the power line voltage increases over nominal values for more than 10 milliseconds. Sixty percent of all power surges are caused from within the home or office, generally when a device with a motor (such as a hair dryer, refrigerator, or water pump) shuts off and the power it was using is diverted elsewhere as excess voltage. The remaining 40 percent of power surges are generated by factors such as lightning, utility grid switching, line slapping, poor wiring, and so on.</para> + <para>While most average electricity-using devices are not affected by power surges, devices relying on computer chips and high-speed microprocessors are susceptible to serious damage. For your computer, power anomalies can result in keyboard lockup, complete data loss, hardware degradation, damaged motherboards, and more. Failure to protect yourself from the inevitable can result in a loss of both time and money.</para> + </sect5> + <sect5> <title>Surge protectors</title> + <para>The most common defense against power surges is a surge protector or suppressor, a device that works by absorbing some of the excess energy and diverting the rest of it to the ground. These are usually found in the form of a power strip (one of those long devices that have six or so outlets and a single, grounded plug). Bear in mind, however, that not every power strip serves as a surge protector. </para> + <para>When selecting your surge protector, you want to be sure it is listed as meeting the UL 1449 standard, which guarantees a certain minimum of protection. You should also look for one that offers protection against lightning (not every one does) and provides insurance for equipment that is properly attached.</para> + <para>Because a power surge can follow any path to your computer, be sure that each peripheral connected to your system is protected. this includes your phone line or cable modem, as power can surge through these routes as well. A number of manufacturers are now producing surge suppressors that feature a phone jack for your modem along with the electrical outlets, while others have coaxial cable jacks for those who use a cable modem or TV tuner card.</para> + <para>If you have a notebook computer, you will want to carry a surge suppressor as well. A variety of suppressors designed specifically for notebooks are available, small in size and possessing both electric and phone outlets that make them ideal for use on the road.</para> + </sect5> + <sect5> <title>Uninterruptible power supply (UPS)</title> + <para>While a surge suppressor will protect your system from minor fluctuations in the power lines, it won’t help you if the power should black out completely. Even an outage of just a few seconds can result in the loss of valuable data, so you might find it worthwhile to invest in an uninterruptible power supply. </para> + <para>Besides serving as surge suppressors, these devices automatically switch to battery power when a power outage occurs, giving you the opportunity to save data and shut down your system. Some models will even allow you to keep working until power is restored. When purchasing a UPS, be sure that it has the same qualities that you would seek in a surge suppressor, but also check out the battery life and included software.</para> + <para>Considering the potential risk to your computing system, ensuring its safety from power disturbances is a worthwhile investment. A quality surge suppressor will cost you upward of €20, a 500W UPS can be had for less than €40. It’s a small cost to pay for the peace of mind you’ll gain knowing your computer is well protected. In the very least pull all lines to your computer when you go on holidays.</para> + </sect5> + </sect4> + <sect4> <title>Solid state drives: USB sticks, memory cards, flash disks</title> + <para>SSDs are mechanically more robust than HDDs and suffer much less on that front when they are plugged into the computer. But since they are mostly mobile devices, their exposure to drops, accidents and electrostatic discharges is much higher. So, for different reasons, SDDs are as likely to fail if not more than hard drives. Add the danger of theft and longevity and limited capacity, and SDDs will become prohibitive as permanent data storage devices.</para> + <para>One major cause for data loss (often recoverable) is the unsafe removal of SDDs from a computer. Before data is saved from a computer memory to any attached device, it remains for some time in buffers. In hard drives this means seconds at most, whereas with SDDs it can be tens of minutes. Therefore, before you disconnect a flash device, always activate data flushing through software (often called "safely remove device").</para> + <para>There is a new technology trend coming up, to replace hard drives with SSD flash drives. By 2010 they may be competitive in price to HDDs. Data retention is an issue with SDDs, it cannot be overwritten an infinite amount of times. SDDs wear in use. Wear then depends much on the location data is written, and how often it is written. &Linux; has developed a special driver avoiding writing to the same spot too often. But this is all premature information. Keep your eyes and ears open.</para> + </sect4> + <sect4> <title>Magnetic media</title> + <para>Magnetic tapes are used in backup systems, much more in professional environments than in home use. Tapes have issues with data retention and changing technology, but they are safer in one aspect than CDs and DVDs: they are less exposed to scratches and dirt and writing deficiencies. On the other hand they are susceptible to magnetic fields. Throw a magnet next to a tape and it's gone! Tapes should be re-copied every 5-8 years, otherwise too many bits will fail and escape the checksum protection. The downside of magnetic tapes is often the recorder price and the restore time (20x longer than from HDD). Tape backup system have seen their best days. </para> + </sect4> + </sect3> + + <sect3 id="logical-errors"> <title>Logical errors</title> + <sect4> <title>Web storage services</title> + <para>Amazon Web Services includes S3 - Simple Storage Service. With appropriate configuration, you can mount that as a drive on &Linux;, Mac, and Windows systems, allowing you to use it as a backup destination for your favorite software. Google Shared Storage is another popular offer where one can store infinite amount of data.</para> + <para>It is expensive compared to hard drives at home - 40 GB cost $75 a year, 400 GB cost $500. And you have to transfer the images over (a comparatively slow) internet.</para> + <para>I think as a safeguard against localized data loss of the most essential images it's not a bad idea at all, but it is not a general backup solution, much too slow for that.</para> + <para>Why didn't I mention Picasaweb or Flickr (to name the competition)? Because the free space is limited there to 1 GB and you don't want to have full resolution images online.</para> + <para>In terms of data retention the web space solution is probably pretty safe. Transmission errors are corrected (thanks to the TCP protocol) and the big companies usually have backup included plus distributed storage so that they are disaster proof within themselves.</para> + </sect4> + <sect4> <title>Transmission Errors</title> + <para>Data does not only get lost from storage devices, it also gets lost when traveling inside the computer or across networks (although the network traffic itself via TCP is error protected). Errors occur on buses and in memory spaces. Consumer hardware has no protection against those bit errors, whereas it is worthwhile to look into such. You can buy ECC (error code correction) protected memory (which is expensive, granted). With ECC RAM at least the memory will be scrubbed for single bit errors and corrected. Double bit errors would escape that scheme but they occur too infrequently. </para> + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;DAM-transmission.png" format="PNG"/></imageobject> + <textobject> <phrase>Transmission errors</phrase> </textobject> + </inlinemediaobject> + </para> + + <para>This diagram depicts the transmission chain elements in a computer, all transitions are susceptible to transmission errors. The zfs and btrfs file system at least ensure the OS to disk path of data integrity.</para> + <para>The Byte Error Rate (BER) for memory and transmission channels is in the order of 1 in 10 Million (10E-7 bit). That just means that <command>1 in 3000 images has an error only due to transmission problems</command>. Now how dramatic that is for an image is left to chance, it could mean that the image is destroyed or that a pixel somewhere changed its value, due to the compression used on almost all images one can't predict the gravity of a single bit error impact. Often one sees some partial images instead of the full image.</para> + <para>The worst of all that is that nobody tells you when a transmission error occurs, not your hardware. All those glitches go down unheard until one day you open the photograph, and to your surprise it's broken. It is quite worrisome that there should be no protection within a computer, nobody seems to have thought of it. The internet (TCP protocol) is much saver as a data path than inside a computer.</para> + <para>Flaky power supplies are another source of transmission losses because they create interference with the data streams. With normal files systems those errors go unnoticed. </para> + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;DAM-errors.png" format="PNG"/></imageobject> + <textobject> <phrase>Expected error rate increasing with complexity</phrase> </textobject> + </inlinemediaobject> + </para> + <para>Even if you are not overly concerned today with transmission problems, have a look into the future at illustration. Already in 2010 we'll see thousands of errors per year!</para> + </sect4> + + <sect4> <title>'Oracle' or 'Rising Sun' at the file system horizon?</title> + <para>ZFS from Sun Microsystems seems to be one of two candidates to deal with disk errors on a low level, and it is highly scalable. It is Open Source, heavily patented, comes with an GPL incompatible license, and is available on Solaris and Leopard. Let us hope that it will soon be available for &Linux; and Windows <ulink url="http://blogs.zdnet.com/storage/?p=169"> (article)</ulink>.</para> + <para>This is for the courageous ones. <ulink url="http://www.wizy.org/wiki/ZFS_on_FUSE">Fuse ZFS</ulink></para> + <para>Oracle has also started an initiative with its btrfs file system, which still is in an alpha stage. It employs the same protection technique as zfs does, and it's available on &Linux;, although it is not yet part of the stock kernel.</para> + </sect4> + </sect3> + + <sect3 id="human-errors"> <title>Human errors</title> + <sect4> <title>Theft and accidents</title> + <para>Do not underestimate it! Those two factor account for 86% of notebook and 46% for desktop system data losses. For notebooks, theft counts for 50% alone.</para> + </sect4> + <sect4> <title>Malware</title> + <para>Data loss due to viruses is less grave than common wisdom make you believe. It accounts for less damage than theft or re-installations, for example. And it is limited to Microsoft OS users. Apple users experience very few viruses and under &Linux; they haven't been around for quite some time now.</para> + </sect4> + <sect4> <title>Panic is a factor in data loss</title> + <para>Human error, as in everything, is a major problem in data loss. Take a deep breath and stop! Panic is a common reaction, and people do really stupid things. Experienced users will pull the wrong drive from a RAID array or reformat a drive, destroying all their information. Acting without thinking is dangerous to your data. Stop stressing about the loss and don’t do anything to the disk. Better yet, stop using the computer until you have a plan. Sit down and explain you plan to a laymen or better, laywoman. You will be amazed how many stupid ideas you'll discover yourself in such an exercise.</para> + <para>If your disk is making weird noises, normal file recovery software isn’t going to work. Do a quick backup if that is going to happen to you. If the drive is still spinning and you can’t find your data, look for a data recovery utility and backup to another computer or drive. (Non-&Linux; users: Google for "free data recovery software" for some options, including one from Ontrack). The important thing is to download them onto another drive, either on another computer, or onto a USB thumb drive or hard disk. It is good practice to save the recovered data to another disk. dd is your friend on *nix systems.</para> + </sect4> + </sect3> + + <sect3 id="myths-dispelled"> <title>Common myths dispelled</title> + <para>I'd like to dispel some common myths:</para> + <itemizedlist> + <listitem><para>Open Source file systems are less prone to data loss than proprietary systems: Wrong, NTFS is rather a tiny notch better than ext3, ReiserFs, JFS, XFS, to name just the most popular file systems that often come as default FS with distributions. A brilliant article about it is here: <ulink url="http://www.cs.wisc.edu/~vijayan/vijayan-thesis.pdf">link</ulink></para></listitem> + <listitem><para>Journaling files systems prevent data corruption/loss: Wrong, they only speed up the scan process in case of a sudden interrupt during operation and prevent ambiguous states. But if a file was not entirely saved before the mishap, it'll be lost.</para></listitem> + <listitem><para>RAID systems prevent data corruption/loss: Mostly wrong, RAID0 and 1 prevent you from nothing, RAID5 can prevent data loss due to disk-failures (but not from disk or file system errors). Many low-end RAID controllers (most mother board controllers are) don’t report problems, figuring you’ll never notice. If you do notice, months later, what is the chance that you’ll know it was the controller’s fault? One insidious problem is corruption of RAID 5 parity data. It is pretty simple to check a file by reading it and matching the metadata. Checking parity data is much more difficult, so you typically won’t see parity errors until a rebuild. Then, of course, it is too late.</para></listitem> + <listitem><para>Viruses are the biggest thread to digital data: Wrong. Theft, and human errors are the primary cause of data loss.</para></listitem> + </itemizedlist> + </sect3> + + <sect3 id="storage-budget"> <title>Make your budget: Data size, required storage volume estimation</title> + <para>Digital camera sensors are 1-2 aperture stops away from fundamental physical limitations. What I mean is this: as technology evolves, there is a natural limit to its progress. Sensitivity and noise characteristics for any kind of light sensor are not far from that limit. </para> + <para>Today's cameras tend towards 10 mega pixels sensors, although this resolution is already too high for compact cameras and deteriorates the end result. Given the sensor size and quality of optics, 6 mega pixels are optimum for compact cameras. Even DSLR cameras run into their limits at 10-12 mega pixels, for higher resolutions one has to go for full frame sensors (24x36mm) or even bigger formats.</para> + <para>So, taking into account the manufacturer mega pixel propaganda it seems save to say that the bulk of future cameras will see less than 20 mega pixels. This gives us an estimation for the necessary storage space per photograph in the long run: <15 MB per image. Even if file versioning will be introduced (grouping of variations of a photograph under one file reference), the trend is to implement scripting of changes so that a small overhead will be recorded only and not a whole different image per version. With faster hardware this concept will see it's maturity quite soon.</para> + <para>In order to estimate the amount of storage space you have to plan for, simply multiply the number of photographs you take per year (easy with &digikam;'s timeline sidebar) and multiply it by 15 MB. Most users will keep less than 2000 pictures per year which requires less than 30 GB/year. Assuming that you will change your hard disk (or whatever media in the future) every 4-5 years, the natural increase in storage capacity will suffice to keep you afloat.</para> + <para>The more ambitious ones out there will need more space, much more maybe. Think of buying a file server, Giga-Ethernet comes integrated into motherboards today and it's a flick to fetch the files over the local network. Speaking about modern mobos: they now have external SATA connectors. This makes it really a trifle to buy an external SATA drive and hook it up to your machine. 1000 GB drives will hit the market this year (2008). These are terrific compact storage containers for backup swapping: keep one drive at home and one somewhere else.</para> + </sect3> + + <sect3 id="backup"> <title>Back it up, backup, backup, recover!</title> + <para>A 750GB HD costs €100 today. Do not blame anybody else for data loss! 6% of all PCs will suffer an episode of data loss in any given year. Backup your data often according to a plan, and back it up and test the backup before you do anything dramatic like re-installing your OS, changing disks, resizing partitions and so on.</para> + + <sect4> <title>Disaster prevention</title> + <para>Say, you religiously do your backups every day on a external SATA drive. Then comes the day where lightning strikes. Happy you if the external drive was not connected at that moment!</para> + <para>Disasters strike locally and destroy a lot. Forget about airplane crashes: fire, water, electricity, kids and theft are dangerous enough to our data. They usually cover a whole room or house. </para> + <para>Therefore disaster control means de-localized storage. Move your backups upstairs, next house, to your bureau (and vise versa), whatever.</para> + <para>There is another good aspect to the physical separation: as said above, panic is often the cause of destroying data, even the backup data. Having a backup not at hand right away may safe your ass one day.</para> + </sect4> + <sect4> <title>Some backup technicalities explained for laymen.</title> +<itemizedlist> + <listitem><para>Full Backup: A complete backup of all the files being backed up. It is a snapshot without history, it represents a full copy at one point in time. </para></listitem> + <listitem><para>Differential Backup: A backup of only the files that have changed since the last full backup. Constitutes a full snapshot of two points in time: the full backup and the last differential one.</para></listitem> + <listitem><para>Incremental Backup: A backup of only the files that have changed since last whatever backup. Constitutes multiple snapshots. You can recreate the original state at any point in time such a backup was made. This comes closest to a versioning system except that it's is only sampled and not continuous.</para></listitem> +</itemizedlist> + </sect4> + <sect4> <title>Best practice: The IT-layman's backup cookbook</title> +<orderedlist> + <listitem><para>do a full backup in a external storage device.</para></listitem> + <listitem><para>verify its data integrity and put it away (disaster control)</para></listitem> + <listitem><para>have another storage device for frequent backups</para></listitem> + <listitem><para>swap the devices every other month after having verified data integrity</para></listitem> +</orderedlist> + </sect4> + <sect4> <title>A useful rsync recipe to backups</title> + <para>Rsync is a wonderful little utility that's amazingly easy to set up on your machines. Rather than have a scripted FTP session, or some other form of file transfer script - rsync copies only the differences of files that have actually changed, compressed and through ssh if you want to for security. That's a mouthful.</para> + <para>A reasonable backup approach for images could be this one:</para> +<orderedlist> + <listitem><para>backup important images right away (after dumping them to a computer) to DVD/optical media</para></listitem> + <listitem><para>do daily incremental backup of the work space</para></listitem> + <listitem><para>do a weekly differential backup and delete integral backups of week-2 (two weeks ago)</para></listitem> + <listitem><para>do a monthly differential backup and delete backup of month-2</para></listitem> + <listitem><para>if not physically separated already, separate it now (swapping-in another backup drive)</para></listitem> +</orderedlist> + <para>This protocol tries to leave you enough time to spot losses and to recover fully at the same time keeping the backup volume at <130% of the working space. You end up with a daily version of the last 7-14 days, a weekly snapshot for at least one month, and a snapshot of every month. Any more thinning should be done by hand after a full verification.</para> + <para>script to follow....TBD</para> + <para>For German speaking *nix users: <ulink url="http://www.heinlein-support.de/web/rsync-backup/"> link</ulink></para> + </sect4> + </sect3> + + <sect3 id="technology-review"> <title>Preserve your images through the changes of technology and owners</title> + <para>Themes: metadata, IPTC stored in image files, XMP files associated, keep the originals, storage, scalability, media, retrieval of images and metadata, copying image data over to the next generation of media, applications, operating systems, virtualization, viewing device... use of the www.</para> + <para>In order for your valuable images to survive the next 40 years or so (because that's about the time that you will become really interested to revisit those nice old photographs of you as a child, adolescent etc.) there are two strategies to be observed:</para> + <orderedlist> + <listitem><para>Keep up with technology, don't lag behind more than a couple of years.</para></listitem> + <listitem><para>Save your photos in an open, non-proprietary standard.</para></listitem> + </orderedlist> + + <sect4> <title>How to keep up with technology?</title> + <para>As the future is unforeseeable by nature, everything said today is to be taken with caution, and to be reviewed as we advance. Unfortunately there is no shortcut possible to some basic vigilance. Every 5-8 years at least one should ask oneself the question of backwards compatibility of current systems. The less variants we used in the past the less questions are to be answered in the future. </para> + <para>Of course every time you change your computer system (machine, operating system, applications, DRM) you have to ask yourself the same questions. Today, if you want to switch to Windows Vista, you have to ask yourself three times if you still can import your pictures, and, more important so, if you are ever able to move them onto some other system or machine. Chances are good that you can't. I see many people struggling around me, because Vista enforces a strict DRM regime. How can you proof to Vista that you are actually the owner of your pictures copyright?</para> + <para>Basically the questions should be answered along the line explained in this document: use and change to open standards supported by a manifold of applications.</para> + <para>Virtualization becomes available now for everybody. So if you have an old system that is important for reading your images, keep it, install it as a virtual machine for later.</para> + <para>Otherwise the advice is quite simple: every time you change your computer architecture, your storage and backup technology, your file format, check it out, go through your library and convert to a newer standard if necessary. And keep to open standards.</para> + </sect4> + + <sect4> <title>Scalability</title> + <para>Scalability is the tech-geek expression of the (easy) capability of a system to be resized, which always means up-sized. </para> + <para>EMVS /LVM Todo</para> + <para>Lets assume you planned for scalability and dedicated the container you want to increase to a separate disk or partition. On *nix systems like &Linux; you then can copy an resize the container to the new disk:</para> + <para>Check with dmesg if your new disk is recognized b the system, but don't mount it.</para> +<blockquote><screen> +$ dd if=/dev/sdb[#] of=/dev/sdc # source is /dev/sdb, new disk is /dev/sdc +$ parted resize /dev/sdc1 0 <disk size in MB> # works on ext2,3, fat16, 32 and reiserfs +$ resize2fs /dev/sadc1 #resize_reiserfs in case +</screen></blockquote> + <para>Todo</para> + </sect4> + + <sect4> <title>Use open, non-proprietary standards as file formats</title> + <para>The short history of the digital era in the past 20 years has proven over and over again that proprietary formats are not the way to go when you want your data to be intelligible 10 years into the future. Microsoft is certainly the well known culprit of that sort because of its domineering market share. But other companies are actually (if inadvertently) worse since they may not stay long enough in the market at all or have a small user/contributor base only. In the case of Microsoft one has at least the advantage of many people sharing the same problems. Finding a solution has therefore much more success. Still, in some cases Microsoft is using Open Source documentation to understand their own systems, so badly maintained have been their own documentation. Usually with any given MSoffice suite one cannot properly read a document created with the same application two major versions earlier.</para> + <para>Image formats have had a longer live time than office documents and are a bit less affected by obsolescence.</para> + <para>Open Source standards have the huge advantage of having an open specification. Even if one day in the future there'll be no software to read it anymore, one can recreate such software, a task becoming simpler every year.</para> + <para><command>JPEG</command> has been around for a while now, and whilst it's a lossy format losing a bit every time you make a modification and save it, it is ubiquitous, supports JFIF, EXIF, IPTC and XMP metadata, has good compression ratios and can be read by all imaging software. Because of its metadata limitation, lossy nature, absence of transparency and 8 bit color channel depth, we do not recommend it. JPEG2000 is better, can be employed lossless, but lacks in user base.</para> + <para><command>GIF</command> is a proprietary. patented format and slowly disappearing from the market. Don't use it.</para> + <para><command>PNG</command> has been invented as a Open Source standard to replace GIF, but it does much more. It is lossless, supports XMP, EXIF and IPTC metadata, 16 bit color encoding and full transparency. PNG can store gamma and chromaticity data for improved color matching on heterogeneous platforms. Its drawback are a relatively big footprints (but smaller than TIFF) and slow compression. We recommend it.</para> + <para><command>TIFF</command> has been widely accepted as an image format. TIFF can exist in uncompressed form or in a container using a lossless compression algorithm (Deflate). It maintains high image quality but at the expense of much larger file sizes. Some cameras let you save your images in this format. The problem is that the format has been altered by so many people that there are now 50 or more flavors and not all are recognizable by all applications.</para> + <para><command>RAW</command> format. Some, typically more expensive, cameras support RAW format shooting. The RAW format is not really an image standard at all, it is a container format which is different for every brand and camera model. RAW format images contain minimally processed data from the image sensor of a digital camera or image scanner. Raw image files are sometimes called digital negatives, as they fulfill the same role as film negatives in traditional chemical photography: that is, the negative is not directly usable as an image, but has all of the information needed to create an image. Storing photographs in a camera's RAW format provides for higher dynamic range and allows you to alter settings, such as white balance, after the photograph has been taken. Most professional photographers use RAW format, because it offers them maximum flexibility. The downside is that RAW image files can be very large indeed.</para> + <para>My recommendation is clearly to <command>abstain from archiving in RAW format</command> (as opposed to shooting in RAW format, which I recommend). It has all bad ingredients: many varieties and proprietary nature. It is clear that in a few years time you can't use your old RAW files anymore. If already seen people changing camera, losing their color profiles and having great difficulty to treat their old RAW files correctly. Better change to DNG format!</para> + <para><command>DNG</command> Digital Negative file format is a royalty free and open RAW image format designed by Adobe Systems. DNG was a response to demand for a unifying camera raw file format. It is based on the TIFF/EP format, and mandates use of metadata. An handful of camera manufacturers have adopted DNG already, let's hope that the main contenders Canon and Nikon will use it one day.</para> + <para>I strongly recommend converting RAW files to DNG for archiving. Despite the fact that DNG was created by Adobe, it is an open standard and widely embraced by the Open Source community (which is usually a good indicator of perennial properties). Some manufacturers have already adopted DNG as RAW format. And last not least, Adobe is the most important source of graphical software today, and they of course support their own invention. It is an ideal archival format, the raw sensor data will be preserved as such in TIFF format inside DNG, so that the risk associated with proprietary RAW formats is alleviated. All of this make migration to another operating system a no-brainer. In the near future we'll see 'non-destructive editing', where files are not changed anymore but rather all editing steps will be recorded (into the DNG as it where). When you open such a file again, the editing script will be replayed. This takes computation power, but it is promising as it leaves the original intact. </para> + <para><command>XML</command> (Extensible Mark-up Language) or <command>RDF</command> (Resource Description Framework). XML is like HTML, but where HTML is mostly concerned with the presentation of data, XML is concerned with the "representation" of data. On top of that, XML is non-proprietary, operating-system-independent, fairly simple to interpret, text-based and cheap. RDF is the WC3's solution to integrate a variety of different applications such as library catalogs, world-wide directories, news feeds, software, as well as collections of music, images, and events using XML as an interchange syntax. Together the specifications provide a method that uses a lightweight ontology based on the Dublin Core which also supports the "Semantic Web" (easy exchange of knowledge on the Web).</para> + + <para>IPTC goes XMP</para> + <para>That's probably one of the reasons why, around 2001, that Adobe introduced its XML based XMP technology to replace the "Image resource block" technology of the nineties. XMP stands for"Extensible Metadata Platform", a mixture of XML and RDF. It is a labeling technology that lets users embed data about a file in the file itself, the file info is saved using the extension".xmp" (signifying the use of XML/RDF). </para> + <para><command>XMP</command>. As much as ODF will be readable forever (since its containing text is written in clear text), XMP will preserve your metadata in a clearly understandable format XML. No danger here of not being able to read it later. It can be embedded into the image files or as a separate accompanying file (sidecar concept). XMP can be used in PDF, JPEG, JPEG2000, GIF, PNG, HTML, TIFF, Adobe Illustrator, PSD, PostScript, and Encapsulated PostScript. In a typical edited JPEG file, XMP information is typically included alongside Exif and IPTC data.</para> + <para>Embedding metadata in files allows easy sharing and transfer of files across products, vendors, platforms, customers, without metadata getting lost. The most common metadata tags recorded in XMP data are those from the Dublin Core Metadata Initiative, which include things like title, description, creator, and so on. The standard is designed to be extensible, allowing users to add their own custom types of metadata into the XMP data. XMP generally does not allow binary data types to be embedded. This means that any binary data one wants to carry in XMP, such as thumbnail images, must be encoded in some XML-friendly format, such as Base64.</para> + <para>Many photographers prefer keeping an original of their shots (mostly RAW) for the archive. XMP suits that approach as it keeps metadata separate from the image file. I do not share this point of view. There could be problems linking metadata file and image file, and as said above, RAW formats will become obsolete. I recommend using DNG as a container and putting everything inside.</para> + <para><ulink url="http://dublincore.org/">The Dublin Core Metadata Initiative</ulink> is an open organization engaged in the development of interoperable online metadata standards that support a broad range of purposes and business models. DCMI's activities include work on architecture and modeling, discussions and collaborative work in DCMI Communities and DCMI Task Groups, annual conferences and workshops, standards liaison, and educational efforts to promote widespread acceptance of metadata standards and practices.</para> + </sect4> + </sect3> + + <sect3 id="best-practice"> <title>Best practice: Data protection</title> + <itemizedlist> + <listitem><para>Use surge protectors (UL 1449 standard), possibly combined with a UPS</para></listitem> + <listitem><para>use ECC memory to verify correct data transmission (even just saving files)</para></listitem> + <listitem><para>watch your hard drives (temperature, noise...), make backups</para></listitem> + <listitem><para>Keep backups at another location, locked up, use web storage space</para></listitem> + <listitem><para>use archival media and burners</para></listitem> + <listitem><para>Don't panic in case of data loss, explain your recovery plan to a layperson</para></listitem> + <listitem><para>choose you file system, partitions, folders to cater for easy scalability</para></listitem> + <listitem><para>Use open, non-proprietary standards to manage and save photographs</para></listitem> + <listitem><para>Do a technology/migration review at least every 5 years</para></listitem> + </itemizedlist> + </sect3> + + </sect2> + + <sect2 id="dam-workflow"> <title>A typical DAM workflow with &digikam;</title> + <orderedlist> + <listitem><para>import images from camera, card reader or scanner. As long as the images are stored on the camera media, you can use that as temporary backup.</para></listitem> + <listitem><para>RAW are converted to DNG and stored away into an RAW archive (not yet implemented)</para></listitem> + <listitem><para>rate and cull, write-back metadata to the DNG archive</para></listitem> + <listitem><para>make a backup e.g. on DVD, optical drive or tape</para></listitem> + <listitem><para>tag, comment, geo-locate</para></listitem> + <listitem><para>edit and improve photographs</para></listitem> + <listitem><para>For layered editing use external applications. Back in &digikam;, re-apply the metadata, which was probably lost or curtailed by the other applications.</para></listitem> + <listitem><para>run the routine backup with following data-integrity checks</para></listitem> + <listitem><para>protect processed images for copyrights with Digital Watermarking. Export to web galleries, slide shows, MPEG encode, contact sheets, printing etc.</para></listitem> + </orderedlist> + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;DAM-Workflow.png" format="PNG"/></imageobject> + <textobject> <phrase>Workflow</phrase> </textobject> + </inlinemediaobject> + </para> + + </sect2> + + + </sect1> + + <sect1 id="using-camera"> <title>Using a Digital Camera With &digikam;</title> + <anchor id="camerainterface.anchor"/> + + <sect2> <title>Introduction to Camera Interface</title> + + <para> + The Camera Tool allows you to download your photographs directly from your camera into a &digikam; Album. You can access the Camera Tool by clicking on the Camera menu and selecting from the list of configured cameras. See the <link linkend="setup-camera">Setup Camera Section</link> of the manual for instructions on how to setup &digikam; to work with your camera. If you want to have more information about how &digikam; supports digital cameras, please a take a look at <link linkend="using-camerasupport">this section</link>. + </para> + + <para> + The Camera Interface is not the only way to get your photographs into &digikam;. See the <link linkend="using-addphototoalbum">Adding a photograph to an Album</link> section for a description of how to add photographs that are already on your hard disk. But Camera Interface provides a lots of advanced settings to import images into your albums database. + </para> + + <para> + To be able to use your digital camera with &digikam;, connect the camera to your computer, switch the camera to the image display mode and turn it on. See you camera's user manual if you need more information. + </para> + + <para> + When you start the Camera Interface, it will try to connect to the Camera. For some cameras this connection phase can take a little while. When connected, a <guilabel>Ready</guilabel> indicator will appear on the bottom and thumbnails of any photographs on the camera will be displayed. Some cameras cannot provide thumbnails of the photographs. If this is the case, you will only see the filenames and a mime-type icon for each item stored by your camera (photograph, movies, sounds, etc). + </para> + + <example> <title>The Camera Client Window</title> + <screenshot><screeninfo>The Camera Client Window</screeninfo> <mediaobject><imageobject><imagedata fileref="&path;cameraclient.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </sect2> + + <sect2> + <title>Getting information about photographs from the Camera</title> + + <para> + Before downloading photographs to your computer, you may wish to see camera item information. Using the + <menuchoice><guimenuitem>Properties</guimenuitem></menuchoice> and <menuchoice><guimenuitem>Metadata</guimenuitem></menuchoice> side bar tabs from Camera Interface will launch camera item properties and metadata information. + </para> + + <example> <title>The Camera Item Properties Sidebar Tab</title> + <screenshot><screeninfo>The camera item properties sidebar Tab</screeninfo><mediaobject><imageobject><imagedata fileref="&path;cameraclientitemproperties.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + The Properties tab displays file information recorded by the camera and a resume of photographer information to describe how the image has been taken. A flag indicates if the image has not yet been downloaded to the computer. Note, all this information may be unavailable with some digital cameras. + </para> + + <para> + The Metadata tab displays an internal picture's metadata like EXIF, Makernotes, GPS, &etc;. This information is the same as <link linkend="using-sidebarmetadata">sidebar Meta-Data</link> from the &digikam; main interface or image editor. Note, all these metadata can be unavailable with some digital cameras. + </para> + + </sect2> + + <sect2> + <title>Downloading photographs to your computer</title> + + <para> + The simplest way to download photographs from your camera to your computer is to click the <guilabel>Download</guilabel> button and then click <guilabel>Download All</guilabel>. This will download all of the photographs on the camera to a single Album in &digikam;. The download process will not remove the photographs from the camera. It is always advisable to check that the photographs have downloaded safely into the Album you were expecting before deleting them from the camera. + </para> + + <para> + If you do not want to download all of the photographs you can select just those that you need using the standard &kde; selection methods. Once you have the photographs selected, click <guilabel>Download</guilabel> and then <guilabel>Download Selected</guilabel>. The <guilabel>Download Selected</guilabel> button will be grayed out until you have selected some photographs. + </para> + + <note><para> + If supported by your camera an option <guilabel>Download new</guilabel> is available. Those are images not yet downloaded by &digikam;. In that case the new images are already marked with a star in the thumbnail window. Obviously if you choose this handy option, it will download the new images only. + </para></note> + + </sect2> + + <sect2> + <title>Selecting a Target Album</title> + <anchor id="targetalbumdialog.anchor"/> + + <para> + Using <guilabel>Download All</guilabel> or <guilabel>Download Selected</guilabel> buttons will bring up a dialog, that allows you to select a target Album into which the photographs will be downloaded. The list of existing Albums is displayed, ordered by the Folder method (see the <link linkend="using-myalbumsview">Albums View</link> for details of Album ordering). You can select the target Album from this list and then click OK. + </para> + + <example> <title>The Target Album Selection Dialog</title> + <screenshot><screeninfo>The Target Album Selection Dialog</screeninfo><mediaobject><imageobject><imagedata fileref="&path;cameratargetalbumdialog.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + If you want to create a new Album, into which you could download the photographs, click the <guilabel>New Album</guilabel> button. The new Album will be created as a sub-folder of the Album that is currently selected in the existing Album list. This means that, if you do not want your new Album to be a sub-folder of an existing folder, you must first select the "My Albums" entry from the very top of the existing Albums list before creating a new Album. + </para> + + <para> + When you have selected the target Album, click OK and &digikam; will download the photographs from the camera to that album. + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;cameraclientdownload.png" format="PNG" /> </imageobject><textobject><phrase>The Downloading in Progress</phrase></textobject></inlinemediaobject> + </para> + + </sect2> + + <sect2> + <title>Deleting photographs from the camera</title> + + <para> + Once you are happy with the downloaded photographs that you wanted, you are ready to delete photographs from the Camera. You can delete all of the photographs at once by clicking the + <menuchoice> + <guimenu>Delete</guimenu> + <guimenuitem>Delete All</guimenuitem> + </menuchoice> + button. If you just want to delete a selection of the photographs, you have to select those that you want to delete and click + <menuchoice><guimenu>Delete</guimenu> + <guimenuitem>Delete Selected</guimenuitem></menuchoice> + </para> + + <caution><para> + Please note that there is no way to restore a photo that you have deleted from the camera. The photographs are not moved to the &kde; Trash Can, they are removed completely. It is best to double check that you have successfully downloaded a photograph into a &digikam; Album before you delete it from the camera. Anyway, if you plan to empty the camera card, you better do that from the camera menu because it is much quicker. + </para></caution> + + </sect2> + + <sect2 id="using-cameraclientrenaming"> + <title>Automatic Renaming</title> + + <para> + Cameras often do not use very meaningful filenames for photographs. The filenames are usually reused once the photographs have been deleted from the camera. This can lead to filename clashes if you download photographs from many shootings into the same Album. It can also be useful to include the date and time that a image was taken into the filename. + </para> + + <example> <title>Files Renaming Options</title> + <screenshot><screeninfo>Files Renaming Options</screeninfo><mediaobject><imageobject><imagedata fileref="&path;cameraclientsetting1.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + &digikam; can automatically rename your photographs using the date and time information included by the camera in the photograph. To use this feature, click the <guilabel>Settings</guilabel> button on the Camera Interface. The Camera Interface window will expand to reveal some extra features. Select <guilabel>Customize</guilabel> and then enter any filename prefix you would like. As an option you can then add the date & time, a sequence number or a combination of both. The sequence number may be needed if you have a camera with a very fast multi-shoot mode where it is possible to get two photographs with exactly the same data and time. + </para> + <para> + In the next box you find the options for rotating/flipping the image and for date based subalbums. If you check the latter option, folder per day will be automatically generated. + </para> + <para> + The 'On the fly operations' open three more options that act on the photos before storing them on disk. The first two relate to the authors data in <link linkend="author-identity">Default Author Identity</link>" Settings. If checked, the respective items will be copied into the EXIF tags and IPTC fields. The last option allows a date & time for all downloaded photographs to be set. + </para> + + <tip> + <para> + <itemizedlist> + + <listitem><para>If you want another date format then the default date format, you could fill in for example: <userinput>photo-%Y-%m-%d %H:%M:%S</userinput> in the prefix edit line (turn off <guilabel>Add camera provided date and time</guilabel>). For additional customization read the man page of strftime.</para></listitem> + + <listitem><para>When you select <guilabel>Use camera provided names</guilabel>, you have the option to change the filenames to lowercase when downloading. Or use uppercase if you prefer.</para></listitem> + + </itemizedlist> + </para> + </tip> + + <para> + The new filename that &digikam; will use for the photographs when they are downloaded is shown underneath the name provided by the camera in the thumbnail view. The renaming settings will be remembered the next time you use the camera interface. + </para> + + </sect2> + + <sect2> + <title>Camera Information Based Operations</title> + + <sect3> + <title>Automatic Rotation</title> + + <para> + &digikam; can use any information about the orientation of the camera at the moment the photograph was taken for automatic rotation of the photograph when it is downloaded. Not all cameras include this information. See the <link linkend="using-sidebarmetadata">sidebar Meta-Data</link> section for more detail about information that your camera may have embedded in your photographs. + </para> + + <example> <title>On the fly Operations Options</title> + <screenshot><screeninfo>On the fly Operations Options</screeninfo><mediaobject><imageobject><imagedata fileref="&path;cameraclientsetting3.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + This automatic rotation is switched on by default, and if your camera does not include the information, &digikam; will leave the photograph at its original orientation. If you would like to switch the automatic rotation off, click the <guilabel>Advanced</guilabel> button and deselect the <guilabel>Auto Orient</guilabel> option at the bottom of the window. + </para> + + </sect3> + + <sect3> + <title>Automatic Destination Albums Creation</title> + + <para> + If your camera provides information about the date of the photograph's taking, &digikam; can use this to automatically create subalbums in the destination Album when it is downloaded. Subalbums names will be based on image dates. All images which have the same date will be downloaded into the same subalbum. Not all cameras include this information. + See the <link linkend="using-sidebarmetadata"> + sidebar Meta-Data</link> section for more detail about + information your camera may have embedded in your photographs. + </para> + + <example> <title>Albums Auto-creation Options</title> + <screenshot><screeninfo>Albums Auto-creation Options</screeninfo><mediaobject><imageobject><imagedata fileref="&path;cameraclientsetting2.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + This option is switched off by default and in this case &digikam; will download the photographs + in the root destination Albums. If you would like to switch on this option click the + <guilabel>Advanced</guilabel> button and select the <guilabel>Download photo in automatically</guilabel> + option at the bottom of the window. + </para> + + </sect3> + + </sect2> + + <sect2> + <title>Uploading Photographs to your camera</title> + + <para> + The simplest way to upload photographs from your computer to your camera is to click the <guilabel>Download</guilabel> button and then click <guilabel>Upload</guilabel>. A standard &kde; file selection dialog will appear to select the files from your computer to copying on your camera. You can select more than one file using the standard &kde; selection methods. + </para> + + <para> + When images selection is done, &digikam; will ask you where you want to upload the files on your camera. A camera folder selection dialog will appear. Just select one folder and press OK to start uploading. No images will be removed from your computer. + </para> + + <example> <title>The Camera Folder Selection Dialog</title> + <screenshot><screeninfo>The Camera Folder Selection Dialog</screeninfo><mediaobject><imageobject><imagedata fileref="&path;camerafolderselectiondialog.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <note><para> + Uploading feature is not supported by all camera drivers. + </para></note> + + </sect2> + + <sect2 id="using-gps"> + <title>How to use a GPS device with &digikam;</title> + <note><para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;handheld_gps.png" format="PNG"/></imageobject> + </inlinemediaobject>GPS (global positioning system) is used as a generic term throughout this document. It just means a location in latitude and longitude global coordinates that can be displayed on a map. The actual technical implementation that provides the data can be the American GPS, the Russian GLONAS, the European GALILEO or any other system. + </para></note> + + <para> + Not only for professional photographers can it be interesting to link an image to a precise geographical location. Not everybody uses an airplane to overfly and scan a certain area with automatic GPS data recording. Environmental planners, military, police, construction bureaus, real estate agencies, all will have an immediate application. + </para> + <para> + But if, after some time, one has forgotten where the image was taken, if one loves the nice feature to open with a simple click a browser displaying a zoom of the area, if you like to send your image as a postcard to another &digikam; user (who is then able to locate your shot), or if you simply need the documentation aspect of it - having position data stored in a photo is great. + </para> + <para> + Now, how do we get GPS data into the images? <ulink url="http://www.exiv2.org/tags.html">exiv2</ulink> supports many kinds of the GPS data fields, even bearing, satellite and map references. So the question is really how to get the data into those fields? There are at least three ways to do this: directly with the appropriate hardware, per post-treatment of GPS and image files using the <ulink url="http://www.kipi-plugins.org">Geolocation</ulink> (<ulink url="help:/kipi-plugins/geolocalization.html">Manual</ulink>) Kipi-plugin and per 'manual' insertion of known locations. + </para> + <itemizedlist> + + <listitem><para>Direct GPS data insertion into the image files</para> + <para> + To our knowledge there is at the time of writing no camera that integrates a GPS unit. But there are a few that combine with GPS receivers, either as a plug-in card or by data transmission through cable or Bluetooth. + </para> + <para><ulink url="http://www.engadget.com.nyud.net:8090/2004/09/17/diy-black-box-tagging-photos-with-gps-coordinates/">Selfmade Howto</ulink> + </para> + <para>Cameras with GPS interface: + <ulink url="http://www.lupinelogic.com/products/coyoteye.html">CoyoteEye iPAQ</ulink> + <ulink url="http://www.survey-lab.com/">Ike</ulink> + <ulink url="http://www.kodak.com/global/en/service/professional/tib/tib7061.jhtml?id=0.1.14.34.3.110&lc=en">Kodak DCS Pro</ulink> + <ulink url="http://nikonimaging.com/global/products/digitalcamera/index.htm">Nikon DSLR</ulink> + <ulink url="http://www.geospatialexperts.com/ricoh.html">Ricoh Pro G3</ulink> <ulink url="http://digitalcameras.engadget.com/2004/04/30/gps-attachment-for-sony-digital-camcorders/">Sony</ulink> + </para> + </listitem> + + <listitem><para>Post-treatment of GPS data and image files</para> + <para> + Using the <ulink url="http://www.kipi-plugins.org">Geolocation</ulink> Kipi-plugin (<ulink url="help:/kipi-plugins/geolocalization.html">Manual</ulink> if Kipi-plugins are already installed). + </para> + <para> + This approach is dead easy: while taking your pictures just keep a GPS device running and carry it around with the camera. Once you are done, download the pictures and the GPS tracks, and run the above plugin. It will correlate the data in the time domain; so it is important that the camera be accurate in its clock setting (the GPS device is always accurate through the satellites). The positional accuracy interpolated from the track points can be as good as 20 meters. Of course, this approach only works if your camera can record EXIF data. + </para> + <para>The GPS track download from a device can be managed with the <ulink url="http://www.ncc.up.pt/gpsman">gpsman</ulink> or <ulink url="http://www.gpsbabel.org">gpsbabel</ulink>. It is important that the downloaded tracks are being stored in gpx format, which is the only one compatible with the Geolocation plugin. + </para> + <para> + Several programs exist for &Windows; and MacOS that are able to extract and correlate data from images and GPS data tracks. The following site provides the same functionality for &Linux;: + <ulink url="http://freefoote.dview.net/linux_gpscorr.html">gpsCorr</ulink> or + <ulink url="http://www.carto.net/projects/photoTools/gpsPhoto/">gpsPhoto</ulink> + </para> + </listitem> + + <listitem> + <para>'Manual' insertion of known locations</para> + <para>If you happen to know the latitude/longitude or other data you can use the this script which is a GPS wrapper for Phil Harvey's <ulink url="http://www.sno.phy.queensu.ca/~phil/exiftool">ExifTool</ulink> that uses the signed floating number coordinate notation as produced by maps.google. + </para> + <tip><para> + maps.google.com does not show the street maps of Europe. But there are European sites (.fr .de .es .it .co .uk at least) that show all navigation details in all of Europe. + </para></tip> + </listitem> + + </itemizedlist> + + <para> + GPS devices: + <ulink url="http://www.letsgodigital.org/en/9323/sony_gps_photography/">GPS tracker from Sony </ulink> and + <ulink url="http://photofinder.atpinc.com/">ATP Fotofinder GPS tracker</ulink> + <ulink url="http://www.emtac.com/products/bluetooth/index.html#btgps">EMTAC bluetooth GPS </ulink> + </para> + </sect2> + </sect1> + + <sect1 id="using-setup"> <title>&digikam; Configuration</title> + + <sect2 id="setupdialog"> <title>The Setup Section</title> + + <anchor id="setupdialog.anchor"/> + + <para> + &digikam; tries to give you as much control over how it works as possible. There are many options that change the behavior of &digikam;. To access these settings select + <menuchoice><guimenu>Setting</guimenu> + <guimenuitem>Configure &digikam;</guimenuitem></menuchoice> from the menubar. The configuration dialog is separated into 15 pages. You can change between these pages by clicking on the icons on the left-hand side of the dialog. + </para> + + <itemizedlist> + <listitem><para><link linkend="setup-album">Album Settings</link></para></listitem> + <listitem><para><link linkend="setup-collection">Collection Settings</link></para></listitem> + <listitem><para><link linkend="author-identity">Default Author Identity</link></para></listitem> + <listitem><para><link linkend="setup-embeddedinfo">Metadata (embedded information)</link></para></listitem> + <listitem><para><link linkend="setup-tooltip">Tooltip Settings</link></para></listitem> + <listitem><para><link linkend="setup-mimetype">Mime Type Settings</link></para></listitem> + <listitem><para><link linkend="setup-lighttable">Light Table Settings</link></para></listitem> + <listitem><para><link linkend="setup-editor">Image Editor Settings</link></para></listitem> + <listitem><para><link linkend="setup-saveimages">Save Image Options</link></para></listitem> + <listitem><para><link linkend="setup-raw-decoder">RAW Decoder Settings</link></para></listitem> + <listitem><para><link linkend="setup-iccprofiles">ICC Profiles setup</link></para></listitem> + <listitem><para><link linkend="setup-kipiplugins">Kipi Plugins Settings</link></para></listitem> + <listitem><para><link linkend="setup-slideshow">Slide show settings</link></para></listitem> + <listitem><para><link linkend="setup-camera">Camera Interface Settings</link></para></listitem> + <listitem><para><link linkend="setup-miscellaneous">Miscellaneous Settings</link></para></listitem> + </itemizedlist> + + <sect3 id="setup-album"> <title>Album Settings</title> + + <para> + The Album settings control how the main application will behave. + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupalbum.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + <para> + The <guilabel>Album Library Path</guilabel> is the location on your hard disk where &digikam; will store all of the Albums. If you change this location without manually moving all of the Albums on the hard disk, &digikam; assumes that there are no existing Albums and will generate a new database at the new location. Your old Albums will not be altered but you will need to change the Album Library Path back to the old location to access them. If you are not sure of what you are doing it is best not to change this location. + </para> + + <para> + The <guilabel>Thumbnails</guilabel> options are described in the <link linkend="using-imageview">Images</link> section. + </para> + + <para> + The <guilabel>Click action</guilabel> can be set to <guilabel>Show embedded preview</guilabel> or <guilabel>Start image editor</guilabel>. You herewith define the default behavior of &digikam; when you click on an image item in the main view. + </para> + + </sect3> + + <sect3 id="setup-collection"> <title>Collection Settings</title> + + <para> + This dialog manages your Collection types. Album Collections are described in detail in the <link linkend="using-myalbumsview">Albums</link> section. + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupcollections.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + </sect3> + + <sect3 id="author-identity"> <title>Default Author Identity for IPTC</title> + + <para> + This page contains the default identity and copyright data as shown on the printscreen below. The data will be automatically written into the respective IPTC data fields if so selected during the download from the <link linkend="using-cameraclientrenaming">camera interface</link>. Also, if you call for database synchronisation, this data will be written into the IPTC fields. + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;cameraclientidentity.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + <para>This is an extract of the IPTC specifications:</para> + <itemizedlist> + <listitem><para> + <emphasis>Author</emphasis> (is synonymous to <emphasis>Creator</emphasis> and <emphasis>By-line</emphasis>): This field should contain your name, or the name of the person who created the photograph. If it is not appropriate to add the name of the photographer (for example, if the identify of the photographer needs to be protected) the name of a company or organization can also be used. Once saved, this field should not be changed by anyone. This field does not support the use of commas or semi-colons as separator. + </para></listitem> + + <listitem><para> + <emphasis>Author title</emphasis> (synonymous with <emphasis>By-line title</emphasis>): This field should contain the job title of the photographer. Examples might include titles such as: Staff Photographer, Freelance Photographer, or Independent Commercial Photographer. Since this is a qualifier for the Author field, the Author field must also be filled out. + </para></listitem> + + <listitem><para> + <emphasis>Credit</emphasis> (synonymous with Provider): Use the credit field to identify who is providing the photograph. This does not necessarily have to be the author. If a photographer is working for a news agency such as Reuters or the Associated Press, these organizations could be listed here as they are "providing" the image for use by others. If the image is a stock photograph, then the group (agency) involved in supplying the image should be listed here. + </para></listitem> + + <listitem><para> + <emphasis>Source</emphasis>: The Source field should be used to identify the original owner or copyright holder of the photograph. The value of this field should never be changed after the information is entered following the image's creation. While not yet enforced by the custom panels, you should consider this to be a "write-once" field. The source could be an individual, an agency, or a member of an agency. To aid in later searches, it is suggested to separate any slashes "/" with a blank space. Use the form "photographer / agency" rather than "photographer/agency." Source may also be different from Creator and from the names listed in the Copyright Notice. + </para></listitem> + + <listitem><para> + <emphasis>Copyright Notice</emphasis>: The Copyright Notice should contain any necessary copyright notice for claiming the intellectual property, and should identify the current owner(s) of the copyright for the photograph. Usually, this would be the photographer, but if the image was done by an employee or as work-for-hire, then the agency or company should be listed. Use the form appropriate to your country. For the United States you would typically follow the form of © {date of first publication} name of copyright owner, as in "©2005 John Doe." Note, the word "copyright" or the abbreviation "copr" may be used in place of the © symbol. In some foreign countries only the copyright symbol is recognized and the abbreviation does not work. Furthermore the copyright symbol must be a full circle with a "c" inside; using something like (c) where the parentheses form a partial circle is not sufficient. For additional protection worldwide, use of the phrase, "all rights reserved" following the notice above is encouraged. In Europe you would use: Copyright {Year} {Copyright owner}, all rights reserved. In Japan, for maximum protection, the following three items should appear in the copyright field of the IPTC Core: (a) the word, Copyright; (b) year of the first publication; and (c) name of the author. You may also wish to include the phrase "all rights reserved." + </para></listitem> + </itemizedlist> + + </sect3> + + <sect3 id="setup-embeddedinfo"> <title>Metadata (embedded information settings)</title> + + <para> + Image files can have some meta-data embedded into the image file format. This meta-data can be stored in a number of standard formats. &digikam; can read meta-data in the EXIF format if it is present in the file. &digikam; can also write captions into the <ulink url="http://www.exif.org">EXIF information</ulink>. Writing captions to the EXIF section is limited to JPEG images for now (the exiv2 library is in development and will be extended to PNG and TIFF format metadata embedding in the near future). + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupembeddedinfo.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + <para> + These settings allow you to control how &digikam; will deal with this embedded information. + </para> + + <para> + <guilabel>Show images/thumbs rotated according to EXIF tag</guilabel> : this will use any orientation information that your camera has included in the EXIF information to automatically rotate your photographs so that they are the correct way up when displayed. It will not actually rotate the image file, only the display of the image on the screen. If you want to permanently rotate the image on file, you can right-click on the thumbnail and select <guilabel>Auto-rotate/flip according to EXIF orientation</guilabel>. The image will then be rotated on disk and the tag will be reset to "normal". If your camera routinely gets this orientation information wrong you might like to switch this feature off. + </para> + + <para> + <guilabel>Set EXIF Orientation Tag to Normal after rotate/flip</guilabel> : the Auto Rotate option automatically corrects the orientation of images taken with digital cameras that have an orientation sensor. The camera adds an orientation tag to the image's EXIF meta-data. &digikam; can read this tag to adjust the image accordingly. If you manually rotate an image, this meta-data will be incorrect. This option will set the orientation tag to "Normal" after an adjustment, assuming that you rotated it to the correct orientation. Switch this off if you don't want &digikam; to make changes to the orientation tag, when you rotate or flip the image. + </para> + + <para> + The <guilabel>IPTC Actions</guilabel> will save the data into the respective IPTC fields, which ensures a permanent metadata storage in the image and not only in &digikam;'s database. Thus, metadata is persistent across applications, and may be exported or imported into &digikam; without loss. + </para> + + <para> + <guilabel>Save image captions as embedded captions (JFIF) in JPEG images</guilabel> : this will synchronize the captions that you add to your photographs with those in embedded in the image. This is useful because the captions embedded in the image can be read by other image viewers. Care should be taken if you have images that already have captions embedded in them because these captions will be overwritten by the captions made within &digikam;. + </para> + + </sect3> + + <sect3 id="setup-tooltip"> <title>Tooltip Settings</title> + + <para> + This setup page covers all options of information appearing when the mouse hovers over a file in the main view. According the checked options they will be shown or not. + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setuptooltip.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + </sect3> + + <sect3 id="setup-mimetype"> <title>Mime Type Settings</title> + + <para> + &digikam; can understand lots of different image file types as well as some video and audio formats. To control which types of files &digikam; will try to display you can add or remove file extensions from these lists. Any files that are in the &digikam; Album folders that do not match these extensions will be ignored by &digikam;. + </para> + <note><para>The default settings can be easily restored by clicking on the update buttons to the right of each category.</para></note> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupmimetypes.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + </sect3> + + <sect3 id="setup-lighttable"> <title>Light Table Settings</title> + + <para> + The setting of the &digikam; Light Table can be set to default values on this page so that every time you open the Light Table, these settings are activated (if possible, because for images having different sizes the synchronous mode does not work). The "Load full image size" is only recommended for fast maschines, but if you have one, enable this option for better viewing results. + </para> + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setuplighttable.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + </sect3> + + <sect3 id="setup-editor"> <title>Image Editor Settings</title> + <para> + By default the Image Editor will use a black background behind photographs when they are displayed. If you prefer a different background color you can choose one here. You can also turn off the ToolBar when the Image Editor is in full screen mode. + </para> + <para> + Over and underexposed areas of an image can be indicated by dark and light marker colors that can be defined here. In the editor this viewing mode can be switched on and off with F10 and F11 respectively.</para> + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupimageeditor.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + </sect3> + + <sect3 id="setup-saveimages"> <title>Save Image Options</title> + + <para> + When changes are made to JPEG files and they are saved back to the hard disk the JPEG file must be re-encoded. Each time a JPEG file is encoded a decision must be made on the level of quality that is to be applied. Unfortunately the level of quality applied is not recorded in the image file. This means that the Image Editor cannot use the same quality ratio when saving an altered image as was used for the original image. You can change the default level of quality that the Image Editor will apply when it saves altered images by moving the <guilabel>JPEG quality</guilabel> slider (1: low quality / 100: high quality and no compression). + </para> + <para> + Chroma subsampling is the practice of encoding images by implementing more resolution for luminance information than for color information. Please read <ulink url="http://en.wikipedia.org/wiki/Chroma_subsampling">this</ulink> Wikipedia article for a full explanation. + </para> + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupsaveimages.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + <para> + With <guilabel>PNG compression</guilabel> option, you can reduce PNG image files size. This operation does not reduce image quality because PNG uses a lossless algorithm. The only effect is that image data needs more time to compress/decompress. If you have a fast computer you can change this value to use a high compression factor (1: low compression / 9: high compression). + </para> + + <para> + With <guilabel>Compress TIFF</guilabel> option, you can toggle to use <emphasis>Deflate</emphasis> compression algorithm with TIFF image files. This will reduce TIFF image files sizes. It has no image quality effect because <emphasis>Deflate</emphasis> is a lossless algorithm. + </para> + + <para> + With the <guilabel>LossLess JPEG 2000 files</guilabel> option allows for lossless storage, or, if the lossy options is selected, even then the quality for comparative files size is much better than normal JPEG. At the time of writing, metadata is not yet supported, but it is in the 'pipeline'. + </para> + + </sect3> + + <sect3 id="setup-raw-decoder"> <title>RAW Decoder Settings</title> + + <para> + In the early versions of &digikam; the Image Editor was just a viewer for photographs, but it is rapidly developing into a very useful photo manipulation tool. This dialog allows you to control how the Image Editor will behave. + </para> + + <para><guilabel>16-bit color depth</guilabel></para> + <para>If enabled, all RAW files will be decoded to 16-bit color depth using a linear gamma curve. To prevent dark image rendering in the editor, it is recommended to use Color Management in this mode. If disabled, all RAW files will be decoded to 8-bit color depth with a BT.709 gamma curve and a 99th-percentile white point. This mode is faster than 16-bit decoding. In 8-bit mode only will the <guilabel>brightness</guilabel> setting be taken into account (dcraw limitation). + </para> + + <para><guilabel>Interplate RGB as four colors</guilabel></para> + <para>The default is to assume that all green pixels are the same. If even-row green pixels of the CCD sensor are more sensitive to ultraviolet light than odd-row this difference causes a mesh pattern in the output; using this option solves this problem with minimal loss of detail. To resume, this option blurs the image a little, but it eliminates false 2x2 mesh patterns with VNG quality method or mazes with AHD quality method.</para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setuprawfiledecoding.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + <para><guilabel>Use camera white balance</guilabel></para> + <para>Use the camera's custom white-balance settings if set. Otherwise apply <guilabel>Automatic color balance</guilabel> if this option is set.</para> + + <para><guilabel>Automatic color balance</guilabel></para> + <para>Only used if camera white balance is not set. The default is to use a fixed color balance based on a white card photographed in sunlight.</para> + + <para><guilabel>Use Super CCD secondary sensors</guilabel></para> + <para>For Fuji Super CCD SLR cameras only. Use the secondary sensors, in effect underexposing the image by four stops to reveal detail in the highlights. For all other camera types this option is being ignored.</para> + + <para><guilabel>Highlights</guilabel></para> + <para>This is the story of the three highlight options, courtesy of <ulink url="http://linux.vilars.com/">Nicolas Vilars</ulink> :</para> + <para>Default is here to consider highlights (read: part of your images that are burned due to the inability of your camera to capture the highlights) as plain / solid white (<guilabel>solid white</guilabel> option). You can get some fancy results with the <guilabel>unclip</guilabel> option which will paint the highlights in various pinks. At last you can try to consider recovering some parts of the missing information from the highlights (<guilabel>reconstruct</guilabel> option).</para> + <para> + This is possible because the blue pixels tends to saturate less quickly than the greens and the reds. &digikam;/dcraw will try to reconstruct the missing green and red colors from the remaining none saturated blue pixels. Of course here everything is a question of tradeoff between how much color or white you want.</para> + <para>If you select <guilabel>reconstruct</guilabel> as the option, you will be given the choice to set a level. A value of 3 is a compromise and can/should be adapted on a per image basis.</para> + <note><para> + A small warning here, for the few curious that have read the man pages of Dcraw, the author says that 5 is the compromise, 0 is solid white and 1 unclip. This is because in &digikam; 0 and 1 are the "solid white" and "unclip" options in the drop down menu (if you select these, the level slider will be grayed out). Therefore, the slider in &digikam; with the "reconstruct" option will let you choose between 0 to 7 (instead of 0 to 9 in Dcraw command line) where 3 is the compromise instead of 5 in "native" Dcraw command line tool.</para></note> + + <para><guilabel>Brightness</guilabel> (works in 8 bit mode only)</para> + <para> + Set the luminosity to your taste, you probably need to go a little higher than the default = 1. But this can be adjusted later with the image options in the &digikam; image editor. Given the cost in time for demosaicing, stay conservative. + </para> + + <para><guilabel>Quality</guilabel></para> + <para> + A <ulink url="http://en.wikipedia.org/wiki/Demosaicing">demosaicing</ulink> algorithm is a digital image process used to interpolate a complete image from the partial raw data received from the color-filtered image sensor internal to many digital cameras in form of a matrix of colored pixels. Also known as CFA interpolation or color reconstruction.</para> + <para> + &digikam; and Dcraw offer us three alternatives: bi-linear, VNG interpolation, AHD interpolation. It seems that <emphasis>AHD interpolation</emphasis> (for Adaptive Homogeneity-Directed) is the best choice for quality according to some test that I have performed and the paper of the person that implemented it. <emphasis>VNG interpolation</emphasis> (Variable Number of Gradients) was the first algorithm used by Dcraw but suffers from color artifacts on the edge. <emphasis>Bilinear</emphasis> is interesting if you are looking for speed with a acceptable result.</para> + + <para><guilabel>Enable Noise Reduction</guilabel></para> + <para> + While demosaicing your image, you can additionally ask for noise reduction (at a speed penalty). This option applies a noise reduction algorithm while the image still is in CIE Lab color space. Because the noise is only applied to the Luminosity layer (the "L" of the Lab), it should not blur your image as traditional noise reduction algorithms do in RGB mode. So, if you converted an image from RAW and it appears noisy, rather than applying a denoiser, go back and re-convert with this option enabled. The defaults are: <emphasis>Domain</emphasis> = 2 and <emphasis>Range</emphasis> = 4. + </para> + + <anchor id="CA.anchor"/> + <para><guilabel>Enable chromatic aberation (CA) correction</guilabel></para> + <para> + If you know the CA of your lenses you can set the red and blue correction values here. This is certainly the optimal method for CA correction as it is done during RAW conversion. + </para> + + </sect3> + + <sect3 id="setup-iccprofiles"> <title>ICC Profiles setup</title> + + <para> + &digikam; has the ability to color manage your images. RAW files are not color managed at all. Your camera provides the data it has captured in a raw format and will let you manage all the processing. Every camera has its specifics regarding how it captures color information, therefore you will need to apply a specific profile to the images you want to process. Please refer to the section <link linkend="using-iccprofile">ICC color profile management</link> for more details an explanations. + </para> + <para> + Basically, a profile "maps" the color information and gives information on how one should render them. It gives also information to LCMS and &digikam; on how to translate the color information from one color space to an other in order to keep the colors as accurate as possible. + </para> + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupiccprofiles.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + <para> + <guilabel>Behavior</guilabel> Ask when opening an image in image editor / Launch Color Management tool with RAW files + </para> + <para><guilabel>Color Profiles Directory</guilabel> + Set this to the folder where you store all your profiles ⪚ "/usr/share/color/icc" or "/home/user/.color/icc". &digikam; will scan this folder when starting up.</para> + <para><guilabel>ICC Profiles Settings</guilabel> + Here you are given the ability to provide "default" choices for your profiles. Everything is adaptable later-on at the opening of a RAW file.</para> + <itemizedlist> + + <listitem><para>The <guilabel>Use color managed view</guilabel> is an alternative to using Xcalib or Argyll. Only your image will be color managed, not your entire screen! </para></listitem> + + <listitem><para> + You have to provide a workspace profile (linear profiles such as sRGB, ECI-RGB, LStar-RGB, Adobe-RGB or CIE-RGB). If you want to print your images, you may want to opt for Adobe RGB, if it is only for web publishing, sRGB is better (Adobe RGB will be displayed slightly dull in non color managed enabled software such as browsers). However you may change this later of course (by attributing another profile), therefore Adobe RGB can be a good choice for storing and image handling as you can always change it to sRGB before releasing an image for your blog.</para><para>Do not use non-linear profiles as they will change the color-balance</para> + </listitem> + + <listitem><para> + The input profile should match the camera maker and model you are using. 'Not all profiles are created equal', there are some that have no tone mapping/gamma correction included (Canon). As of now, dcraw does not correct gamma for 16 bit depth conversion, which means that you have to do the tone mapping yourself.</para></listitem> + + <listitem><para> + There are some other options such as the soft proof profile which enables you to emulate, granted that you have a profile for it, how your image will render for a particular device. It is useful before printing for instance because your printer has a smaller gamut than your camera and some colors might look saturated. You may want to fix this manually instead of relying on the "blind" algorithm of your printer.</para></listitem> + + </itemizedlist> + + <para> + For most cameras it is pretty obvious what color profile they propose for the type at hand, not so for the Canon's. Here is a table of camera/profiles matches, it is non-authoritative of course: + </para> + <informaltable><tgroup cols="2"> + <thead><row> + <entry>Camera</entry> + <entry>Profile series</entry> + </row></thead> + <tbody> + <row> <entry>Canon 1D mark II</entry> <entry>6051</entry> </row> + <row> <entry>Canon 1D mark II</entry> <entry>6111</entry> </row> + <row> <entry>Canon 1Ds</entry> <entry>6021</entry> </row> + <row> <entry>Canon 1Ds mark II</entry> <entry>6081</entry> </row> + <row> <entry>Canon 5D</entry> <entry>6091</entry> </row> + <row> <entry>Canon 10D</entry> <entry>6031</entry> </row> + <row> <entry>Canon 20D</entry> <entry>6061</entry> </row> + <row> <entry>Canon 30D</entry> <entry>6112</entry> </row> + <row> <entry>Canon 40D</entry> <entry>6101</entry> </row> + <row> <entry>Canon 300D</entry> <entry>6031</entry> </row> + <row> <entry>Canon 350D</entry> <entry>6111 or 6071</entry> </row> + <row> <entry>Canon 400D</entry> <entry>6131</entry> </row> + </tbody> + </tgroup> + </informaltable> + <para>The Canon profile extension betray the target style: F for Faithful Style, L for Landscape Style, N for Neutral Style, P for Portrait Style, S for Standard Style. + </para> + + <para>Here you find a typical <link linkend="raw-workflow">RAW workflow</link> scenario.</para> + </sect3> + + <sect3 id="setup-kipiplugins"> <title>Kipi Plugins Settings</title> + + <para> + Kipi is the &kde; Image Plugin Interface. It is an interface that is supported by a number of &kde; image viewer/editor applications. By providing this interface, &digikam; can take advantage of many plugins that are written to work with any application that implements the Kipi interface. + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupkipiplugins.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + <para> + If your operating system has the Kipi plugins package installed, you will see a list of available plugins. Select those that you want to use and they will be loaded into &digikam;. The plugins will appear as new menu entries in the main menu bar and in the context menu for thumbnails. + </para> + + <para> + Keyboard shortcuts to actions that plugins perform can be set up in the + <menuchoice><guimenu>Setting</guimenu> + <guimenuitem>Configure Shortcuts</guimenuitem></menuchoice> menu. + </para> + + <para> + For more information about Kipi plugins, you can consult the Kipi project at <ulink url="http://www.kipi-plugins.org">http://www.kipi-plugins.org</ulink> or the <ulink url="help:/kipi-plugins/index.html">Kipi-plugins manual</ulink>. + </para> + + </sect3> + + <sect3 id="setup-slideshow"> <title>Slide show setup</title> + <para>The slide show setup should be easy to understand. The upper slider adjusts the time between image transitions; usually a time of 4-5 seconds is good. The other check boxes enable/disable the metadata to be shown on the bottom of the slide show images during display.</para> + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupslideshow.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + </sect3> + + <sect3 id="setup-camera"> <title>Camera Interface Settings</title> + + <para> + The camera settings shows on the left the list of the currently supported cameras. On the right at the top there is an auto-detect button, which tries to identify the camera connected to your computer (make sure that the camera is connected properly to the computer and turned on in the image display mode). Below this are the port settings; the currently supported are Serial, USB, and USB/FireWire Mass Storage. + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupcamera.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + <anchor id="cameraselection.anchor"/> + + <para> + Clicking on a camera in the list on the left will display the supported ports which you can then select. If there is only one supported port it will be automatically selected. At the bottom on the right there is a box for setting the exact path in case of a serial port. Please note that USB interface does not need any paths to be set. If you cannot find your camera on the list, you can try to use a generic Mass Storage device to selecting <guilabel>Mounted Camera</guilabel> item in the list. + </para> + + <para> + At the very bottom is where you set the path for a USB or FireWire (IEEE-1394 or i-link) Mass Storage camera. This box becomes active once you select USB or FireWire Mass Storage camera in the camera list. You need to enter here the path where you mount the camera, usually "/mnt/camera" or "/mnt/removable". + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupaddcamera.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + <para> + To be able to use your digital camera with &digikam;, connect the camera to your computer, switch the camera to the image display mode and turn it on. + </para> + + <para> + Try and see if &digikam; can auto-detect the camera; if not, you can set the camera model and port manually. Once you have the camera setup, go to the "Cameras" menu in the main interface and you will see the camera listed in the menu. + </para> + + <note><para> + You can choose any title you like for the camera in the setup and this title will be used in the main window <guilabel>Cameras</guilabel> menu. If you have more than one camera, you can add them through this setup interface. + + </para></note> + + </sect3> + + <sect3 id="setup-miscellaneous"> <title>Miscellaneous Settings</title> + + <para> + With the <guilabel>Show confirmation dialog when moving items to trash</guilabel> setting you can set the verbosity of &digikam; when you delete a photograph or an Album. See <link linkend="using-deleteimage">Deleting a Photograph</link> and <link linkend="using-deletealbum">Deleting an Album</link> sections for more details. + </para> + + <para> + The editorial changes done through the right sidebar can be quietly applied by &digikam; when setting the <guilabel>Apply changes in the right sidebar without confirmation</guilabel> option. Otherwise the changes must be applied by pressing the <guilabel>Apply changes</guilabel> button. + </para> + + <para> + You can also switch off the display of the splash screen when &digikam; loads. This may speed up the start time of &digikam; slightly. + </para> + + <anchor id="rescan-items" /> + <para> + <guilabel>Scan for new items at startup</guilabel> option will force &digikam; to scan the album library tree for new items added or removed between &digikam; sessions. This may slow down the start time of &digikam;. If any items have been removed from album library, &digikam; will ask you confirmation before to remove definitely item references in database. + </para> + + <para> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupmisc.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + </sect3> + + </sect2> + + <sect2 id="setuptheme"> <title>The Theme Setup</title> + + <para> + Color schemes are supplied like themes to personalize &digikam; main interface for you pleasure. To access these settings select + <menuchoice><guimenu>Setting</guimenu> + <guimenuitem>Themes</guimenuitem></menuchoice> from the menubar and select your preferred theme to use. A preview of the available themes is listed below: + </para> + + <informaltable><tgroup cols="2"> + + <thead><row> + <entry>Preview</entry> + <entry>Theme Name</entry> + </row></thead> + + <tbody> + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupthemeclean.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Clean + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupthemedark.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Dark + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupthemedefault.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Default + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupthemedessert.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Dessert + </entry> + </row> + + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupthemedigicasa.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Digicasa + </entry> + </row> + + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupthemedreary.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Dreary + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupthememarine.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Marine + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupthemeorangecrush.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + OrangeCrush + </entry> + </row> + + <row> + <entry> + <inlinemediaobject><imageobject><imagedata fileref="&path;setupthemesandy.png" format="PNG" /> </imageobject></inlinemediaobject> + </entry> + + <entry> + Sandy + </entry> + </row> + + </tbody> + + </tgroup></informaltable> + + <note><para> + Theme settings are implemented in simple text file. If you are interested to create a new theme for &digikam;, you can find more information about it in this <ulink url="http://www.digikam.org/themeguide.html">tutorial</ulink>. + </para></note> + + </sect2> + + </sect1> + +</chapter> + +<!-- ****************************************************************************************** --> + +<chapter id="image-editor"> <title>The Image Editor</title> + + <sect1 id="using-imageeditor"> <title>Introduction to Image Editor</title> + <anchor id="imageeditor.anchor"/> + + <sect2 id="imageeditor-window"> <title>The Image Editor Window</title> + <para> + &digikam; incorporates a fast Image Editor with a few basic yet powerful image editing tools. You can use the Image Editor to view your photographs and to make corrections and alterations. The Image Editor can be accessed either by clicking on a thumbnail in the Image Window or by right-clicking on a thumbnail and selecting <guilabel>View/Edit</guilabel> from the context menu. + </para> + + <para> + The Image Editor provides a number of tools that enable you to adjust a photograph. Some of these tools are provided by plugins to &digikam;. So they may not be available by default on your distribution. See the <link linkend="setup-kipiplugins">Setup Image Editor Section</link> for more details about Kipi-plugins. + </para> + + <example> <title>The Image Editor Window</title> + <screenshot><screeninfo>The Image Editor Window</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorpreview.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + The image editor has just one main window with: + + <itemizedlist> + + <listitem><para> + A status at the bottom which shows the filename, the current file number, the current zoom level, and the current image size. + </para></listitem> + + <listitem><para> + A menu bar across the top and below that a tool bar that provides quick access to some commonly used functions. + </para></listitem> + + </itemizedlist> + </para> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;editortoolbar.png" format="PNG"/></imageobject> + <textobject> <phrase>The Image Editor Toolbar</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + + <itemizedlist> + + <listitem><para>(1) : First Current Album Image.</para></listitem> + + <listitem><para>(2) : Previous Image.</para></listitem> + + <listitem><para>(3) : Next Image.</para></listitem> + + <listitem><para>(4) : Last Current Album Image.</para></listitem> + + <listitem><para>(5) : Save the modified image.</para></listitem> + + <listitem><para>(6) : Undoing last action.</para></listitem> + + <listitem><para>(7) : Redoing previous action.</para></listitem> + + <listitem><para>(8) : Restore the Current Image From Disk.</para></listitem> + + <listitem><para>(9) : Zoom Into the Image.</para></listitem> + + <listitem><para>(10) : Zoom Out of the Image.</para></listitem> + + <listitem><para>(11) : Toggle Auto Zooming (if selected image will fit in the window).</para></listitem> + + <listitem><para>(12) : Rotate the Current Image.</para></listitem> + + <listitem><para>(13) : Crop Image to the Selected Region.</para></listitem> + + </itemizedlist> + + </para> + </sect2> + + <sect2> <title>Restoring Your Original Photograph</title> + + <para> + The editing functions of the Image Editor will make changes to your photograph. None of the editing functions will change the original photograph unless you select + <menuchoice><guimenu>File</guimenu> + <guimenuitem>Save</guimenuitem></menuchoice> + or click the <guilabel>Save</guilabel> button in the tool bar. Note that once you have saved the changed version you will not be able to recover the original photograph. + </para> + + <para> + You might prefer to take a copy of your photograph before you make any changes. You can use + <menuchoice><guimenu>File</guimenu> + <guimenuitem>Save As</guimenuitem></menuchoice> + to save a working copy. + </para> + + <para> + At any time <emphasis>before</emphasis> you save your photograph you can restore the view to the original image by selecting + <menuchoice><guimenu>File</guimenu> + <guimenuitem>Revert</guimenuitem></menuchoice> + or clicking the + <inlinemediaobject> + <imageobject><imagedata fileref="&path;editorrevertbutton.png" format="PNG"/></imageobject> + <textobject><phrase>The Image Editor Revert Button</phrase></textobject> + </inlinemediaobject> + <guilabel>Revert</guilabel> button on the tool bar. You will lose any changes that you have made to the photograph since it was last saved. + </para> + + </sect2> + + <sect2> <title>Undoing/Redoing Actions</title> + + <para> + Almost anything you do to an image in Image Editor can be undone/redone. You can undo the most recent action by choosing <menuchoice><guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem></menuchoice>, and redo by <menuchoice><guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem></menuchoice> + </para> + + <para> + If these are done frequently, you really should memorize the keyboard shortcuts, <guilabel>&Ctrl;-Z</guilabel> to undo an action, and <guilabel>&Ctrl;-Shift-Z</guilabel> to redo an action. + </para> + + <para> + You have to press the &LMB; over the undo or redo icon in the tool bar and hold it down for a moment to produce a context menu. If you choose one of the menu items, all undo/redo actions until the chosen ones are undone/undone. + </para> + + </sect2> + + <sect2> <title>Moving Between Photographs</title> + + <para> + Once you have started the Image Editor you can move between photographs in the same view you started from by using the navigator buttons on the toolbar, <keycap>PgUp</keycap>, <keycap>PgDown</keycap> or the entries in the <guilabel>File</guilabel> menu. If you have made any changes to the current photograph you will be asked if you want to save them. + </para> + + </sect2> + + <sect2> <title>Changing the View</title> + + <para> + You can zoom in and out of a photograph using the <keycombo action="press"><keycap>&Ctrl;</keycap><keycap>scroll wheel</keycap></keycombo>, the toolbar icons or the entries in the View menu. + </para> + <para> + To make a photograph fit the window use this button on the tool bar: <guilabel>Zoom Autofit</guilabel> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;editorautosizebutton.png" format="PNG"/></imageobject> + <textobject> <phrase>The Image Editor AutoFit Button</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + <menuchoice><guimenu>View</guimenu> + <guimenuitem>Toggle Full Screen</guimenuitem></menuchoice> will display the photograph using the full screen mode. You can move back to the normal view by pressing the <keycombo><keycap>Esc</keycap></keycombo> key. By default the toolbar is still displayed even in Full Screen Mode. If you would prefer that the toolbar is not displayed you can turn it off in the Configure &digikam; dialog accessed from the main &digikam; window, see the <link linkend="setup-editor">Setup Image Editor Section</link>. + </para> + + </sect2> + + <sect2> <title>Printing Images</title> + + <para> + When you want to print the current image from the Image Editor, select + <menuchoice><guimenu>File</guimenu> + <guimenuitem>Print image</guimenuitem></menuchoice> (&Ctrl;+P) and you get the standard &kde; Print dialog, where you can adjust the settings before printing your photograph. + </para> + + <para> + For more information about advanced printing settings, please consult <ulink url="help:/kdeprint/index.html">&kde; Print manual</ulink>. + </para> + + <para> + From the main window view you can print single images or whole sets of them. Entire thumbnail pages can be printed with your selection. All you need to do is selecting images the standard way and call <menuchoice><guimenu>Album</guimenu><guimenuitem>Export</guimenuitem> <guimenuitem>Print Wizard</guimenuitem></menuchoice>. Then follow the instructions and choices to make. + </para> + </sect2> + + </sect1> + + &doc-photo-editing; + +</chapter> + +<!-- *********************************************************************** --> + +&doc-menu-descriptions; + +<!-- *********************************************************************** --> + +&doc-credits-annexes; + +</book> diff --git a/doc/en/digikam/infraredpreview.png b/doc/en/digikam/infraredpreview.png Binary files differnew file mode 100644 index 00000000..fa153801 --- /dev/null +++ b/doc/en/digikam/infraredpreview.png diff --git a/doc/en/digikam/inpaintingdialog.png b/doc/en/digikam/inpaintingdialog.png Binary files differnew file mode 100644 index 00000000..779133b3 --- /dev/null +++ b/doc/en/digikam/inpaintingdialog.png diff --git a/doc/en/digikam/inpaintingpreview.png b/doc/en/digikam/inpaintingpreview.png Binary files differnew file mode 100644 index 00000000..2f90de4a --- /dev/null +++ b/doc/en/digikam/inpaintingpreview.png diff --git a/doc/en/digikam/inpaintingsettings1.png b/doc/en/digikam/inpaintingsettings1.png Binary files differnew file mode 100644 index 00000000..57fe4d4f --- /dev/null +++ b/doc/en/digikam/inpaintingsettings1.png diff --git a/doc/en/digikam/inpaintingsettings2.png b/doc/en/digikam/inpaintingsettings2.png Binary files differnew file mode 100644 index 00000000..5856b8a2 --- /dev/null +++ b/doc/en/digikam/inpaintingsettings2.png diff --git a/doc/en/digikam/inserttextpreview.png b/doc/en/digikam/inserttextpreview.png Binary files differnew file mode 100644 index 00000000..65b9823f --- /dev/null +++ b/doc/en/digikam/inserttextpreview.png diff --git a/doc/en/digikam/introductionalbumsmissingdialog.png b/doc/en/digikam/introductionalbumsmissingdialog.png Binary files differnew file mode 100644 index 00000000..6b9c1c11 --- /dev/null +++ b/doc/en/digikam/introductionalbumsmissingdialog.png diff --git a/doc/en/digikam/introductionfirewireconnector.png b/doc/en/digikam/introductionfirewireconnector.png Binary files differnew file mode 100644 index 00000000..06dc42f0 --- /dev/null +++ b/doc/en/digikam/introductionfirewireconnector.png diff --git a/doc/en/digikam/introductionfirstrundialog.png b/doc/en/digikam/introductionfirstrundialog.png Binary files differnew file mode 100644 index 00000000..9c4dd977 --- /dev/null +++ b/doc/en/digikam/introductionfirstrundialog.png diff --git a/doc/en/digikam/introductionfoldericon.png b/doc/en/digikam/introductionfoldericon.png Binary files differnew file mode 100644 index 00000000..40fc0f85 --- /dev/null +++ b/doc/en/digikam/introductionfoldericon.png diff --git a/doc/en/digikam/introductionplugininterfaces.png b/doc/en/digikam/introductionplugininterfaces.png Binary files differnew file mode 100644 index 00000000..dc29d18a --- /dev/null +++ b/doc/en/digikam/introductionplugininterfaces.png diff --git a/doc/en/digikam/introductionscandialog.png b/doc/en/digikam/introductionscandialog.png Binary files differnew file mode 100644 index 00000000..da629221 --- /dev/null +++ b/doc/en/digikam/introductionscandialog.png diff --git a/doc/en/digikam/introductionserialconnector.png b/doc/en/digikam/introductionserialconnector.png Binary files differnew file mode 100644 index 00000000..bce36e88 --- /dev/null +++ b/doc/en/digikam/introductionserialconnector.png diff --git a/doc/en/digikam/introductionusbconnector.png b/doc/en/digikam/introductionusbconnector.png Binary files differnew file mode 100644 index 00000000..a64d7204 --- /dev/null +++ b/doc/en/digikam/introductionusbconnector.png diff --git a/doc/en/digikam/lensdistortiondialog.png b/doc/en/digikam/lensdistortiondialog.png Binary files differnew file mode 100644 index 00000000..c959c7b3 --- /dev/null +++ b/doc/en/digikam/lensdistortiondialog.png diff --git a/doc/en/digikam/lensdistortionpreview.png b/doc/en/digikam/lensdistortionpreview.png Binary files differnew file mode 100644 index 00000000..92ed87a0 --- /dev/null +++ b/doc/en/digikam/lensdistortionpreview.png diff --git a/doc/en/digikam/lighttable.png b/doc/en/digikam/lighttable.png Binary files differnew file mode 100644 index 00000000..6ae790ec --- /dev/null +++ b/doc/en/digikam/lighttable.png diff --git a/doc/en/digikam/logo.png b/doc/en/digikam/logo.png Binary files differnew file mode 100644 index 00000000..50dc0b03 --- /dev/null +++ b/doc/en/digikam/logo.png diff --git a/doc/en/digikam/maininterfaceadvancedsearch.png b/doc/en/digikam/maininterfaceadvancedsearch.png Binary files differnew file mode 100644 index 00000000..763c84f3 --- /dev/null +++ b/doc/en/digikam/maininterfaceadvancedsearch.png diff --git a/doc/en/digikam/maininterfaceadvancedsearchoption.png b/doc/en/digikam/maininterfaceadvancedsearchoption.png Binary files differnew file mode 100644 index 00000000..9ded9a81 --- /dev/null +++ b/doc/en/digikam/maininterfaceadvancedsearchoption.png diff --git a/doc/en/digikam/maininterfaceadvancedsearchoptiongroup.png b/doc/en/digikam/maininterfaceadvancedsearchoptiongroup.png Binary files differnew file mode 100644 index 00000000..2affa99f --- /dev/null +++ b/doc/en/digikam/maininterfaceadvancedsearchoptiongroup.png diff --git a/doc/en/digikam/maininterfacealbumproperties.png b/doc/en/digikam/maininterfacealbumproperties.png Binary files differnew file mode 100644 index 00000000..945a3ff8 --- /dev/null +++ b/doc/en/digikam/maininterfacealbumproperties.png diff --git a/doc/en/digikam/maininterfaceassigntags.png b/doc/en/digikam/maininterfaceassigntags.png Binary files differnew file mode 100644 index 00000000..e75e0e92 --- /dev/null +++ b/doc/en/digikam/maininterfaceassigntags.png diff --git a/doc/en/digikam/maininterfacedateview.png b/doc/en/digikam/maininterfacedateview.png Binary files differnew file mode 100644 index 00000000..a6d37869 --- /dev/null +++ b/doc/en/digikam/maininterfacedateview.png diff --git a/doc/en/digikam/maininterfacepreview.png b/doc/en/digikam/maininterfacepreview.png Binary files differnew file mode 100644 index 00000000..b758836d --- /dev/null +++ b/doc/en/digikam/maininterfacepreview.png diff --git a/doc/en/digikam/maininterfacequicksearch.png b/doc/en/digikam/maininterfacequicksearch.png Binary files differnew file mode 100644 index 00000000..6b8f2741 --- /dev/null +++ b/doc/en/digikam/maininterfacequicksearch.png diff --git a/doc/en/digikam/maininterfacesearchview.png b/doc/en/digikam/maininterfacesearchview.png Binary files differnew file mode 100644 index 00000000..103eefc1 --- /dev/null +++ b/doc/en/digikam/maininterfacesearchview.png diff --git a/doc/en/digikam/maininterfacetagsview.png b/doc/en/digikam/maininterfacetagsview.png Binary files differnew file mode 100644 index 00000000..4305123d --- /dev/null +++ b/doc/en/digikam/maininterfacetagsview.png diff --git a/doc/en/digikam/maininterfacetoolbar.png b/doc/en/digikam/maininterfacetoolbar.png Binary files differnew file mode 100644 index 00000000..526760c0 --- /dev/null +++ b/doc/en/digikam/maininterfacetoolbar.png diff --git a/doc/en/digikam/menu-descriptions.docbook b/doc/en/digikam/menu-descriptions.docbook new file mode 100644 index 00000000..f9dfe742 --- /dev/null +++ b/doc/en/digikam/menu-descriptions.docbook @@ -0,0 +1,982 @@ +<chapter id="menu-descriptions"> <title>Menu Descriptions</title> + +<sect1 id="main-window"> <title>The main &digikam; window</title> + + <sect2> <title>The Album Menu</title> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;menualbum.png" format="PNG"/></imageobject> + <textobject> <phrase>Album Menu</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Alt;</keycap><keycap>Left</keycap></keycombo> </shortcut> + <guimenu>Album</guimenu><guimenuitem>Back</guimenuitem> + </menuchoice></term> + <listitem><para><action>Go back to the previously visited View using history.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Alt;</keycap><keycap>Right</keycap></keycombo> </shortcut> + <guimenu>Album</guimenu><guimenuitem>Forward</guimenuitem> + </menuchoice></term> + <listitem><para><action>Go forward to the previously visited View using history. You can only go forward if you've just gone back.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>N</keycap></keycombo> </shortcut> <guimenu>Album</guimenu><guimenuitem>New Album</guimenuitem> + </menuchoice></term> + <listitem><para><action>Create a new album folder.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu><guimenuitem>Edit Album Properties</guimenuitem> + </menuchoice></term> + <listitem><para><action>Edit the currently selected album title, caption and collection.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>F5</keycap></keycombo> </shortcut> + <guimenu>Album</guimenu><guimenuitem>Refresh</guimenuitem> + </menuchoice></term> + <listitem><para><action>Refresh the current view in the Main Window.</action></para></listitem> + </varlistentry> + + <varlistentry id="synchronize-metadata"> + <term><menuchoice> + <guimenu>Album</guimenu> + <guimenuitem>Synchronize images with database</guimenuitem> + </menuchoice></term> + <listitem><para><action>Synchronize the metadata between database and the file's metadata of all items of the current Main Window. The images will inherit the database metadata, not the other way around as in <link linkend="update-db-metadata">this </link>menu.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu> + <guimenuitem>Open in &konqueror;</guimenuitem> + </menuchoice></term> + <listitem><para><action>Open &konqueror; with the current Album path.</action></para></listitem> + </varlistentry> + + <!-- Import sub menu --> + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>I</keycap></keycombo> </shortcut> + <guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Add Images</guimenuitem> + </menuchoice></term> + <listitem><para><action>Select images to be added to the currently selected Album.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Import Folders</guimenuitem> + </menuchoice></term> + <listitem><para><action>Select folders to be imported like Albums to the currently selected Album</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Scan Images</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin for image acquisition with a scanner. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/acquireimages.html">Acquire Images manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu><guimenuitem>Import</guimenuitem><guimenuitem>Screenshot</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to take a screenshot. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/acquireimages.html">Acquire Images manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <!-- Export sub menu --> + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>Archive to + &CD;/DVD</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to archive Albums to &CD; or DVD using K3b. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/cdarchiving.html">&CD; Archiving manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>Export to Flickr...</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to upload or update images to <ulink url="http://www.flickr.com/">Flickr</ulink> server. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/flickrexport.html">Flickr Export manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>Remote Gallery sync...</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to upload or update images to <ulink url="http://www.gallery2.org/">web galleries</ulink>. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/galleryexport.html">Gallery Export manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>&HTML; Gallery</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to create a &HTML; gallery with Albums. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/imagesgallery.html">Images Gallery manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>Print + Wizard</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to print Album images. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/printwizard.html">Print Wizard manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu><guimenuitem>Export</guimenuitem><guimenuitem>SimpleViewer export</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to export to <ulink url="http://www.airtightinteractive.com/photos/">SimpleViewer</ulink>. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/simpleviewer.html">SimpleViewer manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Album</guimenu> + <guimenuitem>Delete Album/Move Album to trash</guimenuitem> + </menuchoice></term> + <listitem><para><action>Delete/Move to trash selected Album and all items in it.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>Q</keycap></keycombo> </shortcut> + <guimenu>Album</guimenu><guimenuitem>Quit</guimenuitem> + </menuchoice></term> + <listitem><para><action>Quit &digikam;</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Tag Menu</title> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;menutag.png" format="PNG"/></imageobject> + <textobject> <phrase>Tags Menu</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <guimenu>Tag</guimenu><guimenuitem>New Tag</guimenuitem> + </menuchoice></term> + <listitem><para><action>Create a new Tag entry in the Albums Database.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tag</guimenu><guimenuitem>Edit Tag Properties</guimenuitem> + </menuchoice></term> + <listitem><para><action>Edit the properties of the currently selected Tag.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tag</guimenu><guimenuitem>Delete Tag</guimenuitem> + </menuchoice></term> + <listitem><para><action>Remove the currently selected Tag from the Album's Database.</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Image Menu</title> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;menuimage.png" format="PNG"/></imageobject> + <textobject> <phrase>Image Menu</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="press"><keycap>F3</keycap></keycombo> </shortcut> + <guimenu>Image</guimenu><guimenuitem>View...</guimenuitem> + </menuchoice> or + <menuchoice> + <shortcut><keycombo action="press"><keycap>Enter</keycap></keycombo></shortcut> + <guimenu></guimenu></menuchoice></term> + <listitem><para><action>View the selected image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="press"><keycap>Esc</keycap></keycombo></shortcut> + <guimenu></guimenu></menuchoice> or + <menuchoice> + <shortcut><keycombo action="press"><keycap>F3</keycap></keycombo></shortcut> + <guimenu></guimenu></menuchoice></term> + <listitem><para><action>Puts you back from 'image view' into the main window.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="press"><keycap>F4</keycap></keycombo> </shortcut> + <guimenu>Image</guimenu><guimenuitem>Edit...</guimenuitem> + </menuchoice></term> + <listitem><para><action>Open the currently selected image in the &digikam; image editor.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="press"><keycap>F6</keycap></keycombo> </shortcut> + <guimenu>Image</guimenu><guimenuitem>Place onto Light Table</guimenuitem> + </menuchoice></term> + <listitem> + <para><action>Adds selection to the Light Table thumbbar and puts the Light Table into the foreground.</action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Image</guimenu><guimenuitem>Correct EXIF Orientation Tag</guimenuitem> + </menuchoice></term> + <listitem><para><action>Manual EXIF Orientation Tag adjustment options of the currently selected image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Image</guimenu><guimenuitem>Auto Rotate/Flip using EXIF information</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin menu entry to manually activate the auto rotate/flip feature for the currently selected images using the EXIF orientation tag. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Image</guimenu><guimenuitem>Rotate</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin menu entry for rotating the currently selected images by 90/180/270 degrees. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Image</guimenu><guimenuitem>Flip</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin menu entry for flipping the currently selected images horizontally or vertically. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Image</guimenu><guimenuitem>Convert to Black & White</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin menu entry for converting the currently selected images to black & white. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/jpeglossless.html">JPEG Loss Less manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Image</guimenu><guimenuitem>Email images</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin for emailing images with your preferred mail agent. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/sendimages.html">Send Images manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Image</guimenu><guimenuitem>Geolocation</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to handle GPS meta data of the image. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/geolocalization.html">Geolocation manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Image</guimenu><guimenuitem>Metadata</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to handle meta data of the image (EXIF, IPTC, captions). + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/metadata.html">Metadata manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Image</guimenu><guimenuitem>Adjust Time and Date</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin for adjusting time and date of the currently selected images. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/timeadjust.html">Time Adjust manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Image</guimenu><guimenuitem>Set as Background</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin for setting the currently selected image as the desktop background. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/wallpaper.html">Wall Paper manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="press"><keycap>F2</keycap></keycombo> </shortcut> + <guimenu>Image</guimenu><guimenuitem>Rename</guimenuitem> + </menuchoice></term> + <listitem><para><action>Rename the currently selected image.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="press"><keycap>F8</keycap></keycombo> </shortcut> + <guimenu>Image</guimenu><guimenuitem>Delete</guimenuitem> + </menuchoice></term> + <listitem><para><action>Move to trash (recoverable delete)</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Select Menu</title> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;menuselect.png" format="PNG"/></imageobject> + <textobject> <phrase>Select Menu</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>A</keycap></keycombo> </shortcut> + <guimenu>Select</guimenu><guimenuitem>Select All</guimenuitem> + </menuchoice></term> + <listitem><para><action>Select all images currently shown</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>U</keycap></keycombo> </shortcut> + <guimenu>Select</guimenu><guimenuitem>Select None</guimenuitem> + </menuchoice></term> + <listitem><para><action>Unselect all items in the current view</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>*</keycap></keycombo> </shortcut> + <guimenu>Select</guimenu><guimenuitem>Invert Selection</guimenuitem> + </menuchoice></term> + <listitem><para><action>Invert the current selection</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The View Menu</title> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;menuview.png" format="PNG"/></imageobject> + <textobject> <phrase>View Menu</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>F</keycap></keycombo> </shortcut> + <guimenu>View</guimenu><guimenuitem>Full Screen Mode</guimenuitem> + </menuchoice></term> + <listitem><para><action>Switch to full screen (same as F11).</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>View</guimenu><guimenuitem>Slide Show</guimenuitem> + </menuchoice></term> + <listitem><para><action>Slide Show including RAW files.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="press"><keycap>F9</keycap></keycombo> </shortcut> + <guimenu>View</guimenu><guimenuitem>Slide Show</guimenuitem><guimenuitem>All</guimenuitem> + </menuchoice></term> + <listitem><para><action>Start slide show of all images in current window.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Alt;</keycap><keycap>F9</keycap></keycombo> </shortcut> + <guimenu>View</guimenu><guimenuitem>Slide Show</guimenuitem><guimenuitem>Selection</guimenuitem> + </menuchoice></term> + <listitem><para><action>Start slide show on selected images.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Shift;</keycap><keycap>F9</keycap></keycombo> </shortcut> + <guimenu>View</guimenu><guimenuitem>Slide Show</guimenuitem><guimenuitem>Recursive</guimenuitem> + </menuchoice></term> + <listitem><para><action>Slide show that recurses through the current album tree.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>+</keycap></keycombo> </shortcut> + <guimenu>View</guimenu><guimenuitem>Increase Thumbnail Size</guimenuitem> + </menuchoice></term> + <listitem><para><action>Increase the thumbnail size of the currently selected Album.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>-</keycap></keycombo> </shortcut> + <guimenu>View</guimenu><guimenuitem>Decrease Thumbnail Size</guimenuitem> + </menuchoice></term> + <listitem><para><action>Decrease the thumbnail size of the currently selected Album.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>View</guimenu><guimenuitem>Sort Albums</guimenuitem> + </menuchoice></term> + <listitem><para><action>Sort all &digikam; Albums by Folder, by Collection, or by Date.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>View</guimenu><guimenuitem>Sort Images</guimenuitem> + </menuchoice></term> + <listitem><para><action>Sort all images in current Album by Name, Path, Date, File Size or by Rating.</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Tools Menu</title> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;menutools.png" format="PNG"/></imageobject> + <textobject> <phrase>Tools Menu</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Ctrl;</keycap><keycap>F</keycap></keycombo> </shortcut> + <guimenu>Tools</guimenu><guimenuitem>Quick Search</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Launch the simple search items dialog. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Alt;</keycap><keycap>&Ctrl;</keycap><keycap>F</keycap></keycombo> </shortcut> + <guimenu>Tools</guimenu><guimenuitem>Advanced Search</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Launch the advanced search items dialog. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>&Alt;</keycap><keycap>F6</keycap></keycombo> </shortcut> + <guimenu>Tools</guimenu><guimenuitem>Light Table</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Switches to the Light Table window. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>Scan for new images</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Rescan the library for images not yet in the database (see also <link linkend="rescan-items">start-up option</link>). + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>Rebuild all Thumbnails...</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Launch rebuild of all thumbnails (that can take a long time if you have many images). + </action></para> + </listitem> + </varlistentry> + + <varlistentry id="update-db-metadata"> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>Update Metadata Database...</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Launch synchronization of all metadata between database and files for all files (not just current view as with <link linkend="synchronize-metadata">this</link> menu). Database metadata will be overwritten with the file's metadata in case of discrepancy. The opposite you can do from the <link linkend="synchronize-metadata">Album</link> menu. + </action></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>Find Duplicate Images</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to find duplicate images in Albums Database. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/findduplicateimages.html">Find Duplicate Images manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>Image Viewer</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin OpenGL full screen image viewer with the selected image. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/openglviewer.html">OpenGL viewer manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>Create Calendar</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin for creating a calendar with Album items. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/calendar.html">Calendar manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>Create MPEG Slideshow</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin for creating an MPEG Slideshow with Album items. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/mpegencoder.html">MPEG Encoder manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>Remote Galleries</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin to set up a list of remote galleries for exporting. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/remotegalleries.html">Remote galleries manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>Advanced Slideshow</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin for displaying an advanced slide show with Album items. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/slideshow.html">Advanced Slide Show manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>RAW Image Converter (single)</guimenuitem> + </menuchoice></term> + <listitem> + <para><action> + Kipi-plugin for converting a single RAW image. + </action></para> + <para> + See the dedicated + <ulink url="help:/kipi-plugins/rawconverter.html">RAW Converter manual</ulink> + for more information. + </para> + </listitem> + </varlistentry> + + <!-- Import sub menu --> + + <varlistentry> + <term><menuchoice> + <guimenu>Tools</guimenu><guimenuitem>Batch Processes</guimenuitem> + </menuchoice></term> + + <listitem> + <para><action> + Kipi-plugin menu entries for performing batch Processes on currently selected images. + </action></para> + <para> + See the dedicated manuals for more information: + + <itemizedlist> + <listitem><para> + <ulink url="help:/kipi-plugins/colorimages.html">Color Images manual</ulink> + </para></listitem> + + <listitem><para> + <ulink url="help:/kipi-plugins/convertimages.html">Convert Images manual</ulink> + </para></listitem> + + <listitem><para> + <ulink url="help:/kipi-plugins/effectimages.html">Effect Images manual</ulink> + </para></listitem> + + <listitem><para> + <ulink url="help:/kipi-plugins/filterimages.html">Filter Images manual</ulink> + </para></listitem> + + <listitem><para> + <ulink url="help:/kipi-plugins/recompressimages.html">Recompress Images manual</ulink> + </para></listitem> + + <listitem><para> + <ulink url="help:/kipi-plugins/renameimages.html">Rename Images manual</ulink> + </para></listitem> + + <listitem><para> + <ulink url="help:/kipi-plugins/resizeimages.html">Resize Images manual</ulink> + </para></listitem> + + <listitem><para> + <ulink url="help:/kipi-plugins/rawconverter.html">RAW Converter manual</ulink> + </para></listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <!-- *********************************************************************** --> + + <sect2> <title>The Camera Menu</title> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;menucamera.png" format="PNG"/></imageobject> + <textobject> <phrase>Camera Menu</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + Any configured digital camera will be listed here. You can use the "Add Camera" menu entry to add a new camera to the list. Please, read the <link linkend="cameraselection.anchor">Setup Camera Section</link> + for more information. + </para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <guimenu>Camera</guimenu><guimenuitem>Media Browse</guimenuitem> + </menuchoice></term> + <listitem><para><action>Browsing attached media devices like card readers, DVDs or memory sticks.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Camera</guimenu><guimenuitem>Add camera</guimenuitem> + </menuchoice></term> + <listitem><para><action>Interactively add a new camera.</action></para></listitem> + </varlistentry> + + </variablelist> + + </sect2> + + + <!-- *********************************************************************** --> + + <sect2 id="settings-menu"> <title>The Settings Menu</title> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;menusettings.png" format="PNG"/></imageobject> + <textobject> <phrase>Settings Menu</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + <variablelist> + + <varlistentry> + <term><menuchoice> + <guimenu>Settings</guimenu><guimenuitem>Show Toolbar/Hide Toolbar</guimenuitem> + </menuchoice></term> + <listitem><para><action>Enable or disable the main &digikam; toolbar.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Settings</guimenu><guimenuitem>Show Statusbar/Hide Statusbar</guimenuitem> + </menuchoice></term> + <listitem><para><action>Enable or disable the main &digikam; status bar.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts</guimenuitem> + </menuchoice></term> + <listitem><para><action>Configure the &digikam; shortcuts.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Settings</guimenu><guimenuitem>Configure Toolbars</guimenuitem> + </menuchoice></term> + <listitem><para><action>Configure the &digikam; toolbars.</action></para></listitem> + </varlistentry> + + <varlistentry> + <term><menuchoice> + <guimenu>Settings</guimenu><guimenuitem>Configure &digikam;</guimenuitem> + </menuchoice></term> + <listitem><para><action>Launch &digikam; configure dialog.</action></para></listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + +</sect1> + +<!-- *********************************************************************** --> + +&doc-ie-menu; + +</chapter> diff --git a/doc/en/digikam/menualbum.png b/doc/en/digikam/menualbum.png Binary files differnew file mode 100644 index 00000000..198e1a05 --- /dev/null +++ b/doc/en/digikam/menualbum.png diff --git a/doc/en/digikam/menualbumexport.png b/doc/en/digikam/menualbumexport.png Binary files differnew file mode 100644 index 00000000..c703597e --- /dev/null +++ b/doc/en/digikam/menualbumexport.png diff --git a/doc/en/digikam/menualbumimport.png b/doc/en/digikam/menualbumimport.png Binary files differnew file mode 100644 index 00000000..b38ce98f --- /dev/null +++ b/doc/en/digikam/menualbumimport.png diff --git a/doc/en/digikam/menucamera.png b/doc/en/digikam/menucamera.png Binary files differnew file mode 100644 index 00000000..f201c092 --- /dev/null +++ b/doc/en/digikam/menucamera.png diff --git a/doc/en/digikam/menuhelp.png b/doc/en/digikam/menuhelp.png Binary files differnew file mode 100644 index 00000000..012de071 --- /dev/null +++ b/doc/en/digikam/menuhelp.png diff --git a/doc/en/digikam/menuimage.png b/doc/en/digikam/menuimage.png Binary files differnew file mode 100644 index 00000000..54fdf511 --- /dev/null +++ b/doc/en/digikam/menuimage.png diff --git a/doc/en/digikam/menuimagemetadata.png b/doc/en/digikam/menuimagemetadata.png Binary files differnew file mode 100644 index 00000000..8d3602b4 --- /dev/null +++ b/doc/en/digikam/menuimagemetadata.png diff --git a/doc/en/digikam/menuselect.png b/doc/en/digikam/menuselect.png Binary files differnew file mode 100644 index 00000000..abc8cdb5 --- /dev/null +++ b/doc/en/digikam/menuselect.png diff --git a/doc/en/digikam/menusettings.png b/doc/en/digikam/menusettings.png Binary files differnew file mode 100644 index 00000000..64e24ba4 --- /dev/null +++ b/doc/en/digikam/menusettings.png diff --git a/doc/en/digikam/menutag.png b/doc/en/digikam/menutag.png Binary files differnew file mode 100644 index 00000000..921ddac0 --- /dev/null +++ b/doc/en/digikam/menutag.png diff --git a/doc/en/digikam/menutools.png b/doc/en/digikam/menutools.png Binary files differnew file mode 100644 index 00000000..7c563e91 --- /dev/null +++ b/doc/en/digikam/menutools.png diff --git a/doc/en/digikam/menutoolsbatch.png b/doc/en/digikam/menutoolsbatch.png Binary files differnew file mode 100644 index 00000000..286d8d39 --- /dev/null +++ b/doc/en/digikam/menutoolsbatch.png diff --git a/doc/en/digikam/menuview.png b/doc/en/digikam/menuview.png Binary files differnew file mode 100644 index 00000000..6610d19d --- /dev/null +++ b/doc/en/digikam/menuview.png diff --git a/doc/en/digikam/noisereductiondialog.png b/doc/en/digikam/noisereductiondialog.png Binary files differnew file mode 100644 index 00000000..c5567da3 --- /dev/null +++ b/doc/en/digikam/noisereductiondialog.png diff --git a/doc/en/digikam/noisereductionpreview.png b/doc/en/digikam/noisereductionpreview.png Binary files differnew file mode 100644 index 00000000..0a5002e8 --- /dev/null +++ b/doc/en/digikam/noisereductionpreview.png diff --git a/doc/en/digikam/oilpaintpreview.png b/doc/en/digikam/oilpaintpreview.png Binary files differnew file mode 100644 index 00000000..962a17b7 --- /dev/null +++ b/doc/en/digikam/oilpaintpreview.png diff --git a/doc/en/digikam/perspectivepreview.png b/doc/en/digikam/perspectivepreview.png Binary files differnew file mode 100644 index 00000000..45b2d717 --- /dev/null +++ b/doc/en/digikam/perspectivepreview.png diff --git a/doc/en/digikam/photo-editing.docbook b/doc/en/digikam/photo-editing.docbook new file mode 100644 index 00000000..d9125ec4 --- /dev/null +++ b/doc/en/digikam/photo-editing.docbook @@ -0,0 +1,282 @@ + <sect1 id="photographic-editing"> <title>Photographic Editing - Workflow</title> + + <sect2 id="image-editing-tools"> <title>Image Editing/Workflow Tools</title> + <sect3 id="standard-workflow"> <title>A Standard Workflow Proposal</title> + <para>When performing a basic workflow, the primary areas for consideration are: + <orderedlist> + <listitem><para>Exposure: <link linkend="whitebalance">White Balance</link></para></listitem> + <listitem><para>Color: <link linkend="whitebalance">White Balance</link></para></listitem> + <listitem><para>Black and white points: <link linkend="whitebalance">White Balance</link> or <link linkend="adjustlevels">Adjust Levels</link></para></listitem> + <listitem><para>Contrast: <link linkend="adjustcurves">Adjust Curves</link></para></listitem> + <listitem><para>Saturation: <link linkend="whitebalance">White Balance</link> or <link linkend="coloreffects">Vivid</link> or <link linkend="using-correctingcolor">Hue/Saturation/Lightness</link></para></listitem> + <listitem><para>Resizing (interpolation) : <link linkend="resize">Change Size</link></para></listitem> + <listitem><para><link linkend="sharpening">Sharpening</link></para></listitem> + <listitem><para><ulink url="help:/digikam/inedex.html#dam">Digital Asset Management</ulink> (applying tags, captions, rating, geolocation, save under new name)</para></listitem> + </orderedlist> + We recommend this sequence of image editing steps to ensure optimum photographic quality for the end product. In particular, never do sharpening before the last step. And we recommend using a lossless format like PNG or TIFF for storing photographs. Otherwise you'll lose a bit every time you save the results. If you can afford it, use 16 bit/channel for your best shots. If you want to change color space, in particular if you want to work in CIEL*a*b, 16 bit per channel are required to avoid truncation effects. + </para> + <para>If you swap step 4 and 5, which is well possible if the initial contrast is already very good, you can do the first 4 adjustment in the same plugin, the white balance</para> + <para>Many of the tools you may need for photographic editing are included with &digikam;. Their description follows here. </para> + </sect3> + + <sect3> <title>Introduction to common editing tools features</title> + <para> + All Image Editor tools like Sharpen, Blur, Noise Reduction, Refocus, Unsharp Mask, &etc;. use a common dialog style that previews the effect before applying the filter to the current image. Below you see the "Apply Texture" tool in action using this common dialog layout: + </para> + + <example> + <title>The Apply Texture Tool in Action</title> + <screenshot> + <screeninfo>The Apply Texture Tool in Action</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="&path;editorcommondialogtools.png" format="PNG" /> + </imageobject> + </mediaobject> + </screenshot> + </example> + + <para> + <itemizedlist> + <listitem> + <para> + <emphasis>(1)</emphasis>: The seven buttons to the top left select the comparison style of the preview area. The modes are: + <itemizedlist> + <listitem> <para>Original image</para> </listitem> + <listitem> + <para>Split vertically without duplication. The left area shows the original whereas the right side shows the filter applied to the continuation of the selected zoom.</para> + </listitem> + <listitem> + <para>Split horizontally without duplication. The top area shows the original whereas the lower area shows the filter applied to the continuation of the selected zoom.</para> + </listitem> + <listitem> + <para>Split vertically. The left area shows the original and the right one the filter effect for comparison.</para> + </listitem> + <listitem> + <para>Split horizontally. The top area shows the original and the lower one the filter effect for comparison.</para> + </listitem> + <listitem> + <para>Effect preview. This is a live effect preview without comparison.</para> + </listitem> + <listitem> + <para>'Mouse over' style: preview when mouse is off the preview (in the settings area), otherwise shows original.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para><emphasis>(2)</emphasis>: There are two buttons that can be toggled to show over or underexposure. The colors can be customized in the <link linkend="setupdialog.anchor">general setup page</link>.</para> + </listitem> + <listitem> + <para><emphasis>(3)</emphasis>: The preview selector frame. Click and drag with the mouse on the floating frame to move it on the image. The preview area on the left of dialog is updated accordingly.</para> + </listitem> + <listitem> + <para> <emphasis>(4)</emphasis>: The filter or plugin settings area.</para> + </listitem> + <listitem> + <para> + <emphasis>(5)</emphasis>: At the lower left corner: there is help and a reset to defaults button (all settings are remembered from the last use of the plugin).</para> + </listitem> + <listitem> + <para> + <emphasis>(6)</emphasis>: There is a progress indicator for plugins with involved calculations.</para> + </listitem> + </itemizedlist> + + </para> + </sect3> + + <sect3> <title>The &digikam; tool set</title> + <itemizedlist> + + <listitem><para>Image Color + <itemizedlist> + <listitem><para><link linkend="auto-correction">Auto Correction</link></para></listitem> + <listitem><para><link linkend="exposure-correct">Brightness/Contrast/Gamma</link></para></listitem> + <listitem><para><link linkend="using-correctingcolor">Hue/Saturation/Lightness</link></para></listitem> + <listitem><para><link linkend="colorbalancetool.anchor">Color Balance</link></para></listitem> + <listitem><para><link linkend="blackandwhite-conversion">Black and White</link></para></listitem> + <listitem><para><link linkend="encoding-depth">Encoding Depth</link></para></listitem> + <listitem><para><link linkend="color-management">Color Management</link></para></listitem> + <listitem><para><link linkend="adjustlevels">Levels Adjust</link></para></listitem> + <listitem><para><link linkend="coloreffects">Color Effects (Solarize, Vivid, Neon, Edge)</link></para></listitem> + <listitem><para><link linkend="whitebalance">White Balance/Exposure/Saturation</link></para></listitem> + <listitem><para><link linkend="adjustcurves">Curves Adjust</link></para></listitem> + <listitem><para><link linkend="channelmixer">Channel Mixer</link></para></listitem> + </itemizedlist> + </para></listitem> + + <listitem><para>Image Enhancement + <itemizedlist> + <listitem><para><link linkend="sharpening">Sharpening (sharpen, unsharp mask, refocus)</link></para></listitem> + <listitem><para><link linkend="using-blurfilter" >Blur Tool</link></para></listitem> + <listitem><para><link linkend="using-redeyecorrection">Red Eye Removal</link></para></listitem> + <listitem><para><link linkend="inpainting">Photograph Inpainting</link></para></listitem> + <listitem><para><link linkend="noisereduction">Noise Reduction & blurring</link></para></listitem> + <listitem><para><link linkend="hotpixels">Hot Pixel Correction</link></para></listitem> + <listitem><para><link linkend="lensdistortion">Lens Distortion Correction</link></para></listitem> + <listitem><para><link linkend="restoration">Photograph Restoration</link></para></listitem> + <listitem><para><link linkend="antivignetting">Anti-Vignetting Correction</link></para></listitem> + </itemizedlist> + </para></listitem> + + <listitem><para>Image Transformation Tools + <itemizedlist> + <listitem><para><link linkend="resize">Change Size (reduce and blow-up)</link></para></listitem> + <listitem><para><link linkend="freerotation">Free Rotation</link></para></listitem> + <listitem><para><link linkend="perspective">Perspective Adjustment</link></para></listitem> + <listitem><para><link linkend="sheartool">Shearing Tool</link></para></listitem> + </itemizedlist> + </para></listitem> + + <listitem><para>Image Decoration + <itemizedlist> + <listitem><para><link linkend="border">Add Border</link></para></listitem> + <listitem><para><link linkend="inserttext">Insert Text</link></para></listitem> + <listitem><para><link linkend="superimpose">Template Superimpose</link></para></listitem> + <listitem><para><link linkend="texture">Apply Texture</link></para></listitem> + </itemizedlist> + </para></listitem> + + <listitem><para>Special Effect Filters + <itemizedlist> + <listitem><para><link linkend="infrared">Simulate Infrared Film.</link></para></listitem> + <listitem><para><link linkend="filmgrain">Add Film Grain.</link></para></listitem> + <listitem><para><link linkend="oilpaint">Simulate Oil Painting</link></para></listitem> + <listitem><para><link linkend="charcoal">Simulate Charcoal Drawing.</link></para></listitem> + <listitem><para><link linkend="emboss">Emboss Photograph.</link></para></listitem> + <listitem><para><link linkend="distortionfx">Distortion FX.</link></para></listitem> + <listitem><para><link linkend="blurfx">Blur FX.</link></para></listitem> + <listitem><para><link linkend="raindrops">Add Rain Drops</link></para></listitem> + </itemizedlist> + </para></listitem> + + </itemizedlist> + </sect3> + + </sect2> + + <sect2 id="raw-workflow"> <title>Processing RAW image files, RAW work-flow</title> + <anchor id="rawprocessing.anchor"/> + + <para>A typical RAW workflow with &digikam; may follow these steps:</para> + <itemizedlist> + <listitem><para>Setting up the RAW conversion and color management preferences + <itemizedlist> + <listitem><para>get the ICC color profiles for the camera, display and printer</para></listitem> + <listitem><para>setup &digikam; correctly defining a color work space </para></listitem> + </itemizedlist> + </para></listitem> + <listitem><para>Camera whitepoint setting</para></listitem> + <listitem><para>Demosaicing (includes interpolation, noise filtering and + <ulink url="help:/digikam/using-setup.html#CA.anchor">chromatic abberation correction.</ulink> + </para></listitem> + <listitem><para>Conversion to a color space</para> </listitem> + <listitem><para>Gamma correction, tone mapping</para> </listitem> + <listitem><para>Color profile assignment</para> </listitem> + <listitem><para>Dynamic range expansion (optional)</para></listitem> + <listitem><para>Continue with <link linkend="standard-workflow">standard workflow</link></para></listitem> + </itemizedlist> + + <para> + From there everything is simple, select a RAW image and open it in the editor. The color management widget will be displayed after the image has been processed in order to adjust color rendering. Without color management all images are very dark, this is normal. You can experiment the various profiles you have in order to select the best input profile according to your image (some tends to be very neutral, even a bit dull, some gives more saturated results, &etc;). + </para> + </sect2> + + + &doc-editor-color; + + &doc-editor-enhance; + + &doc-editor-transform; + + &doc-editor-decorate; + + &doc-editor-filters; + + </sect1> + + <sect1 id="using-iccprofile"> <title>ICC color profile management</title> + + <para> + What is the importance of ICC color profile management anyway? In simple terms it is alike hi-fi stereo, where high fidelity is maximized from source to speakers, passing through microphone, recoding media, player and amplifier. Much the same, ICC color profile management tries to maintain color fidelity from photographic subject through the camera to the output media screen, print, paper and beamer. Luckily digital photography has taken out one source of distortion, the storage media (as the &CD-ROM; did in the audio field). + </para> + + <para>The figure below images the problem: Every time there is a transfer from one device to another, an ICC profile is used to compensate for the inaccuracies or limitations of the device. The central work space (which is called Profile Connection Space, PCS) provides a common platform to translate the device color spaces into each other. + </para> + + <para>The inter-connection between devices and their color spaces</para> + <para> + <inlinemediaobject><imageobject><imagedata + fileref="&path;colormanagement.png" format="PNG" /> </imageobject></inlinemediaobject> + </para> + + + <tip> + <para><emphasis>CM Pros.</emphasis> CM is really important whenever you need identical results between shooting sessions, accurate source reproduction, close rendering results between various display media (this would rather point CM to professionals).</para> + <para>As a passionate amateur you can also profit from CM, since it is mostly associated with 16 bit color depth. RAW mode shooting is much more forgiving in terms of exposure than processed shooting (JPEG), so you can generally underexpose and recover the highlights. And, the human eye is much more sensitive to luminosity variations in the dark scales than a digital camera. Careful tonal adjustment close to the blacks will produce a better dynamic of the image. That is why RAW mode images often have an appearance of more depth to them.</para> + + <para><emphasis>CM Cons.</emphasis> If you do not use color management you still can realize fantastic images. In journalism or emotional contexts, for holiday photos you do not need any color management.</para> + </tip> + + <para>To configure &digikam; for ICC color management, please refer to the <ulink url="help:/digikam/using-setup.html#setup-iccprofiles">setup section.</ulink> + </para> + + <para> + The ICC standard covers a data format to exchange color information of devices. ISO 22028-1 specifies unambiguous exchange of color image data of color space encoding, viewing conditions, image state and reference medium. Here follows an example of the differences in color language: one kind of green defined (by the same numbers) in one color space looks different in another color space. This is what happens when no color management is applied. + </para> + <para> + (88, 249, 16) in Adobe RGB <inlinemediaobject><imageobject><imagedata fileref="&path;2Greens.png" format="PNG"/></imageobject></inlinemediaobject> The same RGB value in sRGB. Here is a <ulink url="http://www.cs.rit.edu/~ncs/color/a_spaces.html">link</ulink> where you can play with color spaces. + </para> + + <para> + Photographers want to use the full gamut of their camera and their ink jet printers. Editing of images should be done in a work space, where equal RGB-numbers result into gray (like #333 or #CCC). + </para> + + <para> + The following diagram tries to outline the logic &digikam; will follow in its CM work flow, depending on the settings made in <emphasis>IO Files</emphasis> and <emphasis>ICC profiles</emphasis> of the configuration page. + </para> + + <para> + <inlinemediaobject><imageobject> + <imagedata fileref="&path;ICCworkflowlogic.png" format="PNG" /> + </imageobject></inlinemediaobject> + </para> + + + <sect2 id="softproofing"> + <title>Soft Proofing</title> + <para> Soft Proofing is a way of previewing on the screen (monitor) the result to be expected from an output on another device, typically a printer. Soft proofing will show you the difference to be expected before you actually do it (and waste your costly ink). So you can improve your settings without wasting time and money. + </para> + + </sect2> + + <sect2 id="rendering-intention"> + <title>Rendering intention</title> + + <para>Rendering intent refers to the way gamuts are handled when the intended target color space cannot handle the full gamut.</para> + <itemizedlist> + + <listitem><para><emphasis>Perceptual</emphasis>, also called Image or Maintain Full Gamut. This is generally recommended for photographic images. The color gamut is expanded or compressed when moving between color spaces to maintain consistent overall appearance. Low saturation colors are changed very little. More saturated colors within the gamuts of both spaces may be altered to differentiate them from saturated colors outside the smaller gamut space. Perceptual rendering applies the same gamut compression to all images, even when the image contains no significant out-of-gamut colors.</para> + </listitem> + + <listitem><para><emphasis>Relative Colorimetric</emphasis>, also called Proof or Preserve Identical Color and White Point. Reproduces in-gamut colors exactly and clips out-of-gamut colors to the nearest reproducible hue.</para> + </listitem> + + <listitem><para><emphasis>Absolute Colorimetric</emphasis>, also called Match or Preserve Identical Colors. Reproduces in-gamut colors exactly and clips out-of-gamut colors to the nearest reproducible hue, sacrificing saturation and possibly lightness. On tinted papers, whites may be darkened to keep the hue identical to the original. For example, cyan may be added to the white of a cream-colored paper, effectively darkening the image. Rarely of interest to photographers.</para> + </listitem> + + <listitem><para><emphasis>Saturation</emphasis>, also called Graphic or Preserve Saturation. Maps the saturated primary colors in the source to saturated primary colors in the destination, neglecting differences in hue, saturation, or lightness. For block graphics; rarely of interest to photographers.</para> + </listitem> + + </itemizedlist> + + </sect2> + + <sect2 id="iccprofile-links"> + <title>Links</title> + <para><ulink url="http://www.oyranos.org/wiki/index.php?title=Main_Page">Color wiki</ulink> <ulink url="http://en.wikipedia.org/wiki/CIELAB">CIELab</ulink> <ulink url="http://en.wikipedia.org/wiki/Gamut">Gamut explained</ulink></para> + </sect2> + + </sect1> + diff --git a/doc/en/digikam/raindropspreview.png b/doc/en/digikam/raindropspreview.png Binary files differnew file mode 100644 index 00000000..26bdddcb --- /dev/null +++ b/doc/en/digikam/raindropspreview.png diff --git a/doc/en/digikam/refocus-notsharpened.png b/doc/en/digikam/refocus-notsharpened.png Binary files differnew file mode 100644 index 00000000..88ba3337 --- /dev/null +++ b/doc/en/digikam/refocus-notsharpened.png diff --git a/doc/en/digikam/refocus-refocus.png b/doc/en/digikam/refocus-refocus.png Binary files differnew file mode 100644 index 00000000..335735bd --- /dev/null +++ b/doc/en/digikam/refocus-refocus.png diff --git a/doc/en/digikam/refocus-sharped.png b/doc/en/digikam/refocus-sharped.png Binary files differnew file mode 100644 index 00000000..0d688a5d --- /dev/null +++ b/doc/en/digikam/refocus-sharped.png diff --git a/doc/en/digikam/refocus-unsharpmask.png b/doc/en/digikam/refocus-unsharpmask.png Binary files differnew file mode 100644 index 00000000..83b5046b --- /dev/null +++ b/doc/en/digikam/refocus-unsharpmask.png diff --git a/doc/en/digikam/refocusdialog.png b/doc/en/digikam/refocusdialog.png Binary files differnew file mode 100644 index 00000000..d971db03 --- /dev/null +++ b/doc/en/digikam/refocusdialog.png diff --git a/doc/en/digikam/restorationdialog.png b/doc/en/digikam/restorationdialog.png Binary files differnew file mode 100644 index 00000000..90eb28da --- /dev/null +++ b/doc/en/digikam/restorationdialog.png diff --git a/doc/en/digikam/restorationpreview.png b/doc/en/digikam/restorationpreview.png Binary files differnew file mode 100644 index 00000000..d4dc777a --- /dev/null +++ b/doc/en/digikam/restorationpreview.png diff --git a/doc/en/digikam/restorationpreview2.png b/doc/en/digikam/restorationpreview2.png Binary files differnew file mode 100644 index 00000000..0ad55f6a --- /dev/null +++ b/doc/en/digikam/restorationpreview2.png diff --git a/doc/en/digikam/restorationsettings1.png b/doc/en/digikam/restorationsettings1.png Binary files differnew file mode 100644 index 00000000..51f671ac --- /dev/null +++ b/doc/en/digikam/restorationsettings1.png diff --git a/doc/en/digikam/restorationsettings2.png b/doc/en/digikam/restorationsettings2.png Binary files differnew file mode 100644 index 00000000..37d36101 --- /dev/null +++ b/doc/en/digikam/restorationsettings2.png diff --git a/doc/en/digikam/setupaddcamera.png b/doc/en/digikam/setupaddcamera.png Binary files differnew file mode 100644 index 00000000..c0a02a7b --- /dev/null +++ b/doc/en/digikam/setupaddcamera.png diff --git a/doc/en/digikam/setupalbum.png b/doc/en/digikam/setupalbum.png Binary files differnew file mode 100644 index 00000000..6508e45a --- /dev/null +++ b/doc/en/digikam/setupalbum.png diff --git a/doc/en/digikam/setupcamera.png b/doc/en/digikam/setupcamera.png Binary files differnew file mode 100644 index 00000000..69fd7dd9 --- /dev/null +++ b/doc/en/digikam/setupcamera.png diff --git a/doc/en/digikam/setupcollections.png b/doc/en/digikam/setupcollections.png Binary files differnew file mode 100644 index 00000000..cdd705f6 --- /dev/null +++ b/doc/en/digikam/setupcollections.png diff --git a/doc/en/digikam/setupembeddedinfo.png b/doc/en/digikam/setupembeddedinfo.png Binary files differnew file mode 100644 index 00000000..5e186acb --- /dev/null +++ b/doc/en/digikam/setupembeddedinfo.png diff --git a/doc/en/digikam/setupiccprofiles.png b/doc/en/digikam/setupiccprofiles.png Binary files differnew file mode 100644 index 00000000..14c53f1e --- /dev/null +++ b/doc/en/digikam/setupiccprofiles.png diff --git a/doc/en/digikam/setupimageeditor.png b/doc/en/digikam/setupimageeditor.png Binary files differnew file mode 100644 index 00000000..cbf12678 --- /dev/null +++ b/doc/en/digikam/setupimageeditor.png diff --git a/doc/en/digikam/setupimageplugins.png b/doc/en/digikam/setupimageplugins.png Binary files differnew file mode 100644 index 00000000..b4a60707 --- /dev/null +++ b/doc/en/digikam/setupimageplugins.png diff --git a/doc/en/digikam/setupkipiplugins.png b/doc/en/digikam/setupkipiplugins.png Binary files differnew file mode 100644 index 00000000..786ef098 --- /dev/null +++ b/doc/en/digikam/setupkipiplugins.png diff --git a/doc/en/digikam/setuplighttable.png b/doc/en/digikam/setuplighttable.png Binary files differnew file mode 100644 index 00000000..4ec506bd --- /dev/null +++ b/doc/en/digikam/setuplighttable.png diff --git a/doc/en/digikam/setupmimetypes.png b/doc/en/digikam/setupmimetypes.png Binary files differnew file mode 100644 index 00000000..5d580c7d --- /dev/null +++ b/doc/en/digikam/setupmimetypes.png diff --git a/doc/en/digikam/setupmisc.png b/doc/en/digikam/setupmisc.png Binary files differnew file mode 100644 index 00000000..008dfa47 --- /dev/null +++ b/doc/en/digikam/setupmisc.png diff --git a/doc/en/digikam/setuprawfiledecoding.png b/doc/en/digikam/setuprawfiledecoding.png Binary files differnew file mode 100644 index 00000000..c26aa7d6 --- /dev/null +++ b/doc/en/digikam/setuprawfiledecoding.png diff --git a/doc/en/digikam/setupsaveimages.png b/doc/en/digikam/setupsaveimages.png Binary files differnew file mode 100644 index 00000000..286e644c --- /dev/null +++ b/doc/en/digikam/setupsaveimages.png diff --git a/doc/en/digikam/setupslideshow.png b/doc/en/digikam/setupslideshow.png Binary files differnew file mode 100644 index 00000000..75c33d24 --- /dev/null +++ b/doc/en/digikam/setupslideshow.png diff --git a/doc/en/digikam/setupthemeclean.png b/doc/en/digikam/setupthemeclean.png Binary files differnew file mode 100644 index 00000000..8adb50ec --- /dev/null +++ b/doc/en/digikam/setupthemeclean.png diff --git a/doc/en/digikam/setupthemedark.png b/doc/en/digikam/setupthemedark.png Binary files differnew file mode 100644 index 00000000..a4a16f00 --- /dev/null +++ b/doc/en/digikam/setupthemedark.png diff --git a/doc/en/digikam/setupthemedefault.png b/doc/en/digikam/setupthemedefault.png Binary files differnew file mode 100644 index 00000000..9de06795 --- /dev/null +++ b/doc/en/digikam/setupthemedefault.png diff --git a/doc/en/digikam/setupthemedessert.png b/doc/en/digikam/setupthemedessert.png Binary files differnew file mode 100644 index 00000000..60cb9125 --- /dev/null +++ b/doc/en/digikam/setupthemedessert.png diff --git a/doc/en/digikam/setupthemedigicasa.png b/doc/en/digikam/setupthemedigicasa.png Binary files differnew file mode 100644 index 00000000..892d2db7 --- /dev/null +++ b/doc/en/digikam/setupthemedigicasa.png diff --git a/doc/en/digikam/setupthemedreary.png b/doc/en/digikam/setupthemedreary.png Binary files differnew file mode 100644 index 00000000..b6756711 --- /dev/null +++ b/doc/en/digikam/setupthemedreary.png diff --git a/doc/en/digikam/setupthememarine.png b/doc/en/digikam/setupthememarine.png Binary files differnew file mode 100644 index 00000000..b6602980 --- /dev/null +++ b/doc/en/digikam/setupthememarine.png diff --git a/doc/en/digikam/setupthemeorangecrush.png b/doc/en/digikam/setupthemeorangecrush.png Binary files differnew file mode 100644 index 00000000..ba07aa54 --- /dev/null +++ b/doc/en/digikam/setupthemeorangecrush.png diff --git a/doc/en/digikam/setupthemesandy.png b/doc/en/digikam/setupthemesandy.png Binary files differnew file mode 100644 index 00000000..398735af --- /dev/null +++ b/doc/en/digikam/setupthemesandy.png diff --git a/doc/en/digikam/setuptooltip.png b/doc/en/digikam/setuptooltip.png Binary files differnew file mode 100644 index 00000000..ed67d0fa --- /dev/null +++ b/doc/en/digikam/setuptooltip.png diff --git a/doc/en/digikam/sheartoolpreview.png b/doc/en/digikam/sheartoolpreview.png Binary files differnew file mode 100644 index 00000000..6aec7baa --- /dev/null +++ b/doc/en/digikam/sheartoolpreview.png diff --git a/doc/en/digikam/sidebar.docbook b/doc/en/digikam/sidebar.docbook new file mode 100644 index 00000000..f63b97b8 --- /dev/null +++ b/doc/en/digikam/sidebar.docbook @@ -0,0 +1,384 @@ + <sect2 id="using-sidebarfileproperties"> + <title>Properties</title> + <para> + The properties sidebar shows the essential information about the selected image which are largely self-explanatory. It is grouped into the following sections: + <itemizedlist> + + <listitem><para>File Properties: these are file system related information</para></listitem> + + <listitem><para>Image Properties: shows the image and format properties like dimension, compression, color-depth, &etc;</para></listitem> + + <listitem><para>Photograph Properties: shows a summary of the most important parameters when taking the photograph. This data is taken from the EXIF data fields if available</para></listitem> + + </itemizedlist> + + <example> <title>Sidebar File Properties</title> + <screenshot><screeninfo>sidebar File Properties Example</screeninfo><mediaobject><imageobject><imagedata fileref="&path;sidebarfileproperties.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </para> + </sect2> + + <sect2 id="using-sidebarmetadata"> + <title>The Metadata Tabs</title> + + <para> + The metadata sidebar is composed of four sub tabs <guilabel>EXIF, Makernotes, IPTC and GPS data</guilabel>. On the left, two button let you choose between full and simplified data display. Next to it are a printer and copy icon, They do just that - print (&kprinter; dialog) or copy the respective tab data to the clipboard. In the main window view you will find a navigation button set with the file name on top of the tabs. + </para> + <para>Metadata, as shown in the for tabs, can be modified and enhanced in a number of ways elsewhere: + <itemizedlist> + <listitem><para>with the <ulink url="help:/index.html#using-cameraclientrenaming">camera dialog</ulink></para></listitem> + <listitem><para>the <ulink url="help:/kipi-plugins/metadataeditor.html">metadata editor</ulink></para></listitem> + <listitem><para>the <ulink url="help:/kipi-plugins/geolocalization.html">GPS-locator</ulink></para></listitem> + <listitem><para><ulink url="help:/menu-descriptions#synchronize-metadata">copying</ulink> database metadata to files</para></listitem> + <listitem><para><ulink url="help:/menu-descriptions#update-db-metadata">copying</ulink> file's metadata to the database</para></listitem> + </itemizedlist> + </para> + + <para><inlinemediaobject><imageobject><imagedata fileref="&path;sidebarmetadata.png" format="PNG" /> </imageobject><textobject><phrase>The Metadata Tabs</phrase></textobject></inlinemediaobject> + </para> + + <sect3 id="using-sidebarmetadataexif"> + <title>EXIF Tags</title> + + <anchor id="kexif.anchor"/> + + <sect4> + <title>What is EXIF?</title> + + <para> + EXIF stands for <ulink url="http://www.exif.org">EXtended Interchange Format</ulink>. It was designed specifically for digital cameras. It allows a large amount of information about the photograph to be stored. This information describes the camera which took the image along with the settings (including date and time) in use when the image was taken. An in-line thumbnail can be included. + </para> + + <para> + EXIF format contains a set of marker sections named <emphasis>Image File Directories</emphasis> (IFD). The sections likely to be found in a normal EXIF file are as follows: + + <itemizedlist> + + <listitem><para> + <guilabel>Image Information</guilabel>: contains general information about the image. + </para></listitem> + + <listitem><para> + <guilabel>Embedded Thumbnail</guilabel>: contains information about the embedded thumbnail image. + </para></listitem> + + <listitem><para> + <guilabel>Photograph Information</guilabel>: contains extended information about the photograph. + </para></listitem> + + <listitem><para> + <guilabel>Interoperability</guilabel>: contains information to support interoperability between different EXIF implementations. + </para></listitem> + + </itemizedlist> + + </para> + + </sect4> + + <sect4> + <title>How to Use EXIF Viewer?</title> + + <para> + You can review embedded EXIF information for the selected image from the first sidebar tab. The EXIF Viewer is purely informational: nothing you do with it will cause any change to the EXIF sections. If there are more entries than space available, just scroll down with the mouse wheel. + </para> + + <para> + You can use two different levels to display EXIF marker sections: + + <itemizedlist> + + <listitem><para> + <guilabel>Simple</guilabel>: display only more important EXIF marker for photograph. + </para></listitem> + + <listitem><para> + <guilabel>Full</guilabel>: display all EXIF markers. + </para></listitem> + + </itemizedlist> + + For the displayed data, EXIF Viewer provides a contextual help. Select an item with &RMB; and the corresponding help can be displayed with the "What's This?" option of the dialog. + </para> + + <para> + Some vendors add additional EXIF sections, such as Canon, Fujifilm, Nikon, Minolta, and Sigma. These sections contain vendor and model specific notes. These will be displayed in the <guilabel>Makernote</guilabel> section. + </para> + + </sect4> + + </sect3> + + <sect3 id="using-sidebarmetadatamakernote"> + <title>Makernote Tags</title> + + <sect4> + <title>What is Makernote?</title> + + <para> + The EXIF standard defines a Makernote tag, which allows camera manufacturers to place any custom format metadata in the file. This is used increasingly by camera manufacturers to store a myriad of camera settings not listed in the EXIF standard, such as shooting modes, post-processing settings, serial number, focusing modes, &etc; As this tag format is proprietary and manufacturer specific. + </para> + + </sect4> + + <sect4> + <title>How to Use Makernote Viewer</title> + + <para> + You can review embedded Makernote information for the selected image from the first sidebar tab. The Makernote Viewer is purely informational: nothing you do with it will cause any change to the Makernote sections. + </para> + + <para><inlinemediaobject><imageobject><imagedata fileref="&path;sidebarmetadatamakernote.png" format="PNG" /> </imageobject><textobject><phrase>The Makernote Viewer in Action</phrase></textobject></inlinemediaobject> + </para> + + </sect4> + + </sect3> + + <sect3 id="using-sidebarmetadataiptc"> + <title>IPTC Tags</title> + + <sect4> + <title>What is IPTC?</title> + + <para> + The <ulink url="http://www.iptc.org">International Press Telecommunications Council</ulink>, is a consortium of the world's major news agencies and news industry vendors. It develops and maintains technical standards for improved news exchange that are used by virtually every major news organization in the world. + </para> + + <para> + The IPTC was established in 1965 by a group of news organizations to safeguard the telecommunications interests of the world's press. Since the late 1970s IPTC's activities have primarily focused on developing and publishing industry standards for the interchange of news data. + </para> + + <para> + In particular, the IPTC defined a set of metadata attributes that can be applied to images. These were defined originally in 1979, and revised significantly in 1991 to be the "Information Interchange Model" (IIM), but the concept really advanced in 1994 when Adobe defined a specification for actually embedding the metadata into digital image files - known as "IPTC headers". + </para> + + </sect4> + + <sect4> + <title>How to Use IPTC Viewer</title> + + <para> + You can review embedded IPTC information for the selected image from the first sidebar tab. The IPTC Viewer is purely informational: nothing you do with it will cause any change to the IPTC sections. + </para> + + <para><inlinemediaobject><imageobject><imagedata fileref="&path;sidebarmetadataiptc.png" format="PNG" /> </imageobject><textobject><phrase>The IPTC Viewer in Action</phrase></textobject></inlinemediaobject> + </para> + + </sect4> + + </sect3> + + <sect3 id="using-sidebarmetadatagps"> + <title>Metadata GPS tab</title> + + <sect4> + <title>What is GPS?</title> + + <para> + The <ulink url="http://en.wikipedia.org/wiki/Global_Positioning_System">Global Positioning System</ulink> usually called GPS, is the only fully functional satellite navigation system. A constellation of more than two dozen GPS satellites broadcasts precise timing signals by radio, allowing any GPS receiver to accurately determine its location (longitude, latitude, and altitude) anywhere on Earth. GPS also provides an extremely precise time reference and gauge speed with a very high degree of accuracy. + </para> + + <para> + GPS information can be stored in images directly by supported cameras or by synchronizing photographs with an external GPS device track. Look at this <ulink url="help:/digikam/using-camera.html#using-gps">section</ulink> for more information. + </para> + + </sect4> + + <sect4> + <title>How to Use GPS Locator</title> + + <para> + This tab provides the GPS section of the metadata. The displayed positioning data are actually stored in the image's EXIF tags (and not yet in the database). That allows the location to be read by any other application that can understand EXIF GPS data. + </para> + + <para> + In this tab, a little world map shows where the image has been taken. If you want a more detailed map, just select on the bottom your favorite web map service and press <guilabel>More Info</guilabel> to launch an external web browser instance. + </para> + + <example> <title>sidebar Metadata GPS info</title> + <screenshot><screeninfo>sidebar Metadata info</screeninfo><mediaobject><imageobject><imagedata fileref="&path;sidebarmetadatagps.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </sect4> + + </sect3> + + </sect2> + + <sect2 id="using-sidebarcolors"> + <title>Colors</title> + <para> + The colors sidebar has two sub tabs <guilabel>Color and ICC Profile</guilabel>. Here are more details about <link linkend="using-iccprofile">Color Management</link> + </para> + + <sect3 id="using-histogramviewer"> + <title>Histogram Viewer</title> + + <anchor id="histogramviewer.anchor"/> + + <para> + The histogram for an image shows the amount of each color that is present and their different amplitudes within the image. If your photograph has a color cast you might be able to see what is wrong by looking at the histogram. + </para> + + <para> + The Histogram Viewer shows the statistical distribution of color values in the current image. It is purely informational: nothing you do with it will cause any change to the image. If you want to perform a histogram based color correction, use the Adjust Levels or Adjust Curves Image Editor plugin. + </para> + + <example> <title>The Histogram Viewer in Action</title> + <screenshot><screeninfo>The Histogram Viewer in Action</screeninfo><mediaobject><imageobject><imagedata fileref="&path;sidebarcolorshistogramviewer.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + <para> + An image can be decomposed into <guilabel>Red</guilabel>, <guilabel>Green</guilabel>, <guilabel>Blue</guilabel>, <guilabel>Alpha</guilabel> color channels. <guilabel>Alpha</guilabel> channel is a Layer in the image that supports transparency (like PNG or &GIF; images). Each channel supports a range of intensity levels from 0 to 255 (integer valued). Thus, a black pixel is encoded by 0 on all color channels; a white pixel by 255 on all color channels. A transparent pixel is encoded by 0 on the alpha channel; an opaque pixel by 255. + </para> + + <para> + The Histogram Viewer allows you to view each channel separately: + + <itemizedlist> + + <listitem><para> + <guilabel>Intensity</guilabel>: shows the distribution of brightness values. + </para></listitem> + + <listitem><para> + <guilabel>Red</guilabel>, <guilabel>Green</guilabel>, <guilabel>Blue</guilabel>: show the distribution of intensity levels for the Red, Green, or Blue channels respectively. + </para></listitem> + + <listitem><para> + <guilabel>Alpha</guilabel>: shows the distribution of opacity levels. If the layer is completely opaque or completely transparent, the histogram will consist of a single bar on the left or right edge. + </para></listitem> + + <listitem><para> + <guilabel>Colors</guilabel>: shows the <guilabel>Red</guilabel>, <guilabel>Green</guilabel>, and <guilabel>Blue</guilabel> histograms superposed, so that you can see all of the color distribution information in a single view. In this mode, the histogram foreground color can be chosen with the <guilabel>Color</guilabel> option. + </para></listitem> + + </itemizedlist> + + </para> + + <para> + With the <guilabel>Rendering</guilabel> option, you can determine whether the histogram will be displayed using the <guilabel>Full Image</guilabel> data or only with the current <guilabel>Image Selection</guilabel>. This option can only be enabled if you have previously selected an image region with Image Editor. + </para> + + <para> + With <guilabel>Scale</guilabel> option, you can determine whether the histogram will be displayed using a linear or logarithmic Y axis. For images taken with a digital camera, the <guilabel>Linear</guilabel> mode is usually the most useful. However, for images that contain substantial areas of constant color a <guilabel>Linear</guilabel> histogram will often be dominated by a single bar. In this case a <guilabel>Logarithmic</guilabel> histogram will be more useful. + </para> + + <para> + You can restrict the analysis of the <guilabel>Statistics</guilabel> field shown at the bottom of the dialog to a limited range of values if you wish. You can set the range in one of two ways: + + <itemizedlist> + + <listitem><para> + Click and drag the pointer across the histogram display area, from the lowest level to the highest level of the range you want. + </para></listitem> + + <listitem><para> + Use the spin button entries below the histogram area. Left entry is bottom of range and right entry is top of range. + </para></listitem> + + </itemizedlist> + + </para> + + <para> + The statistics shown at the bottom of the Histogram Viewer describe the distribution of channel values, restricted to the selected range. These are: + + <itemizedlist> + + <listitem><para> + The mean. + </para></listitem> + + <listitem><para> + The standard deviation. + </para></listitem> + + <listitem><para> + The median of the selected histogram portion. + </para></listitem> + + <listitem><para> + The number of pixels in the image. + </para></listitem> + + <listitem><para> + The number whose values fall within the selected range. + </para></listitem> + + <listitem><para> + The percentage whose values fall within the selected range. + </para></listitem> + + </itemizedlist> + + In <guilabel>Colors</guilabel> channel mode, the statistics is updated with the foreground color selected with <guilabel>Color</guilabel> option. + </para> + + </sect3> + + <sect3 id="using-usinghistogram"> + <title>How To Use an Histogram</title> + + <para> + Histograms are a graphical means to assess the accuracy of an image shown on the screen. The graph represents the 3 regions of the photograph brightness: + + <itemizedlist> + + <listitem><para> + (1) : the shadows-tone on the left. + </para></listitem> + + <listitem><para> + (2) : the middle-tone on the middle. + </para></listitem> + + <listitem><para> + (3) : the highlights-tone on the right. + </para></listitem> + + </itemizedlist> + + <example> <title>An Image Histogram in All Colors Mode</title> + <screenshot><screeninfo>An Image Histogram in All Colors Mode</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorhistogramdescription.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + The distribution of the graph, where the spikes and bulges are clustered, indicates whether the image is too dark, too bright, or well-balanced. + </para> + + <para> + With an under exposed photograph, the histogram will have a distribution of brightness that tends to be mostly on the left of the graph. + + <example> <title>An Over Exposed Photograph</title> + <screenshot><screeninfo>An Over Exposed Photograph</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorhistogramsample3.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + With a correctly exposed photograph, the histogram will have a distribution of brightness that will be most prominent near the center part of the graph. + + <example> <title>A Correctly Exposed Photograph</title> + <screenshot><screeninfo>A Correctly Exposed Photograph</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorhistogramsample2.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + With an over exposed photograph, the histogram will have the bulge showing the brightness distributed mostly towards the right of the graph. + + <example> <title>An Under Exposed Photograph</title> + <screenshot><screeninfo>An Under Exposed Photograph</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editorhistogramsample1.png" format="PNG" /> </imageobject></mediaobject></screenshot> + </example> + + </para> + + <para> + Important: not all photographs have to exhibit this bulge in the center part of their histogram. Much depends on the subject of the photograph. In some cases, it might be appropriate for the histogram to show a peak at one end or the other, or both. + </para> + + <para> + The histogram is a reliable way of deciding whether or not a photograph is correctly exposed. Should the histogram show an over or under exposure, an <link linkend="exposure-correct">Exposure Correction Tool</link> should be used to fix the photograph. + </para> + + </sect3> + + </sect2> + diff --git a/doc/en/digikam/sidebarcolorshistogramviewer.png b/doc/en/digikam/sidebarcolorshistogramviewer.png Binary files differnew file mode 100644 index 00000000..e779a254 --- /dev/null +++ b/doc/en/digikam/sidebarcolorshistogramviewer.png diff --git a/doc/en/digikam/sidebarcommentstags.png b/doc/en/digikam/sidebarcommentstags.png Binary files differnew file mode 100644 index 00000000..3cfb99b2 --- /dev/null +++ b/doc/en/digikam/sidebarcommentstags.png diff --git a/doc/en/digikam/sidebarfileproperties.png b/doc/en/digikam/sidebarfileproperties.png Binary files differnew file mode 100644 index 00000000..0b76cd8f --- /dev/null +++ b/doc/en/digikam/sidebarfileproperties.png diff --git a/doc/en/digikam/sidebarmetadata.png b/doc/en/digikam/sidebarmetadata.png Binary files differnew file mode 100644 index 00000000..0210347c --- /dev/null +++ b/doc/en/digikam/sidebarmetadata.png diff --git a/doc/en/digikam/sidebarmetadataexif.png b/doc/en/digikam/sidebarmetadataexif.png Binary files differnew file mode 100644 index 00000000..74be97c1 --- /dev/null +++ b/doc/en/digikam/sidebarmetadataexif.png diff --git a/doc/en/digikam/sidebarmetadatagps.png b/doc/en/digikam/sidebarmetadatagps.png Binary files differnew file mode 100644 index 00000000..fa18d77f --- /dev/null +++ b/doc/en/digikam/sidebarmetadatagps.png diff --git a/doc/en/digikam/sidebarmetadataiptc.png b/doc/en/digikam/sidebarmetadataiptc.png Binary files differnew file mode 100644 index 00000000..66cbb07e --- /dev/null +++ b/doc/en/digikam/sidebarmetadataiptc.png diff --git a/doc/en/digikam/sidebarmetadatamakernote.png b/doc/en/digikam/sidebarmetadatamakernote.png Binary files differnew file mode 100644 index 00000000..c200a5b7 --- /dev/null +++ b/doc/en/digikam/sidebarmetadatamakernote.png diff --git a/doc/en/digikam/sidebartagfilters.png b/doc/en/digikam/sidebartagfilters.png Binary files differnew file mode 100644 index 00000000..4933e4e9 --- /dev/null +++ b/doc/en/digikam/sidebartagfilters.png diff --git a/doc/en/digikam/solarizepreview.png b/doc/en/digikam/solarizepreview.png Binary files differnew file mode 100644 index 00000000..d050de02 --- /dev/null +++ b/doc/en/digikam/solarizepreview.png diff --git a/doc/en/digikam/superimposepreview.png b/doc/en/digikam/superimposepreview.png Binary files differnew file mode 100644 index 00000000..6d77dd5f --- /dev/null +++ b/doc/en/digikam/superimposepreview.png diff --git a/doc/en/digikam/texturedialog.png b/doc/en/digikam/texturedialog.png Binary files differnew file mode 100644 index 00000000..d036d2ff --- /dev/null +++ b/doc/en/digikam/texturedialog.png diff --git a/doc/en/digikam/texturepreview.png b/doc/en/digikam/texturepreview.png Binary files differnew file mode 100644 index 00000000..383e3a07 --- /dev/null +++ b/doc/en/digikam/texturepreview.png diff --git a/doc/en/digikam/unsharpdialog.png b/doc/en/digikam/unsharpdialog.png Binary files differnew file mode 100644 index 00000000..441f9aeb --- /dev/null +++ b/doc/en/digikam/unsharpdialog.png diff --git a/doc/en/digikam/unsharppreview.png b/doc/en/digikam/unsharppreview.png Binary files differnew file mode 100644 index 00000000..1a8fa497 --- /dev/null +++ b/doc/en/digikam/unsharppreview.png diff --git a/doc/en/digikam/whitebalancedialog.png b/doc/en/digikam/whitebalancedialog.png Binary files differnew file mode 100644 index 00000000..60bf5f80 --- /dev/null +++ b/doc/en/digikam/whitebalancedialog.png diff --git a/doc/en/showfoto/Makefile.am b/doc/en/showfoto/Makefile.am new file mode 100644 index 00000000..dcf3118c --- /dev/null +++ b/doc/en/showfoto/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = en +KDE_DOCS = showfoto diff --git a/doc/en/showfoto/README b/doc/en/showfoto/README new file mode 100644 index 00000000..11fdae2d --- /dev/null +++ b/doc/en/showfoto/README @@ -0,0 +1,38 @@ +Handbook README: +---------------- + +>>> How to Make Screenshot for Manual with Alpha Blending 3D Border <<< + +- Never use advanced color theme to make screenshots. Always use KDE default color. + +- Use KSnapshot for take a shot. Use region selection option for take only + important area. Remove buttons and dialog hearder for limit image file size. + _ALWAYS use PNG file format to save image. + +- Open your screenshot in Gimp 2.0 and make operations below: + + * Script-Fu/Decor/Add Border with this options : + -> Border X Size = 1 + -> Border Y Size = 1 + -> Border Color = black (R:0, G:0, B:0) + -> Delata Value on Color = 1 + * Image/Flatten Image + * Script-Fu/Shadow/Drop-Shadow with this options : + -> Offset X = 5 + -> Offset Y = 5 + -> Blur Radius = 10 + -> Color = black (R:0, G:0, B:0) + -> Opacity = 80 + -> Allow Resizing = On + * Save target image in PNG with max compression (Compression Level = 9) + +Note : A gimp2.2 script from Gerhard Kulzer can be use to add Alpha Blending 3D Border around screenshots. + Always use default settings. Script can be downloaded from this url: + +http://digikam3rdparty.free.fr/Tools/printscreen-to-manual.scm + + +Gilles Caulier <caulier dot gilles at gmail dot com> +Gerhard Kulzer <gerhard at kulzer dot net> + +
\ No newline at end of file diff --git a/doc/en/showfoto/index.docbook b/doc/en/showfoto/index.docbook new file mode 100644 index 00000000..f2e4496a --- /dev/null +++ b/doc/en/showfoto/index.docbook @@ -0,0 +1,243 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kappname "&showfoto;"><!-- replace kapp here, do *not* replace kappname--> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE"><!-- change language only here --> + <!ENTITY showfoto '<application>Showfoto</application>'> + <!ENTITY digikam '<application>Showfoto</application>'> + <!-- relative path to snapshots for showfoto --> + <!ENTITY path "../digikam/"> + <!ENTITY doc-file-formats SYSTEM "../digikam/file-formats.docbook"> + <!ENTITY doc-sidebar SYSTEM "../digikam/sidebar.docbook"> + <!ENTITY doc-photo-editing SYSTEM "../digikam/photo-editing.docbook"> + <!ENTITY doc-editor-color SYSTEM "../digikam/editor-color.docbook"> + <!ENTITY doc-editor-enhance SYSTEM "../digikam/editor-enhance.docbook"> + <!ENTITY doc-editor-transform SYSTEM "../digikam/editor-transform.docbook"> + <!ENTITY doc-editor-filters SYSTEM "../digikam/editor-filters.docbook"> + <!ENTITY doc-editor-decorate SYSTEM "../digikam/editor-decorate.docbook"> + <!ENTITY doc-ie-menu SYSTEM "../digikam/ie-menu.docbook"> + <!ENTITY doc-credits-annexes SYSTEM "../digikam/credits-annex.docbook"> +]> + +<book lang="&language;"> + +<bookinfo> + +<title>The &showfoto; Handbook</title> + +<authorgroup> + + <author> + <firstname>Gilles</firstname><surname>Caulier</surname> + <affiliation><address><email>caulier_dot_gilles_at_gmail_dot_com</email></address></affiliation> + </author> + + <author> + <firstname>Gerhard</firstname><surname>Kulzer</surname> + <affiliation><address><email>gerhard at kulzer.net</email></address></affiliation> + </author> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + + +<copyright> + <year>2004</year> + <year>2008</year> + <holder>The &showfoto; developers team</holder> +</copyright> + +<!-- Translators: put here the copyright notice of the translation --> +<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook + and in the FDL itself on how to use it. --> +<legalnotice>&FDLNotice;</legalnotice> + +<date>2008-01-05</date> +<releaseinfo>0.9.3</releaseinfo> + +<abstract> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;digikamlogo.png" format="PNG"/></imageobject> + <textobject> <phrase>&digikam; logo</phrase> </textobject> + </inlinemediaobject> + </para> + + <para> + &showfoto; is a &kde; stand alone Photo Editor based on &digikam; Image Editor. &showfoto; is a part of &digikam; project. + </para> + +</abstract> + +<keywordset> + <keyword>KDE</keyword> + <keyword>digikam</keyword> + <keyword>showfoto</keyword> + <keyword>Graphics</keyword> + <keyword>Color Management</keyword> + <keyword>exiv2</keyword> + <keyword>dcraw</keyword> +</keywordset> + +</bookinfo> + +<!-- *********************************************************************** --> + +<chapter id="introduction"> + <title>Introduction</title> + + <sect1 id="using-kapp-background"> <title>Background</title> + + <sect2 id="using-kapp-about"> + <title>About &showfoto;</title> + + <para> + &showfoto; is a fast Image Editor with powerful image editing tools. You can use it to view your photographs and improve them. + </para> + + </sect2> + + <sect2> + <title>Reporting Bugs</title> + + <para> + Like the rest of &kde;, &showfoto; is an Open Source project. This means that it relies on its users to play their part by, at least, reporting problems and suggesting possible improvements. + </para> + + <para> + &showfoto; makes it as easy as possible for you to report bugs or suggest improvements. Wherever you are in the application the Help menu will include a Report Bugs option. This will display a message box with a highlighted link. Click on the link and your web browser will open the page for the reporting system. All the information required will already be filled in, just follow the instructions for completing your report. + </para> + </sect2> + + <sect2> + <title>Support</title> + + <para> + &showfoto; is a community supported project, which means that users and developers support one another. If you become a regular user of &showfoto; you are encouraged to join the &showfoto; Users Mailing List. You can start off by asking questions of other &showfoto; users and hopefully soon you will be answering the support questions of others. + </para> + + <para> + <ulink url="https://mail.kde.org/mailman/listinfo/digikam-users">&showfoto; Users Mailing + List joining instructions.</ulink> + </para> + + <para> + You can also visit the <ulink url="http://www.digikam.org">&digikam; Home Page.</ulink> for news of new releases and other &showfoto; related information. + </para> + </sect2> + + <sect2> + <title>Getting Involved</title> + + <para> + There are many ways that you can get involved with the continued development of &showfoto;. You do not need to be a software developer. You can help with documentation, translation and user interface design or just contribute really good ideas to the wish-list. You can also get involved by testing early development code as it is being developed and providing feedback to the developers. Of course, if you are a software developer then you can help to make &showfoto; the best digital photograph application there is. + </para> + + <para> + The best way to start getting involved with &showfoto; is to join the Developers Mailing List. + <ulink url="https://mail.kde.org/mailman/listinfo/digikam-devel">&showfoto; Developer Mailing + List joining instructions.</ulink> + </para> + </sect2> + + </sect1> + + &doc-file-formats; + +</chapter> + +<chapter> <title>The &showfoto; sidebar</title> + <sect1 id="using-sidebar"> <title>&digikam; sidebar</title> + <anchor id="sidebar.anchor"/> + + <sect2> + <title>Introduction to the right sidebar</title> + <para> + The &showfoto; main window has a sidebar at the right border providing important information and actions of the selected images. This same sidebar is also available in the <ulink url="help:/digikam/image-editor.html#using-imageeditor">Image Editor</ulink> view. It can be displayed by respectively clicking on one of the five tabs: + </para> + + <para> + <itemizedlist> + + <listitem><para><link linkend="using-sidebarfileproperties">Properties</link> : File and image properties, key shooting parameters (EXIF tags)</para></listitem> + + <listitem><para><link linkend="using-sidebarmetadata">Metadata</link> : EXIF, Makernotes, IPTC and GPS data (these properties can be edited by two kipi-plugins</para></listitem> + + <listitem><para><link linkend="using-sidebarcolors">Colors</link> : Histograms and embedded ICC profiles</para></listitem> + + </itemizedlist> + Clicking successively onto the same tab will make the sidebar pop up or fold back into the border. + </para> + </sect2> + + &doc-sidebar; + </sect1> + +</chapter> + +<chapter id="using-kapp"> <title>Using &showfoto;</title> + + &doc-photo-editing; + + <sect1 id="using-setup"> <title>&showfoto; Configuration</title> + + <anchor id="setupdialog.anchor"/> + + <para> + &showfoto; tries to give you as much control on how it works as possible. There are many options that change the behavior of &showfoto;. To access these settings select + <menuchoice><guimenu>Setting</guimenu> + <guimenuitem>Configure &showfoto;</guimenuitem></menuchoice> from the Menu Bar. The configuration dialog is separated into eight pages. You can change between these pages by clicking on the icons on the left-hand side of the dialog. + </para> + + <sect2 id="setupgeneral"> <title>The Configuration Dialog</title> + + <para> + The <guilabel>Interface Options</guilabel> section is rather self-explanatory. + </para> + + <para> + The <guilabel>Exposure Indicators</guilabel> lets one choose the color to use when the under- respectively over-exposure indicators are selected. Preferentially the colors should be contrasting with what they indicate, that is, under-exposure should have a light color and over-exposure areas should show dark colors. + </para> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="setupgeneral.png" format="PNG"/></imageobject> + <textobject> <phrase>General Settings</phrase> </textobject> + </inlinemediaobject> + </para> + + <itemizedlist> + <listitem><para>Tooltip settings, these are self-explanatory</para> + </listitem> + <listitem><para> + <ulink url="help:/digikam/using-setup.html#setup-raw-decoder">RAW file decoding settings</ulink></para> + </listitem> + <listitem><para> + <ulink url="help:/digikam/using-setup.html#setup-iccprofiles">ICC profiles settings</ulink></para> + </listitem> + <listitem><para> + <ulink url="help:/digikam/using-setup.html#setup-saveimages">Save images settings</ulink></para> + </listitem> + <listitem><para> + <ulink url="help:/digikam/using-setup.html#setup-slideshow">The native slideshow settings</ulink></para> + </listitem> + </itemizedlist> + + </sect2> + + + </sect1> + +</chapter> + + +<chapter id="menudescriptions"> <title>Menu Descriptions</title> + +&doc-ie-menu; + +</chapter> + +&doc-credits-annexes; + +</book> diff --git a/doc/en/showfoto/introductionplugininterfaces.png b/doc/en/showfoto/introductionplugininterfaces.png Binary files differnew file mode 100644 index 00000000..dc29d18a --- /dev/null +++ b/doc/en/showfoto/introductionplugininterfaces.png diff --git a/doc/en/showfoto/setupgeneral.png b/doc/en/showfoto/setupgeneral.png Binary files differnew file mode 100644 index 00000000..b8eeaf62 --- /dev/null +++ b/doc/en/showfoto/setupgeneral.png diff --git a/doc/en/showfoto/setupplugins.png b/doc/en/showfoto/setupplugins.png Binary files differnew file mode 100644 index 00000000..aecc1044 --- /dev/null +++ b/doc/en/showfoto/setupplugins.png diff --git a/doc/en/showfoto/setupslideshow.png b/doc/en/showfoto/setupslideshow.png Binary files differnew file mode 100644 index 00000000..47630bb9 --- /dev/null +++ b/doc/en/showfoto/setupslideshow.png |
