Mercurial > hg > forks > geeqie

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Window Options</title>
<link rel="previous" href="GuideOptionsImage.html" title="Image Options">
<link rel="next" href="GuideOptionsKeyboard.html" title="Keyboard Options">
<link rel="top" href="GuideIndex.html" title="The Geeqie User Manual">
<style type="text/css">

html { height: 100%; }
body {
  margin: 0px; padding: 12px;
  background-color: #f9f9f6;
  min-height: 100%;
  direction: ltr;
}
div, p, pre, blockquote { margin: 0; padding: 0; }
p img { vertical-align: middle; }
sub { font-size: 0.83em; }
sub sub { font-size: 1em; }
sup { font-size: 0.83em; }
sup sup { font-size: 1em; }
table { border-collapse: collapse; }
table.table-pgwide { width: 100%; }
td { vertical-align: top; }
td { padding: 0.2em 0.83em 0.2em 0.83em; }
th { padding: 0 0.83em 0 0.83em; }
tr.tr-shade {
  background-color: #f9f9f6;
}
td.td-colsep { border-right: solid 1px; }
td.td-rowsep { border-bottom: solid 1px; }
thead { border-top: solid 2px; border-bottom: solid 2px; }
tfoot { border-top: solid 2px; border-bottom: solid 2px; }
div.body {
  padding: 1em;
  max-width: 60em;
  background-color: #ffffff;
  border: solid 1px #e0e0df;
}
div.body-sidebar {
  margin-right: 13em;
}
div.division div.division { margin-top: 1.72em; }
div.division div.division div.division { margin-top: 1.44em; }
div.header {
  margin: 0;
  color: #3f3f3f;
  border-bottom: solid 1px #e0e0df;
}
h1, h2, h3, h4, h5, h6, h7 {
  margin: 0; padding: 0;
  color: #3f3f3f;
}
h1.title { font-size: 1.72em; }
h2.title { font-size: 1.44em; }
h3.title { font-size: 1.2em; }
h4.title, h5.title, h6.title, h7.title { font-size: 1em; }
.block { margin-top: 1em; }
.block .block-first { margin-top: 0; }
.block-indent {
  margin-left left: 1.72em;
  margin-: 1em;
}
.block-indent .block-indent { margin-left: 0em; margin-right: 0em; }
td .block-indent  { margin-left: 0em; margin-right: 0em; }
dd .block-indent  { margin-left: 0em; margin-right: 0em; }
.block-verbatim { white-space: pre; }
div.title {
  margin-bottom: 0.2em;
  font-weight: bold;
  color: #3f3f3f;
}
div.title-formal { padding-left: 0.2em; padding-right: 0.2em; }
div.title-formal .label { font-weight: normal; }
a {
  color: #1f609f;
  text-decoration: none;
}
a:hover { text-decoration: underline; }
a:visited { color: #9f1f6f; }
ul, ol, dl { margin: 0; padding: 0; }
li {
  margin-top: 1em;
  margin-left: 2.4em;
  padding: 0;
}
li.li-first { margin-top: 0; }
dt { margin: 1em 0 0 0; }
dt.dt-first { margin: 0; }
dd {
  margin-left: 1.72em;
  margin-top: 0.5em;
}
dl.dl-compact dt { margin-top: 0; }
dl.dl-compact dd { margin-top: 0; margin-bottom: 0; }


ul.linktrail {
  display: block;
  margin: 0.2em 0 0 0;
  text-align: right;
}
li.linktrail { display: inline; margin: 0; padding: 0; }

li.linktrail::before {
  content: '  /  ';
  color: #3f3f3f;
}

li.linktrail-first::before, li.linktrail-only::before { content: ''; }


div.navbar {
  padding: 0.5em 1em 0.5em 1em;
  max-width: 60em;
  background-color: #ffffff;
  border: solid 1px #e0e0df;
}
div.navbar-top { margin-bottom: 1em; }
div.navbar-bottom { margin-top: 1em; clear: both; }
div.navbar img { border: 0; vertical-align: -0.4em; }
table.navbar { width: 100%; margin: 0; border: none; }
table.navbar td { padding: 0; border: none; }
td.navbar-next {
  text-align: right;
}
a.navbar-prev::before {

  content: '◀  ';
  color: #3f3f3f;
}
a.navbar-next::after {

  content: '  ▶';
  color: #3f3f3f;
}


div.sidebar {
  float: right;
  padding: 0; margin: 0; width: 12em;
}
div.sidenav {
  padding: 0.5em 1em 0 1em;
  background-color: #ffffff;
  border: solid 1px #e0e0df;
}
div.sidenav div.autotoc {
  background-color: #ffffff;
  border: none; padding: 0; margin: 0;
}
div.sidenav div.autotoc div.autotoc { margin-top: 0.5em; }
div.sidenav div.autotoc li { margin-bottom: 0.5em; }
div.sidenav div.autotoc div.autotoc div.autotoc {
  margin-left: 1em;
  margin-top: 0;
}
div.sidenav div.autotoc div.autotoc div.autotoc li { margin-bottom: 0; }


div.autotoc {

  display: table;
  margin-top: 1em;
  margin-left: 1.72em;
  padding: 0.5em 1em 0.5em 1em;
  background-color: #f0f9ff;
  border: solid 1px #c0c9ff;
}
div.autotoc ul { margin: 0; padding: 0; }
div.autotoc li { list-style-type: none; margin: 0; }
div.autotoc div.autotoc-title { margin-bottom: 0.5em; }
div.autotoc div.autotoc { border: none; padding: 0; margin-top: 0; margin-bottom: 0.5em; }
div.autotoc div.autotoc div.autotoc { margin-bottom: 0; }


span.bibliolabel {
  color: #3f3f3f;
}


div.admonition {
  padding: 0.5em 6px 0.5em 6px;
  border: solid 1px #e0e0df;
  background-color: #fffff0;
}
div.caution-inner, div.important-inner, div.note-inner, div.tip-inner, div.warning-inner {
  padding-left: 60px;
  background-position: left top;
  background-repeat: no-repeat;
  min-height: 48px;
}
div.caution-inner { background-image: url("admon-caution.png"); }
div.important-inner { background-image: url("admon-important.png"); }
div.note-inner { background-image: url("admon-note.png"); }
div.note-bug div.note-inner { background-image: url("admon-bug.png"); }
div.tip-inner { background-image: url("admon-tip.png"); }
div.warning-inner { background-image: url("admon-warning.png"); }
div.blockquote {

  background-image: url('watermark-blockquote-201C.png');
  background-repeat: no-repeat;
  background-position: top left;
  padding: 0.5em;
  padding-left: 4em;
}
div.attribution {
  margin-top: 0.5em;
  color: #3f3f3f;
}
div.attribution::before {

  content: '― ';
}
div.epigraph {
  text-align: right;
  margin-left: 20%;
  margin-right: 0;
  color: #3f3f3f;
}
div.figure, div.informalfigure {

  display: table;
  padding: 0.5em;
  background-color: #f9f9f6;
  border: solid 1px #e0e0df;
}
div.figure-inner, div.informalfigure-inner {
  padding: 0.5em;
  background-color: #ffffff;
  border: solid 1px #e0e0df;
}
div.caption { margin-top: 0.5em; }
div.programlisting {
  padding: 0.5em;

  background-color: #f9f9f6;
  border: solid 1px #e0e0df;
}
div.screen {
  padding: 0.5em;

  background-color: #f9f9f6;
  border: solid 1px #e0e0df;
}
div.screen .prompt {
  color: #3f3f3f;
}
div.screen .userinput {
  font-weight: bold;
  color: #3f3f3f;
}
div.programlisting .userinput {
  font-weight: bold;
  color: #3f3f3f;
}
pre.linenumbering {
  color: #3f3f3f;
  margin: 0;
  padding-right: 1em;
  float: left;
  text-align: right;
}


dl.index dt { margin-top: 0; }
dl.index dd { margin-top: 0; margin-bottom: 0; }
dl.indexdiv dt { margin-top: 0; }
dl.indexdiv dd { margin-top: 0; margin-bottom: 0; }
dl.setindex dt { margin-top: 0; }
dl.setindex dd { margin-top: 0; margin-bottom: 0; }
div.list div.title-formal span.title {
  border-bottom: solid 1px #e0e0df;
}
div.simplelist {
  margin-left: 1.72em;
}
div.simplelist table { margin-left: 0; border: none; }
div.simplelist td {
  padding: 0.5em;
  border-left: solid 1px #e0e0df;
}
div.simplelist td.td-first {
  padding-left: 0;
  border-left: 0;
}
div.synopsis {
  padding: 0.5em;

  background-color: #f9f9f6;
  border-top: solid 2px #c0c9ff;
  border-bottom: solid 2px #c0c9ff;
}
div.synopsis div.synopsis {
  padding: 0;
  border: none;
}
div.synopsis div.block { margin-top: 0.2em; }
div.synopsis div.block-first { margin-top: 0; }
div.cmdsynopsis { font-family: monospace; }

span.accel { text-decoration: underline; }
span.acronym { font-family: sans-serif; }
span.application { font-style: italic; }
span.classname, span.exceptionname, span.interfacename { font-family: monospace; }
span.code {
  font-family: monospace;
  border: solid 1px #e0e0df;
  padding-left: 0.2em;
  padding-right: 0.2em;
}
pre span.code { border: none; padding: 0; }
span.command {
  font-family: monospace;
  border: solid 1px #e0e0df;
  padding-left: 0.2em;
  padding-right: 0.2em;
}
pre span.command { border: none; padding: 0; }
span.computeroutput { font-family: monospace; }

span.constant { font-family: monospace; }
span.database { font-family: monospace; }
span.email { font-family: monospace; }
span.emphasis { font-style: italic; }
span.emphasis-bold { font-style: normal; font-weight: bold; }
span.envar { font-family: monospace; }

span.filename { font-family: monospace; }
span.firstterm { font-style: italic; }
span.foreignphrase { font-style: italic; }
span.function { font-family: monospace; }

dt.glossterm span.glossterm { font-style: normal; }


span.glossterm { font-style: italic; }

span.guibutton, span.guilabel, span.guimenu, span.guimenuitem, span.guisubmenu, span.interface {
  font-weight: bold;
  color: #3f3f3f;
}
span.keycap {
  font-weight: bold;
  color: #3f3f3f;
}
span.lineannotation { font-style: italic; }
span.literal { font-family: monospace; }
span.markup  { font-family: monospace; }
span.medialabel { font-style: italic; }
span.methodname { font-family: monospace; }
span.ooclass, span.ooexception, span.oointerface { font-family: monospace; }
span.option { font-family: monospace; }
span.parameter { font-family: monospace; }
span.paramdef span.parameter { font-style: italic; }
span.prompt { font-family: monospace; }
span.property { font-family: monospace; }
span.replaceable  { font-style: italic; }
span.returnvalue { font-family: monospace; }
span.sgmltag { font-family: monospace; }
span.structfield, span.structname { font-family: monospace; }
span.symbol { font-family: monospace; }
span.systemitem { font-family: monospace; }
span.token { font-family: monospace; }
span.type { font-family: monospace; }
span.uri { font-family: monospace; }
span.userinput { font-family: monospace; }
span.varname { font-family: monospace; }
span.wordasword { font-style: italic; }


div.footnotes { font-style: italic; font-size: 0.8em; }
div.footnote { margin-top: 1.44em; }
span.footnote-number { display: inline; padding-right: 0.83em; }
span.footnote-number + p { display: inline; }
a.footnote { text-decoration: none; font-size: 0.8em; }
a.footnote-ref { text-decoration: none; }

span.co {
  margin-left: 0.2em; margin-right: 0.2em;
  padding-left: 0.4em; padding-right: 0.4em;
  border: solid 1px #000000;
  -moz-border-radius: 8px;
  background-color: #000000;
  color: #FFFFFF;
  font-size: 8px;
}
span.co:hover {
  border-color: #333333;
  background-color: #333333;
  color: #FFFFFF;
}
span.co a { text-decoration: none; }
span.co a:hover { text-decoration: none; }

dt.question { margin-left: 0em; }
dt.question div.label { float: left; }
dd + dt.question { margin-top: 1em; }
dd.answer {
  margin-top: 1em;
  margin-left: 2em;
  margin-right: 1em;
}
dd.answer div.label { float: left; }
</style>
</head>
<body>
<div class="navbar navbar-top"><table class="navbar"><tr>
<td class="navbar-prev"><a class="navbar-prev" href="GuideOptionsImage.html" title="Image Options">Image Options</a></td>
<td class="navbar-next"><a class="navbar-next" href="GuideOptionsKeyboard.html" title="Keyboard Options">Keyboard Options</a></td>
</tr></table></div>
<div class="sidebar"><div class="sidenav"><div class="autotoc"><ul>
<li><a href="GuideIndex-info.html" title="About This Document">About This Document</a></li>
<li>
<a class="xref" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a><div class="autotoc"><ul>
<li><a class="xref" href="GuideIntroduction.html" title="Introduction">Introduction</a></li>
<li><a class="xref" href="GuideMainWindow.html" title="Main Window">Main Window</a></li>
<li><a class="xref" href="GuideSidebars.html" title="Sidebars">Sidebars</a></li>
<li><a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
<li><a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a></li>
<li><a class="xref" href="GuideImageManagementPlugins.html" title="Plugins">Plugins</a></li>
<li><a class="xref" href="GuideImageManagement.html" title="File Management">File Management</a></li>
<li><a class="xref" href="GuideColorManagement.html" title="Color Management">Color Management</a></li>
<li><a class="xref" href="GuideImagePresentation.html" title="Image Presentation">Image Presentation</a></li>
<li><a class="xref" href="GuidePrinting.html" title="Printing">Printing</a></li>
<li>
<a class="xref" href="GuideOptionsMain.html" title="Preferences">Preferences</a><div class="autotoc"><ul>
<li><a class="xref" href="GuideOptionsGeneral.html" title="General Options">General Options</a></li>
<li><a class="xref" href="GuideOptionsImage.html" title="Image Options">Image Options</a></li>
<li>Window Options</li>
<li><a class="xref" href="GuideOptionsKeyboard.html" title="Keyboard Options">Keyboard Options</a></li>
<li><a class="xref" href="GuideOptionsFiltering.html" title="Files Options">Files Options</a></li>
<li><a class="xref" href="GuideOptionsMetadata.html" title="Metadata">Metadata</a></li>
<li><a class="xref" href="GuideOptionsKeywords.html" title="Keywords">Keywords</a></li>
<li><a class="xref" href="GuideOptionsColor.html" title="Color management options">Color management options</a></li>
<li><a class="xref" href="GuideOptionsStereo.html" title="Stereo image management">Stereo image management</a></li>
<li><a class="xref" href="GuideOptionsBehavior.html" title="Behavior Options">Behavior Options</a></li>
<li><a class="xref" href="GuideOptionsToolbar.html" title="Toolbar">Toolbar</a></li>
</ul></div>
</li>
<li><a class="xref" href="GuideOptionsAdditional.html" title="Additional Preferences">Additional Preferences</a></li>
<li><a class="xref" href="GuideReference.html" title="Reference">Reference</a></li>
<li><a class="xref" href="GuideFaq.html" title="Frequently Asked Questions">Frequently Asked Questions</a></li>
<li><a class="xref" href="GuideLicence.html" title="Licence">Licence</a></li>
<li><a class="xref" href="GuideCredits.html" title="Credits">Credits</a></li>
<li><a class="xref" href="GuideGnuFdl.html" title="GNU Free Documentation License">GNU Free Documentation License</a></li>
</ul></div>
</li>
</ul></div></div></div>
<div class="body body-sidebar"><div class="division section">
<a name="GuideOptionsWindow"></a><div class="header"><h1 class="section title"><span class="title">Window Options</span></h1></div>
<ul class="linktrail">
<li class="linktrail linktrail-first"><a class="linktrail" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a></li>
<li class="linktrail linktrail-last"><a class="linktrail" href="GuideOptionsMain.html" title="Preferences">Preferences</a></li>
</ul>
<p class="para block block-first">This section describes the options presented under the Windows Tab of the preferences dialog.</p>
<div class="autotoc"><ul>
<li>
<span class="label">11.3.1. </span><a class="xref" href="GuideOptionsWindow.html#State" title="State">State</a>
</li>
<li>
<span class="label">11.3.2. </span><a class="xref" href="GuideOptionsWindow.html#Size" title="Size">Size</a>
</li>
<li>
<span class="label">11.3.3. </span><a class="xref" href="GuideOptionsWindow.html#FullScreen" title="Full Screen">Full Screen</a>
</li>
<li>
<span class="label">11.3.4. </span><a class="xref" href="GuideOptionsWindow.html#OverlayScreenDisplay" title="Overlay Screen Display">Overlay Screen Display</a>
</li>
</ul></div>
<div class="division section">
<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>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Remember window positions</span>
        </dt>
<dd>
          <p class="para block block-first">This will maintain windows size and position between Geeqie sessions.</p>
        </dd>
</dl></div>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Use saved window positions also for new windows</span>
        </dt>
<dd>
          <p class="para block block-first">
            A new window opened by menu
            <span class="menuchoice"><span class="guimenu">File</span> ▸ <span class="guimenuitem">New Window</span> <span class="shortcut">(
                <span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">N</span></span>
              )</span></span>
            will use the saved window positions also.
          </p>
        </dd>
</dl></div>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Remember tool state</span>
        </dt>
<dd>
          <p class="para block block-first">
            Maintains the selection set by
            <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">(
                <span class="keycombo"><span class="keycap">L</span></span>
              )</span></span>
          </p>
        </dd>
