README for Eyefi ImageModifier for version 0.3
The Eyefi ImageModifier library is a high-level programming interface for describing and caching a series of image transformations which are applied to source images, typically for display on web pages.
The work process is as follows: you define a 'chain' of transformations, optionally giving it a name, and then apply an image to this chain, which results in a new image. If the image is applied to the chain a second time, a cached image will be used.
Currently, the following filters are defined:
- resize
- border
- apply color mask
- round corners
- cropping (to ratio, to dimension, square)
- color blending
- text (ttf / t1)
- margin
- overlay (for watermarking)
- grayscale
- canvassize
The Eyefi Open Source website, available at http://opensource.eyefi.nl/eyefi-imgfilter/, documents all features in detail.
REQUIREMENTS
This product is tested with PHP versions 4.4 and below. Furthermore, the GD imaging functions must be available. From version 4.3, GD is included in the standard PHP distribution.
For full type1 support, GD must be compiled with t1lib support.
You can check by running phpinfo() in a script on your website and checking the output.
INSTALLATION
Make sure that your PHP installation meets the above requirements.
- Copy imgfilter.inc.php anywhere on your server, preferably in your php's include_path.
- Make a directory imgcache under your document root and make it writable for user running the web server process.
This should do it, you should now be able to run any of the examples mentioned on the website.
SMARTY INSTALLATION
Smarty needs the function.imagemodifier.php in its plugin path. Move the file to folder lib/plugins in your smarty installation.
Furthermore, if you plan to use relative filenames for the {imagemodifier img=...} file, you need to define DATA_PATH as the root for the referenced files:
define("DATA_PATH", "/tmp/data/upload/");
Please also define LIBRARY_PATH as the path to imgfilter.inc.php, because the smarty function uses it:
example ( for /your/path/to/imgfilter.inc.php) define("LIBRARY_PATH", "/your/path/to/");