Git commit dfc332b2dff7f19bfac43046f297d47306da081d by Gilles Caulier. Committed on 28/08/2016 at 08:19. Pushed by cgilles into branch 'master'.
add Local Contrast tool section M +1 -1 digikam/editor-enhance-blur.docbook A +60 -0 digikam/editor-enhance-localcontrast.docbook M +1 -0 digikam/editor-enhance.docbook A +- -- digikam/editor-localcontrast.png M +1 -0 digikam/editor-photoediting.docbook M +68 -67 digikam/index.docbook M +29 -26 showfoto/index.docbook http://commits.kde.org/digikam-doc/dfc332b2dff7f19bfac43046f297d47306da081d diff --git a/digikam/editor-enhance-blur.docbook b/digikam/editor-enhance-blur.docbook index f874da7..a007af8 100644 --- a/digikam/editor-enhance-blur.docbook +++ b/digikam/editor-enhance-blur.docbook @@ -1,6 +1,6 @@ <sect3 id="editor-enhance-blur" > <sect3info> - <title>BLur Tool</title> + <title>Blur Tool</title> <abstract> <para> The <emphasis>Blur Tool</emphasis> is dedicated to soft an image. diff --git a/digikam/editor-enhance-localcontrast.docbook b/digikam/editor-enhance-localcontrast.docbook new file mode 100644 index 0000000..8748051 --- /dev/null +++ b/digikam/editor-enhance-localcontrast.docbook @@ -0,0 +1,60 @@ +<sect3 id="editor-enhance-localcontrast" > + <sect3info> + <title>Local Contrast Tool</title> + <abstract> + <para> + The <emphasis>Local Contrast</emphasis> tool render pseudo-HDR image. + </para> + </abstract> + + <keywordset> + <keyword>HDR</keyword> + <keyword>Tone Mapping</keyword> + </keywordset> + + </sect3info> + + <title>Improve Photos exposure with Local Contrast Tool</title> + + <para> + There are multiple way to render HDR image to improve photos containing under or overexposed areas. With camera devices, usual tools lets you merge multiple shots + with different exposures into one perfectly exposed photo. This work nicely but require some limitation, as for example the necessity to shot static subjects. + But what if you have just in case of single image, or with dynamic subjects? You might want to give a try to the Local Contrast feature. + It’s based on the LDR Tonemapping utility which is designed to improve the dynamic range of the photo by reducing its global contrast and increasing the local contrast. + It does so by generating a desaturated and blurred version of the photo. It then combines the RGB channels of the original photo with the desaturated blurred image + using either the Linear or Power function. Sounds complicated? Don’t worry, the Local Contrast tool is rather straightforward to use, + so you don’t have to understand all its intricacies in order to achieve pleasing results. + </para> + + <example> + <title>The Local Contrast in Action</title> + <screenshot> + <screeninfo>The Local Contrast Tool in Action</screeninfo> + <mediaobject><imageobject> + <imagedata fileref="&path;editor-localcontrast.png" format="PNG" /> + </imageobject></mediaobject> + </screenshot> + </example> + + <para> + Open the photo you want in the editor and choose <menuchoice><guimenu>Enhance</guimenu><guimenuitem>Local Contrast</guimenuitem></menuchoice>. + The tool lets you apply up to four tonemapping operations called stages. + Each stage offers two parameters for you to tweak: Power and Blur. The former allows you to specify the desaturation level, + while the latter lets you adjust the affected areas on the photo. + To preview the result, hit the Try button. Once you are satisfied with the result, press OK to apply the process to the photo. + </para> + + <para> + While the Local Constrast tool may sound like an easy way to fix photos, you should use it with care: + sometimes it can do more damage than good, producing unnaturally looking photos. + </para> + +</sect3> + +<!-- +Local Variables: +mode: sgml +sgml-omittag: nil +sgml-shorttag: t +End: +--> diff --git a/digikam/editor-enhance.docbook b/digikam/editor-enhance.docbook index d291fd2..d13e056 100644 --- a/digikam/editor-enhance.docbook +++ b/digikam/editor-enhance.docbook @@ -2,6 +2,7 @@ <title>Image Enhancement</title> &doc-editor-enhance-distortion; &doc-editor-enhance-hotpixels; + &doc-editor-enhance-localcontrast; &doc-editor-enhance-nr; &doc-editor-enhance-blur; &doc-editor-enhance-restoration; diff --git a/digikam/editor-localcontrast.png b/digikam/editor-localcontrast.png new file mode 100644 index 0000000..9b38b2c Binary files /dev/null and b/digikam/editor-localcontrast.png differ diff --git a/digikam/editor-photoediting.docbook b/digikam/editor-photoediting.docbook index 0584fe3..176e7e6 100644 --- a/digikam/editor-photoediting.docbook +++ b/digikam/editor-photoediting.docbook @@ -148,6 +148,7 @@ <listitem><para><link linkend="editor-enhance-blur" >Blur Tool</link></para></listitem> <listitem><para><link linkend="editor-enhance-redeyes">Red Eyes Removal</link></para></listitem> <listitem><para><link linkend="editor-enhance-inpaint">Photograph Inpainting</link></para></listitem> + <listitem><para><link linkend="editor-enhance-localcontrast">Local Contrast</link></para></listitem> <listitem><para><link linkend="editor-enhance-nr">Noise Reduction</link></para></listitem> <listitem><para><link linkend="editor-enhance-hotpixels">Hot Pixel Correction</link></para></listitem> <listitem><para><link linkend="editor-enhance-distortion">Lens Distortion Correction</link></para></listitem> diff --git a/digikam/index.docbook b/digikam/index.docbook index eb4d9e9..8388dba 100644 --- a/digikam/index.docbook +++ b/digikam/index.docbook @@ -8,80 +8,81 @@ <!ENTITY path ""><!-- relative path to snapshots for digikam and showfoto --> <!-- Introduction Chapter --> - <!ENTITY doc-intro-background SYSTEM "intro-background.docbook"> - <!ENTITY doc-intro-firstrun SYSTEM "intro-firstrun.docbook"> - <!ENTITY doc-intro-imageformats SYSTEM "intro-imageformats.docbook"> - <!ENTITY doc-intro-movieformats SYSTEM "intro-movieformats.docbook"> - <!ENTITY doc-intro-camerasupport SYSTEM "intro-camerasupport.docbook"> - <!ENTITY doc-intro-pluginsupport SYSTEM "intro-pluginsupport.docbook"> - <!ENTITY doc-intro-database SYSTEM "intro-database.docbook"> + <!ENTITY doc-intro-background SYSTEM "intro-background.docbook"> + <!ENTITY doc-intro-firstrun SYSTEM "intro-firstrun.docbook"> + <!ENTITY doc-intro-imageformats SYSTEM "intro-imageformats.docbook"> + <!ENTITY doc-intro-movieformats SYSTEM "intro-movieformats.docbook"> + <!ENTITY doc-intro-camerasupport SYSTEM "intro-camerasupport.docbook"> + <!ENTITY doc-intro-pluginsupport SYSTEM "intro-pluginsupport.docbook"> + <!ENTITY doc-intro-database SYSTEM "intro-database.docbook"> <!-- Using Application Chapter --> - <!ENTITY doc-using-mainwindow SYSTEM "using-mainwindow.docbook"> - <!ENTITY doc-using-sidebar SYSTEM "using-sidebar.docbook"> - <!ENTITY doc-using-lighttable SYSTEM "using-lighttable.docbook"> - <!ENTITY doc-using-bqm SYSTEM "using-bqm.docbook"> - <!ENTITY doc-using-tagsmngr SYSTEM "using-tagsmngr.docbook"> - <!ENTITY doc-using-dam SYSTEM "using-dam.docbook"> - <!ENTITY doc-using-camera SYSTEM "using-camera.docbook"> - <!ENTITY doc-using-setup SYSTEM "using-setup.docbook"> + <!ENTITY doc-using-mainwindow SYSTEM "using-mainwindow.docbook"> + <!ENTITY doc-using-sidebar SYSTEM "using-sidebar.docbook"> + <!ENTITY doc-using-lighttable SYSTEM "using-lighttable.docbook"> + <!ENTITY doc-using-bqm SYSTEM "using-bqm.docbook"> + <!ENTITY doc-using-tagsmngr SYSTEM "using-tagsmngr.docbook"> + <!ENTITY doc-using-dam SYSTEM "using-dam.docbook"> + <!ENTITY doc-using-camera SYSTEM "using-camera.docbook"> + <!ENTITY doc-using-setup SYSTEM "using-setup.docbook"> <!-- Image Editor Chapter --> - <!ENTITY doc-editor-using SYSTEM "editor-using.docbook"> - <!ENTITY doc-editor-photoediting SYSTEM "editor-photoediting.docbook"> - <!ENTITY doc-editor-color SYSTEM "editor-color.docbook"> - - <!ENTITY doc-editor-enhance SYSTEM "editor-enhance.docbook"> - <!ENTITY doc-editor-enhance-distortion SYSTEM "editor-enhance-distortion.docbook"> - <!ENTITY doc-editor-enhance-hotpixels SYSTEM "editor-enhance-hotpixels.docbook"> - <!ENTITY doc-editor-enhance-nr SYSTEM "editor-enhance-nr.docbook"> - <!ENTITY doc-editor-enhance-blur SYSTEM "editor-enhance-blur.docbook"> - <!ENTITY doc-editor-enhance-restoration SYSTEM "editor-enhance-restoration.docbook"> - <!ENTITY doc-editor-enhance-vignetting SYSTEM "editor-enhance-vignetting.docbook"> - <!ENTITY doc-editor-enhance-inpaint SYSTEM "editor-enhance-inpaint.docbook"> - <!ENTITY doc-editor-enhance-redeyes SYSTEM "editor-enhance-redeyes.docbook"> - <!ENTITY doc-editor-enhance-sharpen SYSTEM "editor-enhance-sharpen.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"> - <!ENTITY doc-editor-colormanagement SYSTEM "editor-colormanagement.docbook"> + <!ENTITY doc-editor-using SYSTEM "editor-using.docbook"> + <!ENTITY doc-editor-photoediting SYSTEM "editor-photoediting.docbook"> + <!ENTITY doc-editor-color SYSTEM "editor-color.docbook"> + + <!ENTITY doc-editor-enhance SYSTEM "editor-enhance.docbook"> + <!ENTITY doc-editor-enhance-distortion SYSTEM "editor-enhance-distortion.docbook"> + <!ENTITY doc-editor-enhance-hotpixels SYSTEM "editor-enhance-hotpixels.docbook"> + <!ENTITY doc-editor-enhance-localcontrast SYSTEM "editor-enhance-localcontrast.docbook"> + <!ENTITY doc-editor-enhance-nr SYSTEM "editor-enhance-nr.docbook"> + <!ENTITY doc-editor-enhance-blur SYSTEM "editor-enhance-blur.docbook"> + <!ENTITY doc-editor-enhance-restoration SYSTEM "editor-enhance-restoration.docbook"> + <!ENTITY doc-editor-enhance-vignetting SYSTEM "editor-enhance-vignetting.docbook"> + <!ENTITY doc-editor-enhance-inpaint SYSTEM "editor-enhance-inpaint.docbook"> + <!ENTITY doc-editor-enhance-redeyes SYSTEM "editor-enhance-redeyes.docbook"> + <!ENTITY doc-editor-enhance-sharpen SYSTEM "editor-enhance-sharpen.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"> + <!ENTITY doc-editor-colormanagement SYSTEM "editor-colormanagement.docbook"> <!-- Tools Chapter --> <!-- native --> - <!ENTITY doc-tool-acquireimages SYSTEM "tool-acquireimages.docbook"> - <!ENTITY doc-tool-geolocationeditor SYSTEM "tool-geolocationeditor.docbook"> - <!ENTITY doc-tool-presentation SYSTEM "tool-presentation.docbook"> - <!ENTITY doc-tool-advrename SYSTEM "tool-advrename.docbook"> - <!ENTITY doc-tool-findduplicates SYSTEM "tool-findduplicates.docbook"> - <!ENTITY doc-tool-metadataeditor SYSTEM "tool-metadataeditor.docbook"> - <!ENTITY doc-tool-panorama SYSTEM "tool-panorama.docbook"> - <!ENTITY doc-tool-expoblending SYSTEM "tool-expoblending.docbook"> - <!ENTITY doc-tool-calendar SYSTEM "tool-calendar.docbook"> - <!ENTITY doc-tool-maintenance SYSTEM "tool-maintenance.docbook"> + <!ENTITY doc-tool-acquireimages SYSTEM "tool-acquireimages.docbook"> + <!ENTITY doc-tool-geolocationeditor SYSTEM "tool-geolocationeditor.docbook"> + <!ENTITY doc-tool-presentation SYSTEM "tool-presentation.docbook"> + <!ENTITY doc-tool-advrename SYSTEM "tool-advrename.docbook"> + <!ENTITY doc-tool-findduplicates SYSTEM "tool-findduplicates.docbook"> + <!ENTITY doc-tool-metadataeditor SYSTEM "tool-metadataeditor.docbook"> + <!ENTITY doc-tool-panorama SYSTEM "tool-panorama.docbook"> + <!ENTITY doc-tool-expoblending SYSTEM "tool-expoblending.docbook"> + <!ENTITY doc-tool-calendar SYSTEM "tool-calendar.docbook"> + <!ENTITY doc-tool-maintenance SYSTEM "tool-maintenance.docbook"> <!-- plugins --> - <!ENTITY doc-tool-printwizard SYSTEM "tool-printwizard.docbook"> - <!ENTITY doc-tool-sendimages SYSTEM "tool-sendimages.docbook"> - <!ENTITY doc-tool-flickrexport SYSTEM "tool-flickrexport.docbook"> - <!ENTITY doc-tool-piwigoexport SYSTEM "tool-piwigoexport.docbook"> - <!ENTITY doc-tool-kmlexport SYSTEM "tool-kmlexport.docbook"> - <!ENTITY doc-tool-googleexport SYSTEM "tool-googleexport.docbook"> - <!ENTITY doc-tool-flashexport SYSTEM "tool-flashexport.docbook"> - <!ENTITY doc-tool-dropbox SYSTEM "tool-dropbox.docbook"> - <!ENTITY doc-tool-facebook SYSTEM "tool-facebook.docbook"> - <!ENTITY doc-tool-imageshack SYSTEM "tool-imageshack.docbook"> - <!ENTITY doc-tool-imgur SYSTEM "tool-imgur.docbook"> - <!ENTITY doc-tool-mediawiki SYSTEM "tool-mediawiki.docbook"> - <!ENTITY doc-tool-rajce SYSTEM "tool-rajce.docbook"> - <!ENTITY doc-tool-remotestorage SYSTEM "tool-remotestorage.docbook"> - <!ENTITY doc-tool-smug SYSTEM "tool-smug.docbook"> - <!ENTITY doc-tool-vkontakte SYSTEM "tool-vkontakte.docbook"> - <!ENTITY doc-tool-yandexfotki SYSTEM "tool-yandexfotki.docbook"> + <!ENTITY doc-tool-printwizard SYSTEM "tool-printwizard.docbook"> + <!ENTITY doc-tool-sendimages SYSTEM "tool-sendimages.docbook"> + <!ENTITY doc-tool-flickrexport SYSTEM "tool-flickrexport.docbook"> + <!ENTITY doc-tool-piwigoexport SYSTEM "tool-piwigoexport.docbook"> + <!ENTITY doc-tool-kmlexport SYSTEM "tool-kmlexport.docbook"> + <!ENTITY doc-tool-googleexport SYSTEM "tool-googleexport.docbook"> + <!ENTITY doc-tool-flashexport SYSTEM "tool-flashexport.docbook"> + <!ENTITY doc-tool-dropbox SYSTEM "tool-dropbox.docbook"> + <!ENTITY doc-tool-facebook SYSTEM "tool-facebook.docbook"> + <!ENTITY doc-tool-imageshack SYSTEM "tool-imageshack.docbook"> + <!ENTITY doc-tool-imgur SYSTEM "tool-imgur.docbook"> + <!ENTITY doc-tool-mediawiki SYSTEM "tool-mediawiki.docbook"> + <!ENTITY doc-tool-rajce SYSTEM "tool-rajce.docbook"> + <!ENTITY doc-tool-remotestorage SYSTEM "tool-remotestorage.docbook"> + <!ENTITY doc-tool-smug SYSTEM "tool-smug.docbook"> + <!ENTITY doc-tool-vkontakte SYSTEM "tool-vkontakte.docbook"> + <!ENTITY doc-tool-yandexfotki SYSTEM "tool-yandexfotki.docbook"> <!-- Menus Chapter --> - <!ENTITY doc-menu-mainwindow SYSTEM "menu-mainwindow.docbook"> - <!ENTITY doc-menu-editor SYSTEM "menu-editor.docbook"> - <!ENTITY doc-menu-lighttable SYSTEM "menu-lighttable.docbook"> - <!ENTITY doc-menu-bqm SYSTEM "menu-bqm.docbook"> - <!ENTITY doc-menu-camera SYSTEM "menu-camera.docbook"> + <!ENTITY doc-menu-mainwindow SYSTEM "menu-mainwindow.docbook"> + <!ENTITY doc-menu-editor SYSTEM "menu-editor.docbook"> + <!ENTITY doc-menu-lighttable SYSTEM "menu-lighttable.docbook"> + <!ENTITY doc-menu-bqm SYSTEM "menu-bqm.docbook"> + <!ENTITY doc-menu-camera SYSTEM "menu-camera.docbook"> <!-- Annexes Chapter --> - <!ENTITY doc-annexes-credits SYSTEM "annexes-credits.docbook"> + <!ENTITY doc-annexes-credits SYSTEM "annexes-credits.docbook"> <!-- Do not define any other entities; instead, use the entities from kde-genent.entities and $LANG/user.entities. --> diff --git a/showfoto/index.docbook b/showfoto/index.docbook index 28ad8da..3346dde 100644 --- a/showfoto/index.docbook +++ b/showfoto/index.docbook @@ -9,32 +9,35 @@ <!ENTITY digikam-app '<application>digiKam</application>'> <!ENTITY path "../digikam/"><!-- relative path to snapshots for showfoto --> - <!ENTITY doc-intro-imageformats SYSTEM "../digikam/intro-imageformats.docbook"> - <!ENTITY doc-using-sidebar SYSTEM "../digikam/using-sidebar.docbook"> - <!ENTITY doc-editor-photoediting SYSTEM "../digikam/editor-photoediting.docbook"> - <!ENTITY doc-editor-color SYSTEM "../digikam/editor-color.docbook"> - - <!ENTITY doc-editor-enhance SYSTEM "../digikam/editor-enhance.docbook"> - <!ENTITY doc-editor-enhance-distortion SYSTEM "../digikam/editor-enhance-distortion.docbook"> - <!ENTITY doc-editor-enhance-hotpixels SYSTEM "../digikam/editor-enhance-hotpixels.docbook"> - <!ENTITY doc-editor-enhance-nr SYSTEM "../digikam/editor-enhance-nr.docbook"> - <!ENTITY doc-editor-enhance-blur SYSTEM "../digikam/editor-enhance-blur.docbook"> - <!ENTITY doc-editor-enhance-restoration SYSTEM "../digikam/editor-enhance-restoration.docbook"> - <!ENTITY doc-editor-enhance-vignetting SYSTEM "../digikam/editor-enhance-vignetting.docbook"> - <!ENTITY doc-editor-enhance-inpaint SYSTEM "../digikam/editor-enhance-inpaint.docbook"> - <!ENTITY doc-editor-enhance-redeyes SYSTEM "../digikam/editor-enhance-redeyes.docbook"> - <!ENTITY doc-editor-enhance-sharpen SYSTEM "../digikam/editor-enhance-sharpen.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-editor-colormanagement SYSTEM "../digikam/editor-colormanagement.docbook"> - <!ENTITY doc-tool-acquireimages SYSTEM "../digikam/tool-acquireimages.docbook"> - <!ENTITY doc-tool-presentation SYSTEM "../digikam/tool-presentation.docbook"> - <!ENTITY doc-tool-geolocationeditor SYSTEM "../digikam/tool-geolocationeditor.docbook"> - <!ENTITY doc-tool-metadataeditor SYSTEM "../digikam/tool-metadataeditor.docbook"> - <!ENTITY doc-menu-editor SYSTEM "../digikam/menu-editor.docbook"> - <!ENTITY doc-annexes-credits SYSTEM "../digikam/annexes-credits.docbook"> + <!ENTITY doc-intro-imageformats SYSTEM "../digikam/intro-imageformats.docbook"> + <!ENTITY doc-using-sidebar SYSTEM "../digikam/using-sidebar.docbook"> + <!ENTITY doc-editor-photoediting SYSTEM "../digikam/editor-photoediting.docbook"> + <!ENTITY doc-editor-color SYSTEM "../digikam/editor-color.docbook"> + + <!ENTITY doc-editor-enhance SYSTEM "../digikam/editor-enhance.docbook"> + <!ENTITY doc-editor-enhance-distortion SYSTEM "../digikam/editor-enhance-distortion.docbook"> + <!ENTITY doc-editor-enhance-hotpixels SYSTEM "../digikam/editor-enhance-hotpixels.docbook"> + <!ENTITY doc-editor-enhance-localcontrast SYSTEM "../digikam/editor-enhance-localcontrast.docbook"> + <!ENTITY doc-editor-enhance-nr SYSTEM "../digikam/editor-enhance-nr.docbook"> + <!ENTITY doc-editor-enhance-blur SYSTEM "../digikam/editor-enhance-blur.docbook"> + <!ENTITY doc-editor-enhance-restoration SYSTEM "../digikam/editor-enhance-restoration.docbook"> + <!ENTITY doc-editor-enhance-vignetting SYSTEM "../digikam/editor-enhance-vignetting.docbook"> + <!ENTITY doc-editor-enhance-inpaint SYSTEM "../digikam/editor-enhance-inpaint.docbook"> + <!ENTITY doc-editor-enhance-redeyes SYSTEM "../digikam/editor-enhance-redeyes.docbook"> + <!ENTITY doc-editor-enhance-sharpen SYSTEM "../digikam/editor-enhance-sharpen.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-editor-colormanagement SYSTEM "../digikam/editor-colormanagement.docbook"> + + <!ENTITY doc-tool-acquireimages SYSTEM "../digikam/tool-acquireimages.docbook"> + <!ENTITY doc-tool-presentation SYSTEM "../digikam/tool-presentation.docbook"> + <!ENTITY doc-tool-geolocationeditor SYSTEM "../digikam/tool-geolocationeditor.docbook"> + <!ENTITY doc-tool-metadataeditor SYSTEM "../digikam/tool-metadataeditor.docbook"> + + <!ENTITY doc-menu-editor SYSTEM "../digikam/menu-editor.docbook"> + <!ENTITY doc-annexes-credits SYSTEM "../digikam/annexes-credits.docbook"> <!-- Do not define any other entities; instead, use the entities from kde-genent.entities and $LANG/user.entities. -->
