doc/docbook/GuideReferenceTags.xml

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