Jbyers: correct Evan Miller's domain

2010-11-10T23:08:25Z

correct Evan Miller's domain

New page

= ngx_http_circle_gif_module =

''Note: this module is not distributed with the Nginx source. Installation instructions are [[#Installation|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:
<geshi lang="nginx">
location /circles {
circle_gif;
}
</geshi>

= 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

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

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:

<pre>
/circles/ffffff/000000/20.gif
</pre>

= 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: [http://wiki.nginx.org/File:Nginx_circle_gif-0.1.3.tar.gz]

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

<pre>
--add-module=path/to/circle_gif/directory
</pre>

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

= Bugs =

Please report bugs to [http://evanmiller.org Evan Miller].

HttpCircleGifModule - Revision history

Jbyers: correct Evan Miller's domain