NAME¶
Perlbal::Plugin::Palimg - plugin that allows Perlbal to serve palette altered
images
VERSION¶
This documentation refers to "Perlbal::Plugin::Palimg" that ships with
Perlbal 1.50
DESCRIPTION¶
Palimg is a perlbal plugin that allows you to modify "GIF" and
"PNG" on the fly. Put the images you want to be able to modify into
the "DOCROOT/palimg/" directory. You modify them by adding
"/pSPEC" to the end of the url, where SPEC is one of the below
defined commands (gradient, tint, etc).
CONFIGURING PERLBAL¶
To configure your Perlbal installation to use Palimg you'll need to
"LOAD" the plugin then add a service parameter to a
"web_server" service to activate it.
Example "perlbal.conf":
LOAD palimg
CREATE SERVICE palex
SET listen = ${ip:eth0}:80
SET role = web_server
SET plugins = palimg
SET docroot = /usr/share/doc/
SET dirindexing = 0
ENABLE palex
GRADIENTS¶
You can change the gradient of the image by adding
"/pg0011111164ffffff" to the end of the url. 00 is the index where
the gradient starts and 111111 is the color (in hex) of the beginning of the
gradient. 64 is the index of the end of the gradient and "ffffff" is
the color of the end of the gradient. Note that all colors specified in hex
should be lowercase.
Example:
http://192.168.0.1/palimg/logo.gif/pg01aaaaaa99cccccc
TINTING¶
You can tint the image by adding "/pt000000aaaaaa" to the end of the
url. 000000 should be replaced with the color to tint towards.
"aaaaaa" is optional and defines the "dark" tint color.
Both colors should be specified as lowercase hex numbers.
Example:
http://192.168.0.1/palimg/logo.gif/pt1c1c1c22dba1
PALETTE REPLACEMENT¶
You can specify a palette to replace the palette of the image. Do this by adding
up to six sets of seven hex lowercase numbers prefixed with "/p" to
the end of the URL.
Example:
http://192.168.0.1/palimg/logo.gif/p01234567890abcfffffffcccccccddddddd
BUGS AND LIMITATIONS¶
There are no known bugs in this module.
Please report problems to the Perlbal mailing list,
http://groups.google.com/group/perlbal
Patches are welcome.
AUTHORS¶
Brad Fitzpatrick <brad@danga.com> Mark Smith <junior@danga.com>
LICENSE AND COPYRIGHT¶
Artistic/GPLv2, at your choosing.
Copyright 2004, Danga Interactive Copyright 2005-2007, Six Apart Ltd