/usr/share/doc/geeqie/html/GuideOptionsMetadata.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Metadata Options</title>
<link rel="previous" href="GuideOptionsFiltering.html" title="
      Filtering Options
    ">
<link rel="next" href="GuideOptionsColor.html" title="
      Color management
    ">
<link rel="top" href="GuideIndex.html" title="
      The Geeqie User Manual
    ">
<style type="text/css">

html { height: 100%; }
body {
  margin: 0px; padding: 12px;
  background-color: #f9f9f6;
  min-height: 100%;
  direction: ltr;
}
div, p, pre, blockquote { margin: 0; padding: 0; }
p img { vertical-align: middle; }
sub { font-size: 0.83em; }
sub sub { font-size: 1em; }
sup { font-size: 0.83em; }
sup sup { font-size: 1em; }
table { border-collapse: collapse; }
table.table-pgwide { width: 100%; }
td { vertical-align: top; }
td { padding: 0.2em 0.83em 0.2em 0.83em; }
th { padding: 0 0.83em 0 0.83em; }
tr.tr-shade {
  background-color: #f9f9f6;
}
td.td-colsep { border-right: solid 1px; }
td.td-rowsep { border-bottom: solid 1px; }
thead { border-top: solid 2px; border-bottom: solid 2px; }
tfoot { border-top: solid 2px; border-bottom: solid 2px; }
div.body {
  padding: 1em;
  max-width: 60em;
  background-color: #ffffff;
  border: solid 1px #e0e0df;
}
div.body-sidebar {
  margin-right: 13em;
}
div.division div.division { margin-top: 1.72em; }
div.division div.division div.division { margin-top: 1.44em; }
div.header {
  margin: 0;
  color: #3f3f3f;
  border-bottom: solid 1px #e0e0df;
}
h1, h2, h3, h4, h5, h6, h7 {
  margin: 0; padding: 0;
  color: #3f3f3f;
}
h1.title { font-size: 1.72em; }
h2.title { font-size: 1.44em; }
h3.title { font-size: 1.2em; }
h4.title, h5.title, h6.title, h7.title { font-size: 1em; }
.block { margin-top: 1em; }
.block .block-first { margin-top: 0; }
.block-indent {
  margin-left left: 1.72em;
  margin-: 1em;
}
.block-indent .block-indent { margin-left: 0em; margin-right: 0em; }
td .block-indent  { margin-left: 0em; margin-right: 0em; }
dd .block-indent  { margin-left: 0em; margin-right: 0em; }
.block-verbatim { white-space: pre; }
div.title {
  margin-bottom: 0.2em;
  font-weight: bold;
  color: #3f3f3f;
}
div.title-formal { padding-left: 0.2em; padding-right: 0.2em; }
div.title-formal .label { font-weight: normal; }
a {
  color: #1f609f;
  text-decoration: none;
}
a:hover { text-decoration: underline; }
a:visited { color: #9f1f6f; }
ul, ol, dl { margin: 0; padding: 0; }
li {
  margin-top: 1em;
  margin-left: 2.4em;
  padding: 0;
}
li.li-first { margin-top: 0; }
dt { margin: 1em 0 0 0; }
dt.dt-first { margin: 0; }
dd {
  margin-left: 1.72em;
  margin-top: 0.5em;
}
dl.dl-compact dt { margin-top: 0; }
dl.dl-compact dd { margin-top: 0; margin-bottom: 0; }


ul.linktrail {
  display: block;
  margin: 0.2em 0 0 0;
  text-align: right;
}
li.linktrail { display: inline; margin: 0; padding: 0; }

li.linktrail::before {
  content: '  /  ';
  color: #3f3f3f;
}

li.linktrail-first::before, li.linktrail-only::before { content: ''; }


div.navbar {
  padding: 0.5em 1em 0.5em 1em;
  max-width: 60em;
  background-color: #ffffff;
  border: solid 1px #e0e0df;
}
div.navbar-top { margin-bottom: 1em; }
div.navbar-bottom { margin-top: 1em; clear: both; }
div.navbar img { border: 0; vertical-align: -0.4em; }
table.navbar { width: 100%; margin: 0; border: none; }
table.navbar td { padding: 0; border: none; }
td.navbar-next {
  text-align: right;
}
a.navbar-prev::before {
  
  content: '◀  ';
  color: #3f3f3f;
}
a.navbar-next::after {
  
  content: '  ▶';
  color: #3f3f3f;
}


div.sidebar {
  float: right;
  padding: 0; margin: 0; width: 12em;
}
div.sidenav {
  padding: 0.5em 1em 0 1em;
  background-color: #ffffff;
  border: solid 1px #e0e0df;
}
div.sidenav div.autotoc {
  background-color: #ffffff;
  border: none; padding: 0; margin: 0;
}
div.sidenav div.autotoc div.autotoc { margin-top: 0.5em; }
div.sidenav div.autotoc li { margin-bottom: 0.5em; }
div.sidenav div.autotoc div.autotoc div.autotoc {
  margin-left: 1em;
  margin-top: 0;
}
div.sidenav div.autotoc div.autotoc div.autotoc li { margin-bottom: 0; }


div.autotoc {
  
  display: table;
  margin-top: 1em;
  margin-left: 1.72em;
  padding: 0.5em 1em 0.5em 1em;
  background-color: #f0f9ff;
  border: solid 1px #c0c9ff;
}
div.autotoc ul { margin: 0; padding: 0; }
div.autotoc li { list-style-type: none; margin: 0; }
div.autotoc div.autotoc-title { margin-bottom: 0.5em; }
div.autotoc div.autotoc { border: none; padding: 0; margin-top: 0; margin-bottom: 0.5em; }
div.autotoc div.autotoc div.autotoc { margin-bottom: 0; }


span.bibliolabel {
  color: #3f3f3f;
}


div.admonition {
  padding: 0.5em 6px 0.5em 6px;
  border: solid 1px #e0e0df;
  background-color: #fffff0;
}
div.caution-inner, div.important-inner, div.note-inner, div.tip-inner, div.warning-inner {
  padding-left: 60px;
  background-position: left top;
  background-repeat: no-repeat;
  min-height: 48px;
}
div.caution-inner { background-image: url("admon-caution.png"); }
div.important-inner { background-image: url("admon-important.png"); }
div.note-inner { background-image: url("admon-note.png"); }
div.note-bug div.note-inner { background-image: url("admon-bug.png"); }
div.tip-inner { background-image: url("admon-tip.png"); }
div.warning-inner { background-image: url("admon-warning.png"); }
div.blockquote {
  
  background-image: url('watermark-blockquote-201C.png');
  background-repeat: no-repeat;
  background-position: top left;
  padding: 0.5em;
  padding-left: 4em;
}
div.attribution {
  margin-top: 0.5em;
  color: #3f3f3f;
}
div.attribution::before {
  
  content: '― ';
}
div.epigraph {
  text-align: right;
  margin-left: 20%;
  margin-right: 0;
  color: #3f3f3f;
}
div.figure, div.informalfigure {
  
  display: table;
  padding: 0.5em;
  background-color: #f9f9f6;
  border: solid 1px #e0e0df;
}
div.figure-inner, div.informalfigure-inner {
  padding: 0.5em;
  background-color: #ffffff;
  border: solid 1px #e0e0df;
}
div.caption { margin-top: 0.5em; }
div.programlisting {
  padding: 0.5em;
  
  background-color: #f9f9f6;
  border: solid 1px #e0e0df;
}
div.screen {
  padding: 0.5em;
  
  background-color: #f9f9f6;
  border: solid 1px #e0e0df;
}
div.screen .prompt {
  color: #3f3f3f;
}
div.screen .userinput {
  font-weight: bold;
  color: #3f3f3f;
}
div.programlisting .userinput {
  font-weight: bold;
  color: #3f3f3f;
}
pre.linenumbering {
  color: #3f3f3f;
  margin: 0;
  padding-right: 1em;
  float: left;
  text-align: right;
}



dl.index dt { margin-top: 0; }
dl.index dd { margin-top: 0; margin-bottom: 0; }
dl.indexdiv dt { margin-top: 0; }
dl.indexdiv dd { margin-top: 0; margin-bottom: 0; }
dl.setindex dt { margin-top: 0; }
dl.setindex dd { margin-top: 0; margin-bottom: 0; }
div.list div.title-formal span.title {
  border-bottom: solid 1px #e0e0df;
}
div.simplelist {
  margin-left: 1.72em;
}
div.simplelist table { margin-left: 0; border: none; }
div.simplelist td {
  padding: 0.5em;
  border-left: solid 1px #e0e0df;
}
div.simplelist td.td-first {
  padding-left: 0;
  border-left: 0;
}
div.synopsis {
  padding: 0.5em;
  
  background-color: #f9f9f6;
  border-top: solid 2px #c0c9ff;
  border-bottom: solid 2px #c0c9ff;
}
div.synopsis div.synopsis {
  padding: 0;
  border: none;
}
div.synopsis div.block { margin-top: 0.2em; }
div.synopsis div.block-first { margin-top: 0; }
div.cmdsynopsis { font-family: monospace; }

span.accel { text-decoration: underline; }
span.acronym { font-family: sans-serif; }
span.application { font-style: italic; }
span.classname, span.exceptionname, span.interfacename { font-family: monospace; }
span.code {
  font-family: monospace;
  border: solid 1px #e0e0df;
  padding-left: 0.2em;
  padding-right: 0.2em;
}
pre span.code { border: none; padding: 0; }
span.command {
  font-family: monospace;
  border: solid 1px #e0e0df;
  padding-left: 0.2em;
  padding-right: 0.2em;
}
pre span.command { border: none; padding: 0; }
span.computeroutput { font-family: monospace; }

span.constant { font-family: monospace; }
span.database { font-family: monospace; }
span.email { font-family: monospace; }
span.emphasis { font-style: italic; }
span.emphasis-bold { font-style: normal; font-weight: bold; }
span.envar { font-family: monospace; }

span.filename { font-family: monospace; }
span.firstterm { font-style: italic; }
span.foreignphrase { font-style: italic; }
span.function { font-family: monospace; }

dt.glossterm span.glossterm { font-style: normal; }


span.glossterm { font-style: italic; }

span.guibutton, span.guilabel, span.guimenu, span.guimenuitem, span.guisubmenu, span.interface {
  font-weight: bold;
  color: #3f3f3f;
}
span.keycap {
  font-weight: bold;
  color: #3f3f3f;
}
span.lineannotation { font-style: italic; }
span.literal { font-family: monospace; }
span.markup  { font-family: monospace; }
span.medialabel { font-style: italic; }
span.methodname { font-family: monospace; }
span.ooclass, span.ooexception, span.oointerface { font-family: monospace; }
span.option { font-family: monospace; }
span.parameter { font-family: monospace; }
span.paramdef span.parameter { font-style: italic; }
span.prompt { font-family: monospace; }
span.property { font-family: monospace; }
span.replaceable  { font-style: italic; }
span.returnvalue { font-family: monospace; }
span.sgmltag { font-family: monospace; }
span.structfield, span.structname { font-family: monospace; }
span.symbol { font-family: monospace; }
span.systemitem { font-family: monospace; }
span.token { font-family: monospace; }
span.type { font-family: monospace; }
span.uri { font-family: monospace; }
span.userinput { font-family: monospace; }
span.varname { font-family: monospace; }
span.wordasword { font-style: italic; }



div.footnotes { font-style: italic; font-size: 0.8em; }
div.footnote { margin-top: 1.44em; }
span.footnote-number { display: inline; padding-right: 0.83em; }
span.footnote-number + p { display: inline; }
a.footnote { text-decoration: none; font-size: 0.8em; }
a.footnote-ref { text-decoration: none; }

span.co {
  margin-left: 0.2em; margin-right: 0.2em;
  padding-left: 0.4em; padding-right: 0.4em;
  border: solid 1px #000000;
  -moz-border-radius: 8px;
  background-color: #000000;
  color: #FFFFFF;
  font-size: 8px;
}
span.co:hover {
  border-color: #333333;
  background-color: #333333;
  color: #FFFFFF;
}
span.co a { text-decoration: none; }
span.co a:hover { text-decoration: none; }

dt.question { margin-left: 0em; }
dt.question div.label { float: left; }
dd + dt.question { margin-top: 1em; }
dd.answer {
  margin-top: 1em;
  margin-left: 2em;
  margin-right: 1em;
}
dd.answer div.label { float: left; }
</style>
</head>
<body>
<div class="navbar navbar-top"><table class="navbar"><tr>
<td class="navbar-prev"><a class="navbar-prev" href="GuideOptionsFiltering.html" title="
      Filtering Options
    ">
      Filtering Options
    </a></td>
<td class="navbar-next"><a class="navbar-next" href="GuideOptionsColor.html" title="
      Color management
    ">
      Color management
    </a></td>
</tr></table></div>
<div class="sidebar"><div class="sidenav"><div class="autotoc"><ul>
<li><a href="GuideIndex-info.html" title="About This Document">About This Document</a></li>
<li>
<a class="xref" href="GuideIndex.html" title="
      The Geeqie User Manual
    ">
      The Geeqie User Manual
    </a><div class="autotoc"><ul>
<li><a class="xref" href="GuideIntroduction.html" title="
      Introduction
    ">
      Introduction
    </a></li>
<li><a class="xref" href="GuideMainWindow.html" title="
      Main Window
    ">
      Main Window
    </a></li>
<li><a class="xref" href="GuideOtherWindows.html" title="
      Other Windows
    ">
      Other Windows
    </a></li>
<li><a class="xref" href="GuideImageManagement.html" title="
      Image Management
    ">
      Image Management
    </a></li>
<li><a class="xref" href="GuideImageSearch.html" title="
      Image Search
    ">
      Image Search
    </a></li>
<li><a class="xref" href="GuideCollections.html" title="
      Collections
    ">
      Collections
    </a></li>
<li><a class="xref" href="GuideSidebars.html" title="
      Sidebars
    ">
      Sidebars
    </a></li>
<li><a class="xref" href="GuideImagePresentation.html" title="
      Image Presentation
    ">
      Image Presentation
    </a></li>
<li><a class="xref" href="GuidePrinting.html" title="
      Printing
    ">
      Printing
    </a></li>
<li>
<a class="xref" href="GuideOptions.html" title="
      Options Explained
    ">
      Options Explained
    </a><div class="autotoc"><ul>
<li><a class="xref" href="GuideOptionsGeneral.html" title="
      General Options
    ">
      General Options
    </a></li>
<li><a class="xref" href="GuideOptionsImage.html" title="
      Image Options
    ">
      Image Options
    </a></li>
<li><a class="xref" href="GuideOptionsWindow.html" title="
      Window Options
    ">
      Window Options
    </a></li>
<li><a class="xref" href="GuideOptionsKeyboard.html" title="
      Keyboard Options
    ">
      Keyboard Options
    </a></li>
<li><a class="xref" href="GuideOptionsFiltering.html" title="
      Filtering Options
    ">
      Filtering Options
    </a></li>
<li>
      Metadata Options
    </li>
<li><a class="xref" href="GuideOptionsColor.html" title="
      Color management
    ">
      Color management
    </a></li>
<li><a class="xref" href="GuideOptionsBehavior.html" title="
      Advanced Behavior Options
    ">
      Advanced Behavior Options
    </a></li>
<li><a class="xref" href="GuideOptionsHidden.html" title="
      Hidden Options
    ">
      Hidden Options
    </a></li>
<li><a class="xref" href="GuideOptionsLayout.html" title="
      Window Layout
    ">
      Window Layout
    </a></li>
</ul></div>
</li>
<li><a class="xref" href="GuideReference.html" title="
      Reference
    ">
      Reference
    </a></li>
<li><a class="xref" href="GuideFaq.html" title="
      Frequently Asked Questions
    ">
      Frequently Asked Questions
    </a></li>
<li><a class="xref" href="GuideCredits.html" title="
      Credits
    ">
      Credits
    </a></li>
<li><a class="xref" href="GuideGnuFdl.html" title="
      GNU Free Documentation License
    ">
      GNU Free Documentation License
    </a></li>
</ul></div>
</li>
</ul></div></div></div>
<div class="body body-sidebar"><div class="division section">
<a name="GuideOptionsMetadata"></a><div class="header"><h1 class="section title"><span class="title">
      Metadata Options
    </span></h1></div>
<ul class="linktrail">
<li class="linktrail linktrail-first"><a class="linktrail" href="GuideIndex.html" title="
      The Geeqie User Manual
    ">
      The Geeqie User Manual
    </a></li>
<li class="linktrail linktrail-last"><a class="linktrail" href="GuideOptions.html" title="
      Options Explained
    ">
      Options Explained
    </a></li>
</ul>
<p class="para block block-first">
      This section describes the metadata writing process and options that influences it.
    </p>
<p class="para block"></p>
<div class="autotoc"><ul>
<li>
<span class="label">10.6.1. </span><a class="xref" href="GuideOptionsMetadata.html#Metadatahandling" title="
      Metadata handling
    ">
      Metadata handling
    </a>
</li>
<li>
<span class="label">10.6.2. </span><a class="xref" href="GuideOptionsMetadata.html#Optionsthatinfluencestheprocess" title="
      Options that influences the process
    ">
      Options that influences the process
    </a>
</li>
</ul></div>
<div class="division section">
<a name="Metadatahandling"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">10.6.1. </span>
      Metadata handling
    </span></h2></div>
<p class="para block block-first"></p>
<div class="autotoc"><ul>
<li>
<span class="label">10.6.1.1. </span><a class="xref" href="GuideOptionsMetadata.html#Readalgorithm" title="
      Read algorithm
    ">
      Read algorithm
    </a>
</li>
<li>
<span class="label">10.6.1.2. </span><a class="xref" href="GuideOptionsMetadata.html#Metadatamodification" title="
      Metadata modification
    ">
      Metadata modification
    </a>
</li>
<li>
<span class="label">10.6.1.3. </span><a class="xref" href="GuideOptionsMetadata.html#Writealgorithm" title="
      Write algorithm
    ">
      Write algorithm
    </a>
</li>
</ul></div>
<div class="division section">
<a name="Readalgorithm"></a><div class="header"><h3 class="section title"><span class="title"><span class="label">10.6.1.1. </span>
      Read algorithm
    </span></h3></div>
<div class="block list orderedlist"><ol class="orderedlist" compact>
<li class="li-first"><span class="para">Read exif, iptc and XMP from the file.
      </span></li>
<li><span class="para">Now we have "raw" data -&gt; show them in <a class="link" href=".html#GuideOtherWindowsExif" title="">Exif Window</a>.
      </span></li>
<li><span class="para">Read XMP sidecar or Geeqie private metadata file, which overrides the XMP read from the file.
      </span></li>
<li><span class="para">Sync XMP with exif and Iptc, this corresponds to the "reconciliation" as described in [<a class="ulink" href="http://www.adobe.com/devnet/xmp/pdfs/XMPSpecificationPart3.pdf" title="http://www.adobe.com/devnet/xmp/pdfs/XMPSpecificationPart3.pdf">XMP Specification</a>]
        <div class="block list itemizedlist"><ul class="itemizedlist" compact>
<li class="li-first"><span class="para">detect which of Exif and Xmp.exif is newer and copy the data in appropriate direction
          </span></li>
<li><span class="para">detect which of Iptc and Xmp is newer and copy the data in appropriate direction
          </span></li>
</ul></div>
      </span></li>
<li><span class="para">Now we have "processed" data - use them for Info Sidebar (title, keywords, ...), Orientation, Color management, etc.
      </span></li>
</ol></div>
<p class="para block"></p>
</div>
<div class="division section">
<a name="Metadatamodification"></a><div class="header"><h3 class="section title"><span class="title"><span class="label">10.6.1.2. </span>
      Metadata modification
    </span></h3></div>
<div class="block list itemizedlist"><ul class="itemizedlist" compact>
<li class="li-first"><span class="para">Grouped files handling (raw + jpeg): description tags (keywords, comments) are written to all image files in the group (a group contains the same image in various formats, descriptions should be the same), technical tags (exif) are handled separately for each file.
      </span></li>
<li><span class="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"
      </span></li>
<li><span class="para">Writing of the queued changes is triggered from the menu or via auto-save. It is possible to review the changes and exclude selected files.
      </span></li>
</ul></div>
<p class="para block"></p>
</div>
<div class="division section">
<a name="Writealgorithm"></a><div class="header"><h3 class="section title"><span class="title"><span class="label">10.6.1.3. </span>
      Write algorithm
    </span></h3></div>
<div class="block list orderedlist"><ol class="orderedlist" compact>
<li class="li-first"><span class="para">Exif and IPTC is updated from XMP (for example Exif.Image.Orientation is updated from Xmp.exif.orientation). See XMP and IPTC4XMP specs for the list of corresponding tags.
      </span></li>
<li><span class="para">Try to write exif, iptc and XMP to the image file
      </span></li>
<li><span class="para">Try to write XMP sidecar for raw file if previous step was not possible.
      </span></li>
<li><span class="para">If previous steps were not possible, write XMP metadata to .metadata.
      </span></li>
<li><span class="para">If previous steps were not possible, write XMP metadata to geeqie private directory.
      </span></li>
<li><span class="para">After the first successful write attempt delete old metadata files in all possible locations.
      </span></li>
</ol></div>
<p class="para block"></p>
</div>
</div>
<div class="division section">
<a name="Optionsthatinfluencestheprocess"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">10.6.2. </span>
      Options that influences the process
    </span></h2></div>
<p class="para block block-first">
      File types with allowed sidecars are listed in the Files tab.
    </p>
<p class="para block"></p>
</div>
</div></div>
<div class="navbar navbar-bottom"><table class="navbar"><tr>
<td class="navbar-prev"><a class="navbar-prev" href="GuideOptionsFiltering.html" title="
      Filtering Options
    ">
      Filtering Options
    </a></td>
<td class="navbar-next"><a class="navbar-next" href="GuideOptionsColor.html" title="
      Color management
    ">
      Color management
    </a></td>
</tr></table></div>
</body>
</html>
geeqie-common 1:1.2-3 / usr / share / doc / geeqie / html / GuideOptionsMetadata.html
