|--nolog||build Imager without logging support. This will speed up Imager a little. You can also remove logging by setting the IMAGER_NOLOG environment variable to a true value.|
|--coverage||used to build Imager for gcov coverage testing. This is intended for development and also requires options supplied to make.|
|--assert||build Imager with assertions enabled.|
|--tracecontext||build Imager to trace context object management to stderr for debugging.|
o IMAGER_NOLOG - build Imager with logging disabled. o IMAGER_DEBUG_MALLOC - build Imager with its debug malloc wrappers. This is not compatible with threaded code. o IM_INCPATH - equivalent to --incpath. o IM_LIBPATH - equivalent to --libpath. o IM_VERBOSE - equivalent to --verbose o IM_CFLAGS - extra C compiler flags. o IM_LFLAGS - extra linker flags. o IM_DFLAGS - extra preprocessor flags.
Some of the file format and font modules included with Imager use external libraries, which should be installed before you try to install Imager itself.
If you dont have the libraries installed then Imager itself will install successfully, but the file format or font support module wont be.
Preferably the latest version of each library should be used, simple because it has the latest security fixes.
PNG - CWlibpngImager::File::PNG uses libpng
<http://www.libpng.org/pub/png/libpng.html> for PNG image file support.
Debian package: libpng12-dev
Version 3.6.0 or later is required to avoid an exploit with infinite IFD loops, though its possible some distributions have applied the fix to older versions as a security fix.
Version 3.9.0 is rejected during the probe process due to a serious bug, fixed in 3.9.1.
Debian package: libtiff4-dev
libgif releases 4.2.0 and 5.0.0 are specifically not supported, due to bugs in those versions.
Release 4.1.4 or later should be used.
giflib 3 is no longer supported.
libungif is no longer supported as an alternative.
Debian package: libgif-dev
You may also use libjpeg-turbo <http://sourceforge.net/projects/libjpeg-turbo/>.
To install older releases of libjpeg from source, youll need to run:
to install the libraries. make install only installs the program binaries.
Redhat package: libjpeg-devel
Debian package: libjpeg8-dev
Freetype 2.x - CWlibfreetypeImager::Font::FT2 uses Freetype 2 (libfreetype) <http://www.freetype.org/> for font support, supporting too many font formats to mention here.
This is the recommended library to use for font support.
Debian package: libfreetype6-dev
Redhat package: freetype-devel
Imager::Font::W32 uses Win32 GDI <http://msdn.microsoft.com/en-us/library/dd145203%28v=vs.85%29.aspx> to render text using installed Windows fonts.
This requires Win32 SDK headers and libraries, and is only expected to work on native Win32 or Cygwin.
For this to work under Cygwin, install the w32api-headers and w32api-runtime packages.
CWt1libImager::Font::T1 uses t1lib <http://www.t1lib.org/> for font support, supporting Postscript Type 1 fonts only.
Debian package: libt1-dev
Freetype 1.x is essentially unsupported and shouldnt be used for new code.
Several distributions include an Imager package, but they are typically several releases behind due to the nature of release cycles.
To install the libraries used by Imager under Debian (or Ubuntu), run as root (or with sudo):
apt-get install libgif-dev libjpeg8-dev libtiff4-dev libpng12-dev libfreetype6-dev
You may also need to install development tools:
apt-get install build-essential
To install the libraries used by Imager under Redhat and related Linux distributions, run as root (or sudo):
yum install giflib-devel libjpeg-devel libtiff-devel libpng-devel freetype-devel
To install the development tools needed:
yum install gcc
(which appears to be enough on a base Redhat-like install) or the more commonly recommended recipe:
yum groupinstall "Development Tools"
which is massive overkill.
The default perl build in Snow Leopard and Lion is a fat binary, and default builds of giflib, libpng and libjpeg (and maybe other libraries) will produce link failures.
To avoid this you need to supply a CFLAGS parameter to the librarys configure script, but since the -arch flag conflicts with the options used to build the dependency files, you need to supply another flag to disable dependency tracking.
Snow Leopard fat binaries include i386, x86_64 and PPC objects, hence you would run configure like:
./configure --disable-dependency-tracking CFLAGS=-arch x86_64 -arch i386 -arch ppc
Lion doesnt support PPC, so there you run configure like:
./configure --disable-dependency-tracking CFLAGS=-arch x86_64 -arch i386
For libgif you might also want to supply the --without-x option:
./configure --disable-dependency-tracking --without-x CFLAGS=-arch x86_64 -arch i386
If you copy library files into place manually, you may need to run ranlib on them in their new location:
Macintosh dfont and suitcase font support
Through Freetype 2.1, Imager can use Macintosh DFON (.dfont) fonts and suitcase font files.
If you want to be able to use more than just the first face in the font file though, you will need to configure freetype2 with the --with-old-mac-fonts option:
You can use the index option to get to the other font faces in the file:
If youre using a suitcase font, you will also need to force the use of Freetype 2 with the type argument:
The simplest way to install the libraries used by Imager is to install Strawberry perl <http://strawberryperl.com/>.
If you get errors from your make tool, make sure youre using the same make that was used to build your perl - nmake for Visual C/C++ and dmake for MinGW, run:
to see which make was used to build your perl.
To build Imager with as much library support as possible on Cygwin, install the following packages:
libjpeg-devel libpng-devel libgif-devel libtiff-devel libfreetype-devel t1lib-devel w32api-headers w32api-runtime
If you see an error under cygwin during testing along the lines of:
C:\cygwin\bin\perl.exe: *** unable to remap C:\cygwin\...some dll to the same address as parent (0x...) != 0x....
you will need to install the cygwin rebase package and run:
$ rebaseall -v
or possibly, just:
will fix the problem.
Freetype 1.x is no longer recommended, is no longer supported upstream, and receives only limited updates in Imager.
These two libraries have some conflicting include file names, but as long as you dont put the Freetype 2.x freetype.h directory in the include path it should all work.
Put the directory containing ft2build.h in the include path, but not the directory containing the freetype 2.x freetype.h.
If you see compilation errors from font.c youve probably made the mistake of putting the Freetype 2.x freetype.h directory into the include path.
To see which directories should be in the include path, try:
Tony Cook <firstname.lastname@example.org>, Arnar M. Hrafnkelsson
|perl v5.20.3||IMAGER::INSTALL (3)||2014-01-10|