Introduction

   PerlMagick, version 4.28, is an objected-oriented Perl interface to
   ImageMagick.  Use the module to read, manipulate, or write an image
   or image sequence from within a Perl script. This makes it suitable
   for Web CGI scripts. You must have ImageMagick 4.2.7 above and Perl
   version 5.002 or greater installed on your system.  Perl version
   5.005_02 or greater is required for PerlMagick to work under NT.

   See

     http://www.wizards.dupont.com/magick/www/perl.html

   for additional information about PerlMagick.  See

     http://www.wizards.dupont.com/magick/

   for instructions about installing ImageMagick.


Installation

   Get the PerlMagick distribution and type the following:

       gunzip PerlMagick-4.28.tar.gz
       tar xvf PerlMagick-4.28.tar
       cd Magick

   Next, edit Makefile.PL and change LIBS and INC to include the
   appropriate path information to the required libMagick library. You
   will also need library search paths (-L) to JPEG, PNG, TIFF,
   etc. libraries if they were included with your installed
   version of ImageMagick. If an extension library is built as a
   shared library but not installed in the system's default
   library search path, you may need to add run-path information
   (often -R or -rpath) corresponding to the equivalent library
   search path option so that the library can be located at
   run-time.

   To create and install the dymamically-loaded version of
   PerlMagick (the preferred way), execute

       perl Makefile.PL
       make
       make install

   To create and install a new 'perl' executable (replacing your
   existing PERL interpreter!) with PerlMagick statically linked
   (but other libraries linked statically or dynamically according
   to system linker default), execute

       perl Makefile.PL
       make perl
       make -f Makefile.aperl inst_perl

   or to create and install a new PERL interpreter with a
   different name than 'perl' (e.g. 'PerlMagick') and with
   PerlMagick statically linked

       perl Makefile.PL MAP_TARGET=PerlMagick
       make PerlMagick
       make -f Makefile.aperl inst_perl

   See the ExtUtils::MakeMaker(3) manual page for more information on
   building PERL extensions (like PerlMagick).

   Use nmake instead of make on an NT system.  For NT, you also need
   to copy IMagick.dll and X11.dll from the NT ImageMagick (see
   ftp://ftp.wizards.dupont.com/pub/ImageMagick/nt) distribution to a
   path library such as c:\perl\lib.

   For Unix, you typically need to be root to install the software.
   There are ways around this.  Consult the Perl manual pages for more
   information. You are now ready to utilize the PerlMagick routines
   from within your Perl scripts.

Testing PerlMagick

   Before PerlMagick is installed, you may want to execute

       make test

   to verify that PERL can load the PerlMagick extension ok.  Chances are
   some of the tests will fail if you do not have the proper delegates
   installed for formats like JPEG, TIFF, etc.

   To see a number of PerlMagick demonstration scripts, type

       cd demo
       make


Example Perl Magick Script

   Here is an example script to get you started:

       #!/usr/local/bin/perl
       use Image::Magick;

       $q = Image::Magick->new;
       $x = $q->Read("model.gif", "logo.gif", "rose.gif");
       warn "$x" if $x;

       $x = $q->Crop(geom=>'100x100+100+100');
       warn "$x" if $x;

       $x = $q->Write("x.gif");
       warn "$x" if $x;

   The script reads three images, crops them, and writes a single
   image as a GIF animation sequence.