JPG Comment, EXIF, IPTC and XMP plugin 2.3.0.3 for Total Commander
===================================================================

Copyright  2006-2010 by Udo Liess, Thomas Beutlich


 * Disclaimer:
--------------

This program 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 any later version.

This program 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, Fifth Floor, Boston, MA  02110-1301, USA.
http://www.fsf.org/licensing/licenses/gpl.txt


 * Installation:
----------------

Open the plugin archive using Total Commander and installation will start.

The default configuration file jpg-comment.ini is initialized during the very
first plugin initialization.


 * Update Remarks:
------------------

 o If you update from version 2.1.5.0 (and former) you will notice that the
   metadata list is changed. For compatibility reasons the previous metadata
   configuration is saved in backup file jpg-comment.old.ini. The appropriate
   translation is also saved in backup file jpg-comment.old.lng. You can rename
   jpg-comment.old.ini and jpg-comment.old.lng to jpg-comment.ini and
   jpg-comment.lng, respectively, to apply the old metadata setup. However,
   jpg-comment.old.ini will not be maintained for future versions of the plugin.
 o With version 2.3.0.0 the directory of jpg-comment.ini changed from the plugin
   directory to the same directory as the initialization file (wincmd.ini) of Total
   Commander. However, if a jpg-comment.ini with a valid [Metadata] section is found
   in the plugin directory this jpg-comment.ini is used instead.
 o With version 2.3.0.0 the metadata configuration of jpg-comment.ini changed. The
   section name changed from [Settings] to [Metadata]. The superfluous flag for
   repeatable IPTC metadata fields vanished.


 * Description:
---------------

This plugin shows
 o JPG comment of JPG and JPEG files as whole or as single lines.
 o EXIF metadata of image files
 o IPTC metadata of image files
 o XMP metadata of image files

You can set/edit almost all fields inside Total Commander (requires TC7).

See http://dev.exiv2.org/wiki/exiv2/Supported_image_formats for the list of
supported file formats and its read/write access.

See configuration file jpg-comment.ini for the configuration of the metadata
fields.

This plugin uses the Exiv2 Image Metadata Library Vs. 0.21.


 * ChangeLog:
-------------

 o Version 2.3.0.3 (06.12.2010)
   - replaced Exiv2 library 0.20 by latest Exiv2 library 0.21 (+ patch)
   - replaced zlib library 1.2.3 by latest zlib library 1.2.5
   - added EXV, CR2, CRW, MRW, ARW, RW2, SR2, SRW, ORF, RAF and XMP file
     extensions to detection string  
 o Version 2.3.0.2 (09.08.2010)
   - fixed: if a jpg-comment.ini with a valid [Metadata] section is found in
     the plugin directory this jpg-comment.ini is used instead
 o Version 2.3.0.1 (08.08.2010)
   - fixed trailing wide string for ft_numeric_floating fields
 o Version 2.3.0.0 (07.08.2010)
   - replaced Exiv2 library 0.18.2 by latest Exiv2 library 0.20
   - changed directory of jpg-comment.ini from plugin directory to same directory
     as the initialization file (wincmd.ini) of Total Commander
   - changed metadata configuration file format (see above)
   - added support of Unicode file names
   - added support of Unicode field strings
   - added support of pretty printed field strings (read-only)
   - added various EXIF metadata to default jpg-comment.ini
 o Version 2.2.0.11 (25.06.2009)
   - replaced Exiv2 library 0.18.1 by latest Exiv2 library 0.18.2
   - added experimental support for PGF files
 o Version 2.2.0.10 (08.05.2009)
   - fixed ft_numeric_32 and ft_numeric_64 type conversion
 o Version 2.2.0.9 (06.05.2009)
   - fixed metadata field detection performance
 o Version 2.2.0.8 (04.05.2009)
   - fixed error handling for getting multiple choice fields
 o Version 2.2.0.7 (28.04.2009)
   - fixed default configuration file handling
 o Version 2.2.0.6 (27.04.2009)
   - fixed default configuration file handling
 o Version 2.2.0.5 (20.04.2009)
   - added date/time support for XMP fields
   - fixed error handling for getting the time stamp
   - fixed date/time setting for IPTC fields
   - fixed exception message handling
 o Version 2.2.0.4 (16.04.2009)
   - added cache support for ContentGetValue()
   - added DNG, JP2, NEF, PEF, PNG and PSD file extensions to detection string
   - fixed JPG.Comment detection
   - fixed exception message handling
 o Version 2.2.0.3 (13.04.2009)
   - added exception message handling
   - fixed error handling for getting the time stamp
 o Version 2.2.0.2 (09.04.2009)
   - replaced Exiv2 library 0.18 by latest Exiv2 library 0.18.1
   - added read support for UCS2 encoded Windows EXIF fields
   - added read support for EXIF Rational type
 o Version 2.2.0.1 (05.04.2009)
   - improved set value for multiple choice fields
 o Version 2.2.0.0 (04.04.2009)
   - added generic metadata interface by jpg-comment.ini
 o Version 2.1.5.0 (16.03.2009)
   - added EXIF fields SubSecTime, SubSecTimeOriginal and SubSecTimeDigitized
   - fixed IPTC fields Contact, LocationName and Urgency
   - added XMP field Rating
 o Version 2.1.4.1 (03.03.2009)
   - added French translation
   - added Spanish translation
 o Version 2.1.4.0 (20.12.2008)
   - replaced Exiv2 library 0.15 by latest Exiv2 library 0.18
 o Version 2.1.3.1 (26.09.2008)
   - fixed EXIF fields DateTime, DateTimeOriginal and DateTimeDigitized
     (Thanks to sqa_wizard.)
 o Version 2.1.3.0 (23.09.2008)
   - added EXIF fields DateTime, DateTimeOriginal and DateTimeDigitized
 o Version 2.1.2.0 (13.07.2008)
   - added TIF and TIFF file extensions to detection string
 o Version 2.1.1.0 (17.03.2008)
   - added Danish translation (Thanks to petermad.)
   - added Polish translation (Thanks to fenix.)


 * References:
--------------

 o Content-Plugin Writer's Guide by Christian Ghisler
   - http://ghisler.fileburst.com/beta/contentpluginhelp210beta.zip


 * Acknowledgments:
-------------------

 o Exiv2 Image Metadata Library
   - http://www.exiv2.org


 * Trademark and Copyright Statements:
--------------------------------------

 o Total Commander is Copyright  1993-2010 by Christian Ghisler, Ghisler Software GmbH.
   - http://www.ghisler.com
 o UPX - The Ultimate Packer for eXecutables is Copyright  1996-2010 by Markus
   Oberhumer, Laszlo Molnar & John Reiser
   - http://upx.sourceforge.net


 * Feedback:
------------

If you have problems, questions, suggestions please contact Thomas Beutlich.
 o Email: support@tbeu.de
 o URL: http://tbeu.totalcmd.net