- initial import

git-svn-id: https://siedziba.pl:790/svn/repos/php-imlib/trunk@7 455248ca-bdda-0310-9134-f4ebb693071a

1 files changed, 75 insertions, 0 deletions

diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000..a8c5308
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,75 @@
+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.
+
+Sources for these libraries can be found at:
+
+Imlib2, edb: http://download.sourceforge.net/enlightenment/
+freetype: http://freetype.sourceforge.net
+libjpeg: http://www.ijg.org
+libpng: http://www.libpng.org/pub/png/libpng.html
+
+You may want to look first on your distribution CD/FTP or http://rpmfind.net
+for binary packages. Please note that you will also need -devel packages!
+
+Standalone Installation
+-----------------------
+To avoid recompiling PHP itself, build php_imlib as a self-contained
+extension (imlib.so) and reference it via the extensions directive
+in php.ini. Use of the dl() function is discouraged!
+
+tar -zxvf php_imlib-0.4pre1.tar.gz
+cd imlib
+phpize
+./configure [--with-imlib=/path/to/Imlib2] [other args]
+make
+make install
+
+
+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.4pre1.tar.gz
+cd /path/to/php_src
+./buildconf
+./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
+
+
+Troubleshooting
+---------------
+* phpinfo() does not show any filters
+  - upgrade Imlib2 to version 1.0.5 or later
+* PHP segfaults while trying to use filters
+  - try to apply this patch:
+    http://pp.siedziba.pl/PLD/imlib2-filters-bugfix.patch
+* TGA loader does not work
+  - apply this patch:
+    http://pp.siedziba.pl/PLD/imlib2-loader_tga-bugfix.patch