search.cpan.org is shutting down
Aran Clary Deltac > Math-FitRect-0.04 > Math::FitRect
Module Version: 0.04

NAME

Math::FitRect - Resize one rect in to another while preserving aspect ratio.

SYNOPSIS

```    use Math::FitRect;

# This will return: {w=>40, h=>20, x=>0, y=>10}
my \$rect = fit_rect( [80,40] => 40 );

# This will return: {w=>80, h=>40, x=>-19, y=>0}
my \$rect = crop_rect( [80,40] => 40 );```

DESCRIPTION

This module is very simple in its content but can save much time, much like other simplistic modules like Data::Pager. This module is useful for calculating what size you should resize images as for such things as thumbnails.

RECTANGLES

Rectangles may be specified in several different forms to fit your needs.

A simple scalar integer containg the pixel width/height of a square.
An array ref containing the width and height of a rectangle: [\$width,\$height]
A hash ref containg a w (width) and h (height) key: {w=>\$width,h=>\$height}

FUNCTIONS

fit_rect

```    # This will return: {w=>40, h=>20, x=>0, y=>10}
my \$rect = fit_rect( [80,40] => 40 );```

Takes two rectangles and fits the first one inside the second one. The rectangle that will be returned will be a hash ref with a 'w' and 'h' parameter as well as 'x' and 'y' parameters which will specify any offset.

crop_rect

```    # This will return: {w=>80, h=>40, x=>-19, y=>0}
my \$rect = crop_rect( [80,40] => 40 );```

Like the fit_rect function, crop_rect takes two rectangles as a parameter and it makes \$rect1 completely fill \$rect2. This can mean that the top and bottom or the left and right get chopped off (cropped). This method returns a hash ref just like fit_rect.

AUTHOR

Aran Clary Deltac <bluefeet@gmail.com>