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>Right-click on the left-hand box allows the 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.</para>\r
 118     <para>\r
 119       Right-click on the right-hand box allows a connection to be made between a keyword and a mark. The\r
 120       <link linkend="GuideImageMarks" endterm="titleGuideImageMarks" />\r
 121       section shows how marks and keywords inter-operate.\r
 122     </para>\r
 123     <para>The ordering of keywords in the right-hand box may be changed by drag-and-drop.</para>\r
 124     <para>\r
 125       The meta-data write operation for a file is triggered either\r
 126       <link linkend="Buttons">manually</link>\r
 127       or as defined in\r
 128       <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />\r
 129       .\r
 130     </para>\r
 131     <para />\r
 132   </section>\r
 133   <section id="Listpanes-ExifFileinfoCopyrightLocationandGPS">\r
 134     <title id="titleExif">List panes</title>\r
 135     <para>\r
 136       There are five list panes, whose contents can be configured to display Exif, XMP or IPTC metadata tags. The five panes are:\r
 137       <itemizedlist>\r
 138         <listitem>Title</listitem>\r
 139         <listitem>Exif</listitem>\r
 140         <listitem>File Info</listitem>\r
 141         <listitem>Location and GPS</listitem>\r
 142         <listitem>Copyright</listitem>\r
 143       </itemizedlist>\r
 144     </para>\r
 145     <para>Any metadata tag can be displayed in any pane - the pane titles merely exist as an organisational aide.</para>\r
 146     <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
 147     <para>\r
 148       <note>It is not possible to undo these actions, nor is there a way to reset the display to its original settings.</note>\r
 149     </para>\r
 150     <para>\r
 151       It is also possible to drag new items from the\r
 152       <link linkend="GuideOtherWindowsExif" endterm="titleGuideOtherWindowsExif" />\r
 153       onto any pane.\r
 154     </para>\r
 155     <para>As an aide, in addition to standard metadata tags, Geeqie provides certain pre-formatted tags. These are:</para>\r
 156     <table id="formatted_exif">\r
 157       <tgroup cols="2" rowsep="1" colsep="1">\r
 158         <tbody>\r
 159           <row>\r
 160             <entry>\r
 161               <emphasis role="strong">Tag</emphasis>\r
 162             </entry>\r
 163             <entry>\r
 164               <emphasis role="strong">Replaced by Meta data</emphasis>\r
 165             </entry>\r
 166           </row>\r
 167           <row>\r
 168             <entry>formatted.Camera</entry>\r
 169             <entry>Camera and sofware name</entry>\r
 170           </row>\r
 171           <row>\r
 172             <entry>formatted.DateTime</entry>\r
 173             <entry>Image Date</entry>\r
 174           </row>\r
 175           <row>\r
 176             <entry>formatted.ShutterSpeed</entry>\r
 177             <entry>Shutter speed in seconds (e.g. 1/60s)</entry>\r
 178           </row>\r
 179           <row>\r
 180             <entry>formatted.Aperture</entry>\r
 181             <entry>Aperture (e.g. f5.6)</entry>\r
 182           </row>\r
 183           <row>\r
 184             <entry>formatted.ExposureBias</entry>\r
 185             <entry>Exposure bias (e.g. +0.3)</entry>\r
 186           </row>\r
 187           <row>\r
 188             <entry>formatted.ISOSpeedRating</entry>\r
 189             <entry>ISO sensitivity (e.g. 100)</entry>\r
 190           </row>\r
 191           <row>\r
 192             <entry>formatted.FocalLength</entry>\r
 193             <entry>Focal length</entry>\r
 194           </row>\r
 195           <row>\r
 196             <entry>formatted.FocalLength35mmFilm</entry>\r
 197             <entry>Focal length 35mm</entry>\r
 198           </row>\r
 199           <row>\r
 200             <entry>formatted.SubjectDistance</entry>\r
 201             <entry>Subject distance</entry>\r
 202           </row>\r
 203           <row>\r
 204             <entry>formatted.Flash</entry>\r
 205             <entry>Flash</entry>\r
 206           </row>\r
 207           <row>\r
 208             <entry>formatted.Resolution</entry>\r
 209             <entry>Resolution</entry>\r
 210           </row>\r
 211           <row>\r
 212             <entry>formatted.ColorProfile</entry>\r
 213             <entry>Color profile</entry>\r
 214           </row>\r
 215           <row>\r
 216             <entry>formatted.GPSAltitude</entry>\r
 217             <entry>Altitude above sea level</entry>\r
 218           </row>\r
 219           <row>\r
 220             <entry>formatted.GPSPosition</entry>\r
 221             <entry>Latitude, Longitude</entry>\r
 222           </row>\r
 223           <row>\r
 224             <entry>file.size</entry>\r
 225             <entry>file size in bytes</entry>\r
 226           </row>\r
 227           <row>\r
 228             <entry>file.date</entry>\r
 229             <entry>file date and time in human readable form</entry>\r
 230           </row>\r
 231           <row>\r
 232             <entry>file.mode</entry>\r
 233             <entry>file mode flags</entry>\r
 234           </row>\r
 235         </tbody>\r
 236       </tgroup>\r
 237     </table>\r
 238     <para>Right-clicking on an item opens the context menu:</para>\r
 239     <variablelist>\r
 240       <varlistentry>\r
 241         <term>\r
 242           <guilabel>Add entry</guilabel>\r
 243         </term>\r
 244         <listitem>\r
 245           <variablelist>\r
 246             <varlistentry>\r
 247               <term>\r
 248                 <guilabel>Key</guilabel>\r
 249               </term>\r
 250               <listitem>\r
 251                 <para>\r
 252                   Exif, IPTC, XMP or\r
 253                   <link linkend="formatted_exif">Geeqie formatted exif</link>\r
 254                   tags.\r
 255                 </para>\r
 256               </listitem>\r
 257             </varlistentry>\r
 258             <varlistentry>\r
 259               <term>\r
 260                 <guilabel>Title</guilabel>\r
 261               </term>\r
 262               <listitem>\r
 263                 <para>Displayed title text.</para>\r
 264               </listitem>\r
 265             </varlistentry>\r
 266             <varlistentry>\r
 267               <term>\r
 268                 <guilabel>Show only if set</guilabel>\r
 269               </term>\r
 270               <listitem>\r
 271                 <para>Inhibit display if the tag is empty.</para>\r
 272               </listitem>\r
 273             </varlistentry>\r
 274             <varlistentry>\r
 275               <term>\r
 276                 <guilabel>Editable</guilabel>\r
 277               </term>\r
 278               <listitem>\r
 279                 <para>Displays the value as editable.</para>\r
 280                 <note>\r
 281                   <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
 282                   <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
 283                 </note>\r
 284               </listitem>\r
 285             </varlistentry>\r
 286           </variablelist>\r
 287         </listitem>\r
 288       </varlistentry>\r
 289       <varlistentry>\r
 290         <term>\r
 291           <guilabel>Show hidden</guilabel>\r
 292         </term>\r
 293         <listitem>\r
 294           Shows all entries regardless of\r
 295           <emphasis>Show only if set</emphasis>\r
 296           .\r
 297         </listitem>\r
 298       </varlistentry>\r
 299     </variablelist>\r
 300     <para />\r
 301   </section>\r
 302   <section id="GPSMap">\r
 303     <title>Map Display</title>\r
 304     <para>\r
 305       Geeqie can display maps created by the\r
 306       <ulink url="https://www.openstreetmap.org">openstreetmap.org</ulink>\r
 307       . To use this facility, Geeqie must have been compiled with the --enable-map option.\r
 308     </para>\r
 309     <itemizedlist spacing="compact">\r
 310       <listitem>\r
 311         <para>\r
 312           Image location display\r
 313           <para />\r
 314           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
 315         </para>\r
 316         <para>Right-click on the map will show other map options.</para>\r
 317         <para>Middle-click controls the map-centering function.</para>\r
 318       </listitem>\r
 319       <listitem>\r
 320         <para>\r
 321           Geo-coded search\r
 322           <para />\r
 323           Left-click stores the latitude/longitude under the cursor into the clipboard. This may be used to define the origin of a\r
 324           <link linkend="Searchparameters">geocode search</link>\r
 325           .\r
 326         </para>\r
 327       </listitem>\r
 328       <listitem>\r
 329         <para>\r
 330           Geo-coding Images\r
 331           <para />\r
 332           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
 333         </para>\r
 334       </listitem>\r
 335       <listitem>\r
 336         <para>\r
 337           Map Centering\r
 338           <para />\r
 339           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
 340           <link linkend="GuideReferenceDecodeLatLong">Decoding Latitude and Longitude</link>\r
 341           .\r
 342         </para>\r
 343       </listitem>\r
 344     </itemizedlist>\r
 345   </section>\r
 346 </section>\r