Mercurial > geeqie

<?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>Advanced 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_properties.html">Previous</a>
            </p>
          </th>

          <th>
            <p class="navtop_title">Advanced &ndash; Options Explained</p>
          </th>

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

  <hr />

  <h1>Advanced Options</h1>

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

  <h2>Full Screen</h2>

  <dl class="dialog_desc">
  <dt>Location</dt>
  <dd><p>Selects the location and position of the full screen window. 'Determined by window manager' will leave the window placement up to the window manager. 'Active screen' places the window on the same screen as the Geeqie main window. 'Active monitor' does the same, but limits the full screen window size to the monitor containing the main window. The remaining choices are dependent on the multiple monitor configuration.</p></dd>

  <dt>Stay above other windows</dt>
  <dd><p>Enable this to have Geeqie ask the window manager to keep the full screen window above other windows. Note that the window manager may ignore the request. This option is not relevant when the full screen location is determined by the window manager.</p></dd>

  <dt>Smooth image flip</dt>
  <dd><p>This option delays the image change in full screen until the next image is entirely decoded into memory, the result is a smoother transition between images.</p></dd>

  <dt>Disable screen saver</dt>
  <dd><p>This option will execute <i>xscreensaver-command --deactivate</i> once per minute to avoid the screen saver from activating when Geeqie is displayed full screen.</p></dd>

  </dl>

  <h2>Overlay Screen Display</h2>

  <dl class="dialog_desc">
  <dt>Always show image overlay at startup</dt>
  <dd><p>Enable this to have the image overlay info displayed by default</p></dd>

  <dt>Image overlay template</dt>
  <dd><p>Overlay info is customizable through this template</p>
<p>Overlay info format string syntax is: <code>%tag[:max_length][:extra]%</code></p>

<div class="overlay_tags">
<table width="60%" border="1" cellpadding="2" cellspacing="0">
<col id="overlay_tags_col1" width="30%"></col>
<col id="overlay_tags_col2" width="70%"></col>
<tr><th>Tag</th><th>Replaced by</th></tr>
<tr><td>name</td><td>Filename of the picture</td></tr>
<tr><td>collection</td><td>Name of the collection</td></tr>
<tr><td>number</td><td>Current number of image in the list</td></tr>
<tr><td>total</td><td>Total number of images</td></tr>
<tr><td>date</td><td>File date</td></tr>
<tr><td>size</td><td>File size</td></tr>
<tr><td>width</td><td>Image width</td></tr>
<tr><td>height</td><td>Image height</td></tr>
<tr><td>res</td><td>Image resolution</td></tr>
<tr><td>keywords</td><td>Image keywords from metadata</td></tr>
<tr><td>comment</td><td>Image comment from metadata</td></tr>
</table>
</div>

<p>To access exif data use the exif name, for example: <code>%Exif.Photo.DateTimeOriginal%</code> to get the date of the original shot</p>

<p>Pre-formatted exif data is also available:</p>
<div class="overlay_exif">
<table width="60%" border="1" cellpadding="2" cellspacing="0">
<col id="overlay_exif_col1" width="30%"></col>
<col id="overlay_exif_col2" width="70%"></col>
<tr><th>Tag</th><th>Replaced by exif data</th></tr>

<tr><td>formatted.Camera</td><td>Camera and sofware name</td></tr>
<tr><td>formatted.DateTime</td><td>Image Date</td></tr>
<tr><td>formatted.ShutterSpeed</td><td>Shutter speed in seconds (ie. 1/60s)</td></tr>
<tr><td>formatted.Aperture</td><td>Aperture (ie. f5.6)</td></tr>
<tr><td>formatted.ExposureBias</td><td>Exposure bias (ie. +0.3)</td></tr>
<tr><td>formatted.ISOSpeedRating</td><td>ISO sensitivity (ie. 100)</td></tr>
<tr><td>formatted.FocalLength</td><td>Focal length</td></tr>
<tr><td>formatted.FocalLength35mmFilm</td><td>Focal length 35mm</td></tr>
<tr><td>formatted.SubjectDistance</td><td>Subject distance</td></tr>
<tr><td>formatted.Flash</td><td>Flash</td></tr>
<tr><td>formatted.Resolution</td><td>Resolution</td></tr>
<tr><td>formatted.ColorProfile</td><td>Color profile</td></tr>
</table>
</div>

