---
name: "Perlbal::Plugin::Palimg"
section: "3pm"
platform: "linux"
package: "libperlbal-perl"
version: "1.80-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Perlbal::Plugin::Palimg"
---

# Perlbal::Plugin::Palimg(3pm)

plugin that allows Perlbal to serve palette altered images

## 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