ImageMagick-Iterator version 0.01
=============================

These modules add iteration support to Image::Magick.  This means that
if you have a stream of concatenated images, you can access each image
in the stream as an independent Image::Magick object.

Iteration functionality is not present in Image::Magick itself as of
version 5.56.  Passing a stream of concatenated images would result in
essentially a "stack" of images which would all be manipulated in
parallel by any Image::Magick calls.  Calls to Write() either output
an animated series of image (a la animated GIFs), or the first image in
the series.

Image::Magick::Iterator is extensible to support many different
image filetypes.  Currently only PPM support is implemented.  To iterate
over a PPM stream, the code would look something like:

  my $iter = Image::Magick::Iterator->new();

  #assume PPM stream is coming from STDIN;
  $iter->handle(\*STDIN);

  #explicitly set format to PPM, there is no auto-detection built in
  $iter->format('PPM');

  while(my $image = $iter->next){
    print $image->Get('height'),"\n"; #access height attribute of each
                                      #Image::Magick object
  }

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

  Image::Magick 5.56
  Image::PBMlib 1.05

COPYRIGHT AND LICENCE

Copyright (C) 2004 by Allen Day, allenday@ucla.edu

This library is released under GPL, the GNU General Public License