</dl></div>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Remember dialog window positions</span>
        </dt>
<dd>
          <p class="para block block-first">This will maintain dialog windows size and position between Geeqie sessions.</p>
        </dd>
</dl></div>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Show window IDs</span>
        </dt>
<dd>
          <p class="para block block-first">
            Show the window ID in the titlebar of each window. When multiple Geeqie windows are opened, this option shows a unique identifier for each window. It may be used in conjunction with the command line option:
            <a class="link" href="GuideReferenceCommandLine.html#Remotecommands" title="Remote commands">
              <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">--remote --id:&lt;ID&gt;</pre></div>
            </a>
          </p>
        </dd>
</dl></div>
</div>
<div class="division section">
<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>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Fit window to image when tools are hidden/floating</span>
        </dt>
<dd>
          <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>
        </dd>
</dl></div>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Limit size when auto-sizing window</span>
        </dt>
<dd>
          <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>
        </dd>
</dl></div>
</div>
<div class="division section">
<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>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Location</span>
        </dt>
<dd>
          <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>
        </dd>
</dl></div>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Smooth image flip</span>
        </dt>
<dd>
          <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>
        </dd>
</dl></div>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Disable screen saver</span>
        </dt>
<dd>
          <p class="para block block-first">
            This option will execute
            <span class="emphasis">xscreensaver-command --deactivate</span>
            once per minute to avoid the screen saver from activating when Geeqie is displayed full screen.
          </p>
        </dd>
