Go to file
John Cupitt fa6a8f7e40 stuff 2010-02-06 10:40:41 +00:00
benchmark added postclose callbacks 2010-01-10 21:28:38 +00:00
doc stuff 2010-02-04 22:03:49 +00:00
libvips png fix, doc fixes 2010-02-05 13:32:08 +00:00
libvipsCC added im_meta_remove 2010-01-25 14:23:30 +00:00
man man page spelling errors 2010-01-11 09:06:21 +00:00
po bump to 7.21, im_system_image works 2010-01-15 14:22:11 +00:00
swig make dist fixes 2009-11-10 13:54:15 +00:00
tools stuff 2010-02-06 10:40:41 +00:00
AUTHORS stuff 2009-03-31 23:25:44 +00:00
COPYING split to trunk/branches 2007-08-29 16:23:50 +00:00
ChangeLog stuff 2010-02-05 14:34:38 +00:00
INSTALL split to trunk/branches 2007-08-29 16:23:50 +00:00
Makefile.am add --disable-cxx option 2010-01-08 14:28:40 +00:00
NEWS split to trunk/branches 2007-08-29 16:23:50 +00:00
README stuff 2009-08-27 13:07:58 +00:00
THANKS split to trunk/branches 2007-08-29 16:23:50 +00:00
TODO stuff 2010-02-05 14:34:38 +00:00
acinclude.m4 merged 7.16 changes back into trunk 2008-10-11 21:29:16 +00:00
bootstrap.sh finished colour 2009-11-02 17:54:42 +00:00
configure.in stuff 2010-02-05 14:34:38 +00:00
gtk-doc.make merge gtkdoc branch 2009-08-16 15:00:08 +00:00
vips-7.21.pc.in oops, UCS2xx was broken 2009-11-30 17:14:59 +00:00
vipsCC-7.21.pc.in oops, UCS2xx was broken 2009-11-30 17:14:59 +00:00

README

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.

Building VIPS from source
=========================

In the VIPS directory, you should just be able to do:

	$ ./configure
	$ make
	$ sudo make install

By default this will install files to /usr/local.

If you have problems, read on.

Building VIPS on win32
----------------------

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

You can also cross-compile from a unix system to windows.

Building VIPS on OS X
---------------------

There are packages in macports.

	http://www.macports.org

Building VIPS from SVN
----------------------

Checkout the latest sources with:

	svn co https://vips.svn.sourceforge.net/svnroot/vips/vips7

Then:

	$ ./bootstrap.sh
	$ CFLAGS="-g -Wall" CXXFLAGS="-g -Wall" ./configure --prefix=/home/john/vips --enable-gtk-doc
	$ make
	$ make install

Dependencies
============

VIPS has to have gettext, glib-2.x and libxml-2.0. The build system needs 
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 with pkg-config, so make sure pkg-config can find these
extra libraries. libtiff and libjpeg do not generally use pkg-config, so 
VIPS looks for them in the default path and in $prefix. If you have installed
your own versions of these libraries in a different location, vips will not see
them. Use switches to VIPS configure like:

	./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 

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.