Local time - UTC offset and daylight saving correction
[geeqie.git] / doc / docbook / GuideReferenceTags.xml
1 <?xml version="1.0" encoding="utf-8"?>\r
2 <section id="GuideReferenceXmpExif">\r
3   <title id="titleGuideReferenceXmpExif">XMP, Exif and IPTC</title>\r
4   <para>The tables below show the XMP, Exif and IPTC tags used by Geeqie.</para>\r
5   <section id="preformatted">\r
6     <title>Geeqie pre-formatted tags</title>\r
7     <table frame="all">\r
8       <title>Pre-formatted tags</title>\r
9       <tgroup cols="3" rowsep="1" colsep="1">\r
10         <thead>\r
11           <row>\r
12             <entry>\r
13               <para>Geeqie Tag</para>\r
14             </entry>\r
15             <entry>\r
16               <para>Exif tags used</para>\r
17             </entry>\r
18             <entry>\r
19               <para>Description</para>\r
20             </entry>\r
21           </row>\r
22         </thead>\r
23         <tbody>\r
24           <row>\r
25             <entry>\r
26               <para>formatted.Camera</para>\r
27             </entry>\r
28             <entry>\r
29               <para>\r
30                 Exif.Image.Make\r
31                 <para />\r
32                 Exif.Image.Model\r
33                 <para />\r
34                 Exif.Image.Software\r
35               </para>\r
36             </entry>\r
37             <entry>\r
38               <para>Camera and software name</para>\r
39             </entry>\r
40           </row>\r
41           <row>\r
42             <entry>\r
43               <para>formatted.DateTime</para>\r
44             </entry>\r
45             <entry>\r
46               <para>\r
47                 Exif.Photo.DateTimeOriginal\r
48                 <para />\r
49                 Exif.Photo.SubSecTimeOriginal\r
50                 <para />\r
51                 Exif.Image.DateTime\r
52                 <para />\r
53                 Exif.Photo.SubSecTime\r
54               </para>\r
55             </entry>\r
56             <entry>\r
57               <para>Image Date</para>\r
58             </entry>\r
59           </row>\r
60           <row>\r
61             <entry>\r
62               <para>formatted.ShutterSpeed</para>\r
63             </entry>\r
64             <entry>\r
65               <para>\r
66                 Exif.Photo.ExposureTime\r
67                 <para />\r
68                 Exif.Photo.ShutterSpeedValue\r
69 \r
70               </para>\r
71             </entry>\r
72             <entry>\r
73               <para>Shutter speed in seconds (e.g. 1/60s)</para>\r
74             </entry>\r
75           </row>\r
76           <row>\r
77             <entry>\r
78               <para>formatted.Aperture</para>\r
79             </entry>\r
80             <entry>\r
81               <para>\r
82                 <para>\r
83                   Exif.Photo.Fnumber\r
84                   <para />\r
85                   Exif.Photo.ApertureValue\r
86                 </para>\r
87               </para>\r
88             </entry>\r
89             <entry>\r
90               <para>Aperture (e.g. f5.6)</para>\r
91             </entry>\r
92           </row>\r
93           <row>\r
94             <entry>\r
95               <para>formatted.ExposureBias</para>\r
96             </entry>\r
97             <entry>\r
98               <para>Exif.Photo.ExposureBiasValue</para>\r
99             </entry>\r
100             <entry>\r
101               <para>Exposure bias (e.g. +0.3)</para>\r
102             </entry>\r
103           </row>\r
104           <row>\r
105             <entry>\r
106               <para>formatted.ISOSpeedRating</para>\r
107             </entry>\r
108             <entry>\r
109               <para>Exif.Photo.ISOSpeedRatings</para>\r
110             </entry>\r
111             <entry>\r
112               <para>ISO sensitivity (e.g. 100)</para>\r
113             </entry>\r
114           </row>\r
115           <row>\r
116             <entry>\r
117               <para>formatted.FocalLength</para>\r
118             </entry>\r
119             <entry>\r
120               <para>Exif.Photo.FocalLength</para>\r
121             </entry>\r
122             <entry>\r
123               <para>Focal length</para>\r
124             </entry>\r
125           </row>\r
126           <row>\r
127             <entry>\r
128               <para>formatted.FocalLength35mmFilm</para>\r
129             </entry>\r
130             <entry>\r
131               <para>\r
132                 Exif.Photo.FocalLengthIn35mmFilm\r
133                 <para />\r
134                 Exif.Photo.FocalLength\r
135                 <para />\r
136                 Exif.Photo.FocalPlaneXResolution\r
137                 <para />\r
138                 Exif.Photo.FocalPlaneYResolution\r
139                 <para />\r
140                 Exif.Photo.FocalPlaneResolutionUnit\r
141                 <para />\r
142                 Exif.Photo.PixelXDimension\r
143                 <para />\r
144                 Exif.Photo.PixelYDimension\r
145 \r
146               </para>\r
147             </entry>\r
148             <entry>\r
149               <para>Focal length 35mm</para>\r
150             </entry>\r
151           </row>\r
152           <row>\r
153             <entry>\r
154               <para>formatted.SubjectDistance</para>\r
155             </entry>\r
156             <entry>\r
157               <para>Exif.Photo.SubjectDistance</para>\r
158             </entry>\r
159             <entry>\r
160               <para>Subject distance</para>\r
161             </entry>\r
162           </row>\r
163           <row>\r
164             <entry>\r
165               <para>formatted.Flash</para>\r
166             </entry>\r
167             <entry>\r
168               <para>Exif.Photo.Flash</para>\r
169             </entry>\r
170             <entry>\r
171               <para>Flash</para>\r
172             </entry>\r
173           </row>\r
174           <row>\r
175             <entry>\r
176               <para>formatted.Resolution</para>\r
177             </entry>\r
178             <entry>\r
179               <para>\r
180                 Exif.Image.Xresolution\r
181                 <para />\r
182                 Exif.Image.Yresolution\r
183                 <para />\r
184                 Exif.Image.ResolutionUnit\r
185               </para>\r
186             </entry>\r
187             <entry>\r
188               <para>Resolution</para>\r
189             </entry>\r
190           </row>\r
191           <row>\r
192             <entry>\r
193               <para>formatted.ColorProfile</para>\r
194             </entry>\r
195             <entry>\r
196               <para>\r
197                 Exif.Image.InterColorProfile\r
198                 <para />\r
199                 Exif.Photo.ColorSpace\r
200                 <para />\r
201                 Exif.Iop.InteroperabilityIndex\r
202               </para>\r
203             </entry>\r
204             <entry>\r
205               <para>Color profile</para>\r
206             </entry>\r
207           </row>\r
208           <row>\r
209             <entry>\r
210               <para>formatted.GPSAltitude</para>\r
211             </entry>\r
212             <entry>\r
213               <para>\r
214                 Exif.GPSInfo.GPSAltitudeRef\r
215                 <para />\r
216                 Exif.GPSInfo.GPSAltitude\r
217               </para>\r
218             </entry>\r
219             <entry>\r
220               <para>Altitude above sea level</para>\r
221             </entry>\r
222           </row>\r
223           <row>\r
224             <entry>\r
225               <para>formatted.GPSPosition</para>\r
226             </entry>\r
227             <entry>\r
228               <para>\r
229                 Exif.GPSInfo.GPSLatitude\r
230                 <para />\r
231                 Exif.GPSInfo.GPSLatitudeRef\r
232                 <para />\r
233                 Exif.GPSInfo.GPSLongitude\r
234                 <para />\r
235                 Exif.GPSInfo.GPSLongitudeRef\r
236               </para>\r
237             </entry>\r
238             <entry>\r
239               <para>Latitude, Longitude</para>\r
240             </entry>\r
241           </row>\r
242           <row>\r
243             <entry>\r
244               <para>formatted.localtime</para>\r
245             </entry>\r
246             <entry>\r
247               <para>\r
248                 Exif.GPSInfo.GPSLatitude\r
249                 <para />\r
250                 Exif.GPSInfo.GPSLatitudeRef\r
251                 <para />\r
252                 Exif.GPSInfo.GPSLongitude\r
253                 <para />\r
254                 Exif.GPSInfo.GPSLongitudeRef\r
255                 <para />\r
256                 Exif.GPSInfo.GPSDateStamp\r
257                 <para />\r
258                 Exif.GPSInfo.GPSTimeStamp\r
259               </para>\r
260             </entry>\r
261             <entry>\r
262               <para>\r
263                 Local time corrected for UTC offset, DST correction\r
264                 <footnote id='ref1'>\r
265                   <para>\r
266                     Refer to\r
267                     <link linkend="GuideReferenceUTC">UTC and DST</link>\r
268                     section.\r
269                   </para>\r
270                 </footnote>\r
271               </para>\r
272             </entry>\r
273           </row>\r
274           <row>\r
275             <entry>\r
276               <para>formatted.timezone</para>\r
277             </entry>\r
278             <entry>\r
279               <para>\r
280                 Exif.GPSInfo.GPSLatitude\r
281                 <para />\r
282                 Exif.GPSInfo.GPSLatitudeRef\r
283                 <para />\r
284                 Exif.GPSInfo.GPSLongitude\r
285                 <para />\r
286                 Exif.GPSInfo.GPSLongitudeRef\r
287               </para>\r
288             </entry>\r
289             <entry>\r
290               <para>\r
291                 Timezone indicated by lat/long\r
292                 <footnote id='ref1'>\r
293                   <para>\r
294                     Refer to\r
295                     <link linkend="GuideReferenceUTC">UTC and DST</link>\r
296                     section.\r
297                   </para>\r
298                 </footnote>\r
299               </para>\r
300             </entry>\r
301           </row>\r
302         </tbody>\r
303       </tgroup>\r
304     </table>\r
305   </section>\r
306   <section id="infosidebar">\r
307     <title>Info sidebar panes</title>\r
308     <table frame="all">\r
309       <title>Fixed panes</title>\r
310       <tgroup cols="2" rowsep="1" colsep="1">\r
311         <thead>\r
312           <row>\r
313             <entry>\r
314               <para>Tag</para>\r
315             </entry>\r
316             <entry>\r
317               <para>Pane title</para>\r
318             </entry>\r
319           </row>\r
320         </thead>\r
321         <tbody>\r
322           <row>\r
323             <entry>\r
324               <para>Xmp.dc.description</para>\r
325             </entry>\r
326             <entry>\r
327               <para>Comment</para>\r
328             </entry>\r
329           </row>\r
330           <row>\r
331             <entry>\r
332               <para>Xmp.dc.subject</para>\r
333             </entry>\r
334             <entry>\r
335               <para>Keywords</para>\r
336             </entry>\r
337           </row>\r
338           <row>\r
339             <entry>\r
340               <para>Xmp.dc.title</para>\r
341             </entry>\r
342             <entry>\r
343               <para>Title</para>\r
344             </entry>\r
345           </row>\r
346           <row>\r
347             <entry>\r
348               <para>Xmp.xmp.Rating</para>\r
349             </entry>\r
350             <entry>\r
351               <para>Rating</para>\r
352             </entry>\r
353           </row>\r
354         </tbody>\r
355       </tgroup>\r
356     </table>\r
357     <table frame="all">\r
358       <title>Location and GPS pane</title>\r
359       <tgroup cols="2" rowsep="1" colsep="1">\r
360         <thead>\r
361           <row>\r
362             <entry>\r
363               <para>Tag</para>\r
364             </entry>\r
365             <entry>\r
366               <para>Field</para>\r
367             </entry>\r
368           </row>\r
369         </thead>\r
370         <tbody>\r
371           <row>\r
372             <entry>\r
373               <para>formatted.GPSPosition</para>\r
374             </entry>\r
375             <entry>\r
376               <para>GPS position</para>\r
377             </entry>\r
378           </row>\r
379           <row>\r
380             <entry>\r
381               <para>formatted.GPSAltitude</para>\r
382             </entry>\r
383             <entry>\r
384               <para>GPS altitiude</para>\r
385             </entry>\r
386           </row>\r
387           <row>\r
388             <entry>\r
389               <para>formatted.timezone</para>\r
390             </entry>\r
391             <entry>\r
392               <para>Time zone</para>\r
393             </entry>\r
394           </row>\r
395           <row>\r
396             <entry>\r
397               <para>Xmp.photoshop.Country</para>\r
398             </entry>\r
399             <entry>\r
400               <para>Country</para>\r
401             </entry>\r
402           </row>\r
403           <row>\r
404             <entry>\r
405               <para>\r
406                 <para>Xmp.iptc.CountryCode</para>\r
407               </para>\r
408             </entry>\r
409             <entry>\r
410               <para>Country Code</para>\r
411             </entry>\r
412           </row>\r
413           <row>\r
414             <entry>\r
415               <para>Xmp.photoshop.State</para>\r
416             </entry>\r
417             <entry>\r
418               <para>State</para>\r
419             </entry>\r
420           </row>\r
421           <row>\r
422             <entry>\r
423               <para>Xmp.photoshop.City</para>\r
424             </entry>\r
425             <entry>\r
426               <para>City</para>\r
427             </entry>\r
428           </row>\r
429           <row>\r
430             <entry>\r
431               <para>Xmp.iptc.Location</para>\r
432             </entry>\r
433             <entry>\r
434               <para>Location</para>\r
435             </entry>\r
436           </row>\r
437         </tbody>\r
438       </tgroup>\r
439     </table>\r
440     <table frame="all">\r
441       <title>Copyright pane</title>\r
442       <tgroup cols="2" rowsep="1" colsep="1">\r
443         <thead>\r
444           <row>\r
445             <entry>\r
446               <para>Tag</para>\r
447             </entry>\r
448             <entry>\r
449               <para>Field</para>\r
450             </entry>\r
451           </row>\r
452         </thead>\r
453         <tbody>\r
454           <row>\r
455             <entry>\r
456               <para>Xmp.dc.creator</para>\r
457             </entry>\r
458             <entry>\r
459               <para>Creator</para>\r
460             </entry>\r
461           </row>\r
462           <row>\r
463             <entry>\r
464               <para>Xmp.dc.contributor</para>\r
465             </entry>\r
466             <entry>\r
467               <para>Contributor</para>\r
468             </entry>\r
469           </row>\r
470           <row>\r
471             <entry>\r
472               <para>Xmp.dc.rights</para>\r
473             </entry>\r
474             <entry>\r
475               <para>Rights</para>\r
476             </entry>\r
477           </row>\r
478         </tbody>\r
479       </tgroup>\r
480     </table>\r
481     <table frame="all">\r
482       <title>Exif pane</title>\r
483       <tgroup cols="2" rowsep="1" colsep="1">\r
484         <thead>\r
485           <row>\r
486             <entry>\r
487               <para>Tag</para>\r
488             </entry>\r
489             <entry>\r
490               <para>Field</para>\r
491             </entry>\r
492           </row>\r
493         </thead>\r
494         <tbody>\r
495           <row>\r
496             <entry>\r
497               <para>formatted.Camera</para>\r
498             </entry>\r
499             <entry>\r
500               <para>Camera</para>\r
501             </entry>\r
502           </row>\r
503           <row>\r
504             <entry>\r
505               <para>formatted.DateTime</para>\r
506             </entry>\r
507             <entry>\r
508               <para>Date</para>\r
509             </entry>\r
510           </row>\r
511           <row>\r
512             <entry>\r
513               <para>formatted.localtime</para>\r
514             </entry>\r
515             <entry>\r
516               <para>Local time</para>\r
517             </entry>\r
518           </row>\r
519           <row>\r
520             <entry>\r
521               <para>formatted.ShutterSpeed</para>\r
522             </entry>\r
523             <entry>\r
524               <para>Shutter speed</para>\r
525             </entry>\r
526           </row>\r
527           <row>\r
528             <entry>\r
529               <para>formatted.Aperture</para>\r
530             </entry>\r
531             <entry>\r
532               <para>Aperture</para>\r
533             </entry>\r
534           </row>\r
535           <row>\r
536             <entry>\r
537               <para>formatted.ExposureBias</para>\r
538             </entry>\r
539             <entry>\r
540               <para>Exposure bias</para>\r
541             </entry>\r
542           </row>\r
543           <row>\r
544             <entry>\r
545               <para>formatted.ISOSpeedRating</para>\r
546             </entry>\r
547             <entry>\r
548               <para>ISO sensitivity</para>\r
549             </entry>\r
550           </row>\r
551           <row>\r
552             <entry>\r
553               <para>formatted.FocalLength</para>\r
554             </entry>\r
555             <entry>\r
556               <para>Focal length</para>\r
557             </entry>\r
558           </row>\r
559           <row>\r
560             <entry>\r
561               <para>formatted.FocalLength35mmFilm</para>\r
562             </entry>\r
563             <entry>\r
564               <para>Focal length 35mm</para>\r
565             </entry>\r
566           </row>\r
567           <row>\r
568             <entry>\r
569               <para>formatted.SubjectDistance</para>\r
570             </entry>\r
571             <entry>\r
572               <para>Subject distance</para>\r
573             </entry>\r
574           </row>\r
575           <row>\r
576             <entry>\r
577               <para>formatted.Flash</para>\r
578             </entry>\r
579             <entry>\r
580               <para>Flash</para>\r
581             </entry>\r
582           </row>\r
583           <row>\r
584             <entry>\r
585               <para>formatted.Resolution</para>\r
586             </entry>\r
587             <entry>\r
588               <para>Resolution</para>\r
589             </entry>\r
590           </row>\r
591           <row>\r
592             <entry>\r
593               <para>formatted.ColorProfile</para>\r
594             </entry>\r
595             <entry>\r
596               <para>Color profile</para>\r
597             </entry>\r
598           </row>\r
599           <row>\r
600             <entry>\r
601               <para>Exif.Photo.ExposureProgram</para>\r
602             </entry>\r
603             <entry>\r
604               <para>Exposure Program</para>\r
605             </entry>\r
606           </row>\r
607           <row>\r
608             <entry>\r
609               <para>Exif.Photo.MeteringMode</para>\r
610             </entry>\r
611             <entry>\r
612               <para>Metering Mode</para>\r
613             </entry>\r
614           </row>\r
615           <row>\r
616             <entry>\r
617               <para>Exif.Photo.LightSource</para>\r
618             </entry>\r
619             <entry>\r
620               <para>Light Source</para>\r
621             </entry>\r
622           </row>\r
623         </tbody>\r
624       </tgroup>\r
625     </table>\r
626   </section>\r
627   <section id="exifiptc">\r
628     <title>Exif IPTC alternative keys</title>\r
629     <table frame="all">\r
630       <title>Conversion table</title>\r
631       <tgroup cols="2" rowsep="1" colsep="1">\r
632         <thead>\r
633           <row>\r
634             <entry>\r
635               <para>Tag</para>\r
636             </entry>\r
637             <entry>\r
638               <para>Field</para>\r
639             </entry>\r
640           </row>\r
641         </thead>\r
642         <tbody>\r
643           <row>\r
644             <entry>\r
645               <para>Xmp.tiff.Orientation</para>\r
646             </entry>\r
647             <entry>\r
648               <para>Exif.Image.Orientation</para>\r
649             </entry>\r
650           </row>\r
651           <row>\r
652             <entry>\r
653               <para>Xmp.dc.title</para>\r
654             </entry>\r
655             <entry>\r
656               <para>Iptc.Application2.ObjectName</para>\r
657             </entry>\r
658           </row>\r
659           <row>\r
660             <entry>\r
661               <para>Xmp.photoshop.Urgency</para>\r
662             </entry>\r
663             <entry>\r
664               <para>Iptc.Application2.Urgency</para>\r
665             </entry>\r
666           </row>\r
667           <row>\r
668             <entry>\r
669               <para>Xmp.photoshop.Category</para>\r
670             </entry>\r
671             <entry>\r
672               <para>Iptc.Application2.Category</para>\r
673             </entry>\r
674           </row>\r
675           <row>\r
676             <entry>\r
677               <para>Xmp.photoshop.SupplementalCategory</para>\r
678             </entry>\r
679             <entry>\r
680               <para>Iptc.Application2.SuppCategory</para>\r
681             </entry>\r
682           </row>\r
683           <row>\r
684             <entry>\r
685               <para>Xmp.dc.subject</para>\r
686             </entry>\r
687             <entry>\r
688               <para>Iptc.Application2.Keywords</para>\r
689             </entry>\r
690           </row>\r
691           <row>\r
692             <entry>\r
693               <para>Xmp.iptc.Location</para>\r
694             </entry>\r
695             <entry>\r
696               <para>Iptc.Application2.LocationName</para>\r
697             </entry>\r
698           </row>\r
699           <row>\r
700             <entry>\r
701               <para>Xmp.photoshop.Instruction</para>\r
702             </entry>\r
703             <entry>\r
704               <para>Iptc.Application2.SpecialInstructions</para>\r
705             </entry>\r
706           </row>\r
707           <row>\r
708             <entry>\r
709               <para>Xmp.photoshop.DateCreated</para>\r
710             </entry>\r
711             <entry>\r
712               <para>Iptc.Application2.DateCreated</para>\r
713             </entry>\r
714           </row>\r
715           <row>\r
716             <entry>\r
717               <para>Xmp.dc.creator</para>\r
718             </entry>\r
719             <entry>\r
720               <para>Iptc.Application2.Byline</para>\r
721             </entry>\r
722           </row>\r
723           <row>\r
724             <entry>\r
725               <para>Xmp.photoshop.AuthorsPosition</para>\r
726             </entry>\r
727             <entry>\r
728               <para>Iptc.Application2.BylineTitle</para>\r
729             </entry>\r
730           </row>\r
731           <row>\r
732             <entry>\r
733               <para>Xmp.photoshop.City</para>\r
734             </entry>\r
735             <entry>\r
736               <para>Iptc.Application2.City</para>\r
737             </entry>\r
738           </row>\r
739           <row>\r
740             <entry>\r
741               <para>Xmp.photoshop.State</para>\r
742             </entry>\r
743             <entry>\r
744               <para>Iptc.Application2.ProvinceState</para>\r
745             </entry>\r
746           </row>\r
747           <row>\r
748             <entry>\r
749               <para>Xmp.iptc.CountryCode</para>\r
750             </entry>\r
751             <entry>\r
752               <para>Iptc.Application2.CountryCode</para>\r
753             </entry>\r
754           </row>\r
755           <row>\r
756             <entry>\r
757               <para>Xmp.photoshop.Country</para>\r
758             </entry>\r
759             <entry>\r
760               <para>Iptc.Application2.CountryName</para>\r
761             </entry>\r
762           </row>\r
763           <row>\r
764             <entry>\r
765               <para>Xmp.photoshop.TransmissionReference</para>\r
766             </entry>\r
767             <entry>\r
768               <para>Iptc.Application2.TransmissionReference</para>\r
769             </entry>\r
770           </row>\r
771           <row>\r
772             <entry>\r
773               <para>Xmp.photoshop.Headline</para>\r
774             </entry>\r
775             <entry>\r
776               <para>Iptc.Application2.Headline</para>\r
777             </entry>\r
778           </row>\r
779           <row>\r
780             <entry>\r
781               <para>Xmp.photoshop.Credit</para>\r
782             </entry>\r
783             <entry>\r
784               <para>Iptc.Application2.Credit</para>\r
785             </entry>\r
786           </row>\r
787           <row>\r
788             <entry>\r
789               <para>Xmp.photoshop.Source</para>\r
790             </entry>\r
791             <entry>\r
792               <para>Iptc.Application2.Source</para>\r
793             </entry>\r
794           </row>\r
795           <row>\r
796             <entry>\r
797               <para>Xmp.dc.rights</para>\r
798             </entry>\r
799             <entry>\r
800               <para>Iptc.Application2.Copyright</para>\r
801             </entry>\r
802           </row>\r
803           <row>\r
804             <entry>\r
805               <para>Xmp.dc.description</para>\r
806             </entry>\r
807             <entry>\r
808               <para>Iptc.Application2.Caption</para>\r
809             </entry>\r
810           </row>\r
811           <row>\r
812             <entry>\r
813               <para>Xmp.photoshop.CaptionWriter</para>\r
814             </entry>\r
815             <entry>\r
816               <para>Iptc.Application2.Writer</para>\r
817             </entry>\r
818           </row>\r
819         </tbody>\r
820       </tgroup>\r
821     </table>\r
822   </section>\r
823 </section>\r