You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
199 lines
6.9 KiB
HTML
199 lines
6.9 KiB
HTML
__doctype__
|
|
<html lang="en">
|
|
__header4__
|
|
<body>
|
|
__navbar__
|
|
|
|
<div class="container">
|
|
<div class="page-header">
|
|
<h1>Command line utility examples</h1>
|
|
</div>
|
|
|
|
<div class="row">
|
|
<div class="col-md-6">
|
|
<p>By default, the utility prints a summary of the Exif information</p>
|
|
<pre>
|
|
<span class="stringliteral">$ exiv2 img_1771.jpg</span>
|
|
|
|
__sample-p__
|
|
</pre>
|
|
</div><!-- /.col-md-6 -->
|
|
<div class="col-md-6">
|
|
<p> </p>
|
|
<img src="include/img_1771.jpg" class="img-responsive img-rounded center-block" title="img_1771.jpg (32764 Bytes)" alt="Image with the Exif data shown in the sample output">
|
|
<p class="text-center text-muted"><em>Image with the Exif data shown in the sample output</em></p>
|
|
</div><!-- /.col-md-6 -->
|
|
</div><!-- /.row -->
|
|
|
|
<p> </p>
|
|
<p>With the <code>-pt</code> option, the utility prints out all Exif information as interpreted (translated) values. Alternatively, <code>-pv</code> prints the plain Exif data values.</p>
|
|
|
|
<pre>
|
|
<span class="stringliteral">$ exiv2 -pt img_1771.jpg</span>
|
|
|
|
__sample-pt__
|
|
</pre>
|
|
|
|
<p> </p>
|
|
<p>Short description of the actions and options supported by the Exiv2 utility
|
|
(see the <a href="manpage.html" title="Exiv2 man page">man page</a> for details)</p>
|
|
|
|
<a name="usage"></a><pre>
|
|
<span class="stringliteral">$ exiv2 -h</span>
|
|
|
|
__sample-h__
|
|
</pre>
|
|
|
|
<p> </p>
|
|
<p id="modify">You can modify any Exif or IPTC metadata using modify-commands from a file (<code>-m</code> option) or directly from the command line (<code>-M</code> option). Multiple <code>-M</code> and <code>-m</code> directives can be combined. Here is a sample command file for the modify option (lines starting with <code>#</code> are comments)</p>
|
|
|
|
<pre>
|
|
<span class="comment"># Sample Exiv2 command file</span>
|
|
# -------------------------
|
|
#
|
|
# $ exiv2 -m cmd.txt file ...
|
|
#
|
|
# to apply the commands in cmd.txt to each file. Alternatively, commands can be
|
|
# run from the command line directly, without a command file:
|
|
#
|
|
# $ exiv2 -M"add Iptc.Application2.Credit String mee too!" file ...
|
|
#
|
|
# Note the quotes. Multiple -m and -M options are allowed and can be combined.
|
|
#
|
|
# Command file format
|
|
# -------------------
|
|
# Empty lines and lines starting with # are ignored
|
|
# Each remaining line is a command. The format for command lines is
|
|
# <cmd> <key> [[<type>] <value>]
|
|
# cmd = set|add|del
|
|
# set will set the value of an existing tag of the given key or add a tag
|
|
# add will add a tag (unless the key is a non-repeatable IPTC key)
|
|
# del will delete a tag
|
|
# key = Exiv2 Exif or IPTC key
|
|
# type =
|
|
# Byte|Ascii|Short|Long|Rational|Undefined|SShort|SLong|SRational|Comment
|
|
# for Exif keys, and
|
|
# String|Date|Time|Short|Undefined for IPTC keys
|
|
# The format for IPTC Date values is YYYY-MM-DD (year, month, day) and
|
|
# for IPTC Time values it is HH:MM:SS±HH:MM where HH:MM:SS refers to local
|
|
# hour, minute and seconds and ±HH:MM refers to hours and minutes ahead or
|
|
# behind Universal Coordinated Time.
|
|
# A default type is used if none is explicitely given. The default type
|
|
# is determined based on the key.
|
|
# value
|
|
# The remaining text on the line is the value. It can optionally be enclosed in
|
|
# double quotes ("value")
|
|
#
|
|
|
|
add Iptc.Application2.Credit String "mee too! (1)"
|
|
add Iptc.Application2.Credit mee too! (2)
|
|
del Iptc.Application2.Headline
|
|
|
|
set Iptc.Application2.Headline Filename
|
|
|
|
add Exif.Image.WhitePoint Short 32 12 4 5 6
|
|
|
|
set Exif.Image.DateTime Ascii "Zwanzig nach fuenf"
|
|
set Exif.Image.Artist Ascii nobody
|
|
set Exif.Image.Artist "Vincent van Gogh"
|
|
|
|
set Exif.Photo.UserComment Comment charset=Ascii This is an ASCII Exif comment
|
|
</pre>
|
|
|
|
<p> </p>
|
|
<p id="xmp">The following commands are for XMP tags,
|
|
the <a href="example5.html#output">result</a>
|
|
is the same as that of Example 5.</p>
|
|
|
|
<pre>
|
|
<span class="comment"># Sample Exiv2 command file for XMP tags</span>
|
|
# --------------------------------------
|
|
|
|
# Set basic properties. Exiv2 uses the value type of the XMP specification
|
|
# for the property, if it is not specified. The default XMP value type
|
|
# for unknown properties is a simple text value.
|
|
|
|
# A simple text property.
|
|
set Xmp.dc.source xmpsample.cpp
|
|
|
|
# An array item (unordered array).
|
|
set Xmp.dc.subject "Palmtree"
|
|
|
|
# Add a 2nd array item
|
|
set Xmp.dc.subject "Rubbertree"
|
|
|
|
# A language alternative (without a default)
|
|
set Xmp.dc.title lang=en-US Sunset on the beach
|
|
set Xmp.dc.title lang=de-DE Sonnenuntergang am Strand
|
|
|
|
# Any properties can be set provided the namespace is known.
|
|
set Xmp.dc.one -1
|
|
set Xmp.dc.two 3.1415
|
|
set Xmp.dc.three 5/7
|
|
set Xmp.dc.four 255
|
|
set Xmp.dc.five 256
|
|
set Xmp.dc.six false
|
|
set Xmp.dc.seven Seven
|
|
|
|
# The value type can be specified. Exiv2 has support for a limited number
|
|
# of specific XMP types with built-in types: The basic XmpText, array
|
|
# types XmpAlt (alternative array), XmpBag (unordered array), XmpSeq
|
|
# (ordered array) and language alternatives LangAlt.
|
|
|
|
# Simple text property with explicitly specified value type
|
|
set Xmp.dc.format XmpText "image/jpeg"
|
|
|
|
# An ordered array
|
|
set Xmp.dc.creator XmpSeq "1) The first creator"
|
|
set Xmp.dc.creator "2) The second creator"
|
|
set Xmp.dc.creator "3) And another one"
|
|
|
|
# A language alternative. The default entry of a langauge alternative
|
|
# doesn't need a language qualifier.
|
|
set Xmp.dc.description LangAlt lang=de-DE Hallo, Welt
|
|
set Xmp.dc.description LangAlt Hello, World
|
|
|
|
# According to the XMP specification, Xmp.tiff.ImageDescription is an
|
|
# alias for Xmp.dc.description. Exiv2 treats an alias just like any
|
|
# other property.
|
|
set Xmp.tiff.ImageDescription TIFF image description
|
|
set Xmp.tiff.ImageDescription lang=de-DE TIFF Bildbeschreibung
|
|
|
|
# Register a namespace which Exiv2 doesn't know yet with a prefix.
|
|
reg ns myNamespace/
|
|
|
|
# There are no built-in Exiv2 value types for structures, qualifiers and
|
|
# nested types. However, these can be added by using an XmpText value and a
|
|
# path as the key.
|
|
|
|
# Add a structure
|
|
set Xmp.xmpDM.videoFrameSize/stDim:w 16
|
|
set Xmp.xmpDM.videoFrameSize/stDim:h 9
|
|
set Xmp.xmpDM.videoFrameSize/stDim:unit inch
|
|
|
|
# Add an element with a qualifier (using the namespace registered earlier)
|
|
set Xmp.dc.publisher James Bond
|
|
set Xmp.dc.publisher/?ns:role secret agent
|
|
|
|
# Add a qualifer to an array element of Xmp.dc.creator (added above)
|
|
set Xmp.dc.creator[2]/?ns:role programmer
|
|
|
|
# Add an array of structures. First set a text property with just the
|
|
# array type. (Note: this is not the same as creating an XmpBag property.)
|
|
set Xmp.xmpBJ.JobRef XmpText type=Bag
|
|
|
|
# Then set the array items. Each of them is a structure with two elements.
|
|
set Xmp.xmpBJ.JobRef[1]/stJob:name XmpText Birthday party
|
|
set Xmp.xmpBJ.JobRef[1]/stJob:role XmpText Photographer
|
|
|
|
set Xmp.xmpBJ.JobRef[2]/stJob:name Wedding ceremony
|
|
set Xmp.xmpBJ.JobRef[2]/stJob:role Best man
|
|
|
|
</pre>
|
|
|
|
</div><!-- /.container -->
|
|
__footer__
|
|
__bootstrap__
|
|
</body>
|
|
</html>
|