view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME
    Apache::Gallery - mod_perl handler to create an image gallery

SYNOPSIS
    See the INSTALL file in the distribution for installation instructions.

DESCRIPTION
    Apache::Gallery creates an thumbnail index of each directory and allows
    viewing pictures in different resolutions. Pictures are resized on the
    fly and cached. The gallery can be configured and customized in many
    ways and a custom copyright image can be added to all the images without
    modifying the original.

CONFIGURATION
    In your httpd.conf you set the global options for the gallery. You can
    also override each of the options in .htaccess files in your gallery
    directories.

    The options are set in the httpd.conf/.htaccess file using the syntax:
    PerlSetVar OptionName 'value'

    Example: PerlSetVar GalleryCacheDir '/var/cache/www/'

    GalleryAutoRotate
        Some cameras, like the Canon G3, can detect the orientation of a the
        pictures you take and will save this information in the
        'Orientation' EXIF field. Apache::Gallery will then automatically
        rotate your images.

        This behavior is default but can be disabled by setting
        GalleryAutoRotate to 0.

    GalleryCacheDir
        Directory where Apache::Gallery should create its cache with scaled
        pictures. The default is /var/cache/www/ . Here, a directory for
        each virtualhost or location will be created automatically. Make
        sure your webserver has write access to the CacheDir.

    GalleryTemplateDir
        Full path to the directory where you placed the templates. This
        option can be used both in your global configuration and in
        .htaccess files, this way you can have different layouts in
        different parts of your gallery.

        No default value, this option is required.

    GalleryInfo
        With this option you can define which EXIF information you would
        like to present from the image. The format is: '<MyName =>
        KeyInEXIF, MyOtherName => OtherKeyInEXIF'

        Examples of keys: ShutterSpeedValue, ApertureValue, SubjectDistance,
        and Camera

        You can view all the keys from the EXIF header using this
        perl-oneliner:

        perl "-e" 'use Data::Dumper; use Image::Info qw(image_info); print
        Dumper(image_info(shift));' filename.jpg

        Default is: 'Picture Taken => DateTimeOriginal, Flash => Flash'

    GallerySizes
        Defines which widths images can be scaled to. Images cannot be
        scaled to other widths than the ones you define with this option.

        The default is '640 800 1024 1600'

    GalleryThumbnailSize
        Defines the width and height of the thumbnail images.

        Defaults to '100x75'

    GalleryThumbnailSizeLS
        If set to '1', GalleryThumbnailSize is the long and the short side
        of the thumbnail image instead of the width and height.

        Defaults to '0'.

    GalleryCopyrightImage
        Image you want to blend into your images in the lower right corner.
        This could be a transparent png saying "copyright my name 2001".

        Optional.

    GalleryWrapNavigation
        Make the navigation in the picture view wrap around (So Next at the
        end displays the first picture, etc.)

        Set to 1 or 0, default is 0

    GalleryAllowOriginal
        Allow the user to download the Original picture without resizing or
        putting the CopyrightImage on it.

        Set to 1 or 0, default is 0

    GallerySlideshowIntervals
        With this option you can configure which intervals can be selected
        for a slideshow. The default is '3 5 10 15 30'

    GallerySortBy
        Instead of the default filename ordering you can sort by any stat
        attribute. For example size, atime, mtime, ctime.

    GalleryDirSortBy
        Set this variable to sort directories differently than other items,
        can be set to size, atime, mtime and ctime; setting any other value
        will revert to sorting by name.

    GalleryMemoize
        Cache EXIF data using Memoize - this will make Apache::Gallery
        faster when many people access the same images, but it will also
        cache EXIF data until the current Apache child dies.

    GalleryUseFileDate
        Set this option to 1 to make A::G show the files timestamp instead
        of the EXIF value for "Picture taken".