FAQ

Page Discussion History

HttpCircleGifModule

Revision as of 23:08, 10 November 2010 by Jbyers (Talk)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Contents

ngx_http_circle_gif_module

Note: this module is not distributed with the Nginx source. Installation instructions are below.

The ngx_http_circle_gif_module generates simple circle images with the colors and size specified in the URL. The images are served quickly, much faster than if they had been read from disk. The module was made to help web designers change the colors of their "round corners" without having to fire up PhotoShop.

Example usage:

location /circles {
    circle_gif;
}

Directives

circle_gif

syntax: circle_gif

default: n/a

context: location

circle_gif_min_radius

syntax: circle_min_radius

default: 10

context: location

The minimum radius of generated circle images, in pixels.

circle_gif_max_radius

syntax: circle_max_radius

default: 20

context: location

The maximum radius of generated circle images, in pixels.

circle_gif_step_radius

syntax: circle_step_radius

default: 2

context: location

The "step" in between generated circle images, in pixels.

Usage

To retrieve a circle image, just call a URL in the location you specified that ends like

<background color>/<foreground color>/<radius>.gif

Where radius is the radius in pixels, and the colors are 24-bit hex colors (e.g., "ffffff" is white and "000000" is black). For example, with the configuration above, this URL would produce a black on white circle with a radius of 20 pixels:

/circles/ffffff/000000/20.gif

Installation

You first need the ImageMagick development headers.

This module is not distributed with the Nginx source. You can download the circle_gif module here: [1]

After extracting, add the following option to your Nginx ./configure command:

--add-module=path/to/circle_gif/directory

Then "make" and "make install" as usual.

Bugs

Please report bugs to Evan Miller.