File: GuideReferenceMetadata.xml

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