<?xml version="1.0" encoding="utf-8"?>
<section id="GuideOptionsGeneral">
  <title>General Options</title>
  <para>This section describes the options presented under the General Tab of the preferences dialog.</para>
  <section id="PreferencesThumbnails">
    <title>Thumbnails</title>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Size</guilabel>
        </term>
        <listitem>
          <para>Selects the size of the thumbnails displayed throughout Geeqie, dimensions are width by height in pixels.</para>
        </listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Quality</guilabel>
        </term>
        <listitem>
          <para>
            Selects the method to use when scaling an image down for thumbnails:
            <variablelist>
              <varlistentry>
                <term>
                  <guilabel>Nearest</guilabel>
                </term>
                <listitem>
                  <para>Fastest scaler, but results in poor thumbnail quality.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                  <guilabel>Tiles</guilabel>
                </term>
                <listitem>
                  <para>Thumbnail results are very close to bilinear, with better speed.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                  <guilabel>Bilinear</guilabel>
                </term>
                <listitem>
                  <para>High quality results, moderately fast.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Cache thumbnails and sim. files</guilabel>
        </term>
        <listitem>
          <para>
            Enable this to save thumbnails and
            <link linkend="CreateSimFiles">sim. files</link>
            to disk. Subsequent requests for a thumbnail will be faster, as will searches and find duplicates.
          </para>
          <variablelist>
            <varlistentry>
              <term>
                <guilabel>Use Geeqie thumbnail style and cache</guilabel>
              </term>
              <listitem>
                <para>Thumbnails are stored in a folder hierarchy that mirrors the location of the source images. Thumbnails have the same name as the original appended by the file extension .png.</para>
                <para>
                  The root of the hierarchy is:
                  <para>
                    <programlisting>$XDG_CACHE_HOME/geeqie/thumbnails/</programlisting>
                    or, if $XDG_CACHE_HOME is not defined:
                    <programlisting>$HOME/.cache/geeqie/thumbnails/</programlisting>
                  </para>
                </para>
              </listitem>
            </varlistentry>
          </variablelist>
          <variablelist>
            <varlistentry>
              <term>
                <guilabel>Store thumbnails local to image folder (non-standard)</guilabel>
              </term>
              <listitem>
                <para>
                  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.
                  <para />
                  Thumbnails have the same name as the original appended by the file extension .png.
                  <para />
                  The resulting location is the source image's folder, in a sub folder with the name
                  <programlisting>.thumbnails</programlisting>
                  <para />
                  When the image source folder cannot be written, Geeqie falls back to saving the thumbnail in the user's home folder.
                </para>
              </listitem>
            </varlistentry>
          </variablelist>
          <variablelist>
            <varlistentry>
              <term>
                <guilabel>Use standard thumbnail style and cache, shared with other applications</guilabel>
              </term>
              <listitem>
                <para>
                  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:
                  <para>
                    <programlisting>$XDG_CACHE_HOME/thumbnails/</programlisting>
                    or, if $XDG_CACHE_HOME is not defined:
                    <programlisting>$HOME/.cache/thumbnails/</programlisting>
                  </para>
                  <para>
                    All thumbnails are stored in the same folder, with computer-generated filenames. Refer to
                    <link linkend="GuideReferenceThumbnails">Thumbnails Reference</link>
                    for additional details.
                  </para>
                </para>
              </listitem>
            </varlistentry>
          </variablelist>
        </listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Use EXIF thumbnails when available</guilabel>
        </term>
        <listitem>
          <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>
        </listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Thumbnail color management</guilabel>
        </term>
        <listitem>
          <para>Where possible store thumbnails with an sRGB color profile.</para>
            <note>
              <para>Selecting this option will increase the time taken to generate thumbnails.</para>
              <para>You probably will want to deselect the "Use EXIF thumbnails" option.</para>
            </note>
        </listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Collection preview</guilabel>
        </term>
        <listitem>
          <para>
            If thumbnail caching is enabled and you open the
            <link linkend="GuideReferenceConfig">Collections folder</link>
            , 
            Geeqie will display a preview of the collections as a thumbnail montage. This option limits the number of thumbnails displayed in each preview.
            <note>
              <para>ImageMagick is required for this feature.</para>
            </note>
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </section>
  <section id="StarRatingCharacters">
    <title>Star Rating</title>
    <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>
  </section>
  <section id="Slideshow">
    <title>Slide show</title>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Delay between image change</guilabel>
        </term>
        <listitem>Specifies the delay between images for slide shows, in seconds.</listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Random</guilabel>
        </term>
        <listitem>
          When enabled, slide show images will appear in random order.
          <note>
            <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>
          </note>
        </listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Repeat</guilabel>
        </term>
        <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>
      </varlistentry>
    </variablelist>
  </section>
  <section id="ImageLoadingandCaching">
    <title>Image loading and caching</title>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Decoded image cache size</guilabel>
        </term>
        <listitem>
          <para>Limit the amount of memory available for caching images.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Preload next image</guilabel>
        </term>
        <listitem>
          <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>
          <note>
            <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>
          </note>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Refresh on file change</guilabel>
        </term>
        <listitem>
          <para>Geeqie will monitor currently active images and folders for changes in their modification time, and update the display if it changes.</para>
          <note>
            <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>
          </note>
        </listitem>
      </varlistentry>
    </variablelist>
  </section>
  <section id="MenuStyle">
    <title>Menu style</title>
    <para>Use a ☰ "hamburger" style menu button instead of the standard menu across the top of the frame.</para>
    <note>
      <para>Geeqie must be restarted for changes to take effect.</para>
    </note>
  </section>
  <section id="ExpandToolbar">
    <title>Expand menu/toolbar</title>
    <para>Expand the menu/toolbar to the full width of the window.</para>
    <note>
      <para>Geeqie must be restarted for changes to take effect.</para>
    </note>
  </section>
  <section id="HideSelectableBars">
    <title>Hide Selectable Bars</title>
    <para>The menu item Hide Selectable Bars will toggle display of the bars selected here. The default keystroke for this action is <code>control + backtick</code></para>
    <note>
      <para>Geeqie must be restarted for changes to take effect.</para>
    </note>
  </section>
  <section id="AppImageUpdatesNotifications">
    <title>AppImage updates notifications</title>
    <para>Show a notification on start-up if the server has a newer version than the current. Requires an Internet connection. Displayed only if an AppImage is being run.</para>
  </section>
  <section id="PredefinedKeywordTree">
    <title>Show predefined keyword tree</title>
    <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>
    <note>
      <para>Geeqie must be restarted for the change to take effect.</para>
    </note>
    <variablelist />
  </section>
  <section id="TimezoneDatabase">
    <title>Timezone Database</title>
    <para>
      The timezone database is used to correct exif time and date for UTC offset and Daylight Saving Time as described
      <link linkend="GuideReferenceUTC">here.</link>
      This option allows you to install or update the database. An Internet connection is required.
    </para>
    <variablelist />
  </section>
  <section id="OnLineHelpSearch">
    <title>On-line help search</title>
    <para>
      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:
      <para />
      <code>https://www.search-engine.com/search?q=site:geeqie.org/help</code>
      <para />
      <code>https://www.search-engine.com/?q=site:geeqie.org/help'</code>
    </para>
    <variablelist />
  </section>
</section>
