Home | History | Annotate | only in /external/ImageMagick/PerlMagick
Up to higher level directory
NameDateSize
Changelog22-Oct-2020257
check.sh.in22-Oct-20201.6K
default/22-Oct-2020
demo/22-Oct-2020
Magick.pm22-Oct-20204.2K
Magick.xs22-Oct-2020481.1K
Makefile.am22-Oct-20204.5K
Makefile.nt22-Oct-20205.7K
Makefile.PL.in22-Oct-20209.5K
MANIFEST22-Oct-202016.1K
MANIFEST.SKIP22-Oct-2020165
quantum/22-Oct-2020
README.txt22-Oct-20204.4K
t/22-Oct-2020
typemap22-Oct-202023

README.txt

      1 Introduction 
      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         https://imagemagick.org/script/perl-magick.php
     12 
     13     for additional information about PerlMagick.  If you have problems, go to
     14 
     15         https://imagemagick.org/discourse-server/viewforum.php?f=7
     16 
     17     for help.  For instructions about installing ImageMagick, see
     18 
     19         https://imagemagick.org/
     20 
     21 
     22 Installation 
     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 
     79 Installation - 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       https://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 
    103 Testing 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 
    119 Example 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