web/help/GuideOptionsOSD.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>OverlayScreen Display</title>
   6 <link rel="previous" href="GuideOptionsImage.html" title="Image Options">
   7 <link rel="next" href="GuideOptionsWindow.html" title="Window 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="GuideOptionsWindow.html" title="Window Options">Window 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>OverlayScreen Display</li>
 435 <li><a class="xref" href="GuideOptionsWindow.html" title="Window Options">Window Options</a></li>
 436 <li><a class="xref" href="GuideOptionsKeyboard.html" title="Keyboard Options">Keyboard Options</a></li>
 437 <li><a class="xref" href="GuideOptionsFiltering.html" title="Files Options">Files Options</a></li>
 438 <li><a class="xref" href="GuideOptionsMetadata.html" title="Metadata">Metadata</a></li>
 439 <li><a class="xref" href="GuideOptionsKeywords.html" title="Keywords">Keywords</a></li>
 440 <li><a class="xref" href="GuideOptionsColor.html" title="Color management options">Color management options</a></li>
 441 <li><a class="xref" href="GuideOptionsStereo.html" title="Stereo image management">Stereo image management</a></li>
 442 <li><a class="xref" href="GuideOptionsBehavior.html" title="Behavior Options">Behavior Options</a></li>
 443 <li><a class="xref" href="GuideOptionsToolbar.html" title="Toolbar">Toolbar</a></li>
 444 </ul></div>
 445 </li>
 446 <li><a class="xref" href="GuideOptionsAdditional.html" title="Additional Preferences">Additional Preferences</a></li>
 447 <li><a class="xref" href="GuideReference.html" title="Reference">Reference</a></li>
 448 <li><a class="xref" href="GuideFaq.html" title="Frequently Asked Questions">Frequently Asked Questions</a></li>
 449 <li><a class="xref" href="GuideLicence.html" title="Licence">Licence</a></li>
 450 <li><a class="xref" href="GuideCredits.html" title="Credits">Credits</a></li>
 451 <li><a class="xref" href="GuideGnuFdl.html" title="GNU Free Documentation License">GNU Free Documentation License</a></li>
 452 </ul></div>
 453 </li>
 454 </ul></div></div></div>
 455 <div class="body body-sidebar"><div class="division section">
 456 <a name="GuideOptionsOSD"></a><div class="header"><h1 class="section title"><span class="title">OverlayScreen Display</span></h1></div>
 457 <ul class="linktrail">
 458 <li class="linktrail linktrail-first"><a class="linktrail" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a></li>
 459 <li class="linktrail linktrail-last"><a class="linktrail" href="GuideOptionsMain.html" title="Preferences">Preferences</a></li>
 460 </ul>
 461 <p class="para block block-first">This section describes the options presented under the OSD Tab of the preferences dialog.</p>
 462 <div class="autotoc"><ul><li>
 463 <span class="label">11.3.1. </span><a class="xref" href="GuideOptionsOSD.html#OverlayScreenDisplay" title="Overlay Screen Display">Overlay Screen Display</a>
 464 </li></ul></div>
 465 <div class="division section">
 466 <a name="OverlayScreenDisplay"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.3.1. </span>Overlay Screen Display</span></h2></div>
 467 <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>
 468 <p class="para block">
 469       The format of each entry is:
 470       <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">%tag[:max_length][:extra]%</pre></div>
 471     </p>
 472 <div class="table block block-indent"><table style="border: solid 1px;"><tbody>
 473 <tr>
 474 <td class="td-colsep td-rowsep">
 475               <span class="emphasis emphasis-bold">Tag</span>
 476             </td>
 477 <td class="td-rowsep">
 478               <span class="emphasis emphasis-bold">Replaced by</span>
 479             </td>
 480 </tr>
 481 <tr class="tr-shade">
 482 <td class="td-colsep td-rowsep">name</td>
 483 <td class="td-rowsep">Filename of the picture</td>
 484 </tr>
 485 <tr>
 486 <td class="td-colsep td-rowsep">collection</td>
 487 <td class="td-rowsep">Name of the collection</td>
 488 </tr>
 489 <tr class="tr-shade">
 490 <td class="td-colsep td-rowsep">number</td>
 491 <td class="td-rowsep">Current number of image in the list</td>
 492 </tr>
 493 <tr>
 494 <td class="td-colsep td-rowsep">total</td>
 495 <td class="td-rowsep">Total number of images</td>
 496 </tr>
 497 <tr class="tr-shade">
 498 <td class="td-colsep td-rowsep">date</td>
 499 <td class="td-rowsep">File date</td>
 500 </tr>
 501 <tr>
 502 <td class="td-colsep td-rowsep">size</td>
 503 <td class="td-rowsep">File size</td>
 504 </tr>
 505 <tr class="tr-shade">
 506 <td class="td-colsep td-rowsep">width</td>
 507 <td class="td-rowsep">Image width</td>
 508 </tr>
 509 <tr>
 510 <td class="td-colsep td-rowsep">height</td>
 511 <td class="td-rowsep">Image height</td>
 512 </tr>
 513 <tr class="tr-shade">
 514 <td class="td-colsep td-rowsep">res</td>
 515 <td class="td-rowsep">Image resolution</td>
 516 </tr>
 517 <tr>
 518 <td class="td-colsep td-rowsep">keywords</td>
 519 <td class="td-rowsep">Image keywords from metadata</td>
 520 </tr>
 521 <tr class="tr-shade">
 522 <td class="td-colsep td-rowsep">comment</td>
 523 <td class="td-rowsep">Image comment from XMP metadata</td>
 524 </tr>
 525 <tr>
 526 <td class="td-colsep td-rowsep">imagecomment</td>
 527 <td class="td-rowsep">JPEG image comment</td>
 528 </tr>
 529 <tr class="tr-shade">
 530 <td class="td-colsep td-rowsep">rating</td>
 531 <td class="td-rowsep">Image rating</td>
 532 </tr>
 533 <tr>
 534 <td class="td-colsep td-rowsep">&lt;meta_tag&gt;</td>
 535 <td class="td-rowsep">The Exif, XMP, or IPTC tag from metadata</td>
 536 </tr>
 537 <tr class="tr-shade">
 538 <td class="td-colsep td-rowsep">lua/&lt;lua_script&gt;/</td>
 539 <td class="td-rowsep">The output of a Lua script file</td>
 540 </tr>
 541 <tr>
 542 <td class="td-colsep">lua//&lt;lua_command&gt;</td>
 543 <td>The output of a Lua command</td>
 544 </tr>
 545 </tbody></table></div>
 546 <p class="para block">
 547       As an aide, in addition to standard metadata tags, Geeqie provides a number of
 548       <a class="link" href="GuideSidebarsInfo.html#formatted_exif" title="">pre-formatted tags</a>
 549       .
 550     </p>
 551 <p class="para block">Examples of usage are:</p>
 552 <p class="para block">
 553       <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">        %keywords%
 554         %Exif.Photo.DateTimeOriginal%
 555         %lua/jpeg_comment.lua/:12%
 556         %lua//return(os.date())%
 557       </pre></div>
 558     </p>
 559 <p class="para block">
 560       Refer to
 561       <a class="link" href="GuideReferenceLua.html" title="Lua Extensions">Lua Extensions</a>
 562       for further information.
 563     </p>
 564 <p class="para block">
 565       The length of displayed data can be limited by using the
 566       <span class="emphasis">:max_length</span>
 567       parameter. The following example will truncate the displayed data to 20 characters and will add 3 dots at the end to denote the truncation.
 568       <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">%formatted.Camera:20%</pre></div>
 569     </p>
 570 <p class="para block">
 571       If two or more variables are connected with the
 572       <span class="code" dir="ltr">|</span>
 573       character, the variables are displayed with a separator. For example::
 574       <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%</pre></div>
 575       could show:
 576       <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">"1/20s - 400 - 80 mm"</pre></div>
 577       Or, if there is no ISO information in the Exif data:
 578       <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">"1/200 - 80 mm"</pre></div>
 579     </p>
 580 <p class="para block">If there is no data for a requested tag, the line is not displayed.</p>
 581 <p class="para block">
 582       The
 583       <span class="emphasis">:extra</span>
 584       parameter may be used to format the output by prepending and appending a text string to the displayed item.
 585     </p>
 586 <p class="para block">
 587       The special character
 588       <span class="code" dir="ltr">*</span>
 589       is used to mark the position of the Tag data item. If no
 590       <span class="code" dir="ltr">*</span>
 591       is present, the extra string is just appended to the standard data displayed. Any "\n" is replaced by a newline on display.
 592       <a class="link" href="GuideReferenceStandards.html" title="Standards">Pango mark up</a>
 593       is accepted in both left and right parts. If the data item is empty, nothing will be displayed.
 594     </p>
 595 <p class="para block">Examples:</p>
 596 <div class="table block block-indent"><table style="border: solid 1px;"><tbody>
 597 <tr>
 598 <td class="td-colsep td-rowsep">
 599               <span class="emphasis emphasis-bold">Template</span>
 600             </td>
 601 <td class="td-rowsep">
 602               <span class="emphasis emphasis-bold">Example display</span>
 603             </td>
 604 </tr>
 605 <tr class="tr-shade">
 606 <td class="td-colsep td-rowsep">
 607               %name:
 608               &lt;i&gt;*&lt;/i&gt;\n%
 609             </td>
 610 <td class="td-rowsep">
 611               <span class="emphasis">filename001.jpg</span>
 612             </td>
 613 </tr>
 614 <tr>
 615 <td class="td-colsep td-rowsep">%size:\n%</td>
 616 <td class="td-rowsep">123456</td>
 617 </tr>
 618 <tr class="tr-shade">
 619 <td class="td-colsep td-rowsep">%formatted.ISOSpeedRating:ISO *%</td>
 620 <td class="td-rowsep">ISO 100</td>
 621 </tr>
 622 <tr>
 623 <td class="td-colsep">
 624               %collection:Collection:
 625               &lt;b&gt;*&lt;/b&gt;
 626               \n%
 627             </td>
 628 <td>
 629               Collection:
 630               <span class="emphasis emphasis-bold">my_new_collection</span>
 631             </td>
 632 </tr>
 633 </tbody></table></div>
 634 <p class="para block"></p>
 635 <div class="block list variablelist"><dl class="variablelist">
 636 <dt class="term dt-first">
 637           <span class="guibutton">
 638             <span class="guiicon">
 639               <span class="inlinegraphic"><img src="preferences-desktop-font.png"></span>
 640             </span>
 641           </span>
 642           <span class="guilabel">Font</span>
 643           ,
 644           <span class="guibutton">
 645             <span class="guiicon">
 646               <span class="inlinegraphic"><img src="gtk-color-picker.png"></span>
 647             </span>
 648           </span>
 649           <span class="guilabel">Text</span>
 650           ,
 651           <span class="guibutton">
 652             <span class="guiicon">
 653               <span class="inlinegraphic"><img src="gtk-color-picker.png"></span>
 654             </span>
 655           </span>
 656           <span class="guilabel">Background</span>
 657         </dt>
 658 <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>
 659 </dl></div>
 660 <div class="block list variablelist"><dl class="variablelist">
 661 <dt class="term dt-first">
 662           <span class="guibutton">
 663             <span class="guiicon">
 664               <span class="inlinegraphic"><img src="help-contents.png"></span>
 665             </span>
 666           </span>
 667           <span class="guilabel">Help</span>
 668         </dt>
 669 <dd>
 670           <p class="para block block-first">Show syntax help</p>
 671         </dd>
 672 </dl></div>
 673 <div class="block list variablelist"><dl class="variablelist">
 674 <dt class="term dt-first">
 675           <span class="guilabel">Defaults</span>
 676         </dt>
 677 <dd>
 678           <p class="para block block-first">Restore default image overlay template</p>
 679         </dd>
 680 </dl></div>
 681 </div>
 682 </div></div>
 683 <div class="navbar navbar-bottom"><table class="navbar"><tr>
 684 <td class="navbar-prev"><a class="navbar-prev" href="GuideOptionsImage.html" title="Image Options">Image Options</a></td>
 685 <td class="navbar-next"><a class="navbar-next" href="GuideOptionsWindow.html" title="Window Options">Window Options</a></td>
 686 </tr></table></div>
 687 </body>
 688 </html>