1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
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">
11 html { height: 100%; }
13 margin: 0px; padding: 12px;
14 background-color: #f9f9f6;
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; }
30 background-color: #f9f9f6;
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; }
39 background-color: #ffffff;
40 border: solid 1px #e0e0df;
45 div.division div.division { margin-top: 1.72em; }
46 div.division div.division div.division { margin-top: 1.44em; }
50 border-bottom: solid 1px #e0e0df;
52 h1, h2, h3, h4, h5, h6, h7 {
53 margin: 0; padding: 0;
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; }
63 margin-left left: 1.72em;
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; }
75 div.title-formal { padding-left: 0.2em; padding-right: 0.2em; }
76 div.title-formal .label { font-weight: normal; }
79 text-decoration: none;
81 a:hover { text-decoration: underline; }
82 a:visited { color: #9f1f6f; }
83 ul, ol, dl { margin: 0; padding: 0; }
89 li.li-first { margin-top: 0; }
90 dt { margin: 1em 0 0 0; }
91 dt.dt-first { margin: 0; }
96 dl.dl-compact dt { margin-top: 0; }
97 dl.dl-compact dd { margin-top: 0; margin-bottom: 0; }
105 li.linktrail { display: inline; margin: 0; padding: 0; }
107 li.linktrail::before {
112 li.linktrail-first::before, li.linktrail-only::before { content: ''; }
116 padding: 0.5em 1em 0.5em 1em;
118 background-color: #ffffff;
119 border: solid 1px #e0e0df;
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; }
129 a.navbar-prev::before {
134 a.navbar-next::after {
143 padding: 0; margin: 0; width: 12em;
146 padding: 0.5em 1em 0 1em;
147 background-color: #ffffff;
148 border: solid 1px #e0e0df;
150 div.sidenav div.autotoc {
151 background-color: #ffffff;
152 border: none; padding: 0; margin: 0;
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 {
160 div.sidenav div.autotoc div.autotoc div.autotoc li { margin-bottom: 0; }
168 padding: 0.5em 1em 0.5em 1em;
169 background-color: #f0f9ff;
170 border: solid 1px #c0c9ff;
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; }
185 padding: 0.5em 6px 0.5em 6px;
186 border: solid 1px #e0e0df;
187 background-color: #fffff0;
189 div.caution-inner, div.important-inner, div.note-inner, div.tip-inner, div.warning-inner {
191 background-position: left top;
192 background-repeat: no-repeat;
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"); }
203 background-image: url('watermark-blockquote-201C.png');
204 background-repeat: no-repeat;
205 background-position: top left;
213 div.attribution::before {
223 div.figure, div.informalfigure {
227 background-color: #f9f9f6;
228 border: solid 1px #e0e0df;
230 div.figure-inner, div.informalfigure-inner {
232 background-color: #ffffff;
233 border: solid 1px #e0e0df;
235 div.caption { margin-top: 0.5em; }
239 background-color: #f9f9f6;
240 border: solid 1px #e0e0df;
245 background-color: #f9f9f6;
246 border: solid 1px #e0e0df;
251 div.screen .userinput {
255 div.programlisting .userinput {
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;
281 div.simplelist table { margin-left: 0; border: none; }
284 border-left: solid 1px #e0e0df;
286 div.simplelist td.td-first {
293 background-color: #f9f9f6;
294 border-top: solid 2px #c0c9ff;
295 border-bottom: solid 2px #c0c9ff;
297 div.synopsis div.synopsis {
301 div.synopsis div.block { margin-top: 0.2em; }
302 div.synopsis div.block-first { margin-top: 0; }
303 div.cmdsynopsis { font-family: monospace; }
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; }
310 font-family: monospace;
311 border: solid 1px #e0e0df;
313 padding-right: 0.2em;
315 pre span.code { border: none; padding: 0; }
317 font-family: monospace;
318 border: solid 1px #e0e0df;
320 padding-right: 0.2em;
322 pre span.command { border: none; padding: 0; }
323 span.computeroutput { font-family: monospace; }
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; }
332 span.filename { font-family: monospace; }
333 span.firstterm { font-style: italic; }
334 span.foreignphrase { font-style: italic; }
335 span.function { font-family: monospace; }
337 dt.glossterm span.glossterm { font-style: normal; }
340 span.glossterm { font-style: italic; }
342 span.guibutton, span.guilabel, span.guimenu, span.guimenuitem, span.guisubmenu, span.interface {
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; }
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; }
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;
393 border-color: #333333;
394 background-color: #333333;
397 span.co a { text-decoration: none; }
398 span.co a:hover { text-decoration: none; }
400 dt.question { margin-left: 0em; }
401 dt.question div.label { float: left; }
402 dd + dt.question { margin-top: 1em; }
408 dd.answer div.label { float: left; }
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>
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>
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>
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>
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>
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>
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>
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>
472 <div class="table block block-indent"><table style="border: solid 1px;"><tbody>
474 <td class="td-colsep td-rowsep">
475 <span class="emphasis emphasis-bold">Tag</span>
477 <td class="td-rowsep">
478 <span class="emphasis emphasis-bold">Replaced by</span>
481 <tr class="tr-shade">
482 <td class="td-colsep td-rowsep">name</td>
483 <td class="td-rowsep">Filename of the picture</td>
486 <td class="td-colsep td-rowsep">collection</td>
487 <td class="td-rowsep">Name of the collection</td>
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>
494 <td class="td-colsep td-rowsep">total</td>
495 <td class="td-rowsep">Total number of images</td>
497 <tr class="tr-shade">
498 <td class="td-colsep td-rowsep">date</td>
499 <td class="td-rowsep">File date</td>
502 <td class="td-colsep td-rowsep">size</td>
503 <td class="td-rowsep">File size</td>
505 <tr class="tr-shade">
506 <td class="td-colsep td-rowsep">width</td>
507 <td class="td-rowsep">Image width</td>
510 <td class="td-colsep td-rowsep">height</td>
511 <td class="td-rowsep">Image height</td>
513 <tr class="tr-shade">
514 <td class="td-colsep td-rowsep">res</td>
515 <td class="td-rowsep">Image resolution</td>
518 <td class="td-colsep td-rowsep">keywords</td>
519 <td class="td-rowsep">Image keywords from metadata</td>
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>
526 <td class="td-colsep td-rowsep">imagecomment</td>
527 <td class="td-rowsep">JPEG image comment</td>
529 <tr class="tr-shade">
530 <td class="td-colsep td-rowsep">rating</td>
531 <td class="td-rowsep">Image rating</td>
534 <td class="td-colsep td-rowsep"><meta_tag></td>
535 <td class="td-rowsep">The Exif, XMP, or IPTC tag from metadata</td>
537 <tr class="tr-shade">
538 <td class="td-colsep td-rowsep">lua/<lua_script>/</td>
539 <td class="td-rowsep">The output of a Lua script file</td>
542 <td class="td-colsep">lua//<lua_command></td>
543 <td>The output of a Lua command</td>
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>
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())%
559 <p class="para block">
561 <a class="link" href="GuideReferenceLua.html" title="Lua Extensions">Lua Extensions</a>
562 for further information.
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>
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>
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>
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">
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.
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.
595 <p class="para block">Examples:</p>
596 <div class="table block block-indent"><table style="border: solid 1px;"><tbody>
598 <td class="td-colsep td-rowsep">
599 <span class="emphasis emphasis-bold">Template</span>
601 <td class="td-rowsep">
602 <span class="emphasis emphasis-bold">Example display</span>
605 <tr class="tr-shade">
606 <td class="td-colsep td-rowsep">
608 <i>*</i>\n%
610 <td class="td-rowsep">
611 <span class="emphasis">filename001.jpg</span>
615 <td class="td-colsep td-rowsep">%size:\n%</td>
616 <td class="td-rowsep">123456</td>
618 <tr class="tr-shade">
619 <td class="td-colsep td-rowsep">%formatted.ISOSpeedRating:ISO *%</td>
620 <td class="td-rowsep">ISO 100</td>
623 <td class="td-colsep">
624 %collection:Collection:
630 <span class="emphasis emphasis-bold">my_new_collection</span>
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>
642 <span class="guilabel">Font</span>
644 <span class="guibutton">
645 <span class="guiicon">
646 <span class="inlinegraphic"><img src="gtk-color-picker.png"></span>
649 <span class="guilabel">Text</span>
651 <span class="guibutton">
652 <span class="guiicon">
653 <span class="inlinegraphic"><img src="gtk-color-picker.png"></span>
656 <span class="guilabel">Background</span>
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>
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>
667 <span class="guilabel">Help</span>
670 <p class="para block block-first">Show syntax help</p>
673 <div class="block list variablelist"><dl class="variablelist">
674 <dt class="term dt-first">
675 <span class="guilabel">Defaults</span>
678 <p class="para block block-first">Restore default image overlay template</p>
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>