libvips/README

155 lines
4.1 KiB
Plaintext
Raw Normal View History

libvips
=======
2007-08-29 18:23:50 +02:00
libvips is an image processing library. It's good for large images and for
2007-08-29 18:23:50 +02:00
colour. There's a GUI as well, see the VIPS website:
http://www.vips.ecs.soton.ac.uk
2011-01-06 15:18:00 +01:00
There are packages for most unix-like operating systems, and binaries for
Windows and OS X.
2008-03-26 17:56:51 +01:00
Building libvips from source
============================
2007-08-29 18:23:50 +02:00
In the libvips directory, you should just be able to do:
2007-08-29 18:23:50 +02:00
2009-08-27 15:07:58 +02:00
$ ./configure
$ make
$ sudo make install
2007-08-29 18:23:50 +02:00
2008-03-26 17:56:51 +01:00
By default this will install files to /usr/local.
2007-08-29 18:23:50 +02:00
If you have problems, read on.
Building libvips on win32
-------------------------
2007-08-29 18:23:50 +02:00
http://www.vips.ecs.soton.ac.uk/index.php?title=Build_on_windows
Building libvips on OS X
------------------------
2007-08-29 18:23:50 +02:00
2011-01-06 15:18:00 +01:00
http://www.vips.ecs.soton.ac.uk/index.php?title=Build_on_OS_X
2007-08-29 18:23:50 +02:00
Building libvips from GIT
-------------------------
2009-08-27 15:07:58 +02:00
Checkout the latest sources with:
git clone git://github.com/jcupitt/libvips.git
2009-08-27 15:07:58 +02:00
Then for a debug build:
2009-08-27 15:07:58 +02:00
$ ./bootstrap.sh
$ CFLAGS="-g -Wall" CXXFLAGS="-g -Wall" ./configure --prefix=/home/john/vips --enable-gtk-doc
$ make
$ make install
2007-08-29 18:23:50 +02:00
Dependencies
============
libvips has to have gettext, glib-2.x and libxml-2.0. The build system needs
2007-08-29 18:23:50 +02:00
pkg-config and gnu make.
Optional dependencies
---------------------
If suitable versions are found, libvips will add support for these
libraries automatically. See "./configure --help" for a set of flags to
control library detection. Packages are generally found with pkg-config,
so make sure that is working.
2007-08-29 18:23:50 +02:00
libtiff and libjpeg do not usually use pkg-config so libvips looks for
them in the default path and in $prefix. If you have installed your own
versions of these libraries in a different location, libvips will not see
them. Use switches to libvips configure like:
2007-08-29 18:23:50 +02:00
2008-10-11 23:29:16 +02:00
./configure --prefix=/Users/john/vips \
--with-tiff-includes=/opt/local/include \
--with-tiff-libraries=/opt/local/lib \
--with-jpeg-includes=/opt/local/include \
--with-jpeg-libraries=/opt/local/lib
or perhaps:
CFLAGS="-g -Wall -I/opt/local/include -L/opt/local/lib" \
CXXFLAGS="-g -Wall -I/opt/local/include -L/opt/local/lib" \
./configure --without-python --prefix=/Users/john/vips
2007-08-29 18:23:50 +02:00
to get libvips to see your builds.
2007-08-29 18:23:50 +02:00
libjpeg
The IJG JPEG library.
2007-08-29 18:23:50 +02:00
libexif
if available, libvips adds support for EXIF metadata in JPEG files
2007-08-29 18:23:50 +02:00
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.
libz
If your TIFF library includes ZIP compression, you'll need this too.
videodev.h
If libvips finds linux/videodev.h, you get support for Linux video
2007-08-29 18:23:50 +02:00
grabbing.
fftw3
If libvips finds this library, it uses it for fourier transforms. It
can also use fftw2, but 3 is faster and more accurate.
2007-08-29 18:23:50 +02:00
If the library is not found, libvips falls back to it's own internal
FFT routines which are slower and less accurate.
2007-08-29 18:23:50 +02:00
2011-01-06 15:18:00 +01:00
lcms2
2007-08-29 18:23:50 +02:00
lcms
If present, im_icc_import(), _export() and _transform() are available
for transforming images with ICC profiles. If lcms2 is available,
it is used in preference to lcms.
2007-08-29 18:23:50 +02:00
large files
libvips uses the standard autoconf tests to work out how to support
large files (>2GB) on your system. Any reasonably recent *nix should
be OK.
2007-08-29 18:23:50 +02:00
libpng
if present, libvips can load and save png files.
2007-08-29 18:23:50 +02:00
2008-03-26 17:56:51 +01:00
libMagick, or optionally GraphicsMagick
if available, libvips adds support for loading all libMagick supported
image file types (about 80 different formats). Use
--with-magickpackage to build against graphicsmagick instead.
2007-08-29 18:23:50 +02:00
2011-01-06 15:18:00 +01:00
pangoft2
if available, libvips adds support for text rendering. You need the
2007-08-29 18:23:50 +02:00
package pangoft2 in "pkg-config --list-all"
2011-01-06 15:18:00 +01:00
orc-0.4
if available, vips will accelerate some operations with this run-time
compiler
matio
if available, vips can load images from Matlab save files
cfitsio
if available, vips can load FITS images
2007-08-29 18:23:50 +02:00
OpenEXR
if available, libvips will directly read (but not write, sadly)
OpenEXR images
2007-08-29 18:23:50 +02:00
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.