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, [email protected]

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