Imageserver - Info

Contents

• Files
• Usage
• About Cache
• About Fonts
• About Parameters

Files

The advise is to make a subdomain called image (for example image.domainname.com). And upload the following files here:

image.domainname.com
  cache                         Cache directory
  classes                       Classes directory
    allowedaddresses.php        Class that checks if an IP adress is allowed
    GD.php                      Class for imagemanipulation
    removecache.php             Class to remove all the cache
    Transform.php               Class for imagemanipulation
  config                        Config directory
    removecache_allowedip.php   Configfile for IP-adresses that may remove cache
  fonts                         Fonts directory
   (multiple fonts)
  Imageserver - Info.doc        Info file with most of this information
  index.php                     Root document
  info.php                      This document

Usage

The usage of this imageserver is very easy. Just enter the following url: http://image.domainname.com/?<param1>=<value1>&<param2>=<value2>&img=<the url of an image>.

About Cache

All generated images are cached so they aren't created twice, this improves performance dramaticly, especially for grayscaling. Make sure the cache directory is fully accessable (chmod 777). The url of the incoming image is base64 encoded. This may result in a very long string and so every 100 characters is creates a directory automaticly and stores the image in final directory with the last few chars that are left.

Cache can be deleted, but only by specific IP addresses. If your IP is allowed a link will appear on the info.php page. You can configure this in the following config file: config/removecache_allowedip.php. Just add IP addresses separated by a comma. Tip: Add comments behind the address so you know who you have enabled.

About Fonts

The list of fonts available is generated automaticly on the fonts in the fonts directory. Make sure while adding fonts, that the file is lowercase!

• verdanaz
• times
• timesbi
• courbi
• lsansdi
• lsans
• arial
• arialbi
• courbd
• lsansi
• timesbd
• lucon
• verdana
• verdanai
• couri
• ariali
• cour
• verdanab
• homoarakhn
• timesi
• lsansd
• arialbd

About Parameters

Any query parameter starting with triggers the ImageServer. This identifier is followed by the individual parameters which are separated by an &.

Order: The priciple is as follows:

• Always first since this is where the image is at it's best we rotate and grayscale.
• Then either scale, crop and mirror depending on the given parameters.
• Always last when transformations are done and additions can be made are addtext and gamma. Addtext because the font is best when you add it after making al kinds of transformations. The same goes for gamma.

This is what is looks like than. The order is defined by adding &o=<order> to the querystring. The 's', 'c' and 'm' stand for scale, crop and mirror. Order 'scm' is default.