doc/docbook/GuideReferenceMetadata.xml

   1 <?xml version="1.0" encoding="utf-8"?>\r
   2 <section id="GuideReferenceMetadata">\r
   3   <title id="titleGuideReferenceMetadata">Metadata Processing</title>\r
   4   <para>This section describes the metadata reading and writing process.</para>\r
   5   <para />\r
   6   <section id="Metadatahandling">\r
   7     <title>Metadata handling</title>\r
   8     <para />\r
   9     <section id="Readalgorithm">\r
  10       <title>Read algorithm</title>\r
  11       <orderedlist spacing="compact">\r
  12         <listitem>\r
  13           <para>Read Exif, IPTC and XMP from the file.</para>\r
  14         </listitem>\r
  15         <listitem>\r
  16           <para>\r
  17             Display this "raw" data in the\r
  18             <link linkend="GuideOtherWindowsExif">Exif Window</link>\r
  19             .\r
  20           </para>\r
  21         </listitem>\r
  22         <listitem>\r
  23           <para>Read XMP sidecar or Geeqie private metadata file. This data will override the XMP data read from the file.</para>\r
  24         </listitem>\r
  25         <listitem>\r
  26           <para>\r
  27             Synchronise XMP data with Exif and IPTC data. This process corresponds to the section "Reconciling metadata properties" as described in the\r
  28             <link linkend="GuideReferenceStandards">XMP Specification</link>\r
  29             .\r
  30             <itemizedlist spacing="compact">\r
  31               <listitem>\r
  32                 <para>detect which of Exif and Xmp.exif is newer and copy the data in the appropriate direction</para>\r
  33               </listitem>\r
  34               <listitem>\r
  35                 <para>detect which of IPTC and XMP is newer and copy the data in the appropriate direction</para>\r
  36               </listitem>\r
  37             </itemizedlist>\r
  38           </para>\r
  39         </listitem>\r
  40         <listitem>\r
  41           <para>\r
  42             Use this "processed" data within Geeqie, with the exception of in the\r
  43             <link linkend="GuideOtherWindowsExif">Exif Window</link>\r
  44           </para>\r
  45         </listitem>\r
  46       </orderedlist>\r
  47       <para />\r
  48     </section>\r
  49     <section id="Metadatamodification">\r
  50       <title>Metadata modification</title>\r
  51       <itemizedlist spacing="compact">\r
  52         <listitem>\r
  53           <para>\r
  54             Metadata is written to a single file or group of files as specified in the\r
  55             <link linkend="MetadataMiscellaneous">Metadata</link>\r
  56             tab of main Preferences.\r
  57           </para>\r
  58         </listitem>\r
  59         <listitem>\r
  60           <para>Modifying the keywords, comment, orientation, etc. does not ask for confirmation, but immediately modifies the metadata in memory and adds the file to "write queue"</para>\r
  61         </listitem>\r
  62         <listitem>\r
  63           <para>\r
  64             Writing of the queued changes is triggered either\r
  65             <link linkend="Buttons">manually</link>\r
  66             or as defined in\r
  67             <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />. It is possible to review the changes and exclude selected files.\r
  68           </para>\r
  69         </listitem>\r
  70       </itemizedlist>\r
  71       <para />\r
  72     </section>\r
  73     <section id="Writealgorithm">\r
  74       <title>Write algorithm</title>\r
  75       <orderedlist spacing="compact">\r
  76         <listitem>\r
  77           <para>\r
  78             Exif and IPTC are updated from XMP (for example\r
  79             <emphasis>Exif.Image.Orientation</emphasis>\r
  80             is updated from\r
  81             <emphasis>Xmp.exif.orientation</emphasis>\r
  82             ). See\r
  83             <link linkend="GuideReferenceStandards">XMP</link>\r
  84             and\r
  85             <link linkend="GuideReferenceStandards">IPTC4XMP</link>\r
  86             specifications for the list of corresponding tags.\r
  87           </para>\r
  88         </listitem>\r
  89         <listitem>\r
  90           <para>\r
  91             Try to write metadata in the order specified in the\r
  92             <link linkend="MetadataWritingProcess" endterm="titleMetadataWritingProcess" />\r
  93             section of Preferences.\r
  94           </para>\r
  95         </listitem>\r
  96         <listitem>\r
  97           <para>After the first successful write attempt delete old metadata files in all possible locations.</para>\r
  98         </listitem>\r
  99       </orderedlist>\r
 100       <para />\r
 101     </section>\r
 102   </section>\r
 103   <section id="Optionsthatinfluencestheprocess">\r
 104     <title>Options that influence the process</title>\r
 105     <para>\r
 106       File types with allowed sidecars are listed in the\r
 107       <link linkend="GuideOptionsFiltering" endterm="titleGuideOptionsFiltering" />\r
 108       tab of the main Preferences.\r
 109     </para>\r
 110     <para />\r
 111   </section>\r
 112 </section>\r