</dl></div>
</div>
<div class="division section">
<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>
<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>
<p class="para block">
      The format of each entry is:
      <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">%tag[:max_length][:extra]%</pre></div>
    </p>
<div class="table block block-indent"><table style="border: solid 1px;"><tbody>
<tr>
<td class="td-colsep td-rowsep">
              <span class="emphasis emphasis-bold">Tag</span>
            </td>
<td class="td-rowsep">
              <span class="emphasis emphasis-bold">Replaced by</span>
            </td>
</tr>
<tr class="tr-shade">
<td class="td-colsep td-rowsep">name</td>
<td class="td-rowsep">Filename of the picture</td>
</tr>
<tr>
<td class="td-colsep td-rowsep">collection</td>
<td class="td-rowsep">Name of the collection</td>
</tr>
<tr class="tr-shade">
<td class="td-colsep td-rowsep">number</td>
<td class="td-rowsep">Current number of image in the list</td>
</tr>
<tr>
<td class="td-colsep td-rowsep">total</td>
<td class="td-rowsep">Total number of images</td>
</tr>
<tr class="tr-shade">
<td class="td-colsep td-rowsep">date</td>
<td class="td-rowsep">File date</td>
</tr>
<tr>
<td class="td-colsep td-rowsep">size</td>
<td class="td-rowsep">File size</td>
</tr>
<tr class="tr-shade">
<td class="td-colsep td-rowsep">width</td>
<td class="td-rowsep">Image width</td>
</tr>
<tr>
<td class="td-colsep td-rowsep">height</td>
<td class="td-rowsep">Image height</td>
</tr>
<tr class="tr-shade">
<td class="td-colsep td-rowsep">res</td>
<td class="td-rowsep">Image resolution</td>
</tr>
<tr>
<td class="td-colsep td-rowsep">keywords</td>
<td class="td-rowsep">Image keywords from metadata</td>
</tr>
<tr class="tr-shade">
<td class="td-colsep td-rowsep">comment</td>
<td class="td-rowsep">Image comment from XMP metadata</td>
</tr>
<tr>
<td class="td-colsep td-rowsep">imagecomment</td>
<td class="td-rowsep">JPEG image comment</td>
</tr>
<tr class="tr-shade">
<td class="td-colsep td-rowsep">rating</td>
<td class="td-rowsep">Image rating</td>
</tr>
<tr>
<td class="td-colsep td-rowsep">&lt;meta_tag&gt;</td>
<td class="td-rowsep">The Exif, XMP, or IPTC tag from metadata</td>
</tr>
<tr class="tr-shade">
<td class="td-colsep td-rowsep">lua/&lt;lua_script&gt;/</td>
<td class="td-rowsep">The output of a Lua script file</td>
</tr>
<tr>
<td class="td-colsep">lua//&lt;lua_command&gt;</td>
<td>The output of a Lua command</td>
</tr>
</tbody></table></div>
<p class="para block">
      As an aide, in addition to standard metadata tags, Geeqie provides a number of
      <a class="link" href="GuideSidebarsInfo.html#formatted_exif" title="">pre-formatted tags</a>
      .
    </p>
