web/help/GuideOptionsWindow.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Window Options</title>
   6 <link rel="previous" href="GuideOptionsImage.html" title="Image Options">
   7 <link rel="next" href="GuideOptionsKeyboard.html" title="Keyboard Options">
   8 <link rel="top" href="GuideIndex.html" title="The Geeqie User Manual">
   9 <style type="text/css">
  10
  11 html { height: 100%; }
  12 body {
  13   margin: 0px; padding: 12px;
  14   background-color: #f9f9f6;
  15   min-height: 100%;
  16   direction: ltr;
  17 }
  18 div, p, pre, blockquote { margin: 0; padding: 0; }
  19 p img { vertical-align: middle; }
  20 sub { font-size: 0.83em; }
  21 sub sub { font-size: 1em; }
  22 sup { font-size: 0.83em; }
  23 sup sup { font-size: 1em; }
  24 table { border-collapse: collapse; }
  25 table.table-pgwide { width: 100%; }
  26 td { vertical-align: top; }
  27 td { padding: 0.2em 0.83em 0.2em 0.83em; }
  28 th { padding: 0 0.83em 0 0.83em; }
  29 tr.tr-shade {
  30   background-color: #f9f9f6;
  31 }
  32 td.td-colsep { border-right: solid 1px; }
  33 td.td-rowsep { border-bottom: solid 1px; }
  34 thead { border-top: solid 2px; border-bottom: solid 2px; }
  35 tfoot { border-top: solid 2px; border-bottom: solid 2px; }
  36 div.body {
  37   padding: 1em;
  38   max-width: 60em;
  39   background-color: #ffffff;
  40   border: solid 1px #e0e0df;
  41 }
  42 div.body-sidebar {
  43   margin-right: 13em;
  44 }
  45 div.division div.division { margin-top: 1.72em; }
  46 div.division div.division div.division { margin-top: 1.44em; }
  47 div.header {
  48   margin: 0;
  49   color: #3f3f3f;
  50   border-bottom: solid 1px #e0e0df;
  51 }
  52 h1, h2, h3, h4, h5, h6, h7 {
  53   margin: 0; padding: 0;
  54   color: #3f3f3f;
  55 }
  56 h1.title { font-size: 1.72em; }
  57 h2.title { font-size: 1.44em; }
  58 h3.title { font-size: 1.2em; }
  59 h4.title, h5.title, h6.title, h7.title { font-size: 1em; }
  60 .block { margin-top: 1em; }
  61 .block .block-first { margin-top: 0; }
  62 .block-indent {
  63   margin-left left: 1.72em;
  64   margin-: 1em;
  65 }
  66 .block-indent .block-indent { margin-left: 0em; margin-right: 0em; }
  67 td .block-indent  { margin-left: 0em; margin-right: 0em; }
  68 dd .block-indent  { margin-left: 0em; margin-right: 0em; }
  69 .block-verbatim { white-space: pre; }
  70 div.title {
  71   margin-bottom: 0.2em;
  72   font-weight: bold;
  73   color: #3f3f3f;
  74 }
  75 div.title-formal { padding-left: 0.2em; padding-right: 0.2em; }
  76 div.title-formal .label { font-weight: normal; }
  77 a {
  78   color: #1f609f;
  79   text-decoration: none;
  80 }
  81 a:hover { text-decoration: underline; }
  82 a:visited { color: #9f1f6f; }
  83 ul, ol, dl { margin: 0; padding: 0; }
  84 li {
  85   margin-top: 1em;
  86   margin-left: 2.4em;
  87   padding: 0;
  88 }
  89 li.li-first { margin-top: 0; }
  90 dt { margin: 1em 0 0 0; }
  91 dt.dt-first { margin: 0; }
  92 dd {
  93   margin-left: 1.72em;
  94   margin-top: 0.5em;
  95 }
  96 dl.dl-compact dt { margin-top: 0; }
  97 dl.dl-compact dd { margin-top: 0; margin-bottom: 0; }
  98
  99
 100 ul.linktrail {
 101   display: block;
 102   margin: 0.2em 0 0 0;
 103   text-align: right;
 104 }
 105 li.linktrail { display: inline; margin: 0; padding: 0; }
 106
 107 li.linktrail::before {
 108   content: '  /  ';
 109   color: #3f3f3f;
 110 }
 111
 112 li.linktrail-first::before, li.linktrail-only::before { content: ''; }
 113
 114
 115 div.navbar {
 116   padding: 0.5em 1em 0.5em 1em;
 117   max-width: 60em;
 118   background-color: #ffffff;
 119   border: solid 1px #e0e0df;
 120 }
 121 div.navbar-top { margin-bottom: 1em; }
 122 div.navbar-bottom { margin-top: 1em; clear: both; }
 123 div.navbar img { border: 0; vertical-align: -0.4em; }
 124 table.navbar { width: 100%; margin: 0; border: none; }
 125 table.navbar td { padding: 0; border: none; }
 126 td.navbar-next {
 127   text-align: right;
 128 }
 129 a.navbar-prev::before {
 130
 131   content: '◀  ';
 132   color: #3f3f3f;
 133 }
 134 a.navbar-next::after {
 135
 136   content: '  ▶';
 137   color: #3f3f3f;
 138 }
 139
 140
 141 div.sidebar {
 142   float: right;
 143   padding: 0; margin: 0; width: 12em;
 144 }
 145 div.sidenav {
 146   padding: 0.5em 1em 0 1em;
 147   background-color: #ffffff;
 148   border: solid 1px #e0e0df;
 149 }
 150 div.sidenav div.autotoc {
 151   background-color: #ffffff;
 152   border: none; padding: 0; margin: 0;
 153 }
 154 div.sidenav div.autotoc div.autotoc { margin-top: 0.5em; }
 155 div.sidenav div.autotoc li { margin-bottom: 0.5em; }
 156 div.sidenav div.autotoc div.autotoc div.autotoc {
 157   margin-left: 1em;
 158   margin-top: 0;
 159 }
 160 div.sidenav div.autotoc div.autotoc div.autotoc li { margin-bottom: 0; }
 161
 162
 163 div.autotoc {
 164
 165   display: table;
 166   margin-top: 1em;
 167   margin-left: 1.72em;
 168   padding: 0.5em 1em 0.5em 1em;
 169   background-color: #f0f9ff;
 170   border: solid 1px #c0c9ff;
 171 }
 172 div.autotoc ul { margin: 0; padding: 0; }
 173 div.autotoc li { list-style-type: none; margin: 0; }
 174 div.autotoc div.autotoc-title { margin-bottom: 0.5em; }
 175 div.autotoc div.autotoc { border: none; padding: 0; margin-top: 0; margin-bottom: 0.5em; }
 176 div.autotoc div.autotoc div.autotoc { margin-bottom: 0; }
 177
 178
 179 span.bibliolabel {
 180   color: #3f3f3f;
 181 }
 182
 183
 184 div.admonition {
 185   padding: 0.5em 6px 0.5em 6px;
 186   border: solid 1px #e0e0df;
 187   background-color: #fffff0;
 188 }
 189 div.caution-inner, div.important-inner, div.note-inner, div.tip-inner, div.warning-inner {
 190   padding-left: 60px;
 191   background-position: left top;
 192   background-repeat: no-repeat;
 193   min-height: 48px;
 194 }
 195 div.caution-inner { background-image: url("admon-caution.png"); }
 196 div.important-inner { background-image: url("admon-important.png"); }
 197 div.note-inner { background-image: url("admon-note.png"); }
 198 div.note-bug div.note-inner { background-image: url("admon-bug.png"); }
 199 div.tip-inner { background-image: url("admon-tip.png"); }
 200 div.warning-inner { background-image: url("admon-warning.png"); }
 201 div.blockquote {
 202
 203   background-image: url('watermark-blockquote-201C.png');
 204   background-repeat: no-repeat;
 205   background-position: top left;
 206   padding: 0.5em;
 207   padding-left: 4em;
 208 }
 209 div.attribution {
 210   margin-top: 0.5em;
 211   color: #3f3f3f;
 212 }
 213 div.attribution::before {
 214
 215   content: '― ';
 216 }
 217 div.epigraph {
 218   text-align: right;
 219   margin-left: 20%;
 220   margin-right: 0;
 221   color: #3f3f3f;
 222 }
 223 div.figure, div.informalfigure {
 224
 225   display: table;
 226   padding: 0.5em;
 227   background-color: #f9f9f6;
 228   border: solid 1px #e0e0df;
 229 }
 230 div.figure-inner, div.informalfigure-inner {
 231   padding: 0.5em;
 232   background-color: #ffffff;
 233   border: solid 1px #e0e0df;
 234 }
 235 div.caption { margin-top: 0.5em; }
 236 div.programlisting {
 237   padding: 0.5em;
 238
 239   background-color: #f9f9f6;
 240   border: solid 1px #e0e0df;
 241 }
 242 div.screen {
 243   padding: 0.5em;
 244
 245   background-color: #f9f9f6;
 246   border: solid 1px #e0e0df;
 247 }
 248 div.screen .prompt {
 249   color: #3f3f3f;
 250 }
 251 div.screen .userinput {
 252   font-weight: bold;
 253   color: #3f3f3f;
 254 }
 255 div.programlisting .userinput {
 256   font-weight: bold;
 257   color: #3f3f3f;
 258 }
 259 pre.linenumbering {
 260   color: #3f3f3f;
 261   margin: 0;
 262   padding-right: 1em;
 263   float: left;
 264   text-align: right;
 265 }
 266
 267
 268
 269 dl.index dt { margin-top: 0; }
 270 dl.index dd { margin-top: 0; margin-bottom: 0; }
 271 dl.indexdiv dt { margin-top: 0; }
 272 dl.indexdiv dd { margin-top: 0; margin-bottom: 0; }
 273 dl.setindex dt { margin-top: 0; }
 274 dl.setindex dd { margin-top: 0; margin-bottom: 0; }
 275 div.list div.title-formal span.title {
 276   border-bottom: solid 1px #e0e0df;
 277 }
 278 div.simplelist {
 279   margin-left: 1.72em;
 280 }
 281 div.simplelist table { margin-left: 0; border: none; }
 282 div.simplelist td {
 283   padding: 0.5em;
 284   border-left: solid 1px #e0e0df;
 285 }
 286 div.simplelist td.td-first {
 287   padding-left: 0;
 288   border-left: 0;
 289 }
 290 div.synopsis {
 291   padding: 0.5em;
 292
 293   background-color: #f9f9f6;
 294   border-top: solid 2px #c0c9ff;
 295   border-bottom: solid 2px #c0c9ff;
 296 }
 297 div.synopsis div.synopsis {
 298   padding: 0;
 299   border: none;
 300 }
 301 div.synopsis div.block { margin-top: 0.2em; }
 302 div.synopsis div.block-first { margin-top: 0; }
 303 div.cmdsynopsis { font-family: monospace; }
 304
 305 span.accel { text-decoration: underline; }
 306 span.acronym { font-family: sans-serif; }
 307 span.application { font-style: italic; }
 308 span.classname, span.exceptionname, span.interfacename { font-family: monospace; }
 309 span.code {
 310   font-family: monospace;
 311   border: solid 1px #e0e0df;
 312   padding-left: 0.2em;
 313   padding-right: 0.2em;
 314 }
 315 pre span.code { border: none; padding: 0; }
 316 span.command {
 317   font-family: monospace;
 318   border: solid 1px #e0e0df;
 319   padding-left: 0.2em;
 320   padding-right: 0.2em;
 321 }
 322 pre span.command { border: none; padding: 0; }
 323 span.computeroutput { font-family: monospace; }
 324
 325 span.constant { font-family: monospace; }
 326 span.database { font-family: monospace; }
 327 span.email { font-family: monospace; }
 328 span.emphasis { font-style: italic; }
 329 span.emphasis-bold { font-style: normal; font-weight: bold; }
 330 span.envar { font-family: monospace; }
 331
 332 span.filename { font-family: monospace; }
 333 span.firstterm { font-style: italic; }
 334 span.foreignphrase { font-style: italic; }
 335 span.function { font-family: monospace; }
 336
 337 dt.glossterm span.glossterm { font-style: normal; }
 338
 339
 340 span.glossterm { font-style: italic; }
 341
 342 span.guibutton, span.guilabel, span.guimenu, span.guimenuitem, span.guisubmenu, span.interface {
 343   font-weight: bold;
 344   color: #3f3f3f;
 345 }
 346 span.keycap {
 347   font-weight: bold;
 348   color: #3f3f3f;
 349 }
 350 span.lineannotation { font-style: italic; }
 351 span.literal { font-family: monospace; }
 352 span.markup  { font-family: monospace; }
 353 span.medialabel { font-style: italic; }
 354 span.methodname { font-family: monospace; }
 355 span.ooclass, span.ooexception, span.oointerface { font-family: monospace; }
 356 span.option { font-family: monospace; }
 357 span.parameter { font-family: monospace; }
 358 span.paramdef span.parameter { font-style: italic; }
 359 span.prompt { font-family: monospace; }
 360 span.property { font-family: monospace; }
 361 span.replaceable  { font-style: italic; }
 362 span.returnvalue { font-family: monospace; }
 363 span.sgmltag { font-family: monospace; }
 364 span.structfield, span.structname { font-family: monospace; }
 365 span.symbol { font-family: monospace; }
 366 span.systemitem { font-family: monospace; }
 367 span.token { font-family: monospace; }
 368 span.type { font-family: monospace; }
 369 span.uri { font-family: monospace; }
 370 span.userinput { font-family: monospace; }
 371 span.varname { font-family: monospace; }
 372 span.wordasword { font-style: italic; }
 373
 374
 375
 376 div.footnotes { font-style: italic; font-size: 0.8em; }
 377 div.footnote { margin-top: 1.44em; }
 378 span.footnote-number { display: inline; padding-right: 0.83em; }
 379 span.footnote-number + p { display: inline; }
 380 a.footnote { text-decoration: none; font-size: 0.8em; }
 381 a.footnote-ref { text-decoration: none; }
 382
 383 span.co {
 384   margin-left: 0.2em; margin-right: 0.2em;
 385   padding-left: 0.4em; padding-right: 0.4em;
 386   border: solid 1px #000000;
 387   -moz-border-radius: 8px;
 388   background-color: #000000;
 389   color: #FFFFFF;
 390   font-size: 8px;
 391 }
 392 span.co:hover {
 393   border-color: #333333;
 394   background-color: #333333;
 395   color: #FFFFFF;
 396 }
 397 span.co a { text-decoration: none; }
 398 span.co a:hover { text-decoration: none; }
 399
 400 dt.question { margin-left: 0em; }
 401 dt.question div.label { float: left; }
 402 dd + dt.question { margin-top: 1em; }
 403 dd.answer {
 404   margin-top: 1em;
 405   margin-left: 2em;
 406   margin-right: 1em;
 407 }
 408 dd.answer div.label { float: left; }
 409 </style>
 410 </head>
 411 <body>
 412 <div class="navbar navbar-top"><table class="navbar"><tr>
 413 <td class="navbar-prev"><a class="navbar-prev" href="GuideOptionsImage.html" title="Image Options">Image Options</a></td>
 414 <td class="navbar-next"><a class="navbar-next" href="GuideOptionsKeyboard.html" title="Keyboard Options">Keyboard Options</a></td>
 415 </tr></table></div>
 416 <div class="sidebar"><div class="sidenav"><div class="autotoc"><ul>
 417 <li><a href="GuideIndex-info.html" title="About This Document">About This Document</a></li>
 418 <li>
 419 <a class="xref" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a><div class="autotoc"><ul>
 420 <li><a class="xref" href="GuideIntroduction.html" title="Introduction">Introduction</a></li>
 421 <li><a class="xref" href="GuideMainWindow.html" title="Main Window">Main Window</a></li>
 422 <li><a class="xref" href="GuideSidebars.html" title="Sidebars">Sidebars</a></li>
 423 <li><a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
 424 <li><a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a></li>
 425 <li><a class="xref" href="GuideImageManagementPlugins.html" title="Plugins">Plugins</a></li>
 426 <li><a class="xref" href="GuideImageManagement.html" title="File Management">File Management</a></li>
 427 <li><a class="xref" href="GuideColorManagement.html" title="Color Management">Color Management</a></li>
 428 <li><a class="xref" href="GuideImagePresentation.html" title="Image Presentation">Image Presentation</a></li>
 429 <li><a class="xref" href="GuidePrinting.html" title="Printing">Printing</a></li>
 430 <li>
 431 <a class="xref" href="GuideOptionsMain.html" title="Preferences">Preferences</a><div class="autotoc"><ul>
 432 <li><a class="xref" href="GuideOptionsGeneral.html" title="General Options">General Options</a></li>
 433 <li><a class="xref" href="GuideOptionsImage.html" title="Image Options">Image Options</a></li>
 434 <li>Window Options</li>
 435 <li><a class="xref" href="GuideOptionsKeyboard.html" title="Keyboard Options">Keyboard Options</a></li>
 436 <li><a class="xref" href="GuideOptionsFiltering.html" title="Files Options">Files Options</a></li>
 437 <li><a class="xref" href="GuideOptionsMetadata.html" title="Metadata">Metadata</a></li>
 438 <li><a class="xref" href="GuideOptionsColor.html" title="Color management options">Color management options</a></li>
 439 <li><a class="xref" href="GuideOptionsStereo.html" title="Stereo image management">Stereo image management</a></li>
 440 <li><a class="xref" href="GuideOptionsBehavior.html" title="Behavior Options">Behavior Options</a></li>
 441 <li><a class="xref" href="GuideOptionsToolbar.html" title="Toolbar">Toolbar</a></li>
 442 </ul></div>
 443 </li>
 444 <li><a class="xref" href="GuideOptionsAdditional.html" title="Additional Preferences">Additional Preferences</a></li>
 445 <li><a class="xref" href="GuideReference.html" title="Reference">Reference</a></li>
 446 <li><a class="xref" href="GuideFaq.html" title="Frequently Asked Questions">Frequently Asked Questions</a></li>
 447 <li><a class="xref" href="GuideLicence.html" title="Licence">Licence</a></li>
 448 <li><a class="xref" href="GuideCredits.html" title="Credits">Credits</a></li>
 449 <li><a class="xref" href="GuideGnuFdl.html" title="GNU Free Documentation License">GNU Free Documentation License</a></li>
 450 </ul></div>
 451 </li>
 452 </ul></div></div></div>
 453 <div class="body body-sidebar"><div class="division section">
 454 <a name="GuideOptionsWindow"></a><div class="header"><h1 class="section title"><span class="title">Window Options</span></h1></div>
 455 <ul class="linktrail">
 456 <li class="linktrail linktrail-first"><a class="linktrail" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a></li>
 457 <li class="linktrail linktrail-last"><a class="linktrail" href="GuideOptionsMain.html" title="Preferences">Preferences</a></li>
 458 </ul>
 459 <p class="para block block-first">This section describes the options presented under the Windows Tab of the preferences dialog.</p>
 460 <div class="autotoc"><ul>
 461 <li>
 462 <span class="label">11.3.1. </span><a class="xref" href="GuideOptionsWindow.html#State" title="State">State</a>
 463 </li>
 464 <li>
 465 <span class="label">11.3.2. </span><a class="xref" href="GuideOptionsWindow.html#Size" title="Size">Size</a>
 466 </li>
 467 <li>
 468 <span class="label">11.3.3. </span><a class="xref" href="GuideOptionsWindow.html#FullScreen" title="Full Screen">Full Screen</a>
 469 </li>
 470 <li>
 471 <span class="label">11.3.4. </span><a class="xref" href="GuideOptionsWindow.html#OverlayScreenDisplay" title="Overlay Screen Display">Overlay Screen Display</a>
 472 </li>
 473 </ul></div>
 474 <div class="division section">
 475 <a name="State"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.3.1. </span>State</span></h2></div>
 476 <div class="block list variablelist"><dl class="variablelist">
 477 <dt class="term dt-first">
 478           <span class="guilabel">Remember window positions</span>
 479         </dt>
 480 <dd>
 481           <p class="para block block-first">This will maintain windows size and position between Geeqie sessions.</p>
 482         </dd>
 483 </dl></div>
 484 <div class="block list variablelist"><dl class="variablelist">
 485 <dt class="term dt-first">
 486           <span class="guilabel">Use saved window positions also for new windows</span>
 487         </dt>
 488 <dd>
 489           <p class="para block block-first">
 490             A new window opened by menu
 491             <span class="menuchoice"><span class="guimenu">File</span> ▸ <span class="guimenuitem">New Window</span> <span class="shortcut">(
 492                 <span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">N</span></span>
 493               )</span></span>
 494             will use the saved window positions also.
 495           </p>
 496         </dd>
 497 </dl></div>
 498 <div class="block list variablelist"><dl class="variablelist">
 499 <dt class="term dt-first">
 500           <span class="guilabel">Remember tool state</span>
 501         </dt>
 502 <dd>
 503           <p class="para block block-first">
 504             Maintains the selection set by
 505             <span class="menuchoice"><span class="guimenu">View</span> ▸ <span class="guimenuitem">File and Folders</span> ▸ <span class="guimenuitem">Float File List</span> <span class="shortcut">(
 506                 <span class="keycombo"><span class="keycap">L</span></span>
 507               )</span></span>
 508           </p>
 509         </dd>
 510 </dl></div>
 511 </div>
 512 <div class="division section">
 513 <a name="Size"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.3.2. </span>Size</span></h2></div>
 514 <div class="block list variablelist"><dl class="variablelist">
 515 <dt class="term dt-first">
 516           <span class="guilabel">Fit window to image when tools are hidden/floating</span>
 517         </dt>
 518 <dd>
 519           <p class="para block block-first">The main window will be resized to accommodate each image's size and proportions when the image pane is the only one visible within the window.</p>
 520         </dd>
 521 </dl></div>
 522 <div class="block list variablelist"><dl class="variablelist">
 523 <dt class="term dt-first">
 524           <span class="guilabel">Limit size when auto-sizing window</span>
 525         </dt>
 526 <dd>
 527           <p class="para block block-first">This will restrict the maximum size a window can grow to automatically fit an image. The value represents the percentage of the desktop size in width and height.</p>
 528         </dd>
 529 </dl></div>
 530 </div>
 531 <div class="division section">
 532 <a name="FullScreen"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.3.3. </span>Full Screen</span></h2></div>
 533 <div class="block list variablelist"><dl class="variablelist">
 534 <dt class="term dt-first">
 535           <span class="guilabel">Location</span>
 536         </dt>
 537 <dd>
 538           <p class="para block block-first">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>
 539         </dd>
 540 </dl></div>
 541 <div class="block list variablelist"><dl class="variablelist">
 542 <dt class="term dt-first">
 543           <span class="guilabel">Smooth image flip</span>
 544         </dt>
 545 <dd>
 546           <p class="para block block-first">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>
 547         </dd>
 548 </dl></div>
 549 <div class="block list variablelist"><dl class="variablelist">
 550 <dt class="term dt-first">
 551           <span class="guilabel">Disable screen saver</span>
 552         </dt>
 553 <dd>
 554           <p class="para block block-first">
 555             This option will execute
 556             <span class="emphasis">xscreensaver-command --deactivate</span>
 557             once per minute to avoid the screen saver from activating when Geeqie is displayed full screen.
 558           </p>
 559         </dd>
 560 </dl></div>
 561 </div>
 562 <div class="division section">
 563 <a name="OverlayScreenDisplay"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.3.4. </span>Overlay Screen Display</span></h2></div>
 564 <p class="para block block-first">The contents of the Overlay Screen Display is defined by the Image Overlay Template. This template is easily customised to  display a wide range of data.</p>
 565 <p class="para block">
 566       The format of each entry is:
 567       <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">%tag[:max_length][:extra]%</pre></div>
 568     </p>
 569 <div class="table block block-indent"><table style="border: solid 1px;"><tbody>
 570 <tr>
 571 <td class="td-colsep td-rowsep">
 572               <span class="emphasis emphasis-bold">Tag</span>
 573             </td>
 574 <td class="td-rowsep">
 575               <span class="emphasis emphasis-bold">Replaced by</span>
 576             </td>
 577 </tr>
 578 <tr class="tr-shade">
 579 <td class="td-colsep td-rowsep">name</td>
 580 <td class="td-rowsep">Filename of the picture</td>
 581 </tr>
 582 <tr>
 583 <td class="td-colsep td-rowsep">collection</td>
 584 <td class="td-rowsep">Name of the collection</td>
 585 </tr>
 586 <tr class="tr-shade">
 587 <td class="td-colsep td-rowsep">number</td>
 588 <td class="td-rowsep">Current number of image in the list</td>
 589 </tr>
 590 <tr>
 591 <td class="td-colsep td-rowsep">total</td>
 592 <td class="td-rowsep">Total number of images</td>
 593 </tr>
 594 <tr class="tr-shade">
 595 <td class="td-colsep td-rowsep">date</td>
 596 <td class="td-rowsep">File date</td>
 597 </tr>
 598 <tr>
 599 <td class="td-colsep td-rowsep">size</td>
 600 <td class="td-rowsep">File size</td>
 601 </tr>
 602 <tr class="tr-shade">
 603 <td class="td-colsep td-rowsep">width</td>
 604 <td class="td-rowsep">Image width</td>
 605 </tr>
 606 <tr>
 607 <td class="td-colsep td-rowsep">height</td>
 608 <td class="td-rowsep">Image height</td>
 609 </tr>
 610 <tr class="tr-shade">
 611 <td class="td-colsep td-rowsep">res</td>
 612 <td class="td-rowsep">Image resolution</td>
 613 </tr>
 614 <tr>
 615 <td class="td-colsep td-rowsep">keywords</td>
 616 <td class="td-rowsep">Image keywords from metadata</td>
 617 </tr>
 618 <tr class="tr-shade">
 619 <td class="td-colsep td-rowsep">comment</td>
 620 <td class="td-rowsep">Image comment from XMP metadata</td>
 621 </tr>
 622 <tr>
 623 <td class="td-colsep td-rowsep">imagecomment</td>
 624 <td class="td-rowsep">JPEG image comment</td>
 625 </tr>
 626 <tr class="tr-shade">
 627 <td class="td-colsep td-rowsep">&lt;meta_tag&gt;</td>
 628 <td class="td-rowsep">The Exif, XMP, or IPTC tag from metadata</td>
 629 </tr>
 630 <tr>
 631 <td class="td-colsep td-rowsep">lua/&lt;lua_script&gt;/</td>
 632 <td class="td-rowsep">The output of a Lua script file</td>
 633 </tr>
 634 <tr class="tr-shade">
 635 <td class="td-colsep">lua//&lt;lua_command&gt;</td>
 636 <td>The output of a Lua command</td>
 637 </tr>
 638 </tbody></table></div>
 639 <p class="para block">
 640       As an aide, in addition to standard metadata tags, Geeqie provides a number of
 641       <a class="link" href="GuideSidebarsInfo.html#formatted_exif" title="">pre-formatted tags</a>
 642       .
 643     </p>
 644 <p class="para block">Examples of usage are:</p>
 645 <p class="para block">
 646       <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">        %keywords%
 647         %Exif.Photo.DateTimeOriginal%
 648         %lua/jpeg_comment.lua/:12%
 649         %lua//return(os.date())%
 650       </pre></div>
 651     </p>
 652 <p class="para block">
 653       Refer to
 654       <a class="link" href="GuideReferenceLua.html" title="Lua Extensions">Lua Extensions</a>
 655       for further information.
 656     </p>
 657 <p class="para block">
 658       The length of displayed data can be limited by using the
 659       <span class="emphasis">:max_length</span>
 660       parameter. The following example will truncate the displayed data to 20 characters and will add 3 dots at the end to denote the truncation.
 661       <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">%formatted.Camera:20%</pre></div>
 662     </p>
 663 <p class="para block">
 664       If two or more variables are connected with the
 665       <span class="code" dir="ltr">|</span>
 666       character, the variables are displayed with a separator. For example::
 667       <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%</pre></div>
 668       could show:
 669       <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">"1/20s - 400 - 80 mm"</pre></div>
 670       Or, if there is no ISO information in the Exif data:
 671       <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">"1/200 - 80 mm"</pre></div>
 672     </p>
 673 <p class="para block">If there is no data for a requested tag, the line is not displayed.</p>
 674 <p class="para block">
 675       The
 676       <span class="emphasis">:extra</span>
 677       parameter may be used to format the output by prepending and appending a text string to the displayed item.
 678     </p>
 679 <p class="para block">
 680       The special character
 681       <span class="code" dir="ltr">*</span>
 682       is used to mark the position of the Tag data item. If no
 683       <span class="code" dir="ltr">*</span>
 684       is present, the extra string is just appended to the standard data displayed. Any "\n" is replaced by a newline on display.
 685       <a class="link" href="GuideReferenceStandards.html" title="Standards">Pango mark up</a>
 686       is accepted in both left and right parts. If the data item is empty, nothing will be displayed.
 687     </p>
 688 <p class="para block">Examples:</p>
 689 <div class="table block block-indent"><table style="border: solid 1px;"><tbody>
 690 <tr>
 691 <td class="td-colsep td-rowsep">
 692               <span class="emphasis emphasis-bold">Template</span>
 693             </td>
 694 <td class="td-rowsep">
 695               <span class="emphasis emphasis-bold">Example display</span>
 696             </td>
 697 </tr>
 698 <tr class="tr-shade">
 699 <td class="td-colsep td-rowsep">
 700               %name:
 701               &lt;i&gt;*&lt;/i&gt;\n%
 702             </td>
 703 <td class="td-rowsep">
 704               <span class="emphasis">filename001.jpg</span>
 705             </td>
 706 </tr>
 707 <tr>
 708 <td class="td-colsep td-rowsep">%size:\n%</td>
 709 <td class="td-rowsep">123456</td>
 710 </tr>
 711 <tr class="tr-shade">
 712 <td class="td-colsep td-rowsep">%formatted.ISOSpeedRating:ISO *%</td>
 713 <td class="td-rowsep">ISO 100</td>
 714 </tr>
 715 <tr>
 716 <td class="td-colsep">
 717               %collection:Collection:
 718               &lt;b&gt;*&lt;/b&gt;
 719               \n%
 720             </td>
 721 <td>
 722               Collection:
 723               <span class="emphasis emphasis-bold">my_new_collection</span>
 724             </td>
 725 </tr>
 726 </tbody></table></div>
 727 <p class="para block"></p>
 728 <div class="block list variablelist"><dl class="variablelist">
 729 <dt class="term dt-first">
 730           <span class="guibutton">
 731             <span class="guiicon">
 732               <span class="inlinegraphic"><img src="preferences-desktop-font.png"></span>
 733             </span>
 734           </span>
 735           <span class="guilabel">Font</span>
 736           ,
 737           <span class="guibutton">
 738             <span class="guiicon">
 739               <span class="inlinegraphic"><img src="gtk-color-picker.png"></span>
 740             </span>
 741           </span>
 742           <span class="guilabel">Text</span>
 743           ,
 744           <span class="guibutton">
 745             <span class="guiicon">
 746               <span class="inlinegraphic"><img src="gtk-color-picker.png"></span>
 747             </span>
 748           </span>
 749           <span class="guilabel">Background</span>
 750         </dt>
 751 <dd>The font used for the Overlay Screen Display, as well as the font colour and background colour, may be set via these buttons. Colour transparency can also be set.</dd>
 752 </dl></div>
 753 <div class="block list variablelist"><dl class="variablelist">
 754 <dt class="term dt-first">
 755           <span class="guibutton">
 756             <span class="guiicon">
 757               <span class="inlinegraphic"><img src="help-contents.png"></span>
 758             </span>
 759           </span>
 760           <span class="guilabel">Help</span>
 761         </dt>
 762 <dd>
 763           <p class="para block block-first">Show syntax help</p>
 764         </dd>
 765 </dl></div>
 766 <div class="block list variablelist"><dl class="variablelist">
 767 <dt class="term dt-first">
 768           <span class="guilabel">Defaults</span>
 769         </dt>
 770 <dd>
 771           <p class="para block block-first">Restore default image overlay template</p>
 772         </dd>
 773 </dl></div>
 774 </div>
 775 </div></div>
 776 <div class="navbar navbar-bottom"><table class="navbar"><tr>
 777 <td class="navbar-prev"><a class="navbar-prev" href="GuideOptionsImage.html" title="Image Options">Image Options</a></td>
 778 <td class="navbar-next"><a class="navbar-next" href="GuideOptionsKeyboard.html" title="Keyboard Options">Keyboard Options</a></td>
 779 </tr></table></div>
 780 </body>
 781 </html>