Git commit 45f059825021142322b416ccbf46b377061bbe6c by Gilles Caulier. Committed on 21/08/2016 at 20:39. Pushed by cgilles into branch 'master'.
no tab and polish M +87 -88 digikam/index.docbook http://commits.kde.org/digikam-doc/45f059825021142322b416ccbf46b377061bbe6c diff --git a/digikam/index.docbook b/digikam/index.docbook index 1995f73..a38e17b 100644 --- a/digikam/index.docbook +++ b/digikam/index.docbook @@ -100,25 +100,25 @@ </sect2> <sect2 id="news"> <title>New Features of the 5.x versions</title> - <itemizedlist> - <listitem><para>Runs on any platform that supports Qt5 (including Win32 and MacOS)</para></listitem> - <listitem><para>Multi-threaded interface to query the database</para></listitem> - <listitem><para>Embedded trash support for each collection instead of desktop trash</para></listitem> - <listitem><para>Thumbs and preview video support is now delegated to Qt5Multimedia framework</para></listitem> - <listitem><para>Mysql internal server is now configurable as Sqlite to store database files at a customized place</para></listitem> - <listitem><para>Mysql internal/remote server is now configurable with first run assistant</para></listitem> - <listitem><para>New batch queue manager tool to convert RAW files to DNG</para></listitem> - <listitem><para>New batch queue manager tool to adjust time and date metadata</para></listitem> - <listitem><para>New option in editor and light table to import images from a digital scanner</para></listitem> - <listitem><para>New option in editor and light table to edit metadata</para></listitem> - <listitem><para>New option in editor and light table to edit geolocation</para></listitem> - <listitem><para>New option in editor and light table to run presentation tool</para></listitem> - <listitem><para>New editor tool to perform color chage based on Lut3D</para></listitem> - <listitem><para>New tool in camera import interface to convert RAW files to DNG</para></listitem> - <listitem><para>Consolidation of Mysql database backend</para></listitem> - <listitem><para>Improved startup time with different scan for new items stage</para></listitem> - <listitem><para>... and much more</para></listitem> - </itemizedlist> + <itemizedlist> + <listitem><para>Runs on any platform that supports Qt5 (including Win32 and MacOS)</para></listitem> + <listitem><para>Multi-threaded interface to query the database</para></listitem> + <listitem><para>Embedded trash support for each collection instead of desktop trash</para></listitem> + <listitem><para>Thumbs and preview video support is now delegated to Qt5Multimedia framework</para></listitem> + <listitem><para>Mysql internal server is now configurable as Sqlite to store database files at a customized place</para></listitem> + <listitem><para>Mysql internal/remote server is now configurable with first run assistant</para></listitem> + <listitem><para>New batch queue manager tool to convert RAW files to DNG</para></listitem> + <listitem><para>New batch queue manager tool to adjust time and date metadata</para></listitem> + <listitem><para>New option in editor and light table to import images from a digital scanner</para></listitem> + <listitem><para>New option in editor and light table to edit metadata</para></listitem> + <listitem><para>New option in editor and light table to edit geolocation</para></listitem> + <listitem><para>New option in editor and light table to run presentation tool</para></listitem> + <listitem><para>New editor tool to perform color chage based on Lut3D</para></listitem> + <listitem><para>New tool in camera import interface to convert RAW files to DNG</para></listitem> + <listitem><para>Consolidation of Mysql database backend</para></listitem> + <listitem><para>Improved startup time with different scan for new items stage</para></listitem> + <listitem><para>... and much more</para></listitem> + </itemizedlist> </sect2> <sect2> @@ -174,8 +174,7 @@ <para> <!-- <imagedata fileref="&path;introductionfirstrundialog.png" format="PNG" /> --> <inlinemediaobject><imageobject> - <imagedata fileref="&path;firstrunassistant_step1.webp" /> - </imageobject> + <imagedata fileref="&path;firstrunassistant_step1.png" format="PNG" /></imageobject> </inlinemediaobject> </para> @@ -194,10 +193,10 @@ </inlinemediaobject> </para> - <para>Then you have to specify a local folder that resides on your computer, in which the database will be stored. This path will be the same for all image folders. - </para> + <para>Then you have to specify a local folder that resides on your computer, in which the database will be stored. This path will be the same for all image folders. + </para> - <para> + <para> <inlinemediaobject> <imageobject><imagedata fileref="&path;firstrunassistant_step3.png" format="PNG" /></imageobject> </inlinemediaobject> @@ -214,53 +213,53 @@ </inlinemediaobject> </para> - <para>Metadata information storage may be important if you plan to work with another photo management program and you should choose <guilabel>Add information to files</guilabel>. But if you don't want to alter your pictures, keep the default setting: <guilabel>Do nothing</guilabel>.</para> - - <para> - <inlinemediaobject> - <imageobject><imagedata fileref="&path;firstrunassistant_step5.png" format="PNG"/></imageobject> + <para>Metadata information storage may be important if you plan to work with another photo management program and you should choose <guilabel>Add information to files</guilabel>. But if you don't want to alter your pictures, keep the default setting: <guilabel>Do nothing</guilabel>.</para> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;firstrunassistant_step5.png" format="PNG"/></imageobject> <textobject> <phrase>Metadata information</phrase> </textobject> </inlinemediaobject> </para> - - <para>Then choose how digiKam will load images in preview mode and light table. Reduced version will load faster but at the cost of quality.</para> - - <para> - <inlinemediaobject> - <imageobject><imagedata fileref="&path;firstrunassistant_step6.png" format="PNG"/></imageobject> + + <para>Then choose how digiKam will load images in preview mode and light table. Reduced version will load faster but at the cost of quality.</para> + + <para> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;firstrunassistant_step6.png" format="PNG"/></imageobject> <textobject> <phrase>Preview image method</phrase> </textobject> </inlinemediaobject> </para> - + <para>Now decide how digiKam will open images on a right click. Previews will load faster but you won't be able to make any corrections.</para> - + <para> - <inlinemediaobject> - <imageobject><imagedata fileref="&path;firstrunassistant_step7.png" format="PNG"/></imageobject> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;firstrunassistant_step7.png" format="PNG"/></imageobject> <textobject> <phrase>Open image method</phrase> </textobject> </inlinemediaobject> </para> - + <para>Tooltips are a fast and easy way to display important information about a photograph, they popup as the mouse moves over a thumbnail. Select "Use tooltips" if you want to display them.</para> - + <para> - <inlinemediaobject> - <imageobject><imagedata fileref="&path;firstrunassistant_step8.png" format="PNG"/></imageobject> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;firstrunassistant_step8.png" format="PNG"/></imageobject> <textobject> <phrase>Tooltips</phrase> </textobject> </inlinemediaobject> </para> - + <para>Click on <guibutton>Finish</guibutton>. DigiKam will now start to scan for photographs...</para> - + <para> - <inlinemediaobject> - <imageobject><imagedata fileref="&path;firstrunassistant_step9.png" format="PNG"/></imageobject> + <inlinemediaobject> + <imageobject><imagedata fileref="&path;firstrunassistant_step9.png" format="PNG"/></imageobject> <textobject> <phrase>Tooltips</phrase> </textobject> </inlinemediaobject> - </para> - + </para> + <!-- ¿ws? --> - + </sect3> <sect3> <title>The Scan Items Dialog</title> @@ -271,12 +270,12 @@ <inlinemediaobject> <imageobject> <imagedata fileref="&path;introductionscandialog.png" format="PNG" /> </imageobject></inlinemediaobject> </para> - <note><para>&digikam; will recurse the library path to its full depth. You cannot exclude (prune) any sub-path unless you make that sub-path hidden. You have to do that from outside of &digikam; by putting a dot in front of the sub-path.</para></note> - - <para> + <note><para>&digikam; will recurse the library path to its full depth. You cannot exclude (prune) any sub-path unless you make that sub-path hidden. You have to do that from outside of &digikam; by putting a dot in front of the sub-path.</para></note> + + <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> 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> @@ -624,10 +623,10 @@ <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. + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Rebuild all Thumbnails...</guimenuitem> + </menuchoice> menu item beforehand. </para> <para> @@ -764,13 +763,13 @@ <guimenu></guimenu> </menuchoice> </para> - <para>Deleting works from anywhere in any &digikam; windows</para> + <para>Deleting works from anywhere in any &digikam; windows</para> </sect3> </sect2> - <sect2 id="using-mydatesview"> <title>Calendar View</title> + <sect2 id="using-mydatesview"> <title>Calendar View</title> <para><inlinemediaobject><imageobject><imagedata fileref="&path;maininterfacedateview.png" format="PNG" /> </imageobject> <textobject><phrase>Dates View from Main Window</phrase></textobject></inlinemediaobject> @@ -859,10 +858,10 @@ </sect2> - <sect2> <title>The Timeline</title> - - <para>The timeline view shows a timescale-adjustable histogram of the numbers of images per time unit. A selection frame moves over the histogram. To select a time frame just click into the <emphasis>lower square</emphasis> of the selection frame where the time unit is indicated. That will show all corresponding images in the main window.</para> - <para>In the field right below you can enter a title and save your selection. It will then appear in the list field at the bottom.</para> + <sect2> <title>The Timeline</title> + + <para>The timeline view shows a timescale-adjustable histogram of the numbers of images per time unit. A selection frame moves over the histogram. To select a time frame just click into the <emphasis>lower square</emphasis> of the selection frame where the time unit is indicated. That will show all corresponding images in the main window.</para> + <para>In the field right below you can enter a title and save your selection. It will then appear in the list field at the bottom.</para> <example> <title>The Timeline View in Action</title> <screenshot><mediaobject><imageobject><imagedata fileref="&path;timeline.png" format="PNG" /> </imageobject></mediaobject></screenshot> @@ -890,19 +889,19 @@ <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> - <para>Next to the search box is a little LED that turns green if the search has results. Just click on it to reset the filtering and show all images again. If the search is not succeessful, the LED turns red.</para> + <para>Next to the search box is a little LED that turns green if the search has results. Just click on it to reset the filtering and show all images again. If the search is not succeessful, the LED turns red.</para> <example> <title>Quick Search Tool Dialog in Action</title> <screenshot><mediaobject><imageobject><imagedata fileref="&path;maininterfacequicksearch.png" format="PNG" /> </imageobject></mediaobject></screenshot> </example> - </sect3> + </sect3> - <sect3> <title>Searches proper</title> + <sect3> <title>Searches proper</title> - <para> - The more sophisticated search tool is a tab on the left sidebar (binocular icon). If you open it, you will be presented with a simple search box the works as described above, except that you can save this search as a live folder that always filters for what you entered as search criteria. When saved, the filter will appear in the list. </para> - <para> + <para> + The more sophisticated search tool is a tab on the left sidebar (binocular icon). If you open it, you will be presented with a simple search box the works as described above, except that you can save this search as a live folder that always filters for what you entered as search criteria. When saved, the filter will appear in the list. </para> + <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> <example> @@ -942,18 +941,18 @@ </sect2> <sect2 id="fuzzy-searches"> <title>Fuzzy Searches/Duplicates</title> - <para>&digikam; characterizes every image by a legthy number using a special technique (Haar algorithm) that make it possible to compare images by comparing this calculated signature. The less numerical difference there is between any two image signatures, the more they resemble each other. This technique has three implementations</para> - <itemizedlist> - <listitem><para>Similar items: This is a drag&drop zone where you can drop any image to find a similar one. A threshold can be modified in order to narrow down or enlarge the resulting selection. Drag an image from anywhere over the fuzzy search icon in the left sidebar, it will open and you drop it there.</para></listitem> - <listitem><para>Sketch: free hand color sketching: draw a quick sketch and &digikam; will find corresponding images. Again a threshold can be set.</para></listitem> - <listitem><para>Duplicates: after &digikam; has scanned all collections you will find a list of duplicates here. It's up to you of course to decide what to do with them. From the menu <menuchoice><guimenu>Tools</guimenu><guimenuitem>Rebuild all fingerprints...</guimenuitem></menuchoice> you can initiate a total rebuild of the image signatures (may take hours if you have a large collection, an estimate is 2 hours for 10'000 images) or from the bottom you can just rescan, which is much faster. <guimenu>Find duplicates</guimenu> will do just that, but it will take a long time too as it has to compare every image with any other image. Fortunately, you can refine your search by albums and/or tags.</para></listitem> - </itemizedlist> - + <para>&digikam; characterizes every image by a legthy number using a special technique (Haar algorithm) that make it possible to compare images by comparing this calculated signature. The less numerical difference there is between any two image signatures, the more they resemble each other. This technique has three implementations</para> + <itemizedlist> + <listitem><para>Similar items: This is a drag&drop zone where you can drop any image to find a similar one. A threshold can be modified in order to narrow down or enlarge the resulting selection. Drag an image from anywhere over the fuzzy search icon in the left sidebar, it will open and you drop it there.</para></listitem> + <listitem><para>Sketch: free hand color sketching: draw a quick sketch and &digikam; will find corresponding images. Again a threshold can be set.</para></listitem> + <listitem><para>Duplicates: after &digikam; has scanned all collections you will find a list of duplicates here. It's up to you of course to decide what to do with them. From the menu <menuchoice><guimenu>Tools</guimenu><guimenuitem>Rebuild all fingerprints...</guimenuitem></menuchoice> you can initiate a total rebuild of the image signatures (may take hours if you have a large collection, an estimate is 2 hours for 10'000 images) or from the bottom you can just rescan, which is much faster. <guimenu>Find duplicates</guimenu> will do just that, but it will take a long time too as it has to compare every image with any other image. Fortunately, you can refine your search by albums and/or tags.</para></listitem> + </itemizedlist> + <example> <title>Fuzzy search for similar image</title> <screenshot><mediaobject><imageobject><imagedata fileref="&path;fuzzysearchsimilar.png" format="PNG" /></imageobject></mediaobject></screenshot> </example> - + <example> <title>Find duplicates while restricting to an album</title> <screenshot><mediaobject> @@ -963,8 +962,8 @@ </sect2> <sect2> <title>Map Searches</title> - <para>This tab provides an intuitive map search tool based on the marble widget. You can zoom in and out with the mousewheel by either scrolling it or hold and drag it. Pan by holding down the left mouse button. Press the <keycombo action="press">&Ctrl;<keycap>left mouse button</keycap></keycombo> to pull-up a square as indicated. All images falling within the coordinates of that square will be filtered and shown (provided your images have been geo-coded of course).</para> - <para>In the box below you can enter a name for your geo filter. It will be added to the list view below for future reference, it acts as a live geo folder.</para> + <para>This tab provides an intuitive map search tool based on the marble widget. You can zoom in and out with the mousewheel by either scrolling it or hold and drag it. Pan by holding down the left mouse button. Press the <keycombo action="press">&Ctrl;<keycap>left mouse button</keycap></keycombo> to pull-up a square as indicated. All images falling within the coordinates of that square will be filtered and shown (provided your images have been geo-coded of course).</para> + <para>In the box below you can enter a name for your geo filter. It will be added to the list view below for future reference, it acts as a live geo folder.</para> <example> <title>The Map Searches tab</title> <screenshot><screeninfo>For higher resolution maps choose "More Info"</screeninfo><mediaobject><imageobject><imagedata fileref="&path;sidebargeolocation.png" format="PNG" /> </imageobject></mediaobject></screenshot> </example> @@ -1063,7 +1062,7 @@ </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> 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> @@ -1429,10 +1428,10 @@ Fun stuff <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>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>PGF</command> "Progressive Graphics File" is another not so known but open file image format. Wavelet-based, it allows lossless and lossy data compression. PGF compares well with JPEG 2000 but it was developed for speed (compression/decompression) rather than to be the best at compression ratio. At the same file size a PGF file looks significantly better than a JPEG one, while remaining very good at progressive display too. Thus it should be well-suited to the web but at the moment few browsers can display it. For more information about the PGF format see the <ulink url="http://www.libpgf.org/";>libPGF homepage</ulink>.</para> + <para><command>PGF</command> "Progressive Graphics File" is another not so known but open file image format. Wavelet-based, it allows lossless and lossy data compression. PGF compares well with JPEG 2000 but it was developed for speed (compression/decompression) rather than to be the best at compression ratio. At the same file size a PGF file looks significantly better than a JPEG one, while remaining very good at progressive display too. Thus it should be well-suited to the web but at the moment few browsers can display it. For more information about the PGF format see the <ulink url="http://www.libpgf.org/";>libPGF homepage</ulink>.</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 cannot use your old RAW files anymore. I have 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. A handful of camera manufacturers have adopted DNG already, let's hope that the main contenders Canon and Nikon will use it one day.</para> @@ -1614,8 +1613,8 @@ Fun stuff <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 add many information independently or by combination including : date, time, original file name, file extension, directory, owner, group, camera name, a sequence number or any other metadata from the photograph. </para> - <para> - </para> + <para> + </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> @@ -1627,8 +1626,8 @@ Fun stuff <para> <itemizedlist> - <listitem><para>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></listitem> + <listitem><para>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></listitem> <listitem><para>If you want another date format then the default date format, click on <guilabel>Date & Time...</guilabel>, choose <guilabel>Custom</guilabel> in <guilabel>Format</guilabel> drop-down list and fill in for example "dd.MM.yyyy hh:mm:ss". For more information, read <ulink url="http://doc.qt.digia.com/qt/qdatetime.html#toString";>QdateTime</ulink> class reference.</para></listitem> @@ -1763,7 +1762,7 @@ Fun stuff <para> GPS devices: - <ulink url="http://www.letsgodigital.org/en/9323/sony_gps_photography/";>GPS tracker from Sony </ulink> and + <ulink url="http://www.letsgodigital.org/en/9323/sony_gps_photography/";>GPS tracker from Sony </ulink> and <ulink url="http://www.emtac.com/products/bluetooth/index.html#btgps";>EMTAC bluetooth GPS </ulink> </para> </sect2>
