// ***************************************************************** -*- C++ -*- /*! @file doxygen.hpp @brief Additional documentation, this file contains no source code @version $Rev$ @author Andreas Huggel (ahu) ahuggel@gmx.net @date 07-Feb-04, ahu: created */ /*! @mainpage Exif and Iptc metadata manipulation library and tools v0.8 @section overview Exiv2 Overview %Exiv2 comprises of a C++ library and a command line utility to access image metadata. %Exiv2 is free software. The homepage of %Exiv2 is at http://home.arcor.de/ahuggel/exiv2. The %Exiv2 library provides - full read and write access to the Exif and Iptc metadata of an image through %Exiv2 keys and standard C++ iterators - a smart Iptc implementation that does not effect data that programs like Photoshop store in the same image segment - Exif %MakerNote support: - %MakerNote tags can be accessed just like any other Exif metadata - a sophisticated write algorithm avoids corrupting the %MakerNote:
1) the %MakerNote is not re-located if possible at all, and
2) %MakerNote %Ifd offsets are re-calculated if the %MakerNote needs to be moved (for known %Ifd %MakerNotes) - new camera make/model specific %MakerNotes can be added to the library with minimum effort in OO-fashion (by subclassing %MakerNote or %IfdMakerNote) - extract and delete methods for Exif thumbnails (both, Jpeg and Tiff thumbnails) - set methods for Exif thumbnails (Jpeg only, Tiff thumbnails can be set from individual tags) - complete API documentation (by Doxygen) - generic lower-level classes to access %Ifd (%Image File Directory) data structures @section getting-started Getting started A few pointers to get you started with the %Exiv2 library without delay. @section metadata Supported Exif and MakerNote tags and Iptc datasets - Standard Exif tags - Canon MakerNote tags - Fujifilm MakerNote tags - Nikon MakerNote tags - Olympus MakerNote tags - Panasonic MakerNote tags - Sigma/Foveon MakerNote tags - Sony MakerNote tags - Iptc datasets @section makernote MakerNote Formats and Specifications A summary of MakerNote structures with links to publicly available specifications. @section supp Support

There is now a Yahoo! group for Exiv2 help and discussions.

Join the group to post and receive messages or use exiv2user/password to post anonymously. Bug reports can be submitted directly to the bug tracking system.

@section devel Development

%Exiv2 is maintained in a publicly available subversion repository. There is a live list with the latest commits to the repository, and you can browse the source code online.

To check-out the current source code from the repository, you need a subversion client. If you use a command line client, change to the directory where you want to keep the source code and type:

@verbatim $ svn checkout svn://dev.robotbattle.com/exiv2/trunk . @endverbatim

To download the test data and test drivers for version 0.8 from the repository, change to your local exiv2-0.8 directory and use the following command:

@verbatim $ svn export svn://dev.robotbattle.com/exiv2/tags/0.8/test @endverbatim

If you'd like to contribute code, please contact me. @section license License

%Exiv2 is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

%Exiv2 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, 5th Floor, Boston, MA 02110-1301 USA. */ /*! @example addmoddel.cpp Sample usage of high-level metadata operations. */ /*! @example exifprint.cpp Sample program to print Exif data from an image. */ /*! @example exifcomment.cpp Sample program showing how to set the Exif comment of an image. */ /*! @example iptcprint.cpp Sample program to print the Iptc metadata of an image */ /*! @example iptceasy.cpp The quickest way to access, set or modify Iptc metadata */