doc/docbook/GuideOptionsOSD.xml

   1 <?xml version="1.0" encoding="utf-8"?>\r
   2 <section id="GuideOptionsOSD">\r
   3   <title>OverlayScreen Display</title>\r
   4   <para>This section describes the options presented under the OSD Tab of the preferences dialog.</para>\r
   5   <section id="OverlayScreenDisplay">\r
   6     <title>Overlay Screen Display</title>\r
   7     <para>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.</para>\r
   8     <para>\r
   9       The format of each entry is:\r
  10       <programlisting>%tag[:max_length][:extra]%</programlisting>\r
  11     </para>\r
  12     <table frame="all">\r
  13       <tgroup cols="2" rowsep="1" colsep="1">\r
  14         <tbody>\r
  15           <row>\r
  16             <entry>\r
  17               <emphasis role="strong">Tag</emphasis>\r
  18             </entry>\r
  19             <entry>\r
  20               <emphasis role="strong">Replaced by</emphasis>\r
  21             </entry>\r
  22           </row>\r
  23           <row>\r
  24             <entry>name</entry>\r
  25             <entry>Filename of the picture</entry>\r
  26           </row>\r
  27           <row>\r
  28             <entry>collection</entry>\r
  29             <entry>Name of the collection</entry>\r
  30           </row>\r
  31           <row>\r
  32             <entry>number</entry>\r
  33             <entry>Current number of image in the list</entry>\r
  34           </row>\r
  35           <row>\r
  36             <entry>total</entry>\r
  37             <entry>Total number of images</entry>\r
  38           </row>\r
  39           <row>\r
  40             <entry>date</entry>\r
  41             <entry>File date</entry>\r
  42           </row>\r
  43           <row>\r
  44             <entry>size</entry>\r
  45             <entry>File size</entry>\r
  46           </row>\r
  47           <row>\r
  48             <entry>width</entry>\r
  49             <entry>Image width</entry>\r
  50           </row>\r
  51           <row>\r
  52             <entry>height</entry>\r
  53             <entry>Image height</entry>\r
  54           </row>\r
  55           <row>\r
  56             <entry>res</entry>\r
  57             <entry>Image resolution</entry>\r
  58           </row>\r
  59           <row>\r
  60             <entry>keywords</entry>\r
  61             <entry>Image keywords from metadata</entry>\r
  62           </row>\r
  63           <row>\r
  64             <entry>comment</entry>\r
  65             <entry>Image comment from XMP metadata</entry>\r
  66           </row>\r
  67           <row>\r
  68             <entry>imagecomment</entry>\r
  69             <entry>JPEG image comment</entry>\r
  70           </row>\r
  71           <row>\r
  72             <entry>rating</entry>\r
  73             <entry>Image rating</entry>\r
  74           </row>\r
  75           <row>\r
  76             <entry>&lt;meta_tag&gt;</entry>\r
  77             <entry>The Exif, XMP, or IPTC tag from metadata</entry>\r
  78           </row>\r
  79           <row>\r
  80             <entry>lua/&lt;lua_script&gt;/</entry>\r
  81             <entry>The output of a Lua script file</entry>\r
  82           </row>\r
  83           <row>\r
  84             <entry>lua//&lt;lua_command&gt;</entry>\r
  85             <entry>The output of a Lua command</entry>\r
  86           </row>\r
  87         </tbody>\r
  88       </tgroup>\r
  89     </table>\r
  90     <para>\r
  91       As an aide, in addition to standard metadata tags, Geeqie provides a number of\r
  92       <link linkend="formatted_exif">pre-formatted tags</link>\r
  93       .\r
  94     </para>\r
  95     <para>Examples of usage are:</para>\r
  96     <para>\r
  97       <programlisting xml:space="preserve">\r
  98         %keywords%\r
  99         %Exif.Photo.DateTimeOriginal%\r
 100         %lua/jpeg_comment.lua/:12%\r
 101         %lua//return(os.date())%\r
 102       </programlisting>\r
 103     </para>\r
 104     <para>\r
 105       Refer to\r
 106       <link linkend="GuideReferenceLua">Lua Extensions</link>\r
 107       for further information.\r
 108     </para>\r
 109     <para>\r
 110       The length of displayed data can be limited by using the\r
 111       <emphasis role="italic">:max_length</emphasis>\r
 112       parameter. The following example will truncate the displayed data to 20 characters and will add 3 dots at the end to denote the truncation.\r
 113       <programlisting>%formatted.Camera:20%</programlisting>\r
 114     </para>\r
 115     <para>\r
 116       If two or more variables are connected with the\r
 117       <code>|</code>\r
 118       character, the variables are displayed with a separator. For example::\r
 119       <programlisting>%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%</programlisting>\r
 120       could show:\r
 121       <programlisting>"1/20s - 400 - 80 mm"</programlisting>\r
 122       Or, if there is no ISO information in the Exif data:\r
 123       <programlisting>"1/200 - 80 mm"</programlisting>\r
 124     </para>\r
 125     <para>If there is no data for a requested tag, the line is not displayed.</para>\r
 126     <para>\r
 127       The\r
 128       <emphasis role="italic">:extra</emphasis>\r
 129       parameter may be used to format the output by prepending and appending a text string to the displayed item.\r
 130     </para>\r
 131     <para>\r
 132       The special character\r
 133       <code>*</code>\r
 134       is used to mark the position of the Tag data item. If no\r
 135       <code>*</code>\r
 136       is present, the extra string is just appended to the standard data displayed. Any "\n" is replaced by a newline on display.\r
 137       <link linkend="GuideReferenceStandards">Pango mark up</link>\r
 138       is accepted in both left and right parts. If the data item is empty, nothing will be displayed.\r
 139     </para>\r
 140     <para>Examples:</para>\r
 141     <table>\r
 142       <tgroup cols="2" rowsep="1" colsep="1">\r
 143         <tbody>\r
 144           <row>\r
 145             <entry>\r
 146               <emphasis role="strong">Template</emphasis>\r
 147             </entry>\r
 148             <entry>\r
 149               <emphasis role="strong">Example display</emphasis>\r
 150             </entry>\r
 151           </row>\r
 152           <row>\r
 153             <entry>\r
 154               %name:\r
 155               &lt;i&gt;*&lt;/i&gt;\n%\r
 156             </entry>\r
 157             <entry>\r
 158               <emphasis role="italic">filename001.jpg</emphasis>\r
 159             </entry>\r
 160           </row>\r
 161           <row>\r
 162             <entry>%size:\n%</entry>\r
 163             <entry>123456</entry>\r
 164           </row>\r
 165           <row>\r
 166             <entry>%formatted.ISOSpeedRating:ISO *%</entry>\r
 167             <entry>ISO 100</entry>\r
 168           </row>\r
 169           <row>\r
 170             <entry>\r
 171               %collection:Collection:\r
 172               &lt;b&gt;*&lt;/b&gt;\r
 173               \n%\r
 174             </entry>\r
 175             <entry>\r
 176               Collection:\r
 177               <emphasis role="strong">my_new_collection</emphasis>\r
 178             </entry>\r
 179           </row>\r
 180         </tbody>\r
 181       </tgroup>\r
 182     </table>\r
 183     <para />\r
 184     <variablelist>\r
 185       <varlistentry>\r
 186         <term>\r
 187           <guibutton>\r
 188             <guiicon>\r
 189               <inlinegraphic fileref="preferences-desktop-font.png" />\r
 190             </guiicon>\r
 191           </guibutton>\r
 192           <guilabel>Font</guilabel>\r
 193           ,\r
 194           <guibutton>\r
 195             <guiicon>\r
 196               <inlinegraphic fileref="gtk-color-picker.png" />\r
 197             </guiicon>\r
 198           </guibutton>\r
 199           <guilabel>Text</guilabel>\r
 200           ,\r
 201           <guibutton>\r
 202             <guiicon>\r
 203               <inlinegraphic fileref="gtk-color-picker.png" />\r
 204             </guiicon>\r
 205           </guibutton>\r
 206           <guilabel>Background</guilabel>\r
 207         </term>\r
 208         <listitem>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.</listitem>\r
 209       </varlistentry>\r
 210     </variablelist>\r
 211     <variablelist>\r
 212       <varlistentry>\r
 213         <term>\r
 214           <guibutton>\r
 215             <guiicon>\r
 216               <inlinegraphic fileref="help-contents.png" />\r
 217             </guiicon>\r
 218           </guibutton>\r
 219           <guilabel>Help</guilabel>\r
 220         </term>\r
 221         <listitem>\r
 222           <para>Show syntax help</para>\r
 223         </listitem>\r
 224       </varlistentry>\r
 225     </variablelist>\r
 226     <variablelist>\r
 227       <varlistentry>\r
 228         <term>\r
 229           <guilabel>Defaults</guilabel>\r
 230         </term>\r
 231         <listitem>\r
 232           <para>Restore default image overlay template</para>\r
 233         </listitem>\r
 234       </varlistentry>\r
 235     </variablelist>\r
 236   </section>\r
 237 </section>\r