|
|
|
ImageFolio Pro Edition 3.1 User's Guide
Installing ImageMagick™
(This is not required for ImageFolio to function)
This document covers the OPTIONAL installation of ImageMagick™, a freely available third party image editor.
What is ImageMagick?
ImageMagick is a robust collection of tools and libraries offered under a usage license to read, write, and manipulate an image in many image formats (over 87 major formats as of 2/3/2003) including popular formats like TIFF, JPEG, PNG, PDF, PhotoCD, and GIF. With ImageMagick you can create images dynamically, making it suitable for Web applications. You can also resize, rotate, sharpen, color reduce, or add special effects to an image or image sequence and save your completed work in the same or differing image format. Image processing operations are available from the command line, as well as through C, C++, Perl, or Java programming interfaces.
ImageMagick is quite portable, and compiles under almost every general purpose operating system that runs on 32-bit or 64-bit CPUs. ImageMagick is available for virtually any Unix or Unix-like system, including Linux. It also runs under Windows '95 and later ('95, '98, ME, NT 4.0, 2000, and XP), Macintosh (MacOS 9 and 10), VMS, and OS/2.
How ImageFolio Works with ImageMagick
ImageFolio Pro, ImageFolio Commerce, and the ImageFolio Mod's (Batch Thumbnail, Picture Post) have been written to interface directly with ImageMagick's PerlMagick library. ImageFolio and PerlMagick provide an object-oriented Perl interface to ImageMagick to perform several server side tasks such as thumbnailing, resizing, and watermarking of images.
In order to use these special features offered by ImageFolio, you must have a copy of ImageMagick, with PerlMagick, installed on your server. This is not as simple as it sounds and that is the reason we have written this guide for you. Please bear in mind that we are not ImageMagick experts and do not provide support for third party products. This should serve as the basis for your own education in the installation and use of ImageMagick.
More information can be found online at ImageMagick's website:
http://www.imagemagick.com.
Installation instructions are also available at:
http://www.imagemagick.com/www/install.html
You can also download the latest version of ImageMagick and the delegates here:
http://imagemagick.sourceforge.net/http/
Requirements (Unix)
In order to install ImageMagick on your server, you must have root access via SSH or Telnet. If you do not have root access to your server you are most likely out of luck. ImageMagick must be compiled on the server, along with several required source image libraries, also called delegates, which include JPEG, TIFF, and PNG. If you do not know what root access is, consult with your hosting company to determine the appropriate options, or contact us via telephone at (214) 752-8767 (9AM-5PM, Monday thru Friday).
- Root Access to your server via Telnet or SSH
- FTP Access to your server
- 30-50 MB of hard drive space for the installation files
- 128 MB or more RAM on your server
- Basic knowledge of performing command line compilation from source code
Installation (Unix)
- Download each of the following installation files to your desktop:
ImageMagick-5.5.4-3.tar.gz - ImageMagick and PerlMagick Sources
jpegsrc.v6b.tar.gz - JPEG Sources
libpng-1.2.5.tar.gz - PNG Sources
tiff-v3.5.7.tar.gz - TIFF Sources
zlib-1.1.4.tar.gz - ZLIB Sources - Required by PNG
The file names (above) should tell you what each is. They are the source code compression kits for popular graphical formats.
- Using an FTP utility, log in to your server and create a directory called Installation_Files anywhere you want.
- Upload, to your server, each of the files you downloaded above, in Binary format, to this newly created directory. Take note of the path to the directory you created as you will need to access it via SSH or Telnet in a minute.
- Login to your server via SSH or Telnet and switch to root user.
- If you are on a Unix or Linux server, using a server-based text editor such as Pico or Vi, add the following line (on a new line) to the file "/etc/ld.so.conf"
/usr/local/lib
- Navigate to the Installation_Files directory by typing
cd /PATH/TO/YOUR/Installation_Files
- Install the JPEG sources by typing the following. On the configure, make, and make install steps below, you will see output from your server. Please wait for each process to complete before continuing.
gunzip jpegsrc.v6b.tar.gz
tar xf jpegsrc.v6b.tar
cd jpeg-6b
./configure --enable-shared
make
make install
cd /PATH/TO/YOUR/Installation_Files
- Install the ZLIB sources by typing the following. On the configure, make, and make install steps below, you will see output from your server. Please wait for each process to complete before continuing.
gunzip zlib-1.1.4.tar.gz
tar xf zlib-1.1.4.tar
mv zlib-1.1.4 zlib
cd zlib
./configure
make
make install
cd /PATH/TO/YOUR/Installation_Files
- Install the PNG sources by typing the following. On the configure, make test, and make install steps below, you will see output from your server. Please wait for each process to complete before continuing.
For Linux Servers...
gunzip libpng-1.2.5.tar.gz
tar xf libpng-1.2.5.tar
mv libpng-1.2.5 libpng
cd libpng
cd scripts
cp makefile.linux ../makefile
cd ..
make test
make install
cd /PATH/TO/YOUR/Installation_Files
For Other Servers...
gunzip libpng-1.2.5.tar.gz
tar xf libpng-1.2.5.tar
mv libpng-1.2.5 libpng
cd libpng
cd scripts
cp makefile.* ../makefile
cd ..
make test
make install
cd /PATH/TO/YOUR/Installation_Files
Note: The * above can be one of a number of extensions depending on your server type. See the INSTALL file distributed with libpng for more information.
- Install the TIFF sources by typing the following. On the configure, make, and make install steps below, you will see output from your server. Please wait for each process to complete before continuing.
gunzip tiff-v3.5.7.tar.gz
tar xf tiff-v3.5.7.tar
cd tiff-v3.5.7
./configure
make
make install
cd /PATH/TO/YOUR/Installation_Files
- Install the ImageMagick sources by typing the following. On the configure, make, and make install steps below, you will see output from your server. Please wait for each process to complete before continuing.
gunzip ImageMagick-5.5.4-3.tar.gz
tar xf ImageMagick-5.5.4-3.tar
cd ImageMagick-5.5.4-3
./configure --enable-shared --disable-static --with-perl=/usr/bin/perl --enable-lzw
make
make install
cd /PATH/TO/YOUR/Installation_Files
Change '/usr/bin/perl' (above) to the path to Perl on your system.
That's it.
Installation (Mac OS-X)
- The instructions for installation on Mac OS-X can be found here.
Installation (Windows)
- The instructions for installation on a win32 server can be found here.
- A good resource for if you are getting stuck can be found here.
[ Top ]
© Copyright 1999-2005 BizDesign, Inc. All rights reserved.
BizDesign® is a registered trademark of BizDesign, Inc.
Permission to distribute, in any form, whole or part, is forbidden.
Report Errors or Omissions to webmaster@imagefolio.com
|
|
