Document XMP, Exif and IPTC tag usage

diff --git a/doc/docbook/GuideReference.xml b/doc/docbook/GuideReference.xml
index 72f05a3..1ef6fbf 100644 (file)
--- a/doc/docbook/GuideReference.xml
+++ b/doc/docbook/GuideReference.xml
@@ -9,7 +9,8 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceConfig.xml" />\r
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceLIRC.xml" />\r
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceStandards.xml" />\r
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceTags.xml" />\r
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceSupportedFormats.xml" />\r
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceDecodeLatLong.xml" />\r
   <para />\r
-</chapter>
+</chapter>\r

diff --git a/doc/docbook/GuideReferenceTags.xml b/doc/docbook/GuideReferenceTags.xml
new file mode 100644 (file)
index 0000000..1174926
--- /dev/null
+++ b/doc/docbook/GuideReferenceTags.xml
@@ -0,0 +1,739 @@
+<?xml version="1.0" encoding="utf-8"?>\r
+<section id="GuideReferenceXmpExif">\r
+  <title id="titleGuideReferenceXmpExif">XMP, Exif and IPTC</title>\r
+  <para>The tables below show the XMP, Exif and IPTC tags used by Geeqie.</para>\r
+  <section id="preformatted">\r
+    <title>Geeqie pre-formatted tags</title>\r
+    <table frame="all">\r
+      <title>Pre-formatted tags</title>\r
+      <tgroup cols="3" rowsep="1" colsep="1">\r
+        <thead>\r
+          <row>\r
+            <entry>\r
+              <para>Geeqie Tag</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Exif tags used</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Description</para>\r
+            </entry>\r
+          </row>\r
+        </thead>\r
+        <tbody>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.Camera</para>\r
+            </entry>\r
+            <entry>\r
+              <para>\r
+                Exif.Image.Make\r
+                <para />\r
+                Exif.Image.Model\r
+                <para />\r
+                Exif.Image.Software\r
+              </para>\r
+            </entry>\r
+            <entry>\r
+              <para>Camera and software name</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.DateTime</para>\r
+            </entry>\r
+            <entry>\r
+              <para>\r
+                Exif.Photo.DateTimeOriginal\r
+                <para />\r
+                Exif.Photo.SubSecTimeOriginal\r
+                <para />\r
+                Exif.Image.DateTime\r
+                <para />\r
+                Exif.Photo.SubSecTime\r
+              </para>\r
+            </entry>\r
+            <entry>\r
+              <para>Image Date</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.ShutterSpeed</para>\r
+            </entry>\r
+            <entry>\r
+              <para>\r
+                Exif.Photo.ExposureTime\r
+                <para />\r
+                Exif.Photo.ShutterSpeedValue\r
+\r
+              </para>\r
+            </entry>\r
+            <entry>\r
+              <para>Shutter speed in seconds (e.g. 1/60s)</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.Aperture</para>\r
+            </entry>\r
+            <entry>\r
+              <para>\r
+                <para>\r
+                  Exif.Photo.Fnumber\r
+                  <para />\r
+                  Exif.Photo.ApertureValue\r
+                </para>\r
+              </para>\r
+            </entry>\r
+            <entry>\r
+              <para>Aperture (e.g. f5.6)</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.ExposureBias</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Exif.Photo.ExposureBiasValue</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Exposure bias (e.g. +0.3)</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.ISOSpeedRating</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Exif.Photo.ISOSpeedRatings</para>\r
+            </entry>\r
+            <entry>\r
+              <para>ISO sensitivity (e.g. 100)</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.FocalLength</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Exif.Photo.FocalLength</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Focal length</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.FocalLength35mmFilm</para>\r
+            </entry>\r
+            <entry>\r
+              <para>\r
+                Exif.Photo.FocalLengthIn35mmFilm\r
+                <para />\r
+                Exif.Photo.FocalLength\r
+                <para />\r
+                Exif.Photo.FocalPlaneXResolution\r
+                <para />\r
+                Exif.Photo.FocalPlaneYResolution\r
+                <para />\r
+                Exif.Photo.FocalPlaneResolutionUnit\r
+                <para />\r
+                Exif.Photo.PixelXDimension\r
+                <para />\r
+                Exif.Photo.PixelYDimension\r
+\r
+              </para>\r
+            </entry>\r
+            <entry>\r
+              <para>Focal length 35mm</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.SubjectDistance</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Exif.Photo.SubjectDistance</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Subject distance</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.Flash</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Exif.Photo.Flash</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Flash</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.Resolution</para>\r
+            </entry>\r
+            <entry>\r
+              <para>\r
+                Exif.Image.Xresolution\r
+                <para />\r
+                Exif.Image.Yresolution\r
+                <para />\r
+                Exif.Image.ResolutionUnit\r
+              </para>\r
+            </entry>\r
+            <entry>\r
+              <para>Resolution</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.ColorProfile</para>\r
+            </entry>\r
+            <entry>\r
+              <para>\r
+                Exif.Image.InterColorProfile\r
+                <para />\r
+                Exif.Photo.ColorSpace\r
+                <para />\r
+                Exif.Iop.InteroperabilityIndex\r
+              </para>\r
+            </entry>\r
+            <entry>\r
+              <para>Color profile</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.GPSAltitude</para>\r
+            </entry>\r
+            <entry>\r
+              <para>\r
+                Exif.GPSInfo.GPSAltitudeRef\r
+                <para />\r
+                Exif.GPSInfo.GPSAltitude\r
+              </para>\r
+            </entry>\r
+            <entry>\r
+              <para>Altitude above sea level</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.GPSPosition</para>\r
+            </entry>\r
+            <entry>\r
+              <para>\r
+                Exif.GPSInfo.GPSLatitude\r
+                <para />\r
+                Exif.GPSInfo.GPSLatitudeRef\r
+                <para />\r
+                Exif.GPSInfo.GPSLongitude\r
+                <para />\r
+                Exif.GPSInfo.GPSLongitudeRef\r
+              </para>\r
+            </entry>\r
+            <entry>\r
+              <para>Latitude, Longitude</para>\r
+            </entry>\r
+          </row>\r
+        </tbody>\r
+      </tgroup>\r
+    </table>\r
+  </section>\r
+  <section id="infosidebar">\r
+    <title>Info sidebar panes</title>\r
+    <table frame="all">\r
+      <title>Fixed panes</title>\r
+      <tgroup cols="2" rowsep="1" colsep="1">\r
+        <thead>\r
+          <row>\r
+            <entry>\r
+              <para>Tag</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Pane title</para>\r
+            </entry>\r
+          </row>\r
+        </thead>\r
+        <tbody>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.description</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Comment</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.subject</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Keywords</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.title</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Title</para>\r
+            </entry>\r
+          </row>\r
+        </tbody>\r
+      </tgroup>\r
+    </table>\r
+    <table frame="all">\r
+      <title>Location and GPS pane</title>\r
+      <tgroup cols="2" rowsep="1" colsep="1">\r
+        <thead>\r
+          <row>\r
+            <entry>\r
+              <para>Tag</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Field</para>\r
+            </entry>\r
+          </row>\r
+        </thead>\r
+        <tbody>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.GPSPosition</para>\r
+            </entry>\r
+            <entry>\r
+              <para>GPS position</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.GPSAltitude</para>\r
+            </entry>\r
+            <entry>\r
+              <para>GPS altitiude</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.Country</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Country</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>\r
+                <para>Xmp.iptc.CountryCode</para>\r
+              </para>\r
+            </entry>\r
+            <entry>\r
+              <para>Country Code</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.State</para>\r
+            </entry>\r
+            <entry>\r
+              <para>State</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.City</para>\r
+            </entry>\r
+            <entry>\r
+              <para>City</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.iptc.Location</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Location</para>\r
+            </entry>\r
+          </row>\r
+        </tbody>\r
+      </tgroup>\r
+    </table>\r
+    <table frame="all">\r
+      <title>Copyright pane</title>\r
+      <tgroup cols="2" rowsep="1" colsep="1">\r
+        <thead>\r
+          <row>\r
+            <entry>\r
+              <para>Tag</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Field</para>\r
+            </entry>\r
+          </row>\r
+        </thead>\r
+        <tbody>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.creator</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Creator</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.contributor</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Contributor</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.rights</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Rights</para>\r
+            </entry>\r
+          </row>\r
+        </tbody>\r
+      </tgroup>\r
+    </table>\r
+    <table frame="all">\r
+      <title>Exif pane</title>\r
+      <tgroup cols="2" rowsep="1" colsep="1">\r
+        <thead>\r
+          <row>\r
+            <entry>\r
+              <para>Tag</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Field</para>\r
+            </entry>\r
+          </row>\r
+        </thead>\r
+        <tbody>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.Camera</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Camera</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.DateTime</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Date</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.ShutterSpeed</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Shutter speed</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.Aperture</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Aperture</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.ExposureBias</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Exposure bias</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.ISOSpeedRating</para>\r
+            </entry>\r
+            <entry>\r
+              <para>ISO sensitivity</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.FocalLength</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Focal length</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.FocalLength35mmFilm</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Focal length 35mm</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.SubjectDistance</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Subject distance</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.Flash</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Flash</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.Resolution</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Resolution</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>formatted.ColorProfile</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Color profile</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Exif.Photo.ExposureProgram</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Exposure Program</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Exif.Photo.MeteringMode</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Metering Mode</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Exif.Photo.LightSource</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Light Source</para>\r
+            </entry>\r
+          </row>\r
+        </tbody>\r
+      </tgroup>\r
+    </table>\r
+  </section>\r
+  <section id="exifiptc">\r
+    <title>Exif IPTC alternative keys</title>\r
+    <table frame="all">\r
+      <title>Conversion table</title>\r
+      <tgroup cols="2" rowsep="1" colsep="1">\r
+        <thead>\r
+          <row>\r
+            <entry>\r
+              <para>Tag</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Field</para>\r
+            </entry>\r
+          </row>\r
+        </thead>\r
+        <tbody>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.tiff.Orientation</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Exif.Image.Orientation</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.title</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.ObjectName</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.Urgency</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.Urgency</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.Category</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.Category</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.SupplementalCategory</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.SuppCategory</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.subject</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.Keywords</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.iptc.Location</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.LocationName</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.Instruction</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.SpecialInstructions</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.DateCreated</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.DateCreated</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.creator</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.Byline</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.AuthorsPosition</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.BylineTitle</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.City</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.City</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.State</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.ProvinceState</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.iptc.CountryCode</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.CountryCode</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.Country</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.CountryName</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.TransmissionReference</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.TransmissionReference</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.Headline</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.Headline</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.Credit</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.Credit</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.Source</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.Source</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.rights</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.Copyright</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.dc.description</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.Caption</para>\r
+            </entry>\r
+          </row>\r
+          <row>\r
+            <entry>\r
+              <para>Xmp.photoshop.CaptionWriter</para>\r
+            </entry>\r
+            <entry>\r
+              <para>Iptc.Application2.Writer</para>\r
+            </entry>\r
+          </row>\r
+        </tbody>\r
+      </tgroup>\r
+    </table>\r
+  </section>\r
+</section>\r