f40b473738e4f6b06dfbc48107ed263bd236edba
[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           <row>\r
303             <entry>\r
304               <para>formatted.star_rating</para>\r
305             </entry>\r
306             <entry>\r
307               <para>Xmp.xmp.Rating</para>\r
308             </entry>\r
309             <entry>\r
310               <para>Rating shown as a set of ðŸŸŠ  characters</para>\r
311             </entry>\r
312           </row>\r
313         </tbody>\r
314       </tgroup>\r
315     </table>\r
316   </section>\r
317   <section id="infosidebar">\r
318     <title>Info sidebar panes</title>\r
319     <table frame="all">\r
320       <title>Fixed panes</title>\r
321       <tgroup cols="2" rowsep="1" colsep="1">\r
322         <thead>\r
323           <row>\r
324             <entry>\r
325               <para>Tag</para>\r
326             </entry>\r
327             <entry>\r
328               <para>Pane title</para>\r
329             </entry>\r
330           </row>\r
331         </thead>\r
332         <tbody>\r
333           <row>\r
334             <entry>\r
335               <para>Xmp.dc.description</para>\r
336             </entry>\r
337             <entry>\r
338               <para>Comment</para>\r
339             </entry>\r
340           </row>\r
341           <row>\r
342             <entry>\r
343               <para>Xmp.dc.subject</para>\r
344             </entry>\r
345             <entry>\r
346               <para>Keywords</para>\r
347             </entry>\r
348           </row>\r
349           <row>\r
350             <entry>\r
351               <para>Xmp.dc.title</para>\r
352             </entry>\r
353             <entry>\r
354               <para>Title</para>\r
355             </entry>\r
356           </row>\r
357           <row>\r
358             <entry>\r
359               <para>Xmp.xmp.Rating</para>\r
360             </entry>\r
361             <entry>\r
362               <para>Rating</para>\r
363             </entry>\r
364           </row>\r
365         </tbody>\r
366       </tgroup>\r
367     </table>\r
368     <table frame="all">\r
369       <title>Location and GPS pane</title>\r
370       <tgroup cols="2" rowsep="1" colsep="1">\r
371         <thead>\r
372           <row>\r
373             <entry>\r
374               <para>Tag</para>\r
375             </entry>\r
376             <entry>\r
377               <para>Field</para>\r
378             </entry>\r
379           </row>\r
380         </thead>\r
381         <tbody>\r
382           <row>\r
383             <entry>\r
384               <para>formatted.GPSPosition</para>\r
385             </entry>\r
386             <entry>\r
387               <para>GPS position</para>\r
388             </entry>\r
389           </row>\r
390           <row>\r
391             <entry>\r
392               <para>formatted.GPSAltitude</para>\r
393             </entry>\r
394             <entry>\r
395               <para>GPS altitiude</para>\r
396             </entry>\r
397           </row>\r
398           <row>\r
399             <entry>\r
400               <para>formatted.timezone</para>\r
401             </entry>\r
402             <entry>\r
403               <para>Time zone</para>\r
404             </entry>\r
405           </row>\r
406           <row>\r
407             <entry>\r
408               <para>Xmp.photoshop.Country</para>\r
409             </entry>\r
410             <entry>\r
411               <para>Country</para>\r
412             </entry>\r
413           </row>\r
414           <row>\r
415             <entry>\r
416               <para>\r
417                 <para>Xmp.iptc.CountryCode</para>\r
418               </para>\r
419             </entry>\r
420             <entry>\r
421               <para>Country Code</para>\r
422             </entry>\r
423           </row>\r
424           <row>\r
425             <entry>\r
426               <para>Xmp.photoshop.State</para>\r
427             </entry>\r
428             <entry>\r
429               <para>State</para>\r
430             </entry>\r
431           </row>\r
432           <row>\r
433             <entry>\r
434               <para>Xmp.photoshop.City</para>\r
435             </entry>\r
436             <entry>\r
437               <para>City</para>\r
438             </entry>\r
439           </row>\r
440           <row>\r
441             <entry>\r
442               <para>Xmp.iptc.Location</para>\r
443             </entry>\r
444             <entry>\r
445               <para>Location</para>\r
446             </entry>\r
447           </row>\r
448         </tbody>\r
449       </tgroup>\r
450     </table>\r
451     <table frame="all">\r
452       <title>Copyright pane</title>\r
453       <tgroup cols="2" rowsep="1" colsep="1">\r
454         <thead>\r
455           <row>\r
456             <entry>\r
457               <para>Tag</para>\r
458             </entry>\r
459             <entry>\r
460               <para>Field</para>\r
461             </entry>\r
462           </row>\r
463         </thead>\r
464         <tbody>\r
465           <row>\r
466             <entry>\r
467               <para>Xmp.dc.creator</para>\r
468             </entry>\r
469             <entry>\r
470               <para>Creator</para>\r
471             </entry>\r
472           </row>\r
473           <row>\r
474             <entry>\r
475               <para>Xmp.dc.contributor</para>\r
476             </entry>\r
477             <entry>\r
478               <para>Contributor</para>\r
479             </entry>\r
480           </row>\r
481           <row>\r
482             <entry>\r
483               <para>Xmp.dc.rights</para>\r
484             </entry>\r
485             <entry>\r
486               <para>Rights</para>\r
487             </entry>\r
488           </row>\r
489         </tbody>\r
490       </tgroup>\r
491     </table>\r
492     <table frame="all">\r
493       <title>Exif pane</title>\r
494       <tgroup cols="2" rowsep="1" colsep="1">\r
495         <thead>\r
496           <row>\r
497             <entry>\r
498               <para>Tag</para>\r
499             </entry>\r
500             <entry>\r
501               <para>Field</para>\r
502             </entry>\r
503           </row>\r
504         </thead>\r
505         <tbody>\r
506           <row>\r
507             <entry>\r
508               <para>formatted.Camera</para>\r
509             </entry>\r
510             <entry>\r
511               <para>Camera</para>\r
512             </entry>\r
513           </row>\r
514           <row>\r
515             <entry>\r
516               <para>formatted.DateTime</para>\r
517             </entry>\r
518             <entry>\r
519               <para>Date</para>\r
520             </entry>\r
521           </row>\r
522           <row>\r
523             <entry>\r
524               <para>formatted.localtime</para>\r
525             </entry>\r
526             <entry>\r
527               <para>Local time</para>\r
528             </entry>\r
529           </row>\r
530           <row>\r
531             <entry>\r
532               <para>formatted.ShutterSpeed</para>\r
533             </entry>\r
534             <entry>\r
535               <para>Shutter speed</para>\r
536             </entry>\r
537           </row>\r
538           <row>\r
539             <entry>\r
540               <para>formatted.Aperture</para>\r
541             </entry>\r
542             <entry>\r
543               <para>Aperture</para>\r
544             </entry>\r
545           </row>\r
546           <row>\r
547             <entry>\r
548               <para>formatted.ExposureBias</para>\r
549             </entry>\r
550             <entry>\r
551               <para>Exposure bias</para>\r
552             </entry>\r
553           </row>\r
554           <row>\r
555             <entry>\r
556               <para>formatted.ISOSpeedRating</para>\r
557             </entry>\r
558             <entry>\r
559               <para>ISO sensitivity</para>\r
560             </entry>\r
561           </row>\r
562           <row>\r
563             <entry>\r
564               <para>formatted.FocalLength</para>\r
565             </entry>\r
566             <entry>\r
567               <para>Focal length</para>\r
568             </entry>\r
569           </row>\r
570           <row>\r
571             <entry>\r
572               <para>formatted.FocalLength35mmFilm</para>\r
573             </entry>\r
574             <entry>\r
575               <para>Focal length 35mm</para>\r
576             </entry>\r
577           </row>\r
578           <row>\r
579             <entry>\r
580               <para>formatted.SubjectDistance</para>\r
581             </entry>\r
582             <entry>\r
583               <para>Subject distance</para>\r
584             </entry>\r
585           </row>\r
586           <row>\r
587             <entry>\r
588               <para>formatted.Flash</para>\r
589             </entry>\r
590             <entry>\r
591               <para>Flash</para>\r
592             </entry>\r
593           </row>\r
594           <row>\r
595             <entry>\r
596               <para>formatted.Resolution</para>\r
597             </entry>\r
598             <entry>\r
599               <para>Resolution</para>\r
600             </entry>\r
601           </row>\r
602           <row>\r
603             <entry>\r
604               <para>formatted.ColorProfile</para>\r
605             </entry>\r
606             <entry>\r
607               <para>Color profile</para>\r
608             </entry>\r
609           </row>\r
610           <row>\r
611             <entry>\r
612               <para>Exif.Photo.ExposureProgram</para>\r
613             </entry>\r
614             <entry>\r
615               <para>Exposure Program</para>\r
616             </entry>\r
617           </row>\r
618           <row>\r
619             <entry>\r
620               <para>Exif.Photo.MeteringMode</para>\r
621             </entry>\r
622             <entry>\r
623               <para>Metering Mode</para>\r
624             </entry>\r
625           </row>\r
626           <row>\r
627             <entry>\r
628               <para>Exif.Photo.LightSource</para>\r
629             </entry>\r
630             <entry>\r
631               <para>Light Source</para>\r
632             </entry>\r
633           </row>\r
634         </tbody>\r
635       </tgroup>\r
636     </table>\r
637   </section>\r
638   <section id="exifiptc">\r
639     <title>Exif IPTC alternative keys</title>\r
640     <table frame="all">\r
641       <title>Conversion table</title>\r
642       <tgroup cols="2" rowsep="1" colsep="1">\r
643         <thead>\r
644           <row>\r
645             <entry>\r
646               <para>Tag</para>\r
647             </entry>\r
648             <entry>\r
649               <para>Field</para>\r
650             </entry>\r
651           </row>\r
652         </thead>\r
653         <tbody>\r
654           <row>\r
655             <entry>\r
656               <para>Xmp.tiff.Orientation</para>\r
657             </entry>\r
658             <entry>\r
659               <para>Exif.Image.Orientation</para>\r
660             </entry>\r
661           </row>\r
662           <row>\r
663             <entry>\r
664               <para>Xmp.dc.title</para>\r
665             </entry>\r
666             <entry>\r
667               <para>Iptc.Application2.ObjectName</para>\r
668             </entry>\r
669           </row>\r
670           <row>\r
671             <entry>\r
672               <para>Xmp.photoshop.Urgency</para>\r
673             </entry>\r
674             <entry>\r
675               <para>Iptc.Application2.Urgency</para>\r
676             </entry>\r
677           </row>\r
678           <row>\r
679             <entry>\r
680               <para>Xmp.photoshop.Category</para>\r
681             </entry>\r
682             <entry>\r
683               <para>Iptc.Application2.Category</para>\r
684             </entry>\r
685           </row>\r
686           <row>\r
687             <entry>\r
688               <para>Xmp.photoshop.SupplementalCategory</para>\r
689             </entry>\r
690             <entry>\r
691               <para>Iptc.Application2.SuppCategory</para>\r
692             </entry>\r
693           </row>\r
694           <row>\r
695             <entry>\r
696               <para>Xmp.dc.subject</para>\r
697             </entry>\r
698             <entry>\r
699               <para>Iptc.Application2.Keywords</para>\r
700             </entry>\r
701           </row>\r
702           <row>\r
703             <entry>\r
704               <para>Xmp.iptc.Location</para>\r
705             </entry>\r
706             <entry>\r
707               <para>Iptc.Application2.LocationName</para>\r
708             </entry>\r
709           </row>\r
710           <row>\r
711             <entry>\r
712               <para>Xmp.photoshop.Instruction</para>\r
713             </entry>\r
714             <entry>\r
715               <para>Iptc.Application2.SpecialInstructions</para>\r
716             </entry>\r
717           </row>\r
718           <row>\r
719             <entry>\r
720               <para>Xmp.photoshop.DateCreated</para>\r
721             </entry>\r
722             <entry>\r
723               <para>Iptc.Application2.DateCreated</para>\r
724             </entry>\r
725           </row>\r
726           <row>\r
727             <entry>\r
728               <para>Xmp.dc.creator</para>\r
729             </entry>\r
730             <entry>\r
731               <para>Iptc.Application2.Byline</para>\r
732             </entry>\r
733           </row>\r
734           <row>\r
735             <entry>\r
736               <para>Xmp.photoshop.AuthorsPosition</para>\r
737             </entry>\r
738             <entry>\r
739               <para>Iptc.Application2.BylineTitle</para>\r
740             </entry>\r
741           </row>\r
742           <row>\r
743             <entry>\r
744               <para>Xmp.photoshop.City</para>\r
745             </entry>\r
746             <entry>\r
747               <para>Iptc.Application2.City</para>\r
748             </entry>\r
749           </row>\r
750           <row>\r
751             <entry>\r
752               <para>Xmp.photoshop.State</para>\r
753             </entry>\r
754             <entry>\r
755               <para>Iptc.Application2.ProvinceState</para>\r
756             </entry>\r
757           </row>\r
758           <row>\r
759             <entry>\r
760               <para>Xmp.iptc.CountryCode</para>\r
761             </entry>\r
762             <entry>\r
763               <para>Iptc.Application2.CountryCode</para>\r
764             </entry>\r
765           </row>\r
766           <row>\r
767             <entry>\r
768               <para>Xmp.photoshop.Country</para>\r
769             </entry>\r
770             <entry>\r
771               <para>Iptc.Application2.CountryName</para>\r
772             </entry>\r
773           </row>\r
774           <row>\r
775             <entry>\r
776               <para>Xmp.photoshop.TransmissionReference</para>\r
777             </entry>\r
778             <entry>\r
779               <para>Iptc.Application2.TransmissionReference</para>\r
780             </entry>\r
781           </row>\r
782           <row>\r
783             <entry>\r
784               <para>Xmp.photoshop.Headline</para>\r
785             </entry>\r
786             <entry>\r
787               <para>Iptc.Application2.Headline</para>\r
788             </entry>\r
789           </row>\r
790           <row>\r
791             <entry>\r
792               <para>Xmp.photoshop.Credit</para>\r
793             </entry>\r
794             <entry>\r
795               <para>Iptc.Application2.Credit</para>\r
796             </entry>\r
797           </row>\r
798           <row>\r
799             <entry>\r
800               <para>Xmp.photoshop.Source</para>\r
801             </entry>\r
802             <entry>\r
803               <para>Iptc.Application2.Source</para>\r
804             </entry>\r
805           </row>\r
806           <row>\r
807             <entry>\r
808               <para>Xmp.dc.rights</para>\r
809             </entry>\r
810             <entry>\r
811               <para>Iptc.Application2.Copyright</para>\r
812             </entry>\r
813           </row>\r
814           <row>\r
815             <entry>\r
816               <para>Xmp.dc.description</para>\r
817             </entry>\r
818             <entry>\r
819               <para>Iptc.Application2.Caption</para>\r
820             </entry>\r
821           </row>\r
822           <row>\r
823             <entry>\r
824               <para>Xmp.photoshop.CaptionWriter</para>\r
825             </entry>\r
826             <entry>\r
827               <para>Iptc.Application2.Writer</para>\r
828             </entry>\r
829           </row>\r
830         </tbody>\r
831       </tgroup>\r
832     </table>\r
833   </section>\r
834 </section>\r