NAME

Apache::ImageShoehorn - mod_perl wrapper for Image::Shoehorn

SYNOPSIS

<Directory /path/to/some/directory/with/images>
 SetHandler	perl-script
 PerlHandler	Apache::ImageShoehorn

 PerlSetVar   ScaledDir       /path/to/some/dir

 PerlSetVar	SetScaleSmall	25%
 PerlSetVar	SetScaleMedium	50%
 PerlSetVar	SetScaleLarge	75%
 PerlSetVar	SetScaleThumb	x50

 <FilesMatch "\.html$">
  # Do something with HTML files here
 </FilesMatch>
</Directory>

#

http://www.foo.com/images/bar.jpg?scale=medium

DESCRIPTION

Apache mod_perl wrapper for Image::Shoehorn.

CONFIG DIRECTIVES

  • ScaledDir string

    A path on the filesystem where the handler will save images that have been scaled

    Remember, this directory needs to be writable by whatever user is running the http daemon.

  • SetScaleName string

    Define the names and dimensions of scaled images. name will be converted to lower-case and compared with the scale CGI query parameter. If no matching config directive is located, the handler will return DECLINED.

    If there are multiple SetScale directives then they will be processed, if necessary, during the handler's cleanup stage.

    If a scaled image already exists, it will not be rescaled until the lastmodified time for the source file is greater than that of the scaled version.

    Valid dimensions are identical as those listed in Image::Shoehorn.

VERSION

0.9

DATE

June 12, 2002

AUTHOR

Aaron Straup Cope

TO DO

  • Add hooks to allow for images to be be converted from one format to another. For example, a directory full of PhotoCD images would be sent to the browser as JPEGs.

  • Add hooks to store global TYPES and FORMATS data in a global hash keyed by the handler's location.

SEE ALSO

Image::Shoehorn

LICENSE

Copyright (c) 2002 Aaron Straup Cope. All Rights Reserved.

This is free software, you may use it and distribute it under the same terms as Perl itself.