README file for PEL Examples.

Copyright (C) 2005  Martin Geisler.
Licensed under the GNU GPL, see COPYING for details.


PEL Examples
************

This directory contains various examples of how PEL can be used in
small scripts.

* dirsort.php: an example of how to use PEL to automatically sort a
  collection of photos into different folders.

  The script accepts a number of filenames on the command line, and
  will move them to folders based on the month the photo was taken.

* dump-image.php: a simple script that will load an image and show the
  structure.

  A JPEG or TIFF image should be specified on the command line.  The
  dump will give detailed information about the structure in the
  image.

* edit-description.php: a big example showing how to update the
  ImageDescription EXIF tag using PEL.

  The script is heavely commented, and should be used as a good
  reference as to how PEL works and how it should be used.

* rename.php: a script similar to dirsort.php, only that this one will
  rename photos to a filename containing the full date and time taken
  from the DateTime EXIF tag.


Contributing New Examples
*************************

More examples are needed!  If you have a neat example of how PEL can
be used, then please contribute it to PEL.  Please submit it as a new
item in the SourceForge Patch Tracker:

  http://sourceforge.net/tracker/?atid=650324&group_id=108380

It will then be included in the next release of PEL, of course with
full credit in the AUTHORS file.
