Perlbal::Plugin::Palimg - plugin that allows Perlbal to serve palette altered images
This documentation refers to Perlbal::Plugin::Palimg that ships with Perlbal 1.50
Perlbal::Plugin::Palimg
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).
GIF
PNG
DOCROOT/palimg/
/pSPEC
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.
LOAD
web_server
Example perlbal.conf:
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
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.
/pg0011111164ffffff
00
111111
64
ffffff
Example:
http://192.168.0.1/palimg/logo.gif/pg01aaaaaa99cccccc
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.
/pt000000aaaaaa
000000
aaaaaa
http://192.168.0.1/palimg/logo.gif/pt1c1c1c22dba1
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.
/p
http://192.168.0.1/palimg/logo.gif/p01234567890abcfffffffcccccccddddddd
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.
Brad Fitzpatrick <brad@danga.com> Mark Smith <junior@danga.com>
Artistic/GPLv2, at your choosing.
Copyright 2004, Danga Interactive Copyright 2005-2007, Six Apart Ltd
To install Perlbal, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Perlbal
CPAN shell
perl -MCPAN -e shell install Perlbal
For more information on module installation, please visit the detailed CPAN module installation guide.