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