<p class="para block">Examples of usage are:</p>
<p class="para block">
      <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">        %keywords%
        %Exif.Photo.DateTimeOriginal%
        %lua/jpeg_comment.lua/:12%
        %lua//return(os.date())%
      </pre></div>
    </p>
<p class="para block">
      Refer to
      <a class="link" href="GuideReferenceLua.html" title="Lua Extensions">Lua Extensions</a>
      for further information.
    </p>
<p class="para block">
      The length of displayed data can be limited by using the
      <span class="emphasis">:max_length</span>
      parameter. The following example will truncate the displayed data to 20 characters and will add 3 dots at the end to denote the truncation.
      <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">%formatted.Camera:20%</pre></div>
    </p>
<p class="para block">
      If two or more variables are connected with the
      <span class="code" dir="ltr">|</span>
      character, the variables are displayed with a separator. For example::
      <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%</pre></div>
      could show:
      <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">"1/20s - 400 - 80 mm"</pre></div>
      Or, if there is no ISO information in the Exif data:
      <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">"1/200 - 80 mm"</pre></div>
    </p>
<p class="para block">If there is no data for a requested tag, the line is not displayed.</p>
<p class="para block">
      The
      <span class="emphasis">:extra</span>
      parameter may be used to format the output by prepending and appending a text string to the displayed item.
    </p>
