Home/ Manual/ imagick / imagick/ Imagick::scaleImage

Imagick::scaleImage

PHP function Edit on GitHub ✎

(PECL imagick 2, PECL imagick 3)

Scales the size of an image

Description

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

Parameters

columns: The number of columns in the scaled image.
rows: The number of rows in the scaled image.
bestfit: Whether to fit the image within the given dimensions while preserving the aspect ratio.
legacy: Optional bool parameter. If set to true, the calculations are done with the small rounding bug that existed in Imagick before 3.4.0. If set to false, the calculations should produce the same results as the ImageMagick command-line tools.

Return Values

Success

Errors/Exceptions

Throws

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.
PECL imagick 3.4.0	Added the `legacy` parameter.

Examples

Imagick::scaleImage()

php

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

?>

Source: reference/imagick/imagick/scaleimage.xml · from the official PHP manual (php/doc-en)