
##########################################################################
# 
# Mapivi - Martin's Picture Viewer
#
##########################################################################
File README last modified: 2010-07-08

Picture Viewer and Organizer for Linux, UNIX, Mac OS X, Windows written in
Perl/Tk.
Mapivi supports adding, viewing and editing of JPEG meta informations like:
EXIF, IPTC/IIM and JPEG comments.

Mapivi is an open-source and cross-platform (UNIX, Mac OS X and Windows)
picture manager and organizer written in Perl/Tk.

Mapivi is a photo management tool with focus on JPEG pictures.
Mapivi supports adding, editing and searching of IPTC/IIM, EXIF data and
JPEG comments. The pictures are managed in place (in your folder structure),
so you are able to use other tools like file managers or other viewers
together with Mapivi. 

Mapivi can be found here:
http://mapivi.de.vu/
http://mapivi.sourceforge.net
http://sourceforge.net/projects/mapivi

I am always happy to receive some feedback about Mapivi.

Copyright (c) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
Martin Herrmann. All rights reserved.

Feel free to redistribute. Enjoy!

Of course I give no warranty at all, so if you accidently delete all you 
files, corrupt your harddisk or burn down your computer it's your own 
problem.

##########################################################################
# 
# Copyright
#
##########################################################################

Copyright  2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Martin Herrmann.
All rights reserved.

##########################################################################
# 
# License
#
##########################################################################

    Mapivi 
	Martin's Picture Viewer

    Mapivi is free software, if you want you may make a donation,
    see http://herrmanns-stern.de/software/donations.shtml
    Your donation of any amount will encourage me to continue the
    development.

    A Picture Viewer for Unix/X11, Mac OS X, Windows written in Perl/Tk
    Copyright (C) 2002 - 2010  Martin Herrmann.

    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 (at your option) 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., 675 Mass Ave, Cambridge, MA 02139, USA.

##########################################################################
# 
# Systems
#
##########################################################################

Mapivi is known to run under:

- Linux (Ubuntu, Mandrake, RedHat, Gentoo,...)
- Sun Solaris
- Windows 2000 (with Activeperl)
- Windows XP   (with Activeperl)
- Apple Mac OS X

Please write me, if you know more ...

##########################################################################
# 
# Features 
#
##########################################################################

see also feature list on the Mapivi homepage:
http://mapivi.sourceforge.net/features.shtml

