CamlImages - Objective Caml image processing library

This library is currently under development.

*** Requirements

 To install CamlImages library, you need the following softwares:

	* ocaml 3.04 or higher
	* GNU make

and that is all. But note that this is the minimum requirement: you
can read/write BMP or PXM (PPM, PGM, PBM) image formats but no other
formats. If you want to deal with other image formats, you need to
install the corresponding external libraries:

	* libpng for PNG format
			ftp://ftp.uu.net/graphics/png/src/

	* libjpeg for JPEG format
		The Independent JPEG Group's software
			ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v6b.tar.gz

	* libtiff for TIFF format
		Sam Leffler's TIFF software
			ftp://ftp.sgi.com/graphics/tiff/tiff-v3.4-tar.gz

	* libxpm for XPM format
		X contrib libraries ftp directory
			fftp://ftp.x.org/contrib/libraries

	* freetype for drawing texts using truetype fonts
		The FREETYPE Project
			http://www.freetype.org/
				or
			http://freetype.sourceforge.net/

		Note:
			You need either version 1.3.1 or Version 2.0.x.

	* libungif for GIF format
		Because of the GIF patent problem of Unisys, we do not
		recommend to use GIF file format. If you really want to
		use GIF, do it in your own risk.

		Libungif, a library for using GIFs without compression. 
                  http://prtr-13.ucsc.edu/~badger/software/libungif/index.shtml

        * ghostscript for PS format
                See http://www.ghostscript.com/

Even though you do not have one of these libraries, all the functions of
CamlImages are still available, but they may raise an exception
Failure "??? is not supported"

*** Installation procedure

 Configuration
 -------------
  To compile and install the CamlImages library, first configure the
the library:

	% ./configure

This script searches whether external libraries exist or not and where
they are, and configure automatically your Makefile, config.h, 
camlimages.ml and so on. Some specialized configuration scripts are:
  configure_FreeBSD : to configure a FreeBSD box
  configure_OpenBSD : to configure an OpenBSD box.

  If you have installed the lablgtk library (CVS version):

   http://wwwfun.kurims.kyoto-u.ac.jp/soft/olabl/lablgtk.html

and it is in the standard place, $CAMLDIR/lablgtk, then configure script 
automatically finds it and configure your Makefile. If you installed
lablgtk in another place, you have to specify an option 
--with-lablgtk=LABLGTKDIR to enable to compile some examples using 
the lablgtk GUI library. (LABLGTKDIR standing for the absolute path of 
the directory where lablgtk resides.) 

 Compilation
 -----------
 type 

	% make

and wait. 

 Test
 ----
  Before you actually install the library, you can check that it
really works, by running examples in the test directory. For the test
programs,

	% cd test
	% make
	% ./test

we hope it works for you.

 Native code version
 -------------------
  To compile and install the native code version of the library, type

	% make opt

  (Optionnally you can test the native code version using
	% cd test
	% make opt
	% ./test.opt
        % cd ..
  )

 Installation
 ------------ 

  If there is no compilation error and the test works fine, 
install the library,

	% make install

This installs all the required files into $(LIBDIR) in Makefile.config,
usually /usr/local/lib/ocaml/camlimages, or /usr/lib/ocaml/camlimages.   

  If you want to create a toplevel with camlimages, 

	% make top

that creates a toplevel named "customtop". Then,

	% toplevel

executes customtop with the appropriate options.

 Example applications
 --------------------

  In the examples directory you can find several example applications
using Camlimages. 

  Some of the programs use the lablgtk GUI. 
