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

perl v5.34.0                                       2022-06-28                       Perlbal::Plugin::Palimg(3pm)