doc/options_advanced.html

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   4
   5 <html xmlns="http://www.w3.org/1999/xhtml">
   6 <head>
   7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
   8
   9   <title>Advanced Options - Geeqie User Manual</title>
  10   <link rel="stylesheet" type="text/css" href="style.css" media="all" />
  11   <link rel="stylesheet" type="text/css" href="style_screen.css" media="screen" />
  12   <link rel="stylesheet" type="text/css" href="style_print.css" media="print" />
  13 </head>
  14
  15 <body lang="en-US" dir="ltr" xml:lang="en-US">
  16   <div class="navtop">
  17     <table width="100%" border="0" cellpadding="4" cellspacing="0">
  18       <col id="navtop_col1" width="33%"></col>
  19       <col id="navtop_col2" width="33%"></col>
  20       <col id="navtop_col3" width="33%"></col>
  21
  22         <tr>
  23           <th>
  24             <p class="previous"><a href="options_properties.html">Previous</a>
  25             </p>
  26           </th>
  27
  28           <th>
  29             <p class="navtop_title">Advanced &ndash; Options Explained</p>
  30           </th>
  31
  32           <th>
  33             <p class="next"><a href="options_hidden.html">Next</a>
  34             </p>
  35           </th>
  36         </tr>
  37     </table>
  38   </div>
  39
  40   <hr />
  41
  42   <h1>Advanced Options</h1>
  43
  44   <p>This section describes the options presented under the Advanced Tab of the preferences dialog.</p>
  45
  46   <h2>Full Screen</h2>
  47
  48   <dl class="dialog_desc">
  49   <dt>Location</dt>
  50   <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>
  51
  52   <dt>Stay above other windows</dt>
  53   <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>
  54
  55   <dt>Smooth image flip</dt>
  56   <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>
  57
  58   <dt>Disable screen saver</dt>
  59   <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>
  60
  61   </dl>
  62
  63   <h2>Overlay Screen Display</h2>
  64
  65   <dl class="dialog_desc">
  66   <dt>Always show image overlay at startup</dt>
  67   <dd><p>Enable this to have the image overlay info displayed by default</p></dd>
  68
  69   <dt>Image overlay template</dt>
  70   <dd><p>Overlay info is customizable through this template</p>
  71 <p>Overlay info format string syntax is: <code>%tag[:max_length][:extra]%</code></p>
  72
  73 <div class="overlay_tags">
  74 <table width="60%" border="1" cellpadding="2" cellspacing="0">
  75 <col id="overlay_tags_col1" width="30%"></col>
  76 <col id="overlay_tags_col2" width="70%"></col>
  77 <tr><th>Tag</th><th>Replaced by</th></tr>
  78 <tr><td>name</td><td>Filename of the picture</td></tr>
  79 <tr><td>collection</td><td>Name of the collection</td></tr>
  80 <tr><td>number</td><td>Current number of image in the list</td></tr>
  81 <tr><td>total</td><td>Total number of images</td></tr>
  82 <tr><td>date</td><td>File date</td></tr>
  83 <tr><td>size</td><td>File size</td></tr>
  84 <tr><td>width</td><td>Image width</td></tr>
  85 <tr><td>height</td><td>Image height</td></tr>
  86 <tr><td>res</td><td>Image resolution</td></tr>
  87 <tr><td>keywords</td><td>Image keywords from metadata</td></tr>
  88 <tr><td>comment</td><td>Image comment from metadata</td></tr>
  89 </table>
  90 </div>
  91
  92 <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>
  93
  94 <p>Pre-formatted exif data is also available:</p>
  95 <div class="overlay_exif">
  96 <table width="60%" border="1" cellpadding="2" cellspacing="0">
  97 <col id="overlay_exif_col1" width="30%"></col>
  98 <col id="overlay_exif_col2" width="70%"></col>
  99 <tr><th>Tag</th><th>Replaced by exif data</th></tr>
 100
 101 <tr><td>formatted.Camera</td><td>Camera and sofware name</td></tr>
 102 <tr><td>formatted.DateTime</td><td>Image Date</td></tr>
 103 <tr><td>formatted.ShutterSpeed</td><td>Shutter speed in seconds (ie. 1/60s)</td></tr>
 104 <tr><td>formatted.Aperture</td><td>Aperture (ie. f5.6)</td></tr>
 105 <tr><td>formatted.ExposureBias</td><td>Exposure bias (ie. +0.3)</td></tr>
 106 <tr><td>formatted.ISOSpeedRating</td><td>ISO sensitivity (ie. 100)</td></tr>
 107 <tr><td>formatted.FocalLength</td><td>Focal length</td></tr>
 108 <tr><td>formatted.FocalLength35mmFilm</td><td>Focal length 35mm</td></tr>
 109 <tr><td>formatted.SubjectDistance</td><td>Subject distance</td></tr>
 110 <tr><td>formatted.Flash</td><td>Flash</td></tr>
 111 <tr><td>formatted.Resolution</td><td>Resolution</td></tr>
 112 <tr><td>formatted.ColorProfile</td><td>Color profile</td></tr>
 113 </table>
 114 </div>
 115
 116 <p>
 117   You can limit the length of displayed data using :number notation:
 118   <code>%formatted.Camera:20%</code> will truncate the displayed data to 20 characters
 119   and will add 3 dots at the end to denote the truncation.</p>
 120
 121 <p>
 122   If two or more variables are connected with the |-sign, it prints available
 123   variables with a separator:<br />
 124   <code>%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%</code><br />
 125   could show:<br />
 126     "1/20s - 400 - 80 mm"<br />
 127   or<br />
 128     "1/200 - 80 mm" if there's no ISO information in the Exif data.<br />
 129 </p>
 130
 131 <p>
 132   If a line is empty, it is removed.
 133   This allows to add lines that totally disappear when no data is available.
 134 </p>
 135
 136 <p>
 137   Extra string uses special character '*' to mark the position of the data.
 138   If no '*' is present, then extra string is just appended to data.
 139   Any "\n" is replaced by a newline on display.
 140   Pango mark up is accepted in left and right parts.
 141   If data is empty, nothing will be displayed.
 142 </p>
 143
 144 <p>Examples:</p>
 145   <dl class="examples">
 146   <dt><code>%name:&lt;i&gt;*&lt;/i&gt;\n%</code></dt><dd>name is displayed in italics ended with a newline</dd>
 147   <dt><code>%size:\n%</code></dt><dd>size is displayed with a newline at end</dd>
 148   <dt><code>%formatted.ISOSpeedRating:ISO *%</code></dt><dd>ie. "ISO 100"</dd>
 149   <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>
 150   </dl>
 151
 152   </dd>
 153
 154   <dt>Help button</dt>
 155   <dd><p>Show syntax help</p></dd>
 156
 157   <dt>Defaults button</dt>
 158   <dd><p>Restore default image overlay template</p></dd>
 159
 160   </dl>
 161
 162
 163
 164   <h2>Delete</h2>
 165
 166   <dl class="dialog_desc">
 167   <dt>Confirm file delete</dt>
 168   <dd><p>Prompts for confirmation before deleting files.</p></dd>
 169
 170   <dt>Enable Delete key</dt>
 171   <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>
 172
 173   <dt>Safe Delete</dt>
 174   <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>
 175   <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 />
 176   This is used by the delete feature to distinguish which files to remove first when clearing space for new files.<br />
 177   The digit counter increments with each deleted file.</p></dd>
 178
 179   <dt>Folder</dt>
 180   <dd><p>The location of the folder used by the Safe Delete feature.</p></dd>
 181
 182   <dt>Maximum size</dt>
 183   <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>
 184
 185   <dt>Clear button</dt>
 186   <dd><p>Removes all files contained in the Safe Delete folder.</p></dd>
 187
 188   <dt>View button</dt>
 189   <dd><p>Changes the Geeqie main window to display the contents of the Safe Delete folder.</p></dd>
 190
 191   </dl>
 192
 193   <h2>Behavior</h2>
 194
 195   <dl class="dialog_desc">
 196   <dt>Rectangular selection in icon view</dt>
 197   <dd><p> Enable this to change the selection method used when selecting multiple items in an icon view.</p></dd>
 198
 199   <dt>Descend folders in tree view</dt>
 200   <dd>
 201   <p>This will allow Geeqie to read sub folder content to determine if it should display expander indicators in the folder tree view.</p>
 202   <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>
 203   </dd>
 204
 205   <dt>Show date in directories list view</dt>
 206   <dd><p>Enable this to display directory modification date along its name in the list view</p></dd>
 207
 208   <dt>In place renaming</dt>
 209   <dd><p>When renaming a single file, this will allow the rename entry to appear directly over the original filename.</p></dd>
 210
 211   <dt>Show "Copy path" menu item</dt>
 212   <dd><p>Enable this option to show a "Copy path" menu item in applicable menus.</p>
 213   <p>This allows to copy path to files or directories to the clipboard, names are enclosed with double quotes
 214   and separated by space.</p>
 215   </dd>
 216
 217   <dt>Open recent list maximum size</dt>
 218   <dd><p>This is the number of entries saved in the recent open file list.</p></dd>
 219
 220   <dt>Drag'n drop icon size</dt>
 221   <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>
 222
 223   </dl>
 224
 225   <h2>Navigation</h2>
 226
 227   <dl class="dialog_desc">
 228   <dt>Progressive keyboard scrolling</dt>
 229   <dd><p>This will cause image panning speed to gradually accelerate when holding down the keyboard arrows.</p></dd>
 230
 231   <dt>Mouse wheel scrolls image</dt>
 232   <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>
 233
 234   <dt>Home button path</dt>
 235   <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>
 236
 237   <dt>Use current</dt>
 238   <dd><p>Pressing this button will set the <span class="option_name">Home button path</span> to the current open directory.</p></dd>
 239
 240   </dl>
 241
 242   <h2>Miscellaneous</h2>
 243
 244   <dl class="dialog_desc">
 245
 246   <dt>Store metadata and cache files in source image's directory</dt>
 247   <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>
 248
 249   <dt>Store keywords and comments as XMP tags in images files</dt>
 250   <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>
 251
 252   <dt>Custom similarity threshold</dt>
 253   <dd><p>This setting is used by the compare method &ldquo;similarity (custom)&rdquo;, located in the Find Duplicates window.</p></dd>
 254   </dl>
 255
 256   <h2>Image loading and caching</h2>
 257
 258   <dl class="dialog_desc">
 259
 260   <dt>Offscreen cache size</dt>
 261   <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>
 262   <p class="note"><span class="note_label">Note:</span> This setting controls the amount of memory for <em>each</em> image window.</p>
 263   </dd>
 264
 265   <dt>Decoded image cache size</dt>
 266   <dd><p>This is the cache size in megabytes used by Geeqie to store decoded images.</p></dd>
 267
 268   <dt>Image read buffer size</dt>
 269   <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>
 270
 271   <dt>Image idle loop read count</dt>
 272   <dd><p>This is for fine tuning, do not modify if you don't know what it does.</p></dd>
 273
 274   </dl>
 275
 276   <h2>Color profiles</h2>
 277
 278   <p>Here one can defined color profiles to use.</p>
 279
 280   <dl class="dialog_desc">
 281   <dt>Type</dt>
 282   <dd><p>Either input color profile or screen color profile.</p></dd>
 283   <dt>Menu name</dt>
 284   <dd><p>Name of the menu entry corresponding to the color profile.</p></dd>
 285   <dt>File</dt>
 286   <dd><p>Path to the color profile file.</p></dd>
 287   </dl>
 288
 289   <h2>Debugging</h2>
 290
 291   <dl class="dialog_desc">
 292   <dt>Debug level</dt>
 293   <dd><p>This defines the verbosity of debug info sent to console and log window (0 disables the debug output).</p></dd>
 294   </dl>
 295
 296
 297   <hr id="bottomseparator" />
 298
 299   <div class="navbottom">
 300     <table width="100%" border="0" cellpadding="4" cellspacing="0">
 301       <col id="navbottom_col1" width="33%"></col>
 302       <col id="navbottom_col2" width="33%"></col>
 303       <col id="navbottom_col3" width="33%"></col>
 304
 305         <tr>
 306           <th>
 307             <p class="previous"><a href="options_properties.html">Previous</a>
 308             </p>
 309           </th>
 310
 311           <th>
 312             <p class="navbottom_title"><a href="index.html">Contents</a>
 313             </p>
 314           </th>
 315
 316           <th>
 317             <p class="next"><a href="options_hidden.html">Next</a>
 318             </p>
 319           </th>
 320         </tr>
 321
 322     </table>
 323   </div>
 324
 325   <div class="footer">Geeqie User Manual</div>
 326   <div class="bottomspacer">&nbsp;</div>
 327 </body>
 328 </html>