libvips/README
John Cupitt 832eec9e0a stuff
2008-03-26 16:56:51 +00:00

142 lines
3.6 KiB
Plaintext

VIPS
====
VIPS is an image processing library. It's good for large images and for
colour. There's a GUI as well, see the VIPS website:
http://www.vips.ecs.soton.ac.uk
There are packages for most linuxes and OS X. There is a pre-compiled windows
binary on the vips website.
Getting VIPS from SVN
=====================
Enter:
svn co https://vips.svn.sourceforge.net/svnroot/vips/vips7
Building VIPS from source
=========================
In the VIPS directory, you should just be able to do:
user% ./configure
user% make
then as root:
root% make install
By default this will install files to /usr/local.
If you have problems, read on.
Building VIPS on win32
----------------------
Probably the easiest route is to use mingw/msys. This provides a GNU-style
build environment for win32.
http://www.vips.ecs.soton.ac.uk/index.php?title=Build_on_windows
Alternatively, vips-7.x/win32 contains sample build systems using the
Microsoft toolchain. See the README in there for details.
Building VIPS on OS X
---------------------
There are packages in macports.
http://www.macports.org
Dependencies
============
VIPS has to have glib-2.x and libxml-2.0. The build system needs perl,
pkg-config and gnu make.
Optional dependencies
---------------------
Optional support libraries ... also try ./configure --help to see flags for
controlling these libs. By default, if suitable versions are found, VIPS will
build support for them automatically.
VIPS looks for stuff in /usr. If you have installed your own versions of
these libraries to /usr/local, vips will not see them. Use switches to VIPS
configure like:
./configure --prefix=/home/john/vips \
--with-tiff-includes=/home/john/vips/include \
--with-tiff-libraries=/home/john/vips/lib
to get VIPS to see your builds.
libjpeg
The IJG JPEG library. We use 6b, but 6a works too.
libexif
if available, VIPS adds support for EXIF metadata in JPEG files
libtiff
The TIFF library. It needs to be built with support for JPEG and
ZIP compression. 3.4b037 and later are known to be OK.
You'll need libz for this too. We use 1.1.3, others should work.
libz
If your TIFF library includes ZIP compression, you'll need this too.
videodev.h
If VIPS finds linux/videodev.h, you get support for Linux video
grabbing.
fftw3
If VIPS finds this library, it uses it for fourier transforms. It can
also use fftw2, but 3 is faster and more accurate.
If the library is not found, VIPS falls back to it's own internal FFT
routines which are slower and less accurate.
lcms
If present, im_icc_import(), _export() and _transform() are available
for transforming images with ICC profiles.
large files
VIPS uses the standard autoconf tests to work out how to support large
files (>2GB) on your system. Any reasonably recent *nix should be OK.
libpng
if present, VIPS can load and save png files. Version 1.2+ preferred.
libMagick, or optionally GraphicsMagick
if available, VIPS adds support for loading all libMagick supported
image file types (about 80 different formats). No saving though.
pango
freetype2
fontconfig
if available, VIPS adds support for text rendering. You need the
package pangoft2 in "pkg-config --list-all"
liboil
if available, you get some inner loops replcaed by calls to liboil's
library of optimised inner loops
OpenEXR
if available, VIPS will directly read (but not write, sadly) OpenEXR
images
swig
python
python-dev
if available, we build the python binding too
Disclaimer
----------
Disclaimer: No guarantees of performance accompany this software, nor is any
responsibility assumed on the part of the authors. Please read the licence
agreement.