1Introduction 2 3 PerlMagick, is an objected-oriented Perl interface to ImageMagick. 4 Use the module to read, manipulate, or write an image or image sequence 5 from within a Perl script. This makes it suitable for Web CGI scripts. You 6 must have ImageMagick 7.0.0 or above installed on your system for this 7 module to work properly. 8 9 See 10 11 http://www.imagemagick.org/script/perl-magick.php 12 13 for additional information about PerlMagick. If you have problems, go to 14 15 http://www.imagemagick.org/discourse-server/viewforum.php?f=7 16 17 for help. For instructions about installing ImageMagick, see 18 19 http://www.imagemagick.org/ 20 21 22Installation 23 24 Get the PerlMagick distribution and type the following: 25 26 gunzip ImageMagick-7.0.0-0.tar.gz 27 tar xvf ImageMagick-7.0.0 28 29 Follow the ImageMagick installation instructions in INSTALL-unix.txt 30 then type 31 32 cd PerlMagick 33 34 Next, edit Makefile.PL and change LIBS and INC to include the appropriate 35 path information to the required libMagick library. You will also need 36 library search paths (-L) to JPEG, PNG, TIFF, etc. libraries if they were 37 included with your installed version of ImageMagick. If an extension 38 library is built as a shared library but not installed in the system's 39 default library search path, you may need to add run-path information 40 (often -R or -rpath) corresponding to the equivalent library search 41 path option so that the library can be located at run-time. 42 43 To create and install the dymamically-loaded version of PerlMagick 44 (the preferred way), execute 45 46 perl Makefile.PL 47 make 48 make install 49 50 To create and install a new 'perl' executable (replacing your existing 51 PERL interpreter!) with PerlMagick statically linked (but other libraries 52 linked statically or dynamically according to system linker default), 53 execute 54 55 perl Makefile.PL 56 make perl 57 make -f Makefile.aperl inst_perl 58 59 or to create and install a new PERL interpreter with a different name 60 than 'perl' (e.g. 'PerlMagick') and with PerlMagick statically linked 61 62 perl Makefile.PL MAP_TARGET=PerlMagick 63 make PerlMagick 64 make -f Makefile.aperl inst_perl 65 66 See the ExtUtils::MakeMaker(3) manual page for more information on 67 building PERL extensions (like PerlMagick). 68 69 For Windows systems, type 70 71 perl Makefile.nt 72 nmake install 73 74 For Unix, you typically need to be root to install the software. 75 There are ways around this. Consult the Perl manual pages for more 76 information. You are now ready to utilize the PerlMagick routines from 77 within your Perl scripts. 78 79Installation - Win32 Strawberry perl 80 81 On Win32 Strawberry perl the prefered way of installing PerlMagick is the 82 following: 83 84 1) Download and install ImageMagick Windows binaries from 85 http://www.imagemagick.org/script/binary-releases.php#windows 86 87 2) You HAVE TO choose dynamic (DLL) ImageMagick binaries. Note: it is not 88 possible to mix 32/64bit binaries of perl and ImageMagick 89 90 3) During installation select that you want to install ImageMagick's 91 development files (libraries+headers) 92 93 4) You NEED TO have ImageMagick's directory in your PATH. Note: we are 94 checking the presence of convert.exe or identify.exe tools 95 96 5) You might need Visual C++ Redistributable Package installed on your 97 system. See instructions on ImageMagick's Binary Release webpage. 98 99 6) If you have all prerequisites 1)...5) you can simply install 100 ImageMagick by running: cpan -i Image::Magick 101 102 103Testing PerlMagick 104 105 Before PerlMagick is installed, you may want to execute 106 107 make test 108 109 to verify that PERL can load the PerlMagick extension ok. Chances are 110 some of the tests will fail if you do not have the proper delegates 111 installed for formats like JPEG, TIFF, etc. 112 113 To see a number of PerlMagick demonstration scripts, type 114 115 cd demo 116 make 117 118 119Example Perl Magick Script 120 121 Here is an example script to get you started: 122 123 #!/usr/bin/perl 124 use Image::Magick; 125 126 $q = Image::Magick->new; 127 $x = $q->Read("model.gif", "logo.gif", "rose.gif"); 128 warn "$x" if $x; 129 130 $x = $q->Crop(geom=>'100x100+100+100'); 131 warn "$x" if $x; 132 133 $x = $q->Write("x.gif"); 134 warn "$x" if $x; 135 136 The script reads three images, crops them, and writes a single image 137 as a GIF animation sequence. 138
