PHP Imlib2 Extension (php_imlib)
================================

Dependency Libraries
--------------------
Before building this extension, Imlib2 will need to be installed somewhere
on the system. Imlib2 itself depends on freetype for rendering text and the
relevant underlying image libraries for the desired image formats. At the
very least Imlib2 needs libpng and libjpeg. Lastly, Imlib2 needs a DB
loader, edb.

Where to find these libraries: (There may be more recent versions)

Imlib2: http://www.us.rasterman.com/imlib.html
	http://www.us.rasterman.com/files/imlib2-1.0.0.tar.gz

edb: ftp://ftp.enlightenment.org/pub/enlightenment/e17/libs/edb-1.0.2-1.i386.rpm
     ftp://ftp.enlightenment.org/pub/enlightenment/e17/libs/edb-1.0.2.tar.gz
     ftp://ftp.enlightenment.org/pub/enlightenment/e17/libs/edb-devel-1.0.2-1.i386.rpm

freetype: http://freetype.sourceforge.net
          ftp://freetype.sourceforge.net/pub/freetype/freetype1/freetype-1.3.1.tar.gz
          http://rpmfind.net/linux/RPM/freetype.html
          http://rpmfind.net/linux/RPM/freetype-devel.html

libjpeg: http://www.ijg.org
	 ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v6b.tar.gz
	 http://rpmfind.net/linux/RPM/libjpeg.html
	 http://rpmfind.net/linux/RPM/libjpeg-devel.html

libpng: http://www.libpng.org/pub/png/libpng.html
	http://www.libpng.org/pub/png/src/libpng-1.0.8.tar.gz
	http://rpmfind.net/linux/RPM/libpng.html
	http://rpmfind.net/linux/RPM/libpng-devel.html


Built-in Extension Installation
-------------------------------
To build php_imlib into PHP, extract the extension into the ext/
subdirectory of the PHP source tree, run buildconf, and recompile.

tar -C /path/to/php_src/ext -zxvf php_imlib-0.3.tgz
cd /path/to/php_src
./buildconf
./configure --with-imlib[=/path/to/Imlib2] [other args]
make
make install


Standalone Installation
-----------------------
To avoid recompiling PHP itself, build php_imlib as a self-contained
extension (imlib.so) and reference it via either the extensions directive
in php.ini, or with the dl() function from inside PHP.

tar zxvf php_imlib-0.3.tgz
cd imlib
phpize
./configure [--with-imlib=/path/to/Imlib2] [other args]
make
make install


Configuration
-------------
The only relevant configuration parameter that php_imlib recognizes is
imlib.font_path, used to define which directories are automatically checked
for fonts.  It can be set at a system or directory level, or if it isn't
defined, the default value is /usr/local/share/fonts.

php.ini example:

[Imlib]
imlib.font_path = /usr/local/share/fonts:/web/www.domain.com/fonts

httpd.conf example:

php_value imlib.font_path /web/www.domain.com/fonts
