view doc/options_image.html @ 1186:fd7d587199a7

Resync .h with .c declarations.
author zas_
date Thu, 27 Nov 2008 12:33:07 +0000
parents c564ab6c11fc
children
line wrap: on
line source

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />

  <title>Image Options - Geeqie User Manual</title>
  <link rel="stylesheet" type="text/css" href="style.css" media="all" />
  <link rel="stylesheet" type="text/css" href="style_screen.css" media="screen" />
  <link rel="stylesheet" type="text/css" href="style_print.css" media="print" />
</head>

<body lang="en-US" dir="ltr" xml:lang="en-US">
  <div class="navtop">
    <table width="100%" border="0" cellpadding="4" cellspacing="0">
      <col id="navtop_col1" width="33%"></col>
      <col id="navtop_col2" width="33%"></col>
      <col id="navtop_col3" width="33%"></col>

        <tr>
          <th>
            <p class="previous"><a href="options_general.html">Previous</a>
            </p>
          </th>

          <th>
            <p class="navtop_title">Image &ndash; Options Explaned</p>
          </th>

          <th>
            <p class="next"><a href="options_window.html">Next</a>
            </p>
          </th>
        </tr>
    </table>
  </div>

  <hr />

  <h1>Image Options</h1>

  <p>This section describes the options presented under the Image Tab of the preferences dialog.</p>

  <h2>Zoom</h2>

  <dl class="dialog_desc">
  <dt>Quality</dt>
  <dd><p>Selects the method used to scale the size of an image.</p>

  <dl>
  <dt>Nearest</dt><dd>Fastest scaler, but results in poor image quality.</dd>
  <dt>Tiles</dt><dd>Results are somewhat close to bilinear, with better speed.</dd>
  <dt>Bilinear</dt><dd>High quality results, moderately fast.</dd>
  <dt>Hyper</dt><dd>Slowest scaler, sometimes gives better results than bilinear.</dd>
  </dl>
  </dd>

  <dt>Two pass zooming</dt>
  <dd><p>Enables Geeqie to first display a scaled image using the nearest zoom quality. After image decoding is complete, the image is scaled again using the selected &ldquo;Zoom (scaling)&rdquo; method. This allows faster display of an image as it is decoded from the source file.</p></dd>

  <dt>Allow enlargement of image for zoom to fit</dt>
  <dd><p>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 &ldquo;Fit to Window&rdquo;.</p></dd>

  <dt>Limit image size when autofitting</dt>
  <dd><p>This percentage will affect the size of the image when <span class="option_name">Fit image to window</span> is set, instead of using 100% of the window, it will use the specified percentage. It allows 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.</p></dd>


  <dt>Zoom increment</dt>
  <dd><p>Adjusts the step size when zooming in or out on an image. This value corresponds to the percentage of the original image.</p></dd>

  </dl>

  <h2>Zoom control</h2>

  <dl class="dialog_desc">
  <dt>When new image is selected</dt>
  <dd><p>This controls the behavior of the zoom setting when changing the displayed image.</p>

  <dl>
  <dt>Zoom to original size</dt><dd>The new image is set to it's original size.</dd>
  <dt>Fit image to window</dt><dd>The new image's zoom is changed so that the image will fit within the current view area.</dd>
  <dt>Leave zoom at previous setting</dt><dd>The zoom setting is unchanged, the new image will be scaled the same as the previous image.</dd>
  </dl>
  </dd>
  </dl>

   <h2>Scroll control</h2>

  <dl class="dialog_desc">
  <dt>Scroll reset method</dt>
  <dd><p>This controls the scroll initial position when changing the displayed image.</p>

  <dl>
  <dt>Top left</dt><dd>The new image is displayed from top left corner.</dd>
  <dt>Center</dt><dd>The new image is centered</dd>
  <dt>No change</dt><dd>The new image is positionned as the previous one, whenever possible.</dd>
  </dl>
  </dd>
  </dl>

  <h2>Appearance</h2>

  <dl class="dialog_desc">
  <dt>Custom border color</dt>
  <dd><p>Enable this to draw the image background (the area around the image) in the specified color.</p></dd>
 <dt>Border color</dt>
  <dd><p>Use this color chooser to define the color to use as image background.</p></dd>

  </dl>
  <p class="note"><span class="note_label">Note:</span> You may use <span class="option_name">Limit image size when autofitting</span> option to keep a border around the image in fullscreen mode.</p>

  <h2>Convenience</h2>

  <dl class="dialog_desc">
  <dt>Refresh on file change</dt>
  <dd><p>Geeqie will monitor currently active images and folders for changes in their modification time, and update the display if it changes.</p>
  <p class="note"><span class="note_label">Note:</span> 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.</p>
  </dd>

  <dt>Preload next image</dt>
  <dd><p>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.</p>
 <p class="note"><span class="note_label">Note:</span> 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.</p></dd>

  <dt>Auto rotate image using EXIF information</dt>
  <dd><p>Auto rotates images based on data stored in images that include EXIF data.</p></dd>
  </dl>

  <hr id="bottomseparator" />

  <div class="navbottom">
    <table width="100%" border="0" cellpadding="4" cellspacing="0">
      <col id="navbottom_col1" width="33%"></col>
      <col id="navbottom_col2" width="33%"></col>
      <col id="navbottom_col3" width="33%"></col>

        <tr>
          <th>
            <p class="previous"><a href="options_general.html">Previous</a>
            </p>
          </th>

          <th>
            <p class="navbottom_title"><a href="index.html">Contents</a>
            </p>
          </th>

          <th>
            <p class="next"><a href="options_window.html">Next</a>
            </p>
          </th>
        </tr>

    </table>
  </div>

  <div class="footer">Geeqie User Manual</div>
  <div class="bottomspacer">&nbsp;</div>
</body>
</html>