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.
179 lines
8.1 KiB
HTML
179 lines
8.1 KiB
HTML
__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="col-sm-pair">
|
|
<div class="row">
|
|
<div class="col-sm-6">
|
|
|
|
<h2 id="lib">Exiv2 C++ library</h2>
|
|
<ul>
|
|
<li>Fast read and write access to the
|
|
<a href="http://en.wikipedia.org/wiki/Exif">Exif</a>,
|
|
<a href="http://en.wikipedia.org/wiki/IPTC">IPTC</a> and
|
|
<a href="http://en.wikipedia.org/wiki/Extensible_Metadata_Platform">XMP</a>
|
|
<a href="http://en.wikipedia.org/wiki/Metadata">metadata</a> 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>
|
|
|
|
<h4 class="margin-top-m">Future plans</h4>
|
|
<p>These are high-level goals for the Exiv2 library, see the
|
|
<a href="http://dev.exiv2.org/projects/exiv2/roadmap">roadmap</a>
|
|
for details for the upcoming version.
|
|
</p>
|
|
<ul>
|
|
<li>A stable API</li>
|
|
<li>A unified metadata container</li>
|
|
<li>Additional image formats and more Makernote support</li>
|
|
</ul>
|
|
|
|
<div class="panel panel-primary margin-top-s">
|
|
<div class="panel-body">
|
|
<p>
|
|
To learn how to use the Exiv2 library in your own programs, start by reading the
|
|
short <a href="doc/index.html">API documentation intro</a> and study some of the examples here.
|
|
Refer to the <a href="metadata.html">metadata taglists</a> for supported tags and default types
|
|
and the <a href="doc/namespaceExiv2.html">API documentation</a> for the interface.
|
|
</p>
|
|
<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>
|
|
</div>
|
|
|
|
<div class="panel panel-primary">
|
|
<div class="panel-body">
|
|
<h2>Exiv2 Community and Resources</h2>
|
|
<p>The Exiv2 community website provides access to all project resources, including the
|
|
<a href="http://dev.exiv2.org/projects/exiv2/issues">issue tracker</a>,
|
|
<a href="http://dev.exiv2.org/projects/exiv2/wiki">wiki</a>,
|
|
<a href="http://dev.exiv2.org/projects/exiv2/boards">forum</a> and
|
|
<a href="http://dev.exiv2.org/projects/exiv2/repository">source code repository</a>.
|
|
There you can interact with project members and users
|
|
to get help and support, report bugs and get involved with the project.
|
|
</p>
|
|
<a class="btn btn-primary" href="http://dev.exiv2.org/projects/exiv2/wiki" role="button">Community website</a>
|
|
</div>
|
|
</div>
|
|
|
|
</div><!-- /.col-sm-6 -->
|
|
|
|
<div class="col-sm-6">
|
|
<h2 id="util">Command line utility</h2>
|
|
<ul>
|
|
<li>Print <a href="http://en.wikipedia.org/wiki/Exif">Exif</a>,
|
|
<a href="http://en.wikipedia.org/wiki/IPTC">IPTC</a> and
|
|
<a href="http://en.wikipedia.org/wiki/Extensible_Metadata_Platform">XMP</a> image
|
|
<a href="http://en.wikipedia.org/wiki/Metadata">metadata</a> in different formats:
|
|
Exif summary info, interpreted values, or the plain data for each tag</li>
|
|
<li>Print the structure of images. This is useful for image file analysis.</li>
|
|
<li><a title="Modify" href="sample.html#modify">Set, add and delete</a> Exif, IPTC, XMP metadata and ICC profile
|
|
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>
|
|
<li>Metadata and ICC Profiles can be very conveniently piped on the command-line from one image to others.</li>
|
|
</ul>
|
|
|
|
<div class="panel panel-primary margin-top-s">
|
|
<div class="panel-body">
|
|
<p>
|
|
To get started with the Exiv2 command line utility, run it with the <em>-h</em>
|
|
parameter from a terminal or cmd shell:
|
|
<code><a title="Exiv2 usage" href="sample.html#usage">exiv2 -h</a></code> and
|
|
study the samples here.
|
|
For details, read the <a href="manpage.html" title="Exiv2 man page">manual page</a>.
|
|
</p>
|
|
<a class="btn btn-primary" href="sample.html" role="button">Utility samples</a>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="panel panel-primary">
|
|
<div class="panel-body">
|
|
<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>
|
|
</div><!-- /.col-sm-6 -->
|
|
</div><!-- /.row -->
|
|
</div><!-- /.col-sm-pair -->
|
|
</div><!-- /.container -->
|
|
|
|
__footer__
|
|
__bootstrap__
|
|
<script type="text/javascript">
|
|
//<![CDATA[
|
|
$(document).ready(function() {
|
|
window.swapped = false;
|
|
swapcols();
|
|
});
|
|
$(window).resize(function() {
|
|
swapcols();
|
|
});
|
|
function swapcols() {
|
|
if ($(window).width() < 768 && !window.swapped) {
|
|
$(".col-sm-pair").each( function() {
|
|
$(".col-sm-6", this).eq(0).after($(".col-sm-6", this).eq(2).remove());
|
|
});
|
|
window.swapped = true;
|
|
}
|
|
if ($(window).width() >= 768 && window.swapped) {
|
|
$(".col-sm-pair").each( function() {
|
|
$(".col-sm-6", this).eq(3).before($(".col-sm-6", this).eq(1).remove());
|
|
});
|
|
window.swapped = false;
|
|
}
|
|
}
|
|
//]]>
|
|
</script>
|
|
|
|
</body>
|
|
</html>
|