HttpCircleGifModule

= 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

/ / .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:

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

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

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

= Bugs =

Please report bugs to Evan Miller.