README
1ImageMagick-Iterator version 0.01
2=============================
3
4These modules add iteration support to Image::Magick. This means that
5if you have a stream of concatenated images, you can access each image
6in the stream as an independent Image::Magick object.
7
8Iteration functionality is not present in Image::Magick itself as of
9version 5.56. Passing a stream of concatenated images would result in
10essentially a "stack" of images which would all be manipulated in
11parallel by any Image::Magick calls. Calls to Write() either output
12an animated series of image (a la animated GIFs), or the first image in
13the series.
14
15Image::Magick::Iterator is extensible to support many different
16image filetypes. Currently only PPM support is implemented. To iterate
17over a PPM stream, the code would look something like:
18
19 my $iter = Image::Magick::Iterator->new();
20
21 #assume PPM stream is coming from STDIN;
22 $iter->handle(\*STDIN);
23
24 #explicitly set format to PPM, there is no auto-detection built in
25 $iter->format('PPM');
26
27 while(my $image = $iter->next){
28 print $image->Get('height'),"\n"; #access height attribute of each
29 #Image::Magick object
30 }
31
32INSTALLATION
33
34To install this module type the following:
35
36 perl Makefile.PL
37 make
38 make test
39 make install
40
41DEPENDENCIES
42
43This module requires these other modules and libraries:
44
45 Image::Magick 5.56
46 Image::PBMlib 1.05
47
48COPYRIGHT AND LICENCE
49
50Copyright (C) 2004 by Allen Day, allenday@ucla.edu
51
52This library is released under GPL, the GNU General Public License
53