NAME

Apache::GD::Thumbnail - Apache module which generates on-the-fly thumbnails using GD and libjpeg

SYNOPSIS

<Location /pics/thumbnails>
SetHandler perl-handler
PerlHandler Apache::GD::Thumbnail
PerlSetVar ThumbnailMaxSize 75
PerlSetVar ThumbnailBaseDir "/usr/local/httpd/htdocs/pics"
</Location>

DESCRIPTION

Just what it looks like: creates on-the-fly thumbnails of jpeg images. There are two optional configuration directives.

  • ThumbnailMaxSize

    Sets the maximum number of pixels to be used in the thumbnail for length or width (whichever is larger). Defaults to 50 if not specified.

  • ThumbnailBaseDir

    Sets the directory that contains the images to be thumbnailed. Defaults to ".." if not specified.

EXAMPLES

<Location /pics/thumbnails>
SetHandler perl-handler
PerlHandler Apache::GD::Thumbnail
PerlSetVar ThumbnailMaxSize 75
PerlSetVar ThumbnailBaseDir "/usr/local/httpd/htdocs/pics"
</Location>

In the above example, the URI /pics/thumbnails/img001.jpg will cause the module to generate a 75xnn (where nn < 75) thumbnail of /usr/local/httpd/htdocs/pics/img001.jpg

<Location /pics/*/thumbs>
SetHandler perl-handler
PerlHandler Apache::GD::Thumbnail
</Location>

In the above example, the URI /pics/foo/img001.jpg will cause the module to generate a 50xnn (nn < 50) thumbnail of DIRECTORYROOT/pics/somedirectory/img001.jpg As you can tell, this allows for much more dynamic configuration.

AUTHOR AND COPYRIGHT

Copyright (c) 2002 Issac Goldstand - All rights reserved.

This library is free software. It can be redistributed and/or modified under the same terms as Perl itself.

SEE ALSO

GD(3)