update README
updated the README with some notes on git
This commit is contained in:
parent
826de45ba1
commit
d5d312aa91
85
README
85
README
@ -1,7 +1,7 @@
|
|||||||
VIPS
|
libvips
|
||||||
====
|
=======
|
||||||
|
|
||||||
VIPS is an image processing library. It's good for large images and for
|
libvips is an image processing library. It's good for large images and for
|
||||||
colour. There's a GUI as well, see the VIPS website:
|
colour. There's a GUI as well, see the VIPS website:
|
||||||
|
|
||||||
http://www.vips.ecs.soton.ac.uk
|
http://www.vips.ecs.soton.ac.uk
|
||||||
@ -9,10 +9,10 @@ colour. There's a GUI as well, see the VIPS website:
|
|||||||
There are packages for most unix-like operating systems, and binaries for
|
There are packages for most unix-like operating systems, and binaries for
|
||||||
Windows and OS X.
|
Windows and OS X.
|
||||||
|
|
||||||
Building VIPS from source
|
Building libvips from source
|
||||||
=========================
|
============================
|
||||||
|
|
||||||
In the VIPS directory, you should just be able to do:
|
In the libvips directory, you should just be able to do:
|
||||||
|
|
||||||
$ ./configure
|
$ ./configure
|
||||||
$ make
|
$ make
|
||||||
@ -22,24 +22,24 @@ By default this will install files to /usr/local.
|
|||||||
|
|
||||||
If you have problems, read on.
|
If you have problems, read on.
|
||||||
|
|
||||||
Building VIPS on win32
|
Building libvips on win32
|
||||||
----------------------
|
-------------------------
|
||||||
|
|
||||||
http://www.vips.ecs.soton.ac.uk/index.php?title=Build_on_windows
|
http://www.vips.ecs.soton.ac.uk/index.php?title=Build_on_windows
|
||||||
|
|
||||||
Building VIPS on OS X
|
Building libvips on OS X
|
||||||
---------------------
|
------------------------
|
||||||
|
|
||||||
http://www.vips.ecs.soton.ac.uk/index.php?title=Build_on_OS_X
|
http://www.vips.ecs.soton.ac.uk/index.php?title=Build_on_OS_X
|
||||||
|
|
||||||
Building VIPS from SVN
|
Building libvips from GIT
|
||||||
----------------------
|
-------------------------
|
||||||
|
|
||||||
Checkout the latest sources with:
|
Checkout the latest sources with:
|
||||||
|
|
||||||
svn co https://vips.svn.sourceforge.net/svnroot/vips/vips7
|
git clone git://github.com/jcupitt/libvips.git
|
||||||
|
|
||||||
Then:
|
Then for a debug build:
|
||||||
|
|
||||||
$ ./bootstrap.sh
|
$ ./bootstrap.sh
|
||||||
$ CFLAGS="-g -Wall" CXXFLAGS="-g -Wall" ./configure --prefix=/home/john/vips --enable-gtk-doc
|
$ CFLAGS="-g -Wall" CXXFLAGS="-g -Wall" ./configure --prefix=/home/john/vips --enable-gtk-doc
|
||||||
@ -49,21 +49,21 @@ Then:
|
|||||||
Dependencies
|
Dependencies
|
||||||
============
|
============
|
||||||
|
|
||||||
VIPS has to have gettext, glib-2.x and libxml-2.0. The build system needs
|
libvips has to have gettext, glib-2.x and libxml-2.0. The build system needs
|
||||||
pkg-config and gnu make.
|
pkg-config and gnu make.
|
||||||
|
|
||||||
Optional dependencies
|
Optional dependencies
|
||||||
---------------------
|
---------------------
|
||||||
|
|
||||||
Optional support libraries ... also try ./configure --help to see flags for
|
If suitable versions are found, libvips will add support for these
|
||||||
controlling these libs. By default, if suitable versions are found, VIPS will
|
libraries automatically. See "./configure --help" for a set of flags to
|
||||||
build support for them automatically.
|
control library detection. Packages are generally found with pkg-config,
|
||||||
|
so make sure that is working.
|
||||||
|
|
||||||
VIPS looks for stuff with pkg-config, so make sure pkg-config can find these
|
libtiff and libjpeg do not usually use pkg-config so libvips looks for
|
||||||
extra libraries. libtiff and libjpeg do not generally use pkg-config, so
|
them in the default path and in $prefix. If you have installed your own
|
||||||
VIPS looks for them in the default path and in $prefix. If you have installed
|
versions of these libraries in a different location, libvips will not see
|
||||||
your own versions of these libraries in a different location, vips will not see
|
them. Use switches to libvips configure like:
|
||||||
them. Use switches to VIPS configure like:
|
|
||||||
|
|
||||||
./configure --prefix=/Users/john/vips \
|
./configure --prefix=/Users/john/vips \
|
||||||
--with-tiff-includes=/opt/local/include \
|
--with-tiff-includes=/opt/local/include \
|
||||||
@ -77,52 +77,53 @@ or perhaps:
|
|||||||
CXXFLAGS="-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
|
./configure --without-python --prefix=/Users/john/vips
|
||||||
|
|
||||||
to get VIPS to see your builds.
|
to get libvips to see your builds.
|
||||||
|
|
||||||
libjpeg
|
libjpeg
|
||||||
The IJG JPEG library. We use 6b, but 6a works too.
|
The IJG JPEG library.
|
||||||
|
|
||||||
libexif
|
libexif
|
||||||
if available, VIPS adds support for EXIF metadata in JPEG files
|
if available, libvips adds support for EXIF metadata in JPEG files
|
||||||
|
|
||||||
libtiff
|
libtiff
|
||||||
The TIFF library. It needs to be built with support for JPEG and
|
The TIFF library. It needs to be built with support for JPEG and
|
||||||
ZIP compression. 3.4b037 and later are known to be OK.
|
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
|
libz
|
||||||
If your TIFF library includes ZIP compression, you'll need this too.
|
If your TIFF library includes ZIP compression, you'll need this too.
|
||||||
|
|
||||||
videodev.h
|
videodev.h
|
||||||
If VIPS finds linux/videodev.h, you get support for Linux video
|
If libvips finds linux/videodev.h, you get support for Linux video
|
||||||
grabbing.
|
grabbing.
|
||||||
|
|
||||||
fftw3
|
fftw3
|
||||||
If VIPS finds this library, it uses it for fourier transforms. It can
|
If libvips finds this library, it uses it for fourier transforms. It
|
||||||
also use fftw2, but 3 is faster and more accurate.
|
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
|
If the library is not found, libvips falls back to it's own internal
|
||||||
routines which are slower and less accurate.
|
FFT routines which are slower and less accurate.
|
||||||
|
|
||||||
lcms2
|
lcms2
|
||||||
lcms
|
lcms
|
||||||
If present, im_icc_import(), _export() and _transform() are available
|
If present, im_icc_import(), _export() and _transform() are available
|
||||||
for transforming images with ICC profiles. If lcms2 is available, it
|
for transforming images with ICC profiles. If lcms2 is available,
|
||||||
is used in preference to lcms.
|
it is used in preference to lcms.
|
||||||
|
|
||||||
large files
|
large files
|
||||||
VIPS uses the standard autoconf tests to work out how to support large
|
libvips uses the standard autoconf tests to work out how to support
|
||||||
files (>2GB) on your system. Any reasonably recent *nix should be OK.
|
large files (>2GB) on your system. Any reasonably recent *nix should
|
||||||
|
be OK.
|
||||||
|
|
||||||
libpng
|
libpng
|
||||||
if present, VIPS can load and save png files. Version 1.2+ preferred.
|
if present, libvips can load and save png files.
|
||||||
|
|
||||||
libMagick, or optionally GraphicsMagick
|
libMagick, or optionally GraphicsMagick
|
||||||
if available, VIPS adds support for loading all libMagick supported
|
if available, libvips adds support for loading all libMagick supported
|
||||||
image file types (about 80 different formats). No saving though.
|
image file types (about 80 different formats). Use
|
||||||
|
--with-magickpackage to build against graphicsmagick instead.
|
||||||
|
|
||||||
pangoft2
|
pangoft2
|
||||||
if available, VIPS adds support for text rendering. You need the
|
if available, libvips adds support for text rendering. You need the
|
||||||
package pangoft2 in "pkg-config --list-all"
|
package pangoft2 in "pkg-config --list-all"
|
||||||
|
|
||||||
orc-0.4
|
orc-0.4
|
||||||
@ -136,8 +137,8 @@ cfitsio
|
|||||||
if available, vips can load FITS images
|
if available, vips can load FITS images
|
||||||
|
|
||||||
OpenEXR
|
OpenEXR
|
||||||
if available, VIPS will directly read (but not write, sadly) OpenEXR
|
if available, libvips will directly read (but not write, sadly)
|
||||||
images
|
OpenEXR images
|
||||||
|
|
||||||
swig
|
swig
|
||||||
python
|
python
|
||||||
|
Loading…
Reference in New Issue
Block a user