|
|
|
|
__doctype__
|
|
|
|
|
<html lang="en">
|
|
|
|
|
__header4__
|
|
|
|
|
<body>
|
|
|
|
|
__navbar__
|
|
|
|
|
|
|
|
|
|
<div class="jumbotron">
|
|
|
|
|
<div class="container">
|
|
|
|
|
<h1>Getting started</h1>
|
|
|
|
|
<p class="lead">An overview of the basic Exiv2 C++ library and command line utility features and the Exiv2 project,
|
|
|
|
|
examples and more.
|
|
|
|
|
</p>
|
|
|
|
|
<a href="download.html" class="btn btn-lg btn-success">
|
|
|
|
|
<span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> Download Exiv2
|
|
|
|
|
</a>
|
|
|
|
|
</div>
|
|
|
|
|
</div><!-- /.jumbotron -->
|
|
|
|
|
|
|
|
|
|
<div class="container">
|
|
|
|
|
<div class="row">
|
|
|
|
|
<div class="col-sm-6">
|
|
|
|
|
|
|
|
|
|
<h2 id="lib">Exiv2 C++ library features</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>Fast read and write access to the Exif, IPTC, and XMP metadata of an image</li>
|
|
|
|
|
<li>Easy to use and <a href="doc/index.html" title="Exiv2 API documentation">extensively documented</a> C++ API</li>
|
|
|
|
|
<li><a href="conversion.html" title="Exiv2 Conversions">Conversions</a> of Exif and IPTC metadata to XMP and vice versa</li>
|
|
|
|
|
<li>Smart IPTC implementation that does not affect data that programs like Photoshop store
|
|
|
|
|
in the same image segment</li>
|
|
|
|
|
<li>Exif <a href="makernote.html" title="Exif Makernote Formats and Specifications">Makernote</a> support:
|
|
|
|
|
<ul>
|
|
|
|
|
<li>Makernote tags can be read and written just like any other metadata</li>
|
|
|
|
|
<li>Sophisticated write algorithm avoids corrupting the Makernote</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</li>
|
|
|
|
|
<li>Simple interface to extract previews embedded in RAW images and Exif thumbnails</li>
|
|
|
|
|
<li>Set and delete methods for Exif thumbnails</li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<div class="btn-group">
|
|
|
|
|
<a class="btn btn-primary" href="examples.html" role="button">Library examples</a>
|
|
|
|
|
<button type="button" class="btn btn-primary dropdown-toggle" id="dropdownMenu1" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
|
|
|
|
|
<span class="caret"></span>
|
|
|
|
|
</button>
|
|
|
|
|
<ul class="dropdown-menu" aria-labelledby="dropdownMenu1">
|
|
|
|
|
<li><a title="Reading and printing the Exif metadata of an image" href="examples.html#example1">Read Exif metadata</a></li>
|
|
|
|
|
<li><a title="Sample usage of high-level Exif metadata operations" href="examples.html#example2">Add, modify, delete Exif</a></li>
|
|
|
|
|
<li><a title="Reading and printing the IPTC metadata of an image" href="examples.html#example3">Read IPTC datasets</a></li>
|
|
|
|
|
<li><a title="The quickest way to access, set or modify IPTC metadata" href="examples.html#example4">Set IPTC datasets</a></li>
|
|
|
|
|
<li><a title="Sample (test) usage of high level XMP classes" href="examples.html#example5">Set XMP properties</a></li>
|
|
|
|
|
</ul>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</div><!-- /.col-sm-6 -->
|
|
|
|
|
<div class="col-sm-6">
|
|
|
|
|
|
|
|
|
|
<h2 id="util">Command line utility features</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>Print Exif, IPTC and XMP image metadata in different formats: Exif summary info, interpreted values,
|
|
|
|
|
or the plain data for each tag</li>
|
|
|
|
|
<li><a title="Modify" href="sample.html#modify">Set, add and delete</a> Exif, IPTC and XMP image metadata
|
|
|
|
|
from command line modify commands or command scripts</li>
|
|
|
|
|
<li>Adjust the Exif timestamp (that's how it all started...)</li>
|
|
|
|
|
<li>Rename Exif image files according to the Exif timestamp</li>
|
|
|
|
|
<li>Extract, insert and delete Exif, IPTC and XMP metadata and JPEG comments</li>
|
|
|
|
|
<li><a href="conversion.html" title="Exiv2 Conversions">Convert</a> from Exif and IPTC to XMP properties and vice versa</li>
|
|
|
|
|
<li>Extract previews from RAW images and thumbnails from the Exif metadata</li>
|
|
|
|
|
<li>Insert and delete the thumbnail image embedded in the Exif metadata</li>
|
|
|
|
|
<li>Print, set and delete the JPEG comment of JPEG images</li>
|
|
|
|
|
<li>Fix the Exif ISO setting of picture taken with Canon and Nikon cameras</li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<a class="btn btn-primary" href="sample.html" role="button">Utility samples</a>
|
|
|
|
|
|
|
|
|
|
</div><!-- /.col-sm-6 -->
|
|
|
|
|
</div><!-- /.row -->
|
|
|
|
|
|
|
|
|
|
<p> </p>
|
|
|
|
|
|
|
|
|
|
<div class="row">
|
|
|
|
|
<div class="col-sm-6">
|
|
|
|
|
|
|
|
|
|
<div id="openhub_factoids">
|
|
|
|
|
<h2>Project summary information</h2>
|
|
|
|
|
<p>The Exiv2 project is registered with
|
|
|
|
|
<a href="https://www.openhub.net/p/exiv2">Open Hub</a>, a service that helps track and compare Open Source projects.
|
|
|
|
|
Among other things, the good people at Open Hub provide tools for evaluating Open Source projects and communities.
|
|
|
|
|
Their analysis is based on data gathered from the project's source code repositories. Below are the Open Hub "factoids"
|
|
|
|
|
for Exiv2. Use these to explore what Open Hub has to say on the state of our project.
|
|
|
|
|
</p>
|
|
|
|
|
<script type="text/javascript" src="http://www.openhub.net/p/13985/widgets/project_factoids.js"></script>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</div><!-- /.col-sm-6 -->
|
|
|
|
|
<div class="col-sm-6">
|
|
|
|
|
|
|
|
|
|
__whatsnew-latest__
|
|
|
|
|
|
|
|
|
|
</div><!-- /.col-sm-6 -->
|
|
|
|
|
</div><!-- /.row -->
|
|
|
|
|
|
|
|
|
|
<div class="row">
|
|
|
|
|
<div class="col-sm-6">
|
|
|
|
|
|
|
|
|
|
<h2>Future plans</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>A unified metadata container</li>
|
|
|
|
|
<li>Support for additional image formats</li>
|
|
|
|
|
<li>More Makernotes</li>
|
|
|
|
|
<li>CMake support for all platforms</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p>The <a href="http://dev.exiv2.org/projects/exiv2/roadmap">roadmap</a> has details for the upcoming version.</p>
|
|
|
|
|
|
|
|
|
|
</div><!-- /.col-sm-6 -->
|
|
|
|
|
</div><!-- /.row -->
|
|
|
|
|
|
|
|
|
|
__footer__
|
|
|
|
|
|
|
|
|
|
</div><!-- /.container -->
|
|
|
|
|
|
|
|
|
|
__bootstrap__
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
