doc/docbook/GuideOptionsGeneral.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <section id="GuideOptionsGeneral">
   3     <title>
   4       General Options
   5     </title>
   6     <para>
   7       This section describes the options presented under the General Tab of the preferences dialog.
   8     </para>
   9     <para/><section id="Startup"><title>
  10       Startup
  11     </title>
  12     <variablelist><varlistentry><term>
  13         Restore folder on startup
  14       </term><listitem><para/></listitem></varlistentry></variablelist>
  15     <para>
  16       Enabling this will cause Geeqie to initially open to the specified folder.
  17     </para>
  18     <variablelist><varlistentry><term>
  19         Use Current
  20       </term><listitem><para/></listitem></varlistentry></variablelist>
  21     <para>
  22       Activate this button to change the setting to the current folder.
  23     </para>
  24     <variablelist><varlistentry><term>
  25         Use last path
  26       </term><listitem><para/></listitem></varlistentry></variablelist>
  27     <para>
  28       When checked, Geeqie will recall the last path used on startup.
  29     </para>
  30     <para/></section><section id="Thumbnails"><title>
  31       Thumbnails
  32     </title>
  33     <variablelist><varlistentry><term>
  34         Size
  35       </term><listitem><para/></listitem></varlistentry></variablelist>
  36     <para>
  37       Selects the size of the thumbnails displayed throughout Geeqie, dimensions are width by height in pixels.
  38     </para>
  39     <variablelist><varlistentry><term>
  40         Quality
  41       </term><listitem><para/></listitem></varlistentry></variablelist>
  42     <para>
  43       Selects the method to use when scaling an image down for thumbnails.
  44     </para>
  45     <variablelist><varlistentry><term>
  46         Nearest
  47       </term><listitem><para>
  48         Fastest scaler, but results in poor thumbnail quality.
  49       </para></listitem></varlistentry><varlistentry><term>
  50         Tiles
  51       </term><listitem><para>
  52         Thumbnail results are very close to bilinear, with better speed.
  53       </para></listitem></varlistentry><varlistentry><term>
  54         Bilinear
  55       </term><listitem><para>
  56         High quality results, moderately fast.
  57       </para></listitem></varlistentry><varlistentry><term>
  58         Hyper
  59       </term><listitem><para>
  60         Slowest scaler, sometimes gives better results than bilinear.
  61       </para></listitem></varlistentry></variablelist>
  62     <variablelist><varlistentry><term>
  63         Cache thumbnails
  64       </term><listitem><para/></listitem></varlistentry></variablelist>
  65     <para>
  66       Enable this to save thumbnails to disk, subsequent requests for a thumbnail will be faster. Thumbnails are cached into ($HOME)/.geeqie/thumbnails. Refer to <link linkend="GuideReferenceThumbnails">Thumbnails Reference</link> for details.
  67     </para>
  68     <variablelist><varlistentry><term>
  69         Use shared thumbnail cache
  70       </term><listitem><para/></listitem></varlistentry></variablelist>
  71     <para>
  72       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 ($HOME)/.thumbnails
  73     </para>
  74     <variablelist><varlistentry><term>
  75         Cache thumbnails into .thumbnails
  76       </term><listitem><para/></listitem></varlistentry></variablelist>
  77     <para>
  78       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 <emphasis role="strong">.thumbnails</emphasis>. When the image source folder cannot be written, Geeqie falls back to saving the thumbnail in the user's home folder.
  79     </para>
  80     <variablelist><varlistentry><term>
  81         Faster jpeg thumbnailing
  82       </term><listitem><para/></listitem></varlistentry></variablelist>
  83     <para>
  84       This will speed up thumbnails generation in some cases, but may reduce the quality
  85     </para>
  86     <variablelist><varlistentry><term>
  87         Use EXIF thumbnails when available
  88       </term><listitem><para/></listitem></varlistentry></variablelist>
  89     <para>
  90       Geeqie will extract thumbnail from EXIF data if available instead of generating one. This will speed up thumbnails generation but EXIF thumbnail may be not in sync with the image if it was modified by a tool which didn't take care of the thumbnail data.
  91     </para>
  92     <variablelist><varlistentry><term>
  93         Use xvpics thumbnails when found
  94       </term><listitem><para/></listitem></varlistentry></variablelist>
  95     <para>
  96       xvpics is a common thumbnail caching format used by several applications. Thumbnails are stored locally to the source image in a sub folder with the name <emphasis role="strong">.xvpics</emphasis>. Enabling this option will allow Geeqie to read thumbnails saved in the xvpics format.
  97     </para>
  98     <para>
  99       Note: Support for xvpics is read only, Geeqie can not generate thumbnails in this format.
 100     </para>
 101     <para/></section><section id="Slideshow"><title>
 102       Slide show
 103     </title>
 104     <variablelist><varlistentry><term>
 105         Delay between image change
 106       </term><listitem><para/></listitem></varlistentry></variablelist>
 107     <para>
 108       Specifies the delay between images for slide shows, in seconds.
 109     </para>
 110     <variablelist><varlistentry><term>
 111         Random
 112       </term><listitem><para/></listitem></varlistentry></variablelist>
 113     <para>
 114       When enabled, slide show images will appear in random order.
 115     </para>
 116     <para>
 117       Note: 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.
 118     </para>
 119     <variablelist><varlistentry><term>
 120         Repeat
 121       </term><listitem><para/></listitem></varlistentry></variablelist>
 122     <para>
 123       When enabled, slide shows will continue at the beginning after the last image is displayed.
 124     </para>
 125   <para/></section></section>