<p class="para block">
      The special character
      <span class="code" dir="ltr">*</span>
      is used to mark the position of the Tag data item. If no
      <span class="code" dir="ltr">*</span>
      is present, the extra string is just appended to the standard data displayed. Any "\n" is replaced by a newline on display.
      <a class="link" href="GuideReferenceStandards.html" title="Standards">Pango mark up</a>
      is accepted in both left and right parts. If the data item is empty, nothing will be displayed.
    </p>
<p class="para block">Examples:</p>
<div class="table block block-indent"><table style="border: solid 1px;"><tbody>
<tr>
<td class="td-colsep td-rowsep">
              <span class="emphasis emphasis-bold">Template</span>
            </td>
<td class="td-rowsep">
              <span class="emphasis emphasis-bold">Example display</span>
            </td>
</tr>
<tr class="tr-shade">
<td class="td-colsep td-rowsep">
              %name:
              &lt;i&gt;*&lt;/i&gt;\n%
            </td>
<td class="td-rowsep">
              <span class="emphasis">filename001.jpg</span>
            </td>
</tr>
<tr>
<td class="td-colsep td-rowsep">%size:\n%</td>
<td class="td-rowsep">123456</td>
</tr>
<tr class="tr-shade">
<td class="td-colsep td-rowsep">%formatted.ISOSpeedRating:ISO *%</td>
<td class="td-rowsep">ISO 100</td>
</tr>
<tr>
<td class="td-colsep">
              %collection:Collection:
              &lt;b&gt;*&lt;/b&gt;
              \n%
            </td>
