doc/docbook/GuideSidebarsInfo.xml

   1 <?xml version="1.0" encoding="utf-8"?>\r
   2 <section id="GuideSidebarsInfo">\r
   3   <title>Info Sidebar</title>\r
   4   <para>The Info Sidebar shows various information about the image and can also be used for metadata editing.</para>\r
   5   <para>\r
   6     To toggle display of the Sort Manager select\r
   7     <menuchoice>\r
   8       <shortcut>\r
   9         <keycombo>\r
  10           <keycap>Ctrl</keycap>\r
  11           <keycap>K</keycap>\r
  12         </keycombo>\r
  13       </shortcut>\r
  14       <guimenu>View</guimenu>\r
  15       <guimenuitem>Info Sidebar</guimenuitem>\r
  16     </menuchoice>\r
  17     .\r
  18   </para>\r
  19   <para>It consists of several panes. Left-clicking on the pane title expands or collapses the pane. Right-clicking on the pane title or on empty space opens a context menu allowing you to add and remove panes, or move them up and down.</para>\r
  20   <para />\r
  21   <section id="Histogram">\r
  22     <title>Histogram</title>\r
  23     <para>\r
  24       This histogram is identical to that shown in the\r
  25       <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />\r
  26       . It can be configured by right-click to modify the display of color or linear/logarithmic scale.\r
  27     </para>\r
  28     <para />\r
  29   </section>\r
  30   <section id="TextpaneTitle">\r
  31     <title>Title</title>\r
  32     >\r
  33     <note>\r
  34       <para>\r
  35         Title text is stored in the\r
  36         <emphasis>Xmp.dc.title</emphasis>\r
  37         tag.\r
  38       </para>\r
  39     </note>\r
  40     <para />\r
  41   </section>\r
  42   <section id="TextpaneComment">\r
  43     <title>Comment</title>\r
  44     <note>\r
  45       <para>\r
  46         Comment text is stored in the\r
  47         <emphasis>Xmp.dc.description</emphasis>\r
  48         tag.\r
  49       </para>\r
  50     </note>\r
  51     <para />\r
  52   </section>\r
  53   <section id="Keywords">\r
  54     <title id="titleKeywords">Keywords</title>\r
  55     <para>Keywords, together with a flexible search tool, are essential for handling large image collections.</para>\r
  56     <para>Geeqie has free-form keywords and a hierarchical method of adding new keywords to an image.</para>\r
  57     <note>\r
  58       <para>\r
  59         Keywords are stored in the\r
  60         <emphasis>Xmp.dc.subject</emphasis>\r
  61         tag.\r
  62       </para>\r
  63     </note>\r
  64     <note>\r
  65       <para>\r
  66         Keywords are not case-sensitive unless selected as so in\r
  67         <link linkend="MetadataMiscellaneous">Preferences</link>\r
  68       </para>\r
  69     </note>\r
  70     <para>The Keyword pane in the sidebar consists of two sections:</para>\r
  71     <para>\r
  72       <itemizedlist spacing="compact">\r
  73         <listitem>The left hand section which is for free-form keywords</listitem>\r
  74         <listitem>The right hand section which is a hierarchical structure, allowing sets of keywords to be added.</listitem>\r
  75       </itemizedlist>\r
  76     </para>\r
  77     <para>The contents of the left-hand box is the data written to file.</para>\r
  78     <para>\r
  79       The right-hand section has two types of entries :\r
  80       <itemizedlist spacing="compact">\r
  81         <listitem>Keywords</listitem>\r
  82         <listitem>Helpers</listitem>\r
  83       </itemizedlist>\r
  84       <para>An example of keyword hierarchy is:</para>\r
  85       <programlisting xml:space="preserve">\r
  86         [ ] animal\r
  87         [ ]   mammal\r
  88         [ ]     dog\r
  89         [ ]     cat\r
  90         [ ]   insect\r
  91         [ ]     fly\r
  92         [ ]     dragonfly\r
  93         daytime\r
  94         [ ]   morning\r
  95         [ ]   afternoon\r
  96       </programlisting>\r
  97     </para>\r
  98     <para>\r
  99       In this example\r
 100       <emphasis>daytime</emphasis>\r
 101       is a Helper, and all the others are keywords. Helpers are not stored in metadata - their purpose is only as an organisational aide.\r
 102     </para>\r
 103     <para>\r
 104       In the above example if\r
 105       <emphasis>cat</emphasis>\r
 106       is clicked, both\r
 107       <emphasis>mammal</emphasis>\r
 108       and\r
 109       <emphasis>animal</emphasis>\r
 110       will also automatically be checked, and all three transferred to the left hand box, ready for writing as metadata.\r
 111     </para>\r
 112     <para>If a hierarchy of keywords are checked, and the top-level item then un-checked, all lower level keywords will also be unchecked and will be removed from the left-hand pane.</para>\r
 113     <warning>\r
 114       <para>This action cannot be undone.</para>\r
 115     </warning>\r
 116     <para>Irrespective of their position in a hierarchy in the right-hand box, all keywords are written as individual entries into metadata. When metadata for an image is read in, Geeqie will attempt to recreate any hierarchies within the data, and display it accordingly in the right-hand box.</para>\r
 117     <para>\r
 118       Right-click on the left-hand box allows the selected keywords to be written to the currently selected files - the keywords may be either added to the existing contents, or entirely replace the existing content.\r
 119       <warning>\r
 120         <para>Keyword completion is used when selecting keywords. If the selected area includes part of a keyword, the selection will autmatically be expanded to cover the whole keyword. If no text is selected, all keywords will be used.</para>\r
 121       </warning>\r
 122     </para>\r
 123     <para>\r
 124       Right-click on the right-hand box allows a connection to be made between a keyword and a mark. The\r
 125       <link linkend="GuideImageMarks" endterm="titleGuideImageMarks" />\r
 126       section shows how marks and keywords inter-operate.\r
 127     </para>\r
 128     <para>The ordering of keywords in the right-hand box may be changed by drag-and-drop.</para>\r
 129     <para>\r
 130       The meta-data write operation for a file is triggered either\r
 131       <link linkend="Buttons">manually</link>\r
 132       or as defined in\r
 133       <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />\r
 134       .\r
 135     </para>\r
 136     <para>\r
 137       If the right-click menu item\r
 138       <guimenu>Revert</guimenu>\r
 139       is executed at any time after a\r
 140       <guimenu>Show all</guimenu>\r
 141       or\r
 142       <guimenu>Collapse all</guimenu>\r
 143       , the keyword layout will be restored to the state prior to the\r
 144       <guimenu>Show all</guimenu>\r
 145       or\r
 146       <guimenu>Collapse all</guimenu>\r
 147       .\r
 148       <para />\r
 149       If the right-click menu item\r
 150       <guimenu>Revert</guimenu>\r
 151       is executed at any time before a\r
 152       <guimenu>Show all</guimenu>\r
 153       or\r
 154       <guimenu>Collapse all</guimenu>\r
 155       , the keyword layout will be restored to the state existing at start-up.\r
 156     </para>\r
 157     <note>\r
 158       <para>\r
 159         The selections in the sub-menu\r
 160         <guimenu>On any change</guimenu>\r
 161         will affect the operation of the\r
 162         <guimenu>Revert</guimenu>\r
 163         option.\r
 164       </para>\r
 165     </note>\r
 166     <para />\r
 167   </section>\r
 168   <section id="KeywordAutocompletion">\r
 169     <title id="titleKeywordAutocompletion">Keyword Autocompletion</title>\r
 170     <para>\r
 171       The text box at the bottom of the keywords pane is used for autocompletion. Any keywords typed into the standard keyword box or the autocompletion box will be remembered as candidates for future autocompletion.\r
 172       <para />\r
 173       Frequently used sets of keywords can be entered as comma-delimited lists.\r
 174       <para />\r
 175       The list of keywords used for autocompletion can be edited on the\r
 176       <link linkend="GuideOptionsKeywords">Keywords</link>\r
 177       tab of the Preferences dialog.\r
 178       <para />\r
 179       The menu action "Keyword autocomplete", set to\r
 180       <code>Alt + K</code>\r
 181       by default, will shift the keyboard focus to the autocomplete box. Pressing\r
 182       <code>Alt + K</code>\r
 183       a second time will shift the keyboard focus back to the previous object.\r
 184     </para>\r
 185     <para />\r
 186   </section>\r
 187   <section id="Listpanes-ExifFileinfoCopyrightLocationandGPS">\r
 188     <title id="titleExif">List panes</title>\r
 189     <para>\r
 190       There are five list panes, whose contents can be configured to display Exif, XMP or IPTC metadata tags. The five panes are:\r
 191       <itemizedlist>\r
 192         <listitem>Title</listitem>\r
 193         <listitem>Exif</listitem>\r
 194         <listitem>File Info</listitem>\r
 195         <listitem>Location and GPS</listitem>\r
 196         <listitem>Copyright</listitem>\r
 197       </itemizedlist>\r
 198     </para>\r
 199     <para>Any metadata tag can be displayed in any pane - the pane titles merely exist as an organisational aide.</para>\r
 200     <para>It is possible to reorganise the data displayed by drag-and-dropping any item within a pane, or from one pane to another (although in some cases it makes little sense to do so).</para>\r
 201     <para>\r
 202       <note>It is not possible to undo these actions, nor is there a way to reset the display to its original settings.</note>\r
 203     </para>\r
 204     <para>\r
 205       It is also possible to drag new items from the\r
 206       <link linkend="GuideOtherWindowsExif" endterm="titleGuideOtherWindowsExif" />\r
 207       onto any pane.\r
 208     </para>\r
 209     <para>As an aide, in addition to standard metadata tags, Geeqie can call lua scripts and also provides certain pre-formatted tags. These tags are:</para>\r
 210     <table id="formatted_exif">\r
 211       <tgroup cols="2" rowsep="1" colsep="1">\r
 212         <tbody>\r
 213           <row>\r
 214             <entry>\r
 215               <emphasis role="strong">Tag</emphasis>\r
 216             </entry>\r
 217             <entry>\r
 218               <emphasis role="strong">Replaced by Meta data</emphasis>\r
 219             </entry>\r
 220           </row>\r
 221           <row>\r
 222             <entry>formatted.Camera</entry>\r
 223             <entry>Camera and sofware name</entry>\r
 224           </row>\r
 225           <row>\r
 226             <entry>formatted.DateTime</entry>\r
 227             <entry>Image Date</entry>\r
 228           </row>\r
 229           <row>\r
 230             <entry>formatted.ShutterSpeed</entry>\r
 231             <entry>Shutter speed in seconds (e.g. 1/60s)</entry>\r
 232           </row>\r
 233           <row>\r
 234             <entry>formatted.Aperture</entry>\r
 235             <entry>Aperture (e.g. f5.6)</entry>\r
 236           </row>\r
 237           <row>\r
 238             <entry>formatted.ExposureBias</entry>\r
 239             <entry>Exposure bias (e.g. +0.3)</entry>\r
 240           </row>\r
 241           <row>\r
 242             <entry>formatted.ISOSpeedRating</entry>\r
 243             <entry>ISO sensitivity (e.g. 100)</entry>\r
 244           </row>\r
 245           <row>\r
 246             <entry>formatted.FocalLength</entry>\r
 247             <entry>Focal length</entry>\r
 248           </row>\r
 249           <row>\r
 250             <entry>formatted.FocalLength35mmFilm</entry>\r
 251             <entry>Focal length 35mm</entry>\r
 252           </row>\r
 253           <row>\r
 254             <entry>formatted.SubjectDistance</entry>\r
 255             <entry>Subject distance</entry>\r
 256           </row>\r
 257           <row>\r
 258             <entry>formatted.Flash</entry>\r
 259             <entry>Flash</entry>\r
 260           </row>\r
 261           <row>\r
 262             <entry>formatted.Resolution</entry>\r
 263             <entry>Resolution</entry>\r
 264           </row>\r
 265           <row>\r
 266             <entry>formatted.ColorProfile</entry>\r
 267             <entry>Color profile</entry>\r
 268           </row>\r
 269           <row>\r
 270             <entry>formatted.GPSAltitude</entry>\r
 271             <entry>Altitude above sea level</entry>\r
 272           </row>\r
 273           <row>\r
 274             <entry>formatted.GPSPosition</entry>\r
 275             <entry>Latitude, Longitude</entry>\r
 276           </row>\r
 277           <row>\r
 278             <entry>formatted.localtime</entry>\r
 279             <entry>\r
 280               Local time corrected for UTC offset, DST correction\r
 281               <footnote id='ref1'>\r
 282                 <para>\r
 283                   Refer to\r
 284                   <link linkend="GuideReferenceUTC">UTC and DST</link>\r
 285                   section.\r
 286                 </para>\r
 287               </footnote>\r
 288             </entry>\r
 289           </row>\r
 290           <row>\r
 291             <entry>formatted.timezone</entry>\r
 292             <entry>\r
 293               Timezone indicated by GPS lat/long values\r
 294               <footnote id='ref1'>\r
 295                 <para>\r
 296                   Refer to\r
 297                   <link linkend="GuideReferenceUTC">UTC and DST</link>\r
 298                   section.\r
 299                 </para>\r
 300               </footnote>\r
 301             </entry>\r
 302           </row>\r
 303           <row>\r
 304             <entry>formatted.countryname</entry>\r
 305             <entry>ISO 3166 country name indicated by GPS lat/long values</entry>\r
 306           </row>\r
 307           <row>\r
 308             <entry>formatted.countrycode</entry>\r
 309             <entry>ISO 3166 two-letter abbreviated country name indicated by GPS lat/long values</entry>\r
 310           </row>\r
 311           <row>\r
 312             <entry>file.size</entry>\r
 313             <entry>file size in bytes</entry>\r
 314           </row>\r
 315           <row>\r
 316             <entry>file.date</entry>\r
 317             <entry>file date and time in human readable form</entry>\r
 318           </row>\r
 319           <row>\r
 320             <entry>file.mode</entry>\r
 321             <entry>file mode flags</entry>\r
 322           </row>\r
 323           <row>\r
 324             <entry>file.ctime</entry>\r
 325             <entry>refer to operating system documentation for the meaning of ctime</entry>\r
 326           </row>\r
 327           <row>\r
 328             <entry>file.owner</entry>\r
 329             <entry>the file's owner. Refer to operating system documentation for the meaning of file permissions</entry>\r
 330           </row>\r
 331           <row>\r
 332             <entry>file.group</entry>\r
 333             <entry>the file's group. Refer to operating system documentation for the meaning of file permissions</entry>\r
 334           </row>\r
 335           <row>\r
 336             <entry>file.class</entry>\r
 337             <entry>the file's class e.g. Image, RAW image etc.</entry>\r
 338           </row>\r
 339           <row>\r
 340             <entry>file.link</entry>\r
 341             <entry>if the file is a symbolic link, shows the path of the source file</entry>\r
 342           </row>\r
 343           <row>\r
 344             <entry>lua.&lt;lua script&gt;</entry>\r
 345             <entry>\r
 346               Call a lua script\r
 347               <footnote id='lua_ref1'>The output is expected to be text.</footnote>\r
 348             </entry>\r
 349           </row>\r
 350         </tbody>\r
 351       </tgroup>\r
 352     </table>\r
 353     <para>Right-clicking on an item opens the context menu:</para>\r
 354     <variablelist>\r
 355       <varlistentry>\r
 356         <term>\r
 357           <guilabel>Add entry</guilabel>\r
 358         </term>\r
 359         <listitem>\r
 360           <variablelist>\r
 361             <varlistentry>\r
 362               <term>\r
 363                 <guilabel>Key</guilabel>\r
 364               </term>\r
 365               <listitem>\r
 366                 <para>\r
 367                   Exif, IPTC, XMP or\r
 368                   <link linkend="formatted_exif">Geeqie formatted exif</link>\r
 369                   tags.\r
 370                 </para>\r
 371               </listitem>\r
 372             </varlistentry>\r
 373             <varlistentry>\r
 374               <term>\r
 375                 <guilabel>Title</guilabel>\r
 376               </term>\r
 377               <listitem>\r
 378                 <para>Displayed title text.</para>\r
 379               </listitem>\r
 380             </varlistentry>\r
 381             <varlistentry>\r
 382               <term>\r
 383                 <guilabel>Show only if set</guilabel>\r
 384               </term>\r
 385               <listitem>\r
 386                 <para>Inhibit display if the tag is empty.</para>\r
 387               </listitem>\r
 388             </varlistentry>\r
 389             <varlistentry>\r
 390               <term>\r
 391                 <guilabel>Editable</guilabel>\r
 392               </term>\r
 393               <listitem>\r
 394                 <para>Displays the value as editable.</para>\r
 395                 <note>\r
 396                   <para>Geeqie internally converts Exif and IPTC metadata to XMP on read and back on write, thus any changes made to Exif and IPTC here will be lost on write. You must edit the corresponding XMP instead.</para>\r
 397                   <para>An exception is Makernote tags which don't have an equivalent in XMP. However Makernotes cannot be written to an external file (a sidecar or Geeqie metadata file).</para>\r
 398                 </note>\r
 399               </listitem>\r
 400             </varlistentry>\r
 401           </variablelist>\r
 402         </listitem>\r
 403       </varlistentry>\r
 404       <varlistentry>\r
 405         <term>\r
 406           <guilabel>Show hidden</guilabel>\r
 407         </term>\r
 408         <listitem>\r
 409           Shows all entries regardless of\r
 410           <emphasis>Show only if set</emphasis>\r
 411           .\r
 412         </listitem>\r
 413       </varlistentry>\r
 414     </variablelist>\r
 415     <para />\r
 416   </section>\r
 417   <section id="GPSMap">\r
 418     <title>Map Display</title>\r
 419     <para>\r
 420       Geeqie can display maps created by the\r
 421       <ulink url="https://www.openstreetmap.org">openstreetmap.org</ulink>\r
 422       . To use this facility, Geeqie must have been compiled with the --enable-map option.\r
 423     </para>\r
 424     <itemizedlist spacing="compact">\r
 425       <listitem>\r
 426         <para>\r
 427           Image location display\r
 428           <para />\r
 429           All geocoded images in the currently displayed folder will show as small icons on the map. Clicking the icon will expand the icon to show an image thumbnail, plus other pre-defined image data.\r
 430         </para>\r
 431         <para>Right-click on the map will show other map options.</para>\r
 432         <para>Middle-click controls the map-centering function.</para>\r
 433       </listitem>\r
 434       <listitem>\r
 435         <para>\r
 436           Geo-coded search\r
 437           <para />\r
 438           Left-click stores the latitude/longitude under the cursor into the clipboard. This may be used to define the origin of a\r
 439           <link linkend="Searchparameters">geocode search</link>\r
 440           .\r
 441         </para>\r
 442       </listitem>\r
 443       <listitem>\r
 444         <para>\r
 445           Geo-coding Images\r
 446           <para />\r
 447           If an image is not geocoded, the filename or icon on the file pane can be dragged-and-dropped onto the map. The image latitude and longitude xmp meta-data will be updated to the drop position on the map.\r
 448         </para>\r
 449       </listitem>\r
 450       <listitem>\r
 451         <para>\r
 452           Map Centering\r
 453           <para />\r
 454           If an internet URL containg a valid latitude and longitude is dropped on the map, the map will be re-centered on that location. The zoom level will not change. Refer to\r
 455           <link linkend="GuideReferenceDecodeLatLong">Decoding Latitude and Longitude</link>\r
 456           .\r
 457         </para>\r
 458       </listitem>\r
 459     </itemizedlist>\r
 460   </section>\r
 461 </section>\r