a6cf05bf0d4c4dff20ce154f2bf72038bdeb6fcf
[geeqie.git] / doc / docbook / GuideImageSearch.xml
1 <?xml version="1.0" encoding="utf-8"?>\r
2 <chapter id="GuideImageSearch">\r
3   <title id="titleGuideImageSearch">Search and Select</title>\r
4   <para>Geeqie provides comprehensive set of search methods, including not only the standard functions such as file date or size, but also image similarity.</para>\r
5   <para>There is a duplicate file finder, which uses search parameters such as image dimensions or checksum. Two sets of image files may be compared.</para>\r
6   <para>Geeqie also has a set of temporary "marks" or "tags" which may be allocated to any image as an aide to file organising.</para>\r
7   <section id="GuideImageSearchCache">\r
8     <title id="titleGuideImageSearchCache">Caching Data For Searches</title>\r
9     <para>\r
10       Searching large numbers of files for similarity can take significant cpu time. Part of this is the time to compute the similarity matrix for each file.\r
11       <para />\r
12       If the\r
13       <link linkend="PreferencesThumbnails">Cache Thumbnails</link>\r
14       option is selected in Preferences/General, the similarity matrix and the checksum will also be cached. This will reduce the time needed for future searches.\r
15       <note>If you frequently search on similarity and your images are in a tree arrangement under a single point, initiating a one-time search on similarity from the top of the tree will generate the similarity data for all images.</note>\r
16       <para>Similarity data are stored in a folder hierachy that mirrors the location of the source images. The data have the same name as the original appended by the file extension .sim.</para>\r
17       <para>\r
18         The root of the hierachy is:\r
19         <para>\r
20           <programlisting>$XDG_CACHE_HOME/geeqie/thumbnails/</programlisting>\r
21           or, if $XDG_CACHE_HOME is not defined:\r
22           <programlisting>$HOME/.cache/geeqie/thumbnails/</programlisting>\r
23         </para>\r
24       </para>\r
25     </para>\r
26     <para />\r
27   </section>\r
28   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearchSearch.xml" />\r
29   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearchFindingDuplicates.xml" />\r
30   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageMarks.xml" />\r
31   <para />\r
32 </chapter>\r