Document XMP, Exif and IPTC tag usage
[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         </tbody>\r
243       </tgroup>\r
244     </table>\r
245   </section>\r
246   <section id="infosidebar">\r
247     <title>Info sidebar panes</title>\r
248     <table frame="all">\r
249       <title>Fixed panes</title>\r
250       <tgroup cols="2" rowsep="1" colsep="1">\r
251         <thead>\r
252           <row>\r
253             <entry>\r
254               <para>Tag</para>\r
255             </entry>\r
256             <entry>\r
257               <para>Pane title</para>\r
258             </entry>\r
259           </row>\r
260         </thead>\r
261         <tbody>\r
262           <row>\r
263             <entry>\r
264               <para>Xmp.dc.description</para>\r
265             </entry>\r
266             <entry>\r
267               <para>Comment</para>\r
268             </entry>\r
269           </row>\r
270           <row>\r
271             <entry>\r
272               <para>Xmp.dc.subject</para>\r
273             </entry>\r
274             <entry>\r
275               <para>Keywords</para>\r
276             </entry>\r
277           </row>\r
278           <row>\r
279             <entry>\r
280               <para>Xmp.dc.title</para>\r
281             </entry>\r
282             <entry>\r
283               <para>Title</para>\r
284             </entry>\r
285           </row>\r
286         </tbody>\r
287       </tgroup>\r
288     </table>\r
289     <table frame="all">\r
290       <title>Location and GPS pane</title>\r
291       <tgroup cols="2" rowsep="1" colsep="1">\r
292         <thead>\r
293           <row>\r
294             <entry>\r
295               <para>Tag</para>\r
296             </entry>\r
297             <entry>\r
298               <para>Field</para>\r
299             </entry>\r
300           </row>\r
301         </thead>\r
302         <tbody>\r
303           <row>\r
304             <entry>\r
305               <para>formatted.GPSPosition</para>\r
306             </entry>\r
307             <entry>\r
308               <para>GPS position</para>\r
309             </entry>\r
310           </row>\r
311           <row>\r
312             <entry>\r
313               <para>formatted.GPSAltitude</para>\r
314             </entry>\r
315             <entry>\r
316               <para>GPS altitiude</para>\r
317             </entry>\r
318           </row>\r
319           <row>\r
320             <entry>\r
321               <para>Xmp.photoshop.Country</para>\r
322             </entry>\r
323             <entry>\r
324               <para>Country</para>\r
325             </entry>\r
326           </row>\r
327           <row>\r
328             <entry>\r
329               <para>\r
330                 <para>Xmp.iptc.CountryCode</para>\r
331               </para>\r
332             </entry>\r
333             <entry>\r
334               <para>Country Code</para>\r
335             </entry>\r
336           </row>\r
337           <row>\r
338             <entry>\r
339               <para>Xmp.photoshop.State</para>\r
340             </entry>\r
341             <entry>\r
342               <para>State</para>\r
343             </entry>\r
344           </row>\r
345           <row>\r
346             <entry>\r
347               <para>Xmp.photoshop.City</para>\r
348             </entry>\r
349             <entry>\r
350               <para>City</para>\r
351             </entry>\r
352           </row>\r
353           <row>\r
354             <entry>\r
355               <para>Xmp.iptc.Location</para>\r
356             </entry>\r
357             <entry>\r
358               <para>Location</para>\r
359             </entry>\r
360           </row>\r
361         </tbody>\r
362       </tgroup>\r
363     </table>\r
364     <table frame="all">\r
365       <title>Copyright pane</title>\r
366       <tgroup cols="2" rowsep="1" colsep="1">\r
367         <thead>\r
368           <row>\r
369             <entry>\r
370               <para>Tag</para>\r
371             </entry>\r
372             <entry>\r
373               <para>Field</para>\r
374             </entry>\r
375           </row>\r
376         </thead>\r
377         <tbody>\r
378           <row>\r
379             <entry>\r
380               <para>Xmp.dc.creator</para>\r
381             </entry>\r
382             <entry>\r
383               <para>Creator</para>\r
384             </entry>\r
385           </row>\r
386           <row>\r
387             <entry>\r
388               <para>Xmp.dc.contributor</para>\r
389             </entry>\r
390             <entry>\r
391               <para>Contributor</para>\r
392             </entry>\r
393           </row>\r
394           <row>\r
395             <entry>\r
396               <para>Xmp.dc.rights</para>\r
397             </entry>\r
398             <entry>\r
399               <para>Rights</para>\r
400             </entry>\r
401           </row>\r
402         </tbody>\r
403       </tgroup>\r
404     </table>\r
405     <table frame="all">\r
406       <title>Exif pane</title>\r
407       <tgroup cols="2" rowsep="1" colsep="1">\r
408         <thead>\r
409           <row>\r
410             <entry>\r
411               <para>Tag</para>\r
412             </entry>\r
413             <entry>\r
414               <para>Field</para>\r
415             </entry>\r
416           </row>\r
417         </thead>\r
418         <tbody>\r
419           <row>\r
420             <entry>\r
421               <para>formatted.Camera</para>\r
422             </entry>\r
423             <entry>\r
424               <para>Camera</para>\r
425             </entry>\r
426           </row>\r
427           <row>\r
428             <entry>\r
429               <para>formatted.DateTime</para>\r
430             </entry>\r
431             <entry>\r
432               <para>Date</para>\r
433             </entry>\r
434           </row>\r
435           <row>\r
436             <entry>\r
437               <para>formatted.ShutterSpeed</para>\r
438             </entry>\r
439             <entry>\r
440               <para>Shutter speed</para>\r
441             </entry>\r
442           </row>\r
443           <row>\r
444             <entry>\r
445               <para>formatted.Aperture</para>\r
446             </entry>\r
447             <entry>\r
448               <para>Aperture</para>\r
449             </entry>\r
450           </row>\r
451           <row>\r
452             <entry>\r
453               <para>formatted.ExposureBias</para>\r
454             </entry>\r
455             <entry>\r
456               <para>Exposure bias</para>\r
457             </entry>\r
458           </row>\r
459           <row>\r
460             <entry>\r
461               <para>formatted.ISOSpeedRating</para>\r
462             </entry>\r
463             <entry>\r
464               <para>ISO sensitivity</para>\r
465             </entry>\r
466           </row>\r
467           <row>\r
468             <entry>\r
469               <para>formatted.FocalLength</para>\r
470             </entry>\r
471             <entry>\r
472               <para>Focal length</para>\r
473             </entry>\r
474           </row>\r
475           <row>\r
476             <entry>\r
477               <para>formatted.FocalLength35mmFilm</para>\r
478             </entry>\r
479             <entry>\r
480               <para>Focal length 35mm</para>\r
481             </entry>\r
482           </row>\r
483           <row>\r
484             <entry>\r
485               <para>formatted.SubjectDistance</para>\r
486             </entry>\r
487             <entry>\r
488               <para>Subject distance</para>\r
489             </entry>\r
490           </row>\r
491           <row>\r
492             <entry>\r
493               <para>formatted.Flash</para>\r
494             </entry>\r
495             <entry>\r
496               <para>Flash</para>\r
497             </entry>\r
498           </row>\r
499           <row>\r
500             <entry>\r
501               <para>formatted.Resolution</para>\r
502             </entry>\r
503             <entry>\r
504               <para>Resolution</para>\r
505             </entry>\r
506           </row>\r
507           <row>\r
508             <entry>\r
509               <para>formatted.ColorProfile</para>\r
510             </entry>\r
511             <entry>\r
512               <para>Color profile</para>\r
513             </entry>\r
514           </row>\r
515           <row>\r
516             <entry>\r
517               <para>Exif.Photo.ExposureProgram</para>\r
518             </entry>\r
519             <entry>\r
520               <para>Exposure Program</para>\r
521             </entry>\r
522           </row>\r
523           <row>\r
524             <entry>\r
525               <para>Exif.Photo.MeteringMode</para>\r
526             </entry>\r
527             <entry>\r
528               <para>Metering Mode</para>\r
529             </entry>\r
530           </row>\r
531           <row>\r
532             <entry>\r
533               <para>Exif.Photo.LightSource</para>\r
534             </entry>\r
535             <entry>\r
536               <para>Light Source</para>\r
537             </entry>\r
538           </row>\r
539         </tbody>\r
540       </tgroup>\r
541     </table>\r
542   </section>\r
543   <section id="exifiptc">\r
544     <title>Exif IPTC alternative keys</title>\r
545     <table frame="all">\r
546       <title>Conversion table</title>\r
547       <tgroup cols="2" rowsep="1" colsep="1">\r
548         <thead>\r
549           <row>\r
550             <entry>\r
551               <para>Tag</para>\r
552             </entry>\r
553             <entry>\r
554               <para>Field</para>\r
555             </entry>\r
556           </row>\r
557         </thead>\r
558         <tbody>\r
559           <row>\r
560             <entry>\r
561               <para>Xmp.tiff.Orientation</para>\r
562             </entry>\r
563             <entry>\r
564               <para>Exif.Image.Orientation</para>\r
565             </entry>\r
566           </row>\r
567           <row>\r
568             <entry>\r
569               <para>Xmp.dc.title</para>\r
570             </entry>\r
571             <entry>\r
572               <para>Iptc.Application2.ObjectName</para>\r
573             </entry>\r
574           </row>\r
575           <row>\r
576             <entry>\r
577               <para>Xmp.photoshop.Urgency</para>\r
578             </entry>\r
579             <entry>\r
580               <para>Iptc.Application2.Urgency</para>\r
581             </entry>\r
582           </row>\r
583           <row>\r
584             <entry>\r
585               <para>Xmp.photoshop.Category</para>\r
586             </entry>\r
587             <entry>\r
588               <para>Iptc.Application2.Category</para>\r
589             </entry>\r
590           </row>\r
591           <row>\r
592             <entry>\r
593               <para>Xmp.photoshop.SupplementalCategory</para>\r
594             </entry>\r
595             <entry>\r
596               <para>Iptc.Application2.SuppCategory</para>\r
597             </entry>\r
598           </row>\r
599           <row>\r
600             <entry>\r
601               <para>Xmp.dc.subject</para>\r
602             </entry>\r
603             <entry>\r
604               <para>Iptc.Application2.Keywords</para>\r
605             </entry>\r
606           </row>\r
607           <row>\r
608             <entry>\r
609               <para>Xmp.iptc.Location</para>\r
610             </entry>\r
611             <entry>\r
612               <para>Iptc.Application2.LocationName</para>\r
613             </entry>\r
614           </row>\r
615           <row>\r
616             <entry>\r
617               <para>Xmp.photoshop.Instruction</para>\r
618             </entry>\r
619             <entry>\r
620               <para>Iptc.Application2.SpecialInstructions</para>\r
621             </entry>\r
622           </row>\r
623           <row>\r
624             <entry>\r
625               <para>Xmp.photoshop.DateCreated</para>\r
626             </entry>\r
627             <entry>\r
628               <para>Iptc.Application2.DateCreated</para>\r
629             </entry>\r
630           </row>\r
631           <row>\r
632             <entry>\r
633               <para>Xmp.dc.creator</para>\r
634             </entry>\r
635             <entry>\r
636               <para>Iptc.Application2.Byline</para>\r
637             </entry>\r
638           </row>\r
639           <row>\r
640             <entry>\r
641               <para>Xmp.photoshop.AuthorsPosition</para>\r
642             </entry>\r
643             <entry>\r
644               <para>Iptc.Application2.BylineTitle</para>\r
645             </entry>\r
646           </row>\r
647           <row>\r
648             <entry>\r
649               <para>Xmp.photoshop.City</para>\r
650             </entry>\r
651             <entry>\r
652               <para>Iptc.Application2.City</para>\r
653             </entry>\r
654           </row>\r
655           <row>\r
656             <entry>\r
657               <para>Xmp.photoshop.State</para>\r
658             </entry>\r
659             <entry>\r
660               <para>Iptc.Application2.ProvinceState</para>\r
661             </entry>\r
662           </row>\r
663           <row>\r
664             <entry>\r
665               <para>Xmp.iptc.CountryCode</para>\r
666             </entry>\r
667             <entry>\r
668               <para>Iptc.Application2.CountryCode</para>\r
669             </entry>\r
670           </row>\r
671           <row>\r
672             <entry>\r
673               <para>Xmp.photoshop.Country</para>\r
674             </entry>\r
675             <entry>\r
676               <para>Iptc.Application2.CountryName</para>\r
677             </entry>\r
678           </row>\r
679           <row>\r
680             <entry>\r
681               <para>Xmp.photoshop.TransmissionReference</para>\r
682             </entry>\r
683             <entry>\r
684               <para>Iptc.Application2.TransmissionReference</para>\r
685             </entry>\r
686           </row>\r
687           <row>\r
688             <entry>\r
689               <para>Xmp.photoshop.Headline</para>\r
690             </entry>\r
691             <entry>\r
692               <para>Iptc.Application2.Headline</para>\r
693             </entry>\r
694           </row>\r
695           <row>\r
696             <entry>\r
697               <para>Xmp.photoshop.Credit</para>\r
698             </entry>\r
699             <entry>\r
700               <para>Iptc.Application2.Credit</para>\r
701             </entry>\r
702           </row>\r
703           <row>\r
704             <entry>\r
705               <para>Xmp.photoshop.Source</para>\r
706             </entry>\r
707             <entry>\r
708               <para>Iptc.Application2.Source</para>\r
709             </entry>\r
710           </row>\r
711           <row>\r
712             <entry>\r
713               <para>Xmp.dc.rights</para>\r
714             </entry>\r
715             <entry>\r
716               <para>Iptc.Application2.Copyright</para>\r
717             </entry>\r
718           </row>\r
719           <row>\r
720             <entry>\r
721               <para>Xmp.dc.description</para>\r
722             </entry>\r
723             <entry>\r
724               <para>Iptc.Application2.Caption</para>\r
725             </entry>\r
726           </row>\r
727           <row>\r
728             <entry>\r
729               <para>Xmp.photoshop.CaptionWriter</para>\r
730             </entry>\r
731             <entry>\r
732               <para>Iptc.Application2.Writer</para>\r
733             </entry>\r
734           </row>\r
735         </tbody>\r
736       </tgroup>\r
737     </table>\r
738   </section>\r
739 </section>\r