<td>
              Collection:
              <span class="emphasis emphasis-bold">my_new_collection</span>
            </td>
</tr>
</tbody></table></div>
<p class="para block"></p>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guibutton">
            <span class="guiicon">
              <span class="inlinegraphic"><img src="preferences-desktop-font.png"></span>
            </span>
          </span>
          <span class="guilabel">Font</span>
          ,
          <span class="guibutton">
            <span class="guiicon">
              <span class="inlinegraphic"><img src="gtk-color-picker.png"></span>
            </span>
          </span>
          <span class="guilabel">Text</span>
          ,
          <span class="guibutton">
            <span class="guiicon">
              <span class="inlinegraphic"><img src="gtk-color-picker.png"></span>
            </span>
          </span>
          <span class="guilabel">Background</span>
        </dt>
<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>
</dl></div>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guibutton">
            <span class="guiicon">
              <span class="inlinegraphic"><img src="help-contents.png"></span>
            </span>
          </span>
          <span class="guilabel">Help</span>
        </dt>
<dd>
          <p class="para block block-first">Show syntax help</p>
        </dd>
</dl></div>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
          <span class="guilabel">Defaults</span>
        </dt>
<dd>
          <p class="para block block-first">Restore default image overlay template</p>
        </dd>
</dl></div>
</div>
</div></div>
<div class="navbar navbar-bottom"><table class="navbar"><tr>
<td class="navbar-prev"><a class="navbar-prev" href="GuideOptionsImage.html" title="Image Options">Image Options</a></td>
<td class="navbar-next"><a class="navbar-next" href="GuideOptionsKeyboard.html" title="Keyboard Options">Keyboard Options</a></td>
</tr></table></div>
</body>
</html>
author	Colin Clark <colin.clark@cclark.uk>
date	Sun, 26 Aug 2018 13:32:42 +0100
parents	808983eb036e
children	bb44bd76f857