##########################################################################
# 
# Mapivi - Martin's Picture Viewer
#
##########################################################################

Picture Viewer and Organizer for UNIX/X11, 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.

File README last modified: 02.01.2006

I wrote Mapivi just for me, because I needed a image viewer which is
also able to display EXIF infos of JPEG pictures (like timestamp,
camera model, focal length, exposure time, aperture, etc.), to rename
the pictures according to their internal date/time, to display and
modify JPEG comments and to do lossless rotation, but maybe someone
else can use it too ...

Mapivi can be found here:
http://mapivi.de.vu (link to the mapivi site)
or if this won't work:
http://herrmanns-stern.de (real site)
http://sourceforge.net/projects/mapivi (download)

I would be happy to receive some feedback (e.g. on which os mapivi
works), bugfixes, patches or suggestions about mapivi.

Copyright (c) 2002, 2003, 2004, 2005, 2006  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  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, 2003, 2004, 2005, 2006  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 (Mandrake,   Laptop   96MB RAM, 233MHz)
- Linux (RedHat 9.0, Desktop 512MB RAM, AMD 2600+)
- Linux (Gentoo)
- Sun Solaris
- Windows 2000 (with Activeperl)
- Windows XP   (with Activeperl)

Please write me, if you know more ...

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

see also the more actual feature list on the mapivi homepage: 
http://mapivi.de.vu

o displays JPEG pictures in a X11 window
o generates and displays thumbnail pictures of all pictures in a directory
o stores generated thumbnail pictures in a subdir for faster access the next 
  time the directory is opened (these thumbnails may also used by other 
  applications like mapiso)
o displays EXIF (EXchangeable Image File) information (date, time, aperture, 
  exposure time, ISO speed, ...) and thumbnail, if available in the picture
o copy the EXIF info and thumbnail from a picture to another
o rebuild/rotate EXIF thumbnail
o remove embedded EXIF infos and thumbnails from pictures
o change the EXIF date/time
o displays IPTC/IIM information (International Press Telecommunications 
  Council Information Interchange Model) like caption/abstract, writer, 
  category, keywords, ...), if available in the picture
o add and edit IPTC/IIM information
o lossless JPEG rotation (like e.g. Rota on Windows)
o resize/change the quality (file size) of pictures
o display embedded JPEG comments
o add, edit, join or remove JPEG comments from a picture (if 
  there is more than one comment, it's possible to select which to remove)
o add embedded JPEG comments to multiple pictures without 
  overwriting the existing comments (e.g. to add a copyright notice to a 
  couple of pictures at once)
o remove all embedded JPEG comments in multiple pictures with 
  just two mouse clicks
o renames pictures according to their internal EXIF date and time 
  (e.g. "yyyymmdd-hhmm.jpg")
o displays size of picture in pixels, file size in kB, picture compression
  in bit/pixel
o buffers the last n (e.g. 10) pictures and preloads the next picture 
  (this is optional) for fast display 
o rename, copy, move and delete pictures 
o includes a zoom function (only factor 0,5 and 2 in the moment)
o recompress a picture with a choosable quality
o auto zoom pictures to fit on the screen or window

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

o can't display anything but JEPG pictures (but is able to convert non-JPEGs)
o is not the fastest picture viewer available (focus is more organizing)
o no print support (use e.g. GIMP for printing)

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

o bugs? What's that?  ;-)
o see Waranty
o not enough documentation (just this file, the FAQ, the Tips file and 
  some help menus and comments in the code)

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

The latest version of Mapivi should always be available from:

http://mapivi.de.vu/

this is a link to the Mapivi homepage (please bookmark this, because the
page may move to another provider, but the link should always be valid!)

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

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

To all users giving some feedback (e.g. on which OS mapivi runs), bugs,
bugfixes, patches or suggestions.

And to the newsgroup news:comp.lang.perl.tk where I learnd so much about
Perl/Tk.
(This newsgroup may be searched using this link at google.com:
http://groups.google.com/groups?hl=en&group=comp.lang.perl.tk)

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, Philipp Drum and a lot
of other people 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!