// ***************************************************************** -*- C++ -*- /*! @file doxygen.hpp @brief Additional documentation, this file contains no source code @version $Name: $ $Revision: 1.18 $ @author Andreas Huggel (ahu) ahuggel@gmx.net @date 07-Feb-04, ahu: created */ /*! @mainpage Exif and Iptc metadata manipulation library and tools v0.5 @section overview Exiv2 Overview Exiv2 is a C++ library that provides - read and write access to the Exif and Iptc IIM metadata of an image through %Exiv2 keys and standard C++ iterators - Exif MakerNote support: - MakerNote tags can be accessed just like any other metadata - a sophisticated write algorithm avoids corrupting the MakerNote:
1) the MakerNote is not re-located if possible, 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) - Doxygen API documentation - generic lower-level classes to access IFD (Image File Directory) data structures %Exiv2 is also a command line program to - print the Exif metadata of JPEG images (as summary info, interpreted values, or the plain data for each tag) - print the Iptc metadata of JPEG images - adjust the Exif timestamp (that's how it all started...) - rename Exif image files according to the Exif timestamp - extract a certain type of metadata or all metadata from image files - insert metadata back into image files - extract the thumbnail image embedded in the Exif metadata - delete the thumbnail or specific metadata from an image @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 (format 1) MakerNote tags - Nikon (format 2) MakerNote tags - Nikon (format 3) MakerNote tags - Sigma/Foveon MakerNote tags - Iptc datasets @section makernote MakerNote Formats and Specifications A summary of MakerNote structures with links to publicly available specifications. @section devel Development

%Exiv2 is maintained in a publicly available subversion repository. You can browse the code online, see a list of recent code changes, browse the bug tracking system and report bugs.

To download the source code directly 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 svn co svn://dev.robotbattle.com/exiv2/trunk .

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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, 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 */