Imagick::scaleImage

(PECL imagick 2, PECL imagick 3)

Imagick::scaleImage — Scales the size of an image

Description

public Imagick::scaleImage(
    int $columns,
    int $rows,
    bool $bestfit = false,
    bool $legacy = false
): bool

Scales the size of an image to the given dimensions. The other parameter will be calculated if 0 is passed as either param.

Note: The behavior of the parameter bestfit changed in Imagick 3.0.0. Before this version given dimensions 400x400 an image of dimensions 200x150 would be left untouched. In Imagick 3.0.0 and later the image would be scaled up to size 400x300 as this is the "best fit" for the given dimensions. If bestfit parameter is used both width and height must be given.

Parameters

columns
rows
bestfit

Return Values

Returns true on success.

Errors/Exceptions

Throws ImagickException on error.

Changelog

Version	Description
PECL imagick 2.1.0	Added optional fit parameter. This method now supports proportional scaling. Pass zero as either parameter for proportional scaling.

Examples

Example #1 Imagick::scaleImage()

<?php
function scaleImage($imagePath) {
    $imagick = new \Imagick(realpath($imagePath));
    $imagick->scaleImage(150, 150, true);
    header("Content-Type: image/jpg");
    echo $imagick->getImageBlob();
}

?>

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 5 notes

down

benford at bluhelix dot com ¶

15 years ago

If anyone finds "The other parameter will be calculated if 0 is passed as either param. " to be a bit confusing, it means approximately this:

<?php
$im = new Imagick('example.jpg');
$im->scaleImage(300, 0);
?>

This scales the image such that it is now 300 pixels wide, and automatically calculates the height to keep the image at the same aspect ratio.

<?php
$im = new Imagick('example.jpg');
$im->scaleImage(0, 300);
?>

Similarly, this example scales the image to make it 300 pixels tall, and the method automatically recalculates the image's height to maintain the aspect ratio.

down

vincent dot hoen at gmail dot com ¶

17 years ago

Here is an easy way to resize an animated gif : 

$picture = new Imagick('animated_gif.gif');

foreach($picture as $frame){
    $frame->scaleImage($width, $height);
}

down

octave at web dot de ¶

15 years ago

When using the "fit = true" option, the image will only scale down, but never scale up:

<?php
$im = new Imagick('1600x1200.jpg');

$im->scaleImage(2000, 1500, true); // => 1600x1200

$im->scaleImage(1000, 500, true); // => 666x500
?>

down

agamemnus at flyingsoft dot pw ¶

10 years ago

Warning: this will blur your edges in possibly unexpected ways. For better control, use resizeImage, instead.

down

clickconvert at gmail dot com ¶

12 years ago

Need to resize portrait and landscape images (and convert to 72ppi)? These will fit an area of 800x600 without distorting, no matter how tall or wide.



<?php

    $img = new Imagick($img_loc.$file);

    $img->setImageResolution(72,72); 

    $img->resampleImage(72,72,imagick::FILTER_UNDEFINED,1);

    $img->scaleImage(800,0);

    $d = $img->getImageGeometry(); 

    $h = $d['height']; 

    if($h > 600) {

    $img->scaleImage(0,600);

    $img->writeImage($resized_loc.$file);

    } else {

    $img->writeImage($resized_loc.$file);

    }

    $img->destroy();

?>

＋add a note