doc/docbook/GuideOptionsGeneral.xml

   1 <?xml version="1.0" encoding="utf-8"?>\r
   2 <section id="GuideOptionsGeneral">\r
   3   <title>General Options</title>\r
   4   <para>This section describes the options presented under the General Tab of the preferences dialog.</para>\r
   5   <section id="PreferencesThumbnails">\r
   6     <title>Thumbnails</title>\r
   7     <variablelist>\r
   8       <varlistentry>\r
   9         <term>\r
  10           <guilabel>Size</guilabel>\r
  11         </term>\r
  12         <listitem>\r
  13           <para>Selects the size of the thumbnails displayed throughout Geeqie, dimensions are width by height in pixels.</para>\r
  14         </listitem>\r
  15       </varlistentry>\r
  16     </variablelist>\r
  17     <variablelist>\r
  18       <varlistentry>\r
  19         <term>\r
  20           <guilabel>Quality</guilabel>\r
  21         </term>\r
  22         <listitem>\r
  23           <para>\r
  24             Selects the method to use when scaling an image down for thumbnails:\r
  25             <variablelist>\r
  26               <varlistentry>\r
  27                 <term>\r
  28                   <guilabel>Nearest</guilabel>\r
  29                 </term>\r
  30                 <listitem>\r
  31                   <para>Fastest scaler, but results in poor thumbnail quality.</para>\r
  32                 </listitem>\r
  33               </varlistentry>\r
  34               <varlistentry>\r
  35                 <term>\r
  36                   <guilabel>Tiles</guilabel>\r
  37                 </term>\r
  38                 <listitem>\r
  39                   <para>Thumbnail results are very close to bilinear, with better speed.</para>\r
  40                 </listitem>\r
  41               </varlistentry>\r
  42               <varlistentry>\r
  43                 <term>\r
  44                   <guilabel>Bilinear</guilabel>\r
  45                 </term>\r
  46                 <listitem>\r
  47                   <para>High quality results, moderately fast.</para>\r
  48                 </listitem>\r
  49               </varlistentry>\r
  50               <varlistentry>\r
  51                 <term>\r
  52                   <guilabel>Hyper</guilabel>\r
  53                 </term>\r
  54                 <listitem>\r
  55                   <para>Slowest scaler, sometimes gives better results than bilinear.</para>\r
  56                 </listitem>\r
  57               </varlistentry>\r
  58             </variablelist>\r
  59           </para>\r
  60         </listitem>\r
  61       </varlistentry>\r
  62     </variablelist>\r
  63     <variablelist>\r
  64       <varlistentry>\r
  65         <term>\r
  66           <guilabel>Cache thumbnails</guilabel>\r
  67         </term>\r
  68         <listitem>\r
  69           <para>Enable this to save thumbnails to disk. Subsequent requests for a thumbnail will be faster.</para>\r
  70           <variablelist>\r
  71             <varlistentry>\r
  72               <term>\r
  73                 <guilabel>Use Geeqie thumbnail style and cache</guilabel>\r
  74               </term>\r
  75               <listitem>\r
  76                 <para>Thumbnails are stored in a folder hierachy that mirrors the location of the source images. Thumbnails have the same name as the original appended by the file extension .png.</para>\r
  77                 <para>\r
  78                   The root of the hierachy is:\r
  79                   <para>\r
  80                     <programlisting>$XDG_CACHE_HOME/geeqie/thumbnails/</programlisting>\r
  81                     or, if $XDG_CACHE_HOME is not defined:\r
  82                     <programlisting>$HOME/.cache/geeqie/thumbnails/</programlisting>\r
  83                   </para>\r
  84                 </para>\r
  85               </listitem>\r
  86             </varlistentry>\r
  87           </variablelist>\r
  88           <variablelist>\r
  89             <varlistentry>\r
  90               <term>\r
  91                 <guilabel>Store thumbnails local to image folder (non-standard)</guilabel>\r
  92               </term>\r
  93               <listitem>\r
  94                 <para>\r
  95                   When enabled, Geeqie attempts to store cached thumbnails closer to the source image. This way multiple users can benefit from a single cache, thereby reducing wasted disk space.\r
  96                   <para />\r
  97                   Thumbnails have the same name as the original appended by the file extension .png.\r
  98                   <para />\r
  99                   The resulting location is the source image's folder, in a sub folder with the name\r
 100                   <programlisting>.thumbnails</programlisting>\r
 101                   <para />\r
 102                   When the image source folder cannot be written, Geeqie falls back to saving the thumbnail in the user's home folder.\r
 103                 </para>\r
 104               </listitem>\r
 105             </varlistentry>\r
 106           </variablelist>\r
 107           <variablelist>\r
 108             <varlistentry>\r
 109               <term>\r
 110                 <guilabel>Use standard thumbnail style and cache, shared with other applications</guilabel>\r
 111               </term>\r
 112               <listitem>\r
 113                 <para>\r
 114                   This will use a thumbnail caching method that is compatible with applications that use the standard thumbnail specification. When this option is enabled thumbnails will be stored in:\r
 115                   <para>\r
 116                     <programlisting>$XDG_CACHE_HOME/thumbnails/</programlisting>\r
 117                     or, if $XDG_CACHE_HOME is not defined:\r
 118                     <programlisting>$HOME/.cache/thumbnails/</programlisting>\r
 119                   </para>\r
 120                   <para>\r
 121                     All thumbnails are stored in the same folder, with computer-generated filenames. Refer to\r
 122                     <link linkend="GuideReferenceThumbnails">Thumbnails Reference</link>\r
 123                     for additional details.\r
 124                   </para>\r
 125                 </para>\r
 126               </listitem>\r
 127             </varlistentry>\r
 128           </variablelist>\r
 129         </listitem>\r
 130       </varlistentry>\r
 131     </variablelist>\r
 132     <variablelist>\r
 133       <varlistentry>\r
 134         <term>\r
 135           <guilabel>Use EXIF thumbnails when available</guilabel>\r
 136         </term>\r
 137         <listitem>\r
 138           <para>Geeqie will extract thumbnail from EXIF data if available, instead of generating one. This will speed up thumbnails generation, but the EXIF thumbnail may be not in sync with the image if it was modified by a tool which did not also update the thumbnail data.</para>\r
 139         </listitem>\r
 140       </varlistentry>\r
 141     </variablelist>\r
 142   </section>\r
 143   <section id="StarRatingCharacters">\r
 144     <title>Star Rating</title>\r
 145     <para>The characters used to display the Star Rating are defined here. They are defined as a hexadecimal Unicode character. The complete list of Unicode characters can be found in many places on the Internet.</para>\r
 146   </section>\r
 147   <section id="Slideshow">\r
 148     <title>Slide show</title>\r
 149     <variablelist>\r
 150       <varlistentry>\r
 151         <term>\r
 152           <guilabel>Delay between image change</guilabel>\r
 153         </term>\r
 154         <listitem>Specifies the delay between images for slide shows, in seconds.</listitem>\r
 155       </varlistentry>\r
 156     </variablelist>\r
 157     <variablelist>\r
 158       <varlistentry>\r
 159         <term>\r
 160           <guilabel>Random</guilabel>\r
 161         </term>\r
 162         <listitem>\r
 163           When enabled, slide show images will appear in random order.\r
 164           <note>\r
 165             <para>Random images are displayed such that each image appears once per cycle of all images. When the slide show repeat option is enabled, the image order is randomized after completing each cycle.</para>\r
 166           </note>\r
 167         </listitem>\r
 168       </varlistentry>\r
 169     </variablelist>\r
 170     <variablelist>\r
 171       <varlistentry>\r
 172         <term>\r
 173           <guilabel>Repeat</guilabel>\r
 174         </term>\r
 175         <listitem>This will cause the slide show to loop indefinitely, it will continue with the first image after displaying the last image in the slide show list.</listitem>\r
 176       </varlistentry>\r
 177     </variablelist>\r
 178   </section>\r
 179   <section id="ImageLoadingandCaching">\r
 180     <title>Image loading and caching</title>\r
 181     <variablelist>\r
 182       <varlistentry>\r
 183         <term>\r
 184           <guilabel>Decoded image cache size</guilabel>\r
 185         </term>\r
 186         <listitem>\r
 187           <para>Limit the amount of memory available for caching images.</para>\r
 188         </listitem>\r
 189       </varlistentry>\r
 190       <varlistentry>\r
 191         <term>\r
 192           <guilabel>Preload next image</guilabel>\r
 193         </term>\r
 194         <listitem>\r
 195           <para>Enabling this option will cause Geeqie to read the next logical image from disk when idle, it will also retain the previously viewed image in memory. By reading the nearest images into memory, time to display the next image is reduced.</para>\r
 196           <note>\r
 197             <para>This option will increase Geeqie memory requirements, and may cause performance issues with very large images. If the use of Geeqie results in the system noticeably swapping memory to disk, try disabling this feature.</para>\r
 198           </note>\r
 199         </listitem>\r
 200       </varlistentry>\r
 201       <varlistentry>\r
 202         <term>\r
 203           <guilabel>Refresh on file change</guilabel>\r
 204         </term>\r
 205         <listitem>\r
 206           <para>Geeqie will monitor currently active images and folders for changes in their modification time, and update the display if it changes.</para>\r
 207           <note>\r
 208             <para>Disable this if the system will not go into sleep mode due to occasional disk activity from the time check, or if Geeqie updates too often for folders with continuously changing content.</para>\r
 209           </note>\r
 210         </listitem>\r
 211       </varlistentry>\r
 212     </variablelist>\r
 213   </section>\r
 214   <section id="InfoSidebar">\r
 215     <title>Info Sidebar component heights</title>\r
 216     <para>\r
 217       The heights of the following components can be set individually:\r
 218       <itemizedlist>\r
 219         <listitem>Keywords</listitem>\r
 220         <listitem>Title</listitem>\r
 221         <listitem>Comments</listitem>\r
 222       </itemizedlist>\r
 223     </para>\r
 224     <note>\r
 225       <para>Geeqie must be restarted for changes to take effect.</para>\r
 226     </note>\r
 227     <variablelist />\r
 228   </section>\r
 229   <section id="PredefinedKeywordTree">\r
 230     <title>Show predefined keyword tree</title>\r
 231     <para>Deselecting this option will hide the list of predefined keywords on the right-hand side of the keywords pane of the info sidebar.</para>\r
 232     <note>\r
 233       <para>Geeqie must be restarted for the change to take effect.</para>\r
 234     </note>\r
 235     <variablelist />\r
 236   </section>\r
 237   <section id="OnLineHelpSearch">\r
 238     <title>On-line help search</title>\r
 239     <para>\r
 240       An internet search engine may be used to search the help files on Geeqie's website. The string used to conduct the search is defined here. In most cases it will be in one of two formats:\r
 241       <para />\r
 242       <code>https://www.search-engine.com/search?q=site:geeqie.org/help</code>\r
 243       <para />\r
 244       <code>https://www.search-engine.com/?q=site:geeqie.org/help'</code>\r
 245     </para>\r
 246     <variablelist />\r
 247   </section>\r
 248 </section>\r