NAME

Image::Resize - Resize images using GD

SYNOPSIS

use Image::Resize;

# Create a mini-me 1/10th your size
resize-image("me.png", "mini-mi.jpg", 0.1);

# Resize to exactly 400x400 pixels.
resize-image("original.jpg", "resized.gif", 400, 400);

# scale to height 150px, adjust the width accordingly
scale-to-height("me.jpg", "thumbnail.jpg", 150);

# scale to width 150px, adjust the height accordingly
scale-to-width("me.jpg", "thumbnail.jpg", 150);

DESCRIPTION

The Image::Resize module exports 3 subroutines, each of which take a path to the image file that needs to be resize as the first positional argument, and a path where the resized image should be stored as the second positional argument.

Can read bmp, jpg, png and gif images and store the image in any format (depending on the extension specified for the destination file).

Can also specify the named argument :no-resample, which will disable resampling (using "smooth" copying from a large image to a smaller one, using a weighted average of the pixels).

jpeg-quality

When copying to a jpeg image, you can also specify the named argument :jpeg-quality to change the quality of the resized image. The value should be 0 .. 95. A negative value will set it to default jpeg value of GD.

SUBROUTINES

resize-image

# Create a mini-me 1/10th your size
resize-image("me.png", "mini-mi.jpg", 0.1);

# Resize to exactly 400x400 pixels.
resize-image("original.jpg", "resized.gif", 400, 400);

Resizes the image by a given factor (if only a third positional argument specified) or to a given width and height in pixels (if two positional arguments specified).

scale-to-height

# scale to height 150px, adjust the width accordingly
scale-to-height("me.jpg", "thumbnail.jpg", 150);

Resizes the image to the given height in pixels while preserving the aspect ratio.

scale-to-width

# scale to width 150px, adjust the height accordingly
scale-to-width("me.jpg", "thumbnail.jpg", 150);

Resizes the image to the given width in pixels while preserving the aspect ratio.

AUTHORS

Dagur Valberg Johannsson
Raku Community

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.