NAME
Image::Imlib2::Thumbnail - Generate a set of thumbnails of an image
SYNOPSIS
use Image::Imlib2::Thumbnail;
my $thumbnail = Image::Imlib2::Thumbnail->new();
# generates a set of thumbnails for $source image in $directory
my @thumbnails = $thumbnail->generate( $source, $directory );
foreach my $thumbnail (@thumbnails) {
my $name = $thumbnail->{name};
my $width= $thumbnail->{width};
my $height = $thumbnail->{height};
my $type = $thumbnail->{type};
my $filename = $thumbnail->{filename};
print "$name/$type is $width x $height at $filename\n";
}
DESCRIPTION
This module generates a series of thumbnails of an image using
Image::Imlib2. If you want to generate a single thumbnail, you should
look at Image::Imlib2's create_scaled_image method.
Digital cameras take photos in many different sizes and aspect ratios.
Photo websites need to display thumbnails of different sizes of these
photos. This module makes it easy to generate a series of thumbnails of
an image of the right sizes. It resizes and crops images to match the
requires size.
What sizes does it generate? By default it generates thumbnails of the
same dimension that Flickr generates:
Type Name Width Height
Landscape Square 75 75
Landscape Thumbnail 100 75
Landscape Small 240 180
Landscape Medium 500 375
Landscape Large 1024 768
Portrait Square 75 75
Portrait Thumbnail 75 100
Portrait Small 180 240
Portrait Medium 375 500
Portrait Large 768 1024
The test suite contains images of every size mentioned on the Wikipedia
"Digital camera" article:
http://en.wikipedia.org/wiki/Digital_camera#Image_resolution
METHODS
new
The constructor:
my $thumbnail = Image::Imlib2::Thumbnail->new();
generate
Generates a set of thumbnails for $source image in $directory. Will also
include the original image:
my @thumbnails = $thumbnail->generate( $source, $directory );
foreach my $thumbnail (@thumbnails) {
my $name = $thumbnail->{name};
my $width= $thumbnail->{width};
my $height = $thumbnail->{height};
my $type = $thumbnail->{type};
my $filename = $thumbnail->{filename};
print "$name/$type is $width x $height at $filename\n";
}
add_size
Add an extra size:
$thumbnail->add_size(
{ type => 'landscape',
name => 'header',
width => 350,
height => 200
}
);
AUTHOR
Leon Brocard,
[email protected]
COPYRIGHT
Copyright (c) 2007 Leon Brocard. All rights reserved. This program is
free software; you can redistribute it and/or modify it under the same
terms as Perl itself.