Image Management

    * Mapivi supports any existing folder structure
    * Mapivi stores just picture meta information (IPTC, EXIF, comments,
	  ...) in his database
    * Mapivi supports pictures on removable media (CD, DVD, USB-HD, ...)
    * IPTC/IIM information with keywords, categories, location, headline,
	  caption/abstract, writer, ...:
          o display IPTC
          o add, edit, remove IPTC (also multiple pictures at once)
          o hierarchical IPTC keywords and categories
          o apply or save IPTC templates
          o rating of pictures using the IPTC urgency flag
    * EXIF (EXchangeable Image File) information (date, time, aperture,
	  exposure time, ISO speed, ...):
          o display EXIF
          o copy EXIF
          o save and restore EXIF
          o remove EXIF
          o alter EXIF date/time absolut or relative
          o (re)build, copy, rotate EXIF thumbnail
          o reset/clear EXIF orientation flag
    * JPEG comments (single and multiple comments are supported):
          o display JPEG comments
          o add, edit, copy, join or remove comments
          o add comments to multiple pictures without overwriting the
		    existing comments (e.g. to add a copyright notice to many
			pictures at once (batch processing)

Image Manipulation

    * lossless JPEG rotation (90, 180, 270 degrees or automatic rotation
	  using the EXIF orientation flag)
    * lossless JPEG cropping to any format (useful when printing and framing
	  pictures)
    * rotate pictures at any angle (this is not a lossless operation) 
    * resize pictures, change the quality (file size) of pictures
    * filter a picture (normalize, equalize, saturation, gamma,
	  unsharp mask, ...)

Image Browsing

Nowadays many programs are able to display meta data like IPTC, EXIF or
JPEG comments, but you have to press several buttons to see them for just
one picture. Mapivi is able to show and edit (batch processing) this
informations for a number of pictures at once. The unique feature (as
far as I know :) of Mapivi is the compact tabular display of all
pictures in a directory including:

    * thumbnail
    * filename, file size, size in pixels, aspect ratio (4:3, 3:2, ...)
    * IPTC/IIM infos in a short readable format
    * EXIF infos (date, time, aperture, exposure time, ISO, mode,
	  camera type) in a short readable format
    * comments
	
Other Features

    * generate and display high quality thumbnails
    * store generated thumbnail pictures in a sub directory (.thumbs) or
	  a central thumbnail database for further access
    * search for pictures
    * import pictures from a digital camera, memory card or other device
    * file operations: rename, copy, move, email and delete pictures
    * directory operations: rename, create, delete
    * compare/diff two picture directories and show all files which differ
	  by: file name, file size, pixel size, comment, EXIF info, IPTC info
    * search for duplicate pictures (by file name or by file size)
    * export a static html web gallery of the selected pictures with
	  comments and EXIF and IPTC infos
    * add a border/drop shadow and/or a copyright info (text or picture)
	  to images
    * build index prints
    * compare details between two or more pictures by switching between
	  these pictures zoomed to the same picture area
    * batch rename pictures
    * show pictures in a slideshow
    * fix camera CCD defects by interpolating dead and hot pixels (also
	  possible while importing pictures)
    * show the histogram of a picture
    * make screenshots (single window or complete desktop)
    * set a picture as desktop background

##########################################################################
# 
# Not available:
#
##########################################################################

o Add or edit meta information of non-JPEG pictures
o Edit other EXIF data, but the EXIF date and time (like e.g. Exifer on Windows)
o Print pictures (there are better tools for that task)

##########################################################################
# 
# Bugs:
#
##########################################################################

o Bugs can be reported using Sourceforge
  (http://sourceforge.net/tracker/?group_id=98810&atid=622115)
  or by email to me
o See also Waranty

##########################################################################
# 
# AVAILABILITY
#
##########################################################################

The latest version of Mapivi should always be available from:

http://mapivi.de.vu/
http://mapivi.sourceforge.net
http://sourceforge.net/projects/mapivi
http://herrmanns-stern.de

##########################################################################
# 
# THANKS
#
##########################################################################

Thanks to all users giving feedback, reporting bugs, supplying bugfixes,
patches or suggestions.

Many thanks to the developers of Perl and Perl/Tk and to the newsgroup
news:comp.lang.perl.tk where I learnd so much about Perl/Tk.

Thanks also to the Tango Desktop Project (tango.freedesktop.org) for
supplying such nice icons.

Spezial thanks to Slaven Rezic, Gisle Aas, Guido Ostkamp, Hans-Peter
Rangol, Holger Stephan, Uwe Steffen, Russell Adams, Michael Waldor,
Hans-Peter Kunzle, Kish Shen, Josh Buhl, Eric-Olivier Le Bigot,
Alexey Semenov, Chris Drexler, Eric Piel, Matthias Bobzien, Mister Fred,
Antti Kaihola, Steffen Rehn, Bruce McKenzie, Keith G. Robertson-Turner,
Andreas Rath, Christian Franke, Stefano Bettelli, Dan Eble, Martin
Sarsale, Stephan Helma, Kevin Moloney, Milan Knizek, Piet, Martin
Brachtl, Andres Kuusk, Jack D., Nicolas Heuser and a lot of other
users who send comments, code, money, CDs and/or a lot of good ideas
and tips.

##########################################################################
# 
# AUTHOR
#
##########################################################################

Martin Herrmann

Send me an email if it you have problems, questions, feature requests,
patches or comments:

Martin-Herrmann@gmx.de

Share and Enjoy!