<p>
  You can limit the length of displayed data using :number notation:
  <code>%formatted.Camera:20%</code> will truncate the displayed data to 20 characters
  and will add 3 dots at the end to denote the truncation.</p>

<p>
  If two or more variables are connected with the |-sign, it prints available
  variables with a separator:<br />
  <code>%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%</code><br />
  could show:<br />
    "1/20s - 400 - 80 mm"<br />
  or<br />
    "1/200 - 80 mm" if there's no ISO information in the Exif data.<br />
</p>

<p>
  If a line is empty, it is removed.
  This allows to add lines that totally disappear when no data is available.
</p>

<p>
  Extra string uses special character '*' to mark the position of the data.
  If no '*' is present, then extra string is just appended to data.
  Any "\n" is replaced by a newline on display.
  Pango mark up is accepted in left and right parts.
  If data is empty, nothing will be displayed.
</p>

<p>Examples:</p>
  <dl class="examples">
  <dt><code>%name:&lt;i&gt;*&lt;/i&gt;\n%</code></dt><dd>name is displayed in italics ended with a newline</dd>
  <dt><code>%size:\n%</code></dt><dd>size is displayed with a newline at end</dd>
  <dt><code>%formatted.ISOSpeedRating:ISO *%</code></dt><dd>ie. "ISO 100"</dd>
  <dt><code>Collection &lt;b&gt;*&lt;/b&gt;\n</code></dt><dd>display collection name in bold prefixed by "Collection " and a newline is appended</dd>
  </dl>

  </dd>

  <dt>Help button</dt>
  <dd><p>Show syntax help</p></dd>

  <dt>Defaults button</dt>
  <dd><p>Restore default image overlay template</p></dd>

  </dl>


  <h2>Delete</h2>

  <dl class="dialog_desc">
  <dt>Confirm file delete</dt>
  <dd><p>Prompts for confirmation before deleting files.</p></dd>

  <dt>Enable Delete key</dt>
  <dd><p>Disable this to disassociate the delete file function from the Delete key. This option does not effect the <span class="key">Ctrl</span> + <span class="key">D</span> key sequence. May be useful in combination with &ldquo;confirm file delete&rdquo;, above, disabled so that accidentally hitting a single key will not result in deleted files.</p></dd>

  <dt>Safe Delete</dt>
  <dd><p>Moves deleted files to a temporary folder, for easy retrieval of deleted files. Files in the temporary folder are retained until the maximum size is reached, at which point deleting additional files will result in the removal of the oldest files to reclaim the space needed for the new files.</p>
  <p class="note"><span class="note_label">Note:</span> Files moved to the Safe Delete folder are prefixed with a six digit number in the format: <code>nnnnnn_FILENAME</code><br />
  This is used by the delete feature to distinguish which files to remove first when clearing space for new files.<br />
  The digit counter increments with each deleted file.</p></dd>

  <dt>Folder</dt>
  <dd><p>The location of the folder used by the Safe Delete feature.</p></dd>

  <dt>Maximum size</dt>
  <dd><p>The size to use for the Safe Delete folder, in megabytes. Note that setting this value to 0 (zero) will disable any limit.</p></dd>

  <dt>Clear button</dt>
  <dd><p>Removes all files contained in the Safe Delete folder.</p></dd>

  <dt>View button</dt>
  <dd><p>Changes the Geeqie main window to display the contents of the Safe Delete folder.</p></dd>

  </dl>

  <h2>Behavior</h2>

  <dl class="dialog_desc">
  <dt>Rectangular selection in icon view</dt>
  <dd><p> Enable this to change the selection method used when selecting multiple items in an icon view.</p></dd>

  <dt>Descend folders in tree view</dt>
  <dd>
  <p>This will allow Geeqie to read sub folder content to determine if it should display expander indicators in the folder tree view.</p>
  <p class="note"><span class="note_label">Note:</span> Disable this if Geeqie wakes up auto mounted network shares, or takes too long to initially display the folder view.</p>
  </dd>

  <dt>Show date in directories list view</dt>
  <dd><p>Enable this to display directory modification date along its name in the list view</p></dd>

  <dt>In place renaming</dt>
  <dd><p>When renaming a single file, this will allow the rename entry to appear directly over the original filename.</p></dd>

  <dt>Show "Copy path" menu item</dt>
  <dd><p>Enable this option to show a "Copy path" menu item in applicable menus.</p>
  <p>This allows to copy path to files or directories to the clipboard, names are enclosed with double quotes
  and separated by space.</p>
  </dd>

  <dt>Open recent list maximum size</dt>
  <dd><p>This is the number of entries saved in the recent open file list.</p></dd>

  <dt>Drag'n drop icon size</dt>
  <dd><p>This is the width and height of the icon generated from image and displayed when doing drap'n drop actions. High resolution screens may require to increase this number.</p></dd>

  </dl>

  <h2>Navigation</h2>

  <dl class="dialog_desc">
  <dt>Progressive keyboard scrolling</dt>
  <dd><p>This will cause image panning speed to gradually accelerate when holding down the keyboard arrows.</p></dd>

  <dt>Mouse wheel scrolls image</dt>
  <dd><p>The default is for the mouse wheel to change the image, and to scroll the image when <span class="key">Shift</span> is used in combination with the wheel. Enabling this swaps the behavior so that operating the wheel will scroll the image, and holding down <span class="key">Shift</span> will change the image.</p></dd>

  <dt>Home button path</dt>
  <dd><p>This defines the path to use for the "Home" button in the main window. By default or when this field is empty, this is the user's directory.</p></dd>

  <dt>Use current</dt>
  <dd><p>Pressing this button will set the <span class="option_name">Home button path</span> to the current open directory.</p></dd>

  </dl>

  <h2>Miscellaneous</h2>

  <dl class="dialog_desc">

  <dt>Store metadata and cache files in source image's directory</dt>
  <dd><p> When enabled, Geeqie attempts to store metadata such as keywords closer to the source image. The resulting location is the source image's folder, in a sub folder with the name "<em>.metadata"</em>. When the image source folder cannot be written, Geeqie falls back to saving the medata in "$HOME/.geeqie/metadata".</p></dd>

  <dt>Store keywords and comments as XMP tags in images files</dt>
  <dd><p>When enabled, Geeqie attempts to store keywords and comments as XMP tags <em>in</em> the image file itself. Obviously, this will modify the concerned files.</p></dd>

  <dt>Custom similarity threshold</dt>
  <dd><p>This setting is used by the compare method &ldquo;similarity (custom)&rdquo;, located in the Find Duplicates window.</p></dd>
  </dl>

  <h2>Image loading and caching</h2>

  <dl class="dialog_desc">

  <dt>Offscreen cache size</dt>
  <dd><p>Geeqie only renders the visible portion of an image. To reduce rendering the same area frequently when panning an image, some memory is used to retain the recently rendered image data. This value controls the maximum amount of memory to use.</p>
  <p class="note"><span class="note_label">Note:</span> This setting controls the amount of memory for <em>each</em> image window.</p>
  </dd>

  <dt>Decoded image cache size</dt>
  <dd><p>This is the cache size in megabytes used by Geeqie to store decoded images.</p></dd>

  <dt>Image read buffer size</dt>
  <dd><p>Number of bytes read by Geeqie in one pass, this is for fine tuning, do not modify if you don't know what it does.</p></dd>

  <dt>Image idle loop read count</dt>
  <dd><p>This is for fine tuning, do not modify if you don't know what it does.</p></dd>

  </dl>

  <h2>Color profiles</h2>

  <p>Here one can defined color profiles to use.</p>

  <dl class="dialog_desc">
  <dt>Type</dt>
  <dd><p>Either input color profile or screen color profile.</p></dd>
  <dt>Menu name</dt>
  <dd><p>Name of the menu entry corresponding to the color profile.</p></dd>
  <dt>File</dt>
  <dd><p>Path to the color profile file.</p></dd>
  </dl>

  <h2>Debugging</h2>

  <dl class="dialog_desc">
  <dt>Debug level</dt>
  <dd><p>This defines the verbosity of debug info sent to console and log window (0 disables the debug output).</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_properties.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_hidden.html">Next</a>
            </p>
          </th>
        </tr>

    </table>
  </div>

  <div class="footer">Geeqie User Manual</div>
  <div class="bottomspacer">&nbsp;</div>
</body>
</html>
author	zas_
date	Mon, 06 Apr 2009 22:13:54 +0000
parents	2562e0bc89a1
children