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>\r
  70             Enable this to save thumbnails to disk, subsequent requests for a thumbnail will be faster. Thumbnails are cached into:\r
  71             <programlisting>$XDG_CACHE_HOME/geeqie/thumbnails/</programlisting>\r
  72             <programlisting>($~/.cache/geeqie/thumbnails/)</programlisting>\r
  73             Refer to\r
  74             <link linkend="GuideReferenceThumbnails">Thumbnails Reference</link>\r
  75             for additional details.\r
  76           </para>\r
  77         </listitem>\r
  78       </varlistentry>\r
  79     </variablelist>\r
  80     <variablelist>\r
  81       <varlistentry>\r
  82         <term>\r
  83           <guilabel>Use shared thumbnail cache</guilabel>\r
  84         </term>\r
  85         <listitem>\r
  86           <para>\r
  87             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
  88             <programlisting>$HOME/.thumbnails</programlisting>\r
  89           </para>\r
  90         </listitem>\r
  91       </varlistentry>\r
  92     </variablelist>\r
  93     <variablelist>\r
  94       <varlistentry>\r
  95         <term>\r
  96           <guilabel>Cache thumbnails into .thumbnails</guilabel>\r
  97         </term>\r
  98         <listitem>\r
  99           <para>\r
 100             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. The resulting location is the source image's folder, in a sub folder with the name\r
 101             <programlisting>.thumbnails</programlisting>\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>Faster jpeg thumbnailing</guilabel>\r
 111         </term>\r
 112         <listitem>\r
 113           <para>This will speed up thumbnails generation in some cases, but may reduce the quality</para>\r
 114         </listitem>\r
 115       </varlistentry>\r
 116     </variablelist>\r
 117     <variablelist>\r
 118       <varlistentry>\r
 119         <term>\r
 120           <guilabel>Use EXIF thumbnails when available</guilabel>\r
 121         </term>\r
 122         <listitem>\r
 123           <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
 124         </listitem>\r
 125       </varlistentry>\r
 126     </variablelist>\r
 127     <variablelist>\r
 128       <varlistentry>\r
 129         <term>\r
 130           <guilabel>Use xvpics thumbnails when found</guilabel>\r
 131         </term>\r
 132         <listitem>\r
 133           Refer to\r
 134           <link linkend="GuideOptionsHidden" endterm="titleGuideOptionsHidden" />\r
 135           .\r
 136         </listitem>\r
 137       </varlistentry>\r
 138     </variablelist>\r
 139   </section>\r
 140   <section id="Slideshow">\r
 141     <title>Slide show</title>\r
 142     <variablelist>\r
 143       <varlistentry>\r
 144         <term>\r
 145           <guilabel>Delay between image change</guilabel>\r
 146         </term>\r
 147         <listitem>Specifies the delay between images for slide shows, in seconds.</listitem>\r
 148       </varlistentry>\r
 149     </variablelist>\r
 150     <variablelist>\r
 151       <varlistentry>\r
 152         <term>\r
 153           <guilabel>Random</guilabel>\r
 154         </term>\r
 155         <listitem>\r
 156           When enabled, slide show images will appear in random order.\r
 157           <note>\r
 158             <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
 159           </note>\r
 160         </listitem>\r
 161       </varlistentry>\r
 162     </variablelist>\r
 163     <variablelist>\r
 164       <varlistentry>\r
 165         <term>\r
 166           <guilabel>Repeat</guilabel>\r
 167         </term>\r
 168         <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
 169       </varlistentry>\r
 170     </variablelist>\r
 171   </section>\r
 172   <section id="ImageLoadingandCaching">\r
 173     <title>Image loading and caching</title>\r
 174     <variablelist>\r
 175       <varlistentry>\r
 176         <term>\r
 177           <guilabel>Decoded image cache size</guilabel>\r
 178         </term>\r
 179         <listitem>\r
 180           <para>Limit the amount of memory available for caching images.</para>\r
 181         </listitem>\r
 182       </varlistentry>\r
 183       <varlistentry>\r
 184         <term>\r
 185           <guilabel>Preload next image</guilabel>\r
 186         </term>\r
 187         <listitem>\r
 188           <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
 189           <note>\r
 190             <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
 191           </note>\r
 192         </listitem>\r
 193       </varlistentry>\r
 194       <varlistentry>\r
 195         <term>\r
 196           <guilabel>Refresh on file change</guilabel>\r
 197         </term>\r
 198         <listitem>\r
 199           <para>Geeqie will monitor currently active images and folders for changes in their modification time, and update the display if it changes.</para>\r
 200           <note>\r
 201             <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
 202           </note>\r
 203         </listitem>\r
 204       </varlistentry>\r
 205     </variablelist>\r
 206   </section>\r
 207   <section id="InfoSidebar">\r
 208     <title>Info Sidebar component heights</title>\r
 209     <para>\r
 210       The heights of the following components can be set individually:\r
 211       <itemizedlist>\r
 212         <listitem>Keywords</listitem>\r
 213         <listitem>Title</listitem>\r
 214         <listitem>Comments</listitem>\r
 215       </itemizedlist>\r
 216     </para>\r
 217     <note>\r
 218       <para>Geeqie must be restarted for changes to take effect.</para>\r
 219     </note>\r
 220     <variablelist />\r
 221   </section>\r
 222 </section>\r