<?xml version="1.0" encoding="utf-8"?>
<section id="GuideOptionsImage">
  <title>Image Options</title>
  <para>This section describes the options presented under the Image Tab of the preferences dialog.</para>
  <section id="Zoom">
    <title>Zoom</title>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Quality</guilabel>
        </term>
        <listitem>
          <para>
            Selects the method used to scale the size of an image:
            <variablelist>
              <varlistentry>
                <term>
                  <guilabel>Nearest</guilabel>
                </term>
                <listitem>
                  <para>Fastest scaler, but results in poor image quality.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                  <guilabel>Tiles</guilabel>
                </term>
                <listitem>
                  <para>Results are somewhat 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>
      <varlistentry>
        <term>
          <guilabel>Use GPU acceleration via Clutter library</guilabel>
        </term>
        <listitem>
          <para>Use alternate renderer. Geeqie must be compiled with the --enable-gpu-accel option.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Two pass zooming</guilabel>
        </term>
        <listitem>
          <para>
            Enables Geeqie to first display a scaled image using the
            <emphasis>Nearest</emphasis>
            zoom quality. After image decoding is complete, the image is scaled again using the selected
            <emphasis>Zoom Quality</emphasis>
            method. This allows faster display of an image as it is decoded from the source file.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Zoom increment</guilabel>
        </term>
        <listitem>
          <para>Adjusts the step size when zooming in or out on an image.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Zoom style</guilabel>
        </term>
        <listitem>
          <para>Selects whether the zoom step size is applied as a geometric (n * step) or arithmetic (n + step) factor.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </section>
  <section id="FitImageToWindow">
    <title>Fit Image To Window</title>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Allow enlargement of image (max. size in %)</guilabel>
        </term>
        <listitem>
          <para>
            Enable this to allow Geeqie to increase the image size for images that are smaller than the current view area when the zoom is set to
            <emphasis>Fit image to window</emphasis>
            . This value sets the maximum expansion permitted in percent i.e. 100% is full-size.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Virtual window size (% of actual window)</guilabel>
        </term>
        <listitem>
          <para>
            This value will set the virtual size of the window when
            <emphasis>Fit image to window</emphasis>
            is set. Instead of using the actual size of the window, the specified percentage of the window will be used. It allows one to keep a border around the image (values lower than 100%) or to auto zoom the image (values greater than 100%). It affects fullscreen mode too.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </section>
  <section id="TileSize">
    <title>Tile Size</title>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Tile size in pixels</guilabel>
        </term>
        <listitem>
          <para>
            This option is only available when GPU acceleration is not selected. It sets the size in pixels that large images are split into during rendering. Setting a larger value will reduce the tiling effect seen as the image is displayed, but will also slightly increase the delay until the first part of the image is seen.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </section>
  <section id="Appearance">
    <title>Appearance</title>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Custom border color</guilabel>
        </term>
        <listitem>
          <para>Enable this to draw the image background (the area around the image) in the specified color.</para>
        </listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Border color</guilabel>
        </term>
        <listitem>
          <para>Use this color chooser to define the color to use as image background.</para>
          <note>
            <para>
              You may use the
              <emphasis>Virtual window size</emphasis>
              (see above) option to keep a border around the image in fullscreen mode.
            </para>
          </note>
        </listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Alpha channel color 1/2</guilabel>
        </term>
        <listitem>
          <para>These two colors define the checkerboard background used when images with an alpha channel are displayed.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </section>
</section>
