RubyGems - exiftool_vendored - Versions diffs - 10.49.0 → 10.56.0 - Mend

exiftool_vendored 10.49.0 → 10.56.0

Potentially problematic release.

This version of exiftool_vendored might be problematic. Click here for more details.

Files changed (1010) hide show

data/bin/Image-ExifTool-10.49/html/install.html DELETED Viewed

@@ -1,261 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-        "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
-<html>
-<head>
-<title>Installing ExifTool</title>
-<link rel=stylesheet type='text/css' href='style.css' title='Style'>
-<style type="text/css">
-<!--
-li      { margin-top: .5em }
-.attn   { padding: 0.5em; border: 1px solid gray; background: #fee }
-div.rt  { float: right; clear: both }
--->
-</style></head>
-<body>
-<div class='rt'>
-(<a href="install-fr.pdf">PDF en fran&ccedil;ais</a>)
-</div>
-<h1 class='up'>Installing ExifTool</h1>
-<blockquote class=attn><b class=red>Note:</b> ExifTool <b>does <u>not</u> need
-to be installed</b> to run.  Just download and extract either the full Perl
-distribution on Mac/Linux, or the Windows EXE version on Windows, and run it
-directly.  <i class=lt>[But note that if you move the Perl "exiftool"
-application, you must also move its "lib" directory to the same location. This
-doesn't apply to the Windows version which unpacks the libraries into a
-temporary directory.]</i><br><br>However, the benefits of installation are:
-<ul><li>Makes ExifTool available to all users.</li>
-<li>Saves typing on the command line (by placing "exiftool" in your PATH).</li>
-<li>Installs the ExifTool documentation and API libraries (full Perl version only).</li>
-</ul></blockquote>
-<p>See the appropriate section below with instructions for installing or
-uninstalling ExifTool on your specific platform:</p>
-<ul>
-<li><a href="#Windows">Windows</a></li>
-<li><a href="#OSX">Macintosh OS X</a></li>
-<li><a href="#Unix">Unix Platforms</a></li>
-</ul>
-<p>Also see <a href="index.html#running">these instructions</a> for help running
-ExifTool.</p>
-<hr>
-<h2><a name="Windows">Windows</a></h2>
-<p>In Windows, there is a choice of two different versions of ExifTool to
-install.  The Perl distribution requires Perl to be installed on your system.
-(A good, free Perl interpreter can be downloaded from
-<a href="http://www.activestate.com/activeperl/">activeperl.com</a>.)</p>
-<p>If you don't already have Perl, it is easier to install the stand-alone ExifTool
-executable, but note that the stand-alone version doesn't include the HTML
-documentation or some other files of the full distribution.</p>
-<h3>Stand-Alone Executable</h3>
-<ol>
-<li><b>Download</b> the <b>Windows Executable</b> from the <a href="index.html">ExifTool home page</a>.
-<br><span class=lt>(The file you download will have a name like "<code>exiftool-10.49.zip</code>".)</span></li>
-<li><b>Extract "<code>exiftool(-k).exe</code>"</b> from the
-"<code>.zip</code>" file, and place it <b>on your Desktop</b>.
-<br><span class=lt>(Double-click on "<code>exiftool-10.49.zip</code>" to open
-the archive, then drag "<code>exiftool(-k).exe</code>" to your Desktop.)</span></li>
-</ol>
-<p>You can now double-click on "<code>exiftool(-k).exe</code>" to read the
-application documentation, or drag-and-drop files and folders to run exiftool on
-selected files. To install exiftool for <b>use from the command line</b>,
-continue with the following steps:</p>
-<ol start=3>
-<li><b>Rename</b> "<code>exiftool(-k).exe</code>" to <b>"<code>exiftool.exe</code>"</b>.
-<br><span class=lt>(or "<code>exiftool(-k)</code>" to "<code>exiftool</code>" if file name
-extensions are hidden on your system)</span></li>
-<li><b>Move "<code>exiftool.exe</code>"</b> to the "<code>C:\WINDOWS</code>" directory
-(or any other directory in your PATH).</li>
-</ol>
-<p>You can now run exiftool by typing "<code>exiftool</code>" at the command
-prompt.  (To get to the command prompt, select "Run..." from the Windows "Start"
-menu, then type "<code>cmd</code>" and press Return.)</p>
-<p><b>Notes:</b></p>
-<ol type='a'>
-<li>In Windows 7, running exiftool requires administrator privileges.  If
-necessary, this may be enabled by right clicking on exiftool, then selecting
-<b>"Run this program as administrator"</b> from the Compatibility settings.</li>
-<li>Occasionally users have reported that exiftool gives errors when running
-this version for this first time.  It is possible this may happen if a file gets
-corrupted during the download/installation process.  In this case, follow the
-Uninstalling instructions below then re-install exiftool. Be sure that you have
-sufficient disk space in your TEMP directory for exiftool to unpack about 12 MB
-of temporary files -- these are the Perl libraries used by the exiftool
-application which are unpacked the first time exiftool is run.</li>
-</ol>
-<p><b>Uninstalling:</b></p>
-<ol type='i'>
-<li>Drag "<code>exiftool(-k).exe</code>" (or "<code>C:\WINDOWS\exiftool.exe</code>")
-into the Recycle bin.</li>
-<li>Drag the directory "<code>par-XXX</code>" from your temporary directory to
-the Recycle bin.  Here "<code>XXX</code>" is your user name (in ASCII-hex for
-ExifTool 10.21 or later) and the location of the temporary directory depends on
-the value of the TEMP environment variable (typically
-"<code>C:\Documents and Settings\USER\Local Settings\Temp</code>"
-for Windows XP, or "<code>C:\Users\USER\AppData\Local\Temp</code>" for Windows 7
-or later).</li>
-</ol>
-<h3>Full Perl Distribution</h3>
-<p>You must have Perl installed to use this version.  (A free version of Perl
-can be downloaded from
-<a href="http://www.activestate.com/activeperl/">activeperl.com</a>.)</p>
-<ol>
-<li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
-<br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-10.49.tar.gz</code>".)</span></li>
-<li><b>Extract the ExifTool files</b> from the archive.
-<br><span class=lt>(The archive is a gzipped tar file, and can be opened with
-various Windows utilities, including WinZip.)</span></li>
-<li><b>Rename</b> "<code>exiftool</code>" to <b>"<code>exiftool.pl</code>"</b>
-in the exiftool distribution.</li>
-<li><b>Move "<code>exiftool.pl</code>"</b> and the <b>"<code>lib</code>"</b>
-directory from the exiftool distribution to "<code>C:\WINDOWS</code>"
-(or any other directory in your PATH).</li>
-</ol>
-<p>Now, if you have made the proper Windows associations for the
-"<code>.pl</code>" extension (an option in the ActivePerl installation), you
-can run exiftool by typing "<code>exiftool.pl</code>" at the
-"<code>cmd.exe</code>" prompt.  Otherwise you should type
-"<code>perl c:\windows\exiftool.pl</code>".</p>
-<p><b>Uninstalling:</b></p>
-<ol type='i'>
-<li>Drag "<code>C:\WINDOWS\exiftool.pl</code>" and
-"<code>C:\WINDOWS\lib</code>" into the Recycle bin.  You should first confirm
-that "<code>C:\WINDOWS\lib</code>" contains only the "<code>File</code>"
-and "<code>Image</code>" sub-directories.  Do not delete it if it
-contains anything else.</li>
-</ol>
-<hr>
-<h2><a name="OSX">Macintosh OS X</a></h2>
-<p>If you have installed the BSDSDK package from the Xcode Developer Tools
-(<i>ie. if you have the</i> "<code>make</code>" <i>utility</i>), you should
-follow the install procedure for <a href="#Unix">Unix platforms</a> in the next
-section instead of the steps below. The Unix install has the advantage of making
-the ExifTool library available for your Perl scripts, as well as installing the
-man pages and POD documentation.</p>
-<p>Otherwise, you have a choice of two packages to install: The OS X package, or
-the full Perl distribution.  Both of the procedures below install the ExifTool
-files in the same location.  Installing from the OS X package is easier, but the
-full distribution includes HTML documentation and some other files not included
-in the OS X package.  Both versions run natively on PPC and Intel Macs.</p>
-<h3>OS X Package</h3>
-<ol>
-<li><b>Download</b> the <b>ExifTool OS X Package</b> from the <a href="index.html">ExifTool home page</a>.
-<br><span class=lt>(The file you download will have a name like "<code>ExifTool-10.49.dmg</code>".)</span></li>
-<li><b>Install</b> as a normal <b>OS X package</b>.
-<br><span class=lt>(Open the disk image, double-click on the install package, and follow the instructions.)
-</span></li>
-</ol>
-<p>You can now run exiftool by typing "<code>exiftool</code>" in a Terminal window.</p>
-<p>If this doesn't work, then it is likely you have an older version of OS X for which
-/usr/local/bin isn't in the default PATH.  To fix this, add the following line to your
-~/.profile settings using a text editor:</p>
-<blockquote><code>export PATH=$PATH:/usr/local/bin</code></blockquote>
-<h3>Full Perl Distribution</h3>
-<ol>
-<li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
-to your Desktop.
-<br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-10.49.tar.gz</code>".)</span></li>
-<li><b>Launch</b> the <b>Terminal</b> application from the Utilities folder in your Applications folder.</li>
-<li>In the Terminal window, <b>type the following</b>:
-<pre class='code'>    cd ~/Desktop
-    tar -xzf Image-ExifTool-10.49.tar.gz
-    cd Image-ExifTool-10.49
-    sudo cp -r exiftool lib /usr/local/bin
-</pre>
-<span class=lt>(Note: The last step above will require you to enter your
-password.)</span></li>
-</ol>
-<p>You can now run exiftool by typing "<code>exiftool</code>" in a Terminal window.</p>
-<p class=lt><b>Notes:</b></p><ul class=lt><li>Both OS X installation techniques outlined above place
-exiftool and its lib directory in /usr/local/bin, while the standard Unix
-"<code>make install</code>" described below puts "<code>exiftool</code>" in
-/usr/local/bin and the individual libraries in /Library/Perl/#.#.#, where "#.#.#" is
-your Perl version. If both sets of libraries exist, /usr/local/bin/lib takes
-precedence for exiftool, but /Library/Perl/#.#.# is the default for any other
-Perl scripts.</li>
-<li>In OS X 10.8 or later, you may see this message when you try to open the install package:
-<blockquote class=red>"ExifTool-10.49.pkg" can't be opened because it is from an
-unidentified developer.</blockquote> The solution is to control-click on the pkg
-then select "Open" from the pop-up menu instead of just double-clicking.  An alternative
-is to lower the security settings by changing "Allow applications downloaded from" to
-"Anywhere" in the General "Security &amp; Privacy" System Preferences.
-(<a href="http://news.softpedia.com/news/Fix-OS-X-Error-Application-Can-t-Be-Opened-Because-it-Is-from-an-Unidentified-Developer-407375.shtml">Read
-here</a> for a full description.)</li></ul>
-<h3>Uninstalling</h3>
-<ol type='i'>
-<li>Launch the "Terminal" application from the Applications Utilities folder.</li>
-<li>Type "<code>open /usr/local/bin</code>" (without the quotes) in the Terminal
-window, then press RETURN. (This opens a folder that you normally can't access
-from OS X.)</li>
-<li>Drag "<code>exiftool</code>" and "<code>lib</code>" into the trash from the
-"<code>bin</code>" folder you opened. You should first confirm that
-"<code>lib</code>" contains only two sub-folders: "<code>File</code>" and
-"<code>Image</code>". If it contains anything else, don't trash it because you
-have the wrong "<code>lib</code>" folder.</li>
-</ol>
-<hr>
-<h2><a name="Unix">Unix Platforms</a></h2>
-<ol>
-<li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
-<br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-10.49.tar.gz</code>".)</span></li>
-<li><b>Unpack the distribution</b> and <b>make it your current directory</b> by typing:
-<pre class='code'>    cd <i>&lt;your download directory&gt;</i>
-    gzip -dc Image-ExifTool-10.49.tar.gz | tar -xf -
-    cd Image-ExifTool-10.49
-</pre>
-<span class=lt>(At this point you may run exiftool by typing
-"<code>exiftool <i>&lt;image file name&gt;</i></code>".)</span></li>
-<li><b>Test and install ExifTool</b> by typing:
-<pre class='code'>
-    perl Makefile.PL
-    make test
-    sudo make install
-</pre>
-<span class=lt>(Note: The "<code>make test</code>" step is not required, but
-useful because it runs a full suite of tests to verify that ExifTool is working
-properly on your system.  The "<code>sudo make install</code>" command requires
-that you have su access, and will prompt for your password.  This will make
-ExifTool and its documentation accessible to all users on your system. If you
-don't have su access, you can run ExifTool in your own account by moving
-"<code>exiftool</code>" and its "<code>lib</code>" directory to any convienient
-location, preferably somewhere in your PATH.)</span></li>
-</ol>
-<p>You can now run exiftool by typing "<code>exiftool</code>".  Also, you can
-consult the ExifTool documentation with commands like:</p>
-<blockquote><pre class='code'>perldoc exiftool
-perldoc Image::ExifTool
-perldoc Image::ExifTool::TagNames
-</pre></blockquote>
-<p>or</p>
-<blockquote><pre class='code'>man exiftool
-man Image::ExifTool
-man Image::ExifTool::TagNames
-</pre></blockquote>
-<h3>Uninstalling</h3>
-<ol type='i'>
-<li>Type "<code>sudo make uninstall</code>" from the distribution directory.
-<br><span class=lt>(Note: Unfortunately, newer systems may give an <i>"Uninstall
-is unsafe and deprecated"</i> message even though uninstalling ExifTool is safe
-because it has no dependencies.  If this happens, the necessary commands to
-remove the installed files will be listed, and these commands must be run
-manually.)</span></li>
-</ol>
-<hr>
-<p class='lf'><a href="index.html">&lt;-- Back to ExifTool home page</a></p>
-</body>
-</html>

data/bin/Image-ExifTool-10.49/html/metafiles.html DELETED Viewed

@@ -1,322 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-        "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
-<html>
-<head>
-  <title>Metadata Sidecar Files</title>
-<link rel=stylesheet type='text/css' href='style.css' title='Style'>
-<style type="text/css">
-<!--
-blockquote  { margin-top: 1em; margin-bottom: 1em }
-pre         { color: #800; margin-left: 4em }
-pre.code    { color: #000; padding: 0; margin: 0 }
-.lt         { color: #666 }
-.ind        { margin-left: 2.5em }
-p.a         { margin: 1em 2em 0 1em }
-p.b         { margin: 0 2em 1em 2.2em; color: #666 }
-p.c         { margin: 1em 2em 1em 2.2em; color: #666 }
--->
-</style>
-</head>
-<body>
-<div class='index'>
-<a href="#xmp">XMP Sidecar Files</a>
-<br><a href="#xml">ExifTool XML Files</a>
-<br><a href="#exif">EXIF Files</a>
-<br><a href="#mie">MIE Files</a>
-<br><a href="#exv">EXV Files</a>
-</div>
-<h1 class=up>Metadata Sidecar Files</h1>
-<p>Metadata for images and other file types may be stored in a separate metadata
-file. These are the only files that exiftool can create from scratch.  A common
-example of this is the XMP "sidecar" file (which is discussed in the next
-section in some detail).  Other supported metadata file types are EXIF, MIE,
-EXV, ICC and VRD.  As well, ExifTool supports XML-format output, which can also
-be used to generate metadata sidecar files.</p>
-<hr>
-<a name="xmp"></a>
-<h3>XMP Sidecar Files</h3>
-<p>There are a number of different ways to generate an XMP sidecar file with
-exiftool, and the method you choose depends on your circumstances and
-preferences. Below are a number of example commands which write an output XMP
-file from information in a source file of any type.</p>
-<p class=a><a name="EX1">1.</a> Copy same-named tags from all information types to preferred locations in XMP:</p>
-<p class=b>(<code><i>SRC</i>.<i>EXT</i></code> is the source file name and
-extension, and <code><i>DST</i></code> is the destination file name)</p>
-<pre>exiftool -tagsfromfile <i>SRC</i>.<i>EXT</i> <i>DST</i>.xmp</pre>
-<p class=a><a name="EX2">2.</a> Rewrite source file to destination XMP file:</p>
-<p class=b>(same effect as above, but the command will exit with an error if the output XMP file already exists)</p>
-<pre>exiftool <i>SRC</i>.<i>EXT</i> -o <i>DST</i>.xmp</pre>
-<p class=a><a name="EX3">3.</a> Copy XMP, preserving original locations:</p>
-<p class=b>(ie. copies XMP tags only to the same namespaces in the destination file)</p>
-<pre>exiftool -tagsfromfile <i>SRC</i>.<i>EXT</i> -all:all <i>DST</i>.xmp</pre>
-<p class=c>Advanced: Notice that <code>-all:all</code> is used above instead of
-<code>-xmp:all</code> even though only XMP tags will be copied (since the destination
-is an XMP file).  This is because <code>-all:all</code> preserves the family 1 group
-(ie. XMP namespace) while <code>-xmp:all</code> would copy tags to the preferred XMP
-namespace, which may be different for XMP tags that exist in multiple namespaces.
-To get the best of both worlds, <code>"-all:all&lt;xmp:all"</code> may be used to
-avoid the inefficiencies of assigning tags which aren't copied, while still
-preserving the family 1 group.</p>
-<p class=a><a name="EX4">4.</a> Rewrite source to XMP file, preserving locations:</p>
-<p class=b>(same effect as above, but the command will fail if the XMP file already exists)</p>
-<pre>exiftool <i>SRC</i>.<i>EXT</i> -o <i>DST</i>.xmp -all:all</pre>
-<p class=a><a name="EX5">5.</a> Generate XMP from EXIF and IPTC using standard tag name mappings:</p>
-<p class=b> (the <code>.args</code> files are available in the full ExifTool distribution)</p>
-<pre>exiftool -tagsfromfile <i>SRC</i>.<i>EXT</i> -@ exif2xmp.args -@ iptc2xmp.args <i>DST</i>.xmp</pre>
-<p class=a><a name="EX6">6.</a> Copy XMP as a block to an XMP file:</p>
-<p class=b>(writing as a block is the only way to transfer unknown or non-writable XMP tags)</p>
-<pre>exiftool -tagsfromfile <i>SRC</i>.<i>EXT</i> -xmp <i>DST</i>.xmp</pre>
-<p class=c>Note that this will not deal with extended XMP segments in JPEG
-images if they exist.</p>
-<p><a name="EX7">7.</a> Extract XMP as a block and write to output XMP file: <span class=lt>(same effect as above)</span></p>
-<pre>exiftool -xmp -b <i>SRC</i>.<i>EXT</i> > <i>DST</i>.xmp</pre>
-<p class=c>As with the previous command, this command will not copy extended XMP
-segments in JPEG images, but in this case the <code>-a</code> option may be
-added to also extract extended XMP blocks.  However, the result would be a
-non-standard XMP file that ExifTool could read but other utilities may not.</p>
-<p class=a><a name="EX8">8.</a> Extract XMP as a block to an output text file with .xmp extension:</p>
-<p class=b>(same effect as above, but the destination file name will be the same
-as the source file, and this command will fail if the XMP file exists while the
-previous command will overwrite an existing file)</p>
-<pre>exiftool -xmp -b -w xmp <i>SRC</i>.<i>EXT</i></pre>
-<p class=c>The advantage of this command is that it may be applied to multiple
-source files or entire directories.</p>
-<p><a name="EX9">9.</a> Restore all XMP tags from an XMP sidecar file to XMP in a JPG image:</p>
-<pre>exiftool -tagsfromfile <i>SRC</i>.xmp -all:all <i>DST</i>.jpg</pre>
-<p class=a><a name="EX10">10.</a> Restore XMP as a block from an XMP sidecar file to a JPG image:</p>
-<p class=b>(same effect as above except that any non-writable XMP tags would be
-copied by this command, and the 2 kB of padding recommended by the XMP
-specification is not added when copying as a block)</p>
-<pre>exiftool -tagsfromfile <i>SRC</i>.xmp -xmp <i>DST</i>.jpg</pre>
-<h4>Batch Processing</h4>
-<p>Multiple files may be processed in a single command by specifying multiple
-file and/or directory names on the command line.  The examples below demonstrate
-how to process all files with a specific extension in an entire directory tree.</p>
-<p class=a><a name="EX11">11.</a> Create XMP sidecar files for all files with extension EXT in a
-directory tree:</p>
-<p class=b>(when batch-generating sidecar files from many images, the <code>-o</code>
-form of the command is easier to use, but can not be used to modify
-existing XMP files)</p>
-<pre>exiftool -ext <i>EXT</i> -o %d%f.xmp -r <i>DIR</i></pre>
-<p class=c>where <code><i>DIR</i></code> is the name of the directory containing
-the images.  The <code>-r</code> option causes sub-directories to be recursively
-processed.  Multiple <code>-ext</code> options may be used to process different
-file types in a single command.  With this command, same-named tags from any type
-of metadata will be written to the preferred XMP namespace in the output XMP
-file.  To copy only XMP tags, <code>-xmp:all</code> may be added to the command.
-(See example 14 for more about this.)</p>
-<p class=a><a name="EX12">12.</a> Copy tags to sidecar files that already exist:</p>
-<p class=b>(same as above, but copies only to existing XMP files)</p>
-<pre>exiftool -ext xmp -tagsfromfile %d%f.<i>EXT</i> -r <i>DIR</i></pre>
-<p class=c>This command will add tags from the source files to information that
-already exists in the XMP files, but note that this command searches for the XMP
-files instead of the image files, so it will not generate new XMP sidecar files
-if some images don't have them.  For this, the advanced (ie. tricky and
-confusing to use) <code>-srcfile</code> option comes in handy:</p>
-<p class=a><a name="EX13">13.</a> Copy tags to sidecar files, generating new files if necessary:</p>
-<p class=b>(same as above, but also creates new XMP files if they don't exist)</p>
-<pre>exiftool -ext <i>EXT</i> -tagsfromfile @ -srcfile %d%f.xmp -r <i>DIR</i></pre>
-<p class=c>Note that as with the previous two commands, this command will
-commute metadata from other groups to the preferred location in XMP.</p>
-<p class=a><a name="EX14">14.</a> Copy only XMP tags to the same namespace in sidecar files:</p>
-<p class=b>(same as above, but copies only XMP and preserves specific tag locations)</p>
-<pre>exiftool -ext <i>EXT</i> -tagsfromfile @ "-all:all&lt;xmp:all" -srcfile %d%f.xmp -r <i>DIR</i></pre>
-<p class=c>In this command, if "<code>-xmp:all</code>" was used instead of
-<code>"-all:all&lt;xmp:all"</code>, then all XMP tags would have been copied to
-their preferred namespaces in the sidecar file.  But by writing to the
-destination group of "<code>all</code>", the specific location (ie. XMP
-namespace) of each tag is preserved.</p>
-<p class=a><a name="EX15">15.</a> Copy XMP from sidecar files back to the same locations in the source files:</p>
-<p class=b>(the inverse of the previous command)</p>
-<pre>exiftool -ext <i>EXT</i> -tagsfromfile %d%f.xmp -all:all -r <i>DIR</i></pre>
-<p class=c>Here,
-<code>-all:all</code> copies all metadata (in this case only XMP, since the
-sidecar XMP file contains no other types) to the same specific locations in the
-target files (extension <code><i>EXT</i></code>).</p>
-<p class=a><a name="EX16">16.</a> Write a tag to XMP sidecar if it exists, or the original file otherwise:</p>
-<pre>exiftool -ext <i>EXT</i> -artist="Phil" -srcfile %d%f.xmp -srcfile @ <i>DIR</i></pre>
-<p class=c>When multiple <code>-srcfile</code> options are used, the first
-existing file is processed.  If none of the specified source files exists, then
-the first one in the list is created (however, this won't happen with this
-example since one of the specified source files is "<code>@</code>", which
-represents the original file name).</p>
-<p class=a><a name="EX17">17.</a> Create XMP sidecar file in another directory:</p>
-<pre>exiftool -ext <i>EXT</i> -o <i>DSTDIR</i>/%f.xmp -r <i>SRCDIR</i></pre>
-<p class=c>By specifying a directory name instead of <code>%d</code>, this
-command writes XMP files to <code><i>DSTDIR</i></code> instead of the original
-source directory. The same technique may be used in any of the above commands to
-write XMP to a sidecar file in a different directory.</p>
-<h4>Via the API</h4>
-<p>By specifying different tags in the
-<a href="ExifTool.html#SetNewValuesFromFile">SetNewValuesFromFile</a>
-call, the above examples numbered 1-6 are programmed like this:</p>
-<blockquote><table class='box'><tr><td><pre class='code'>
-$exifTool-><a href="ExifTool.html#SetNewValuesFromFile">SetNewValuesFromFile</a>('SRC.EXT', @tags_to_copy);
-$exifTool-><a href="ExifTool.html#WriteInfo">WriteInfo</a>(undef, 'DST.xmp');
-</pre></td></tr></table></blockquote>
-<p>and examples 7 and 8 use this general technique:</p>
-<blockquote><table class='box'><tr><td><pre class='code'>
-my $info = <a href="ExifTool.html#ImageInfo">ImageInfo</a>('SRC.EXT', 'xmp');
-die "No XMP" unless $$info{XMP};
-open FILE, '&gt;DST.xmp';
-print FILE ${$$info{XMP}};
-close FILE;
-</pre></td></tr></table></blockquote>
-<hr>
-<a name="xml"></a>
-<h3>ExifTool XML Files</h3>
-<p>Closely related to the XMP sidecar file is the XML file written using the
-exiftool <code>-X</code> option.  This file is RDF/XML format like XMP, but uses
-exiftool-specific namespaces to give an exact mapping for all exiftool tag
-names.  This type of file is better suited to general information
-storage/recovery since it facilitates copying of more original metadata than an
-XMP file, but it doesn't have the portability of an XMP file or the ability to
-store native-format data like a MIE or EXV file, and ExifTool can not be used to
-edit XML files as it can with other metadata files.  Below are example commands
-demonstrating the use of exiftool XML files.</p>
-<p>Create an exiftool XML sidecar file:</p>
-<pre>exiftool -X a.jpg > a.xml</pre>
-<p>Restore original meta information from exiftool XML file:</p>
-<pre>exiftool -tagsfromfile a.xml -all:all a.jpg</pre>
-<p>The <code>-X</code> option also supports extracting binary data when
-<code>-b</code> is added.  For example, the above command may be modified to
-also store the binary MakerNotes block like this:</p>
-<pre>exiftool -X -b -makernotes -all a.jpg > a.xml</pre>
-<p>Note that we needed to add <code>-makernotes</code> because it isn't
-extracted as a block unless requested, and since we specified a tag to extract
-we also needed to add <code>-all</code> to continue extracting other tags as
-well.  Restoring the original metadata from this file is the same as in the
-previous example.</p>
-<h4>Via the API</h4>
-<p>There is no way to automatically produce a sidecar exiftool XML file via the
-API since this function is accomplished with an output formatting option of the
-exiftool application.  However, the the API may be used to read and copy tags
-from an exiftool XML file just like any other file format.  When reading
-ExifTool XML files, all tags except those in the <code>ExifTool</code>,
-<code>File</code> and <code>Composite</code> groups are extracted with their
-original family 1 groups to facilitate copying of these tags back into their
-original locations in an image.</p>
-<hr>
-<a name="exif"></a>
-<h3>EXIF Files</h3>
-<p>EXIF files store EXIF information in the same format as in the APP1 segment
-of a JPEG image (<i>with the exception that there is no size limit for an
-EXIF file, while EXIF data in a JPEG image is limited to a maximum of 65527
-bytes</i>). The three commands below illustrate techniques for copying the
-entire EXIF block from a source image (<code><i>SRCFILE</i></code>) to an
-output EXIF file (<code>out.exif</code>):</p>
-<pre>exiftool -exif -b <i>SRCFILE</i> > out.exif
-exiftool -tagsfromfile <i>SRCFILE</i> -exif out.exif
-exiftool -o out.exif -exif <i>SRCFILE</i></pre>
-<p>It is the specification of the <a href="TagNames/Extra.html">Extra</a> EXIF
-tag in each of the above commands (the "<code>-exif</code>" argument) that
-causes the EXIF information to be extracted as a block.  JPEG, PNG, JP2, MIE and
-MIFF files all support storage of EXIF data blocks in this format, although
-exiftool does not currently write MIFF images.</p>
-<p>Tags may also be copied individually to and from an EXIF file, but remember
-that this will not copy "unsafe" tags unless they are specified explicitly.  The
-following command creates an EXIF file from the metadata in a source file:</p>
-<pre>exiftool -o out.exif -all -unsafe <i>SRCFILE</i>
-</pre>
-<p>This technique works for any type of source file, provided the file contains
-at least one tag with the same name as an EXIF tag.  Below is an example of how
-to apply this to all files in a directory:</p>
-<pre>exiftool -o %d%f.exif -all -unsafe <i>DIR</i>
-</pre>
-<hr>
-<a name="mie"></a>
-<h3>MIE Files</h3>
-<p>The <a href="MIE1.1-20070121.pdf">MIE file format</a> allows storage of
-native binary meta information, and is the best option for saving metadata from
-a file in its original format.  Here are two examples that copy all individual
-tags plus the ICC Profile to a MIE sidecar file:</p>
-<pre>exiftool -tagsfromfile a.jpg -all:all -icc_profile a.mie</pre>
-<pre>exiftool -o a.mie -all:all -icc_profile a.jpg</pre>
-<p>And the following command performs the inverse operation, restoring metadata
-in a JPG image from a MIE file:</p>
-<pre>exiftool -tagsfromfile a.mie -all:all -icc_profile a.jpg</pre>
-<p>Information can also be copied in block form to a MIE file.  This allows
-preservation of the original data structure as well as unknown and non-writable
-tags.  The command below copies the full EXIF segment as a block from a JPEG
-image,</p>
-<pre>exiftool -tagsfromfile a.jpg -exif a.mie</pre>
-<p>which is functionally different from copying all writable EXIF tags
-individually with a command more like this</p>
-<pre>exiftool -tagsfromfile a.jpg -exif:all a.mie</pre>
-<p>Block-writable tags are listed in the
-<a href="TagNames/Extra.html">Extra Tags documentation</a>.</p>
-<p>MIE files also have the ability to store information in compressed format with
-the <code>-z</code> option (provided Compress::Zlib is installed on your system),
-which may be useful if disk space is at a premium.</p>
-<hr>
-<a name="exv"></a>
-<h3>EXV Files</h3>
-<p>EXV files are used by <a href="http://exiv2.org/">Exiv2</a>, and are
-basically a JPEG file without the image data, so they may be used as a metadata
-file to contain any information supported by the JPEG format (EXIF, XMP, IPTC,
-etc.).  ExifTool has full read, write and create support for this format.</p>
-<hr>
-<i>Created Nov 12, 2008</i><br>
-<i>Last revised Sept 3, 2015</i>
-<p class='lf'><a href="index.html">&lt;-- Back to ExifTool home page</a></p>
-</body>
-</html>