The 4th Annual China PHP Conference


(PECL imagick 2.0.0)

Imagick::scaleImageMet à l'échelle la taille de l'image


bool Imagick::scaleImage ( int $cols , int $rows [, bool $bestfit = false ] )

Met à l'échelle la taille de l'image, aux dimensions voulues. Les autres paramètres seront calculés si 0 est pas dans l'un d'entre eux.

Note: Le comportement du paramètre bestfit a changé avec Imagick 3.0.0. Avant cette version, fournir les dimensions 400x400 à une image de dimensions 200x150 faisait que la partie gauche était inchangée. Avec Imagick 3.0.0 et suivants, l'image est réduite à la taille 400x300, sachant que c'est le meilleur résultat pour ces dimensions. Si le paramètre bestfit est utilisé, la largeur et la hauteur doivent être fournies.

Liste de paramètres




Valeurs de retour

Retourne TRUE en cas de succès.

Erreurs / Exceptions

Lance une exception ImagickException si une erreur survient.


Version Description
2.1.0 Ajout d'un paramètre optionnel de fit. Cette méthode supporte désormais la mise à l'échelle proportionnelle. Passez zéro dans l'un des paramètres pour activer cette option.


Exemple #1 Exemple avec Imagick::scaleImage()

function scaleImage($imagePath) {
$imagick = new \Imagick(realpath($imagePath));
header("Content-Type: image/jpg");


add a note add a note

User Contributed Notes 6 notes

benford at bluhelix dot com
6 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:

= 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.

= 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.
octave at web dot de
6 years ago
When using the "fit = true" option, the image will only scale down, but never scale up:

= new Imagick('1600x1200.jpg');

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

$im->scaleImage(1000, 500, true); // => 666x500
vincent dot hoen at gmail dot com
8 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);
agamemnus at flyingsoft dot pw
2 years ago
Warning: this will blur your edges in possibly unexpected ways. For better control, use resizeImage, instead.
clickconvert at gmail dot com
3 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.

= new Imagick($img_loc.$file);
$d = $img->getImageGeometry();
$h = $d['height'];
$h > 600) {
    } else {
peter at icb dot at
6 years ago
If using the fit-parameter this function sometimes seems not to work when one of the two sizes (width or height) is the same size as the image has. For example:

= new Imagick('800x480.jpg');
$image->scaleImage(640, 480, true);

// $image is still 800x480

You have to calculate the new sizes yourself and use false for $fit in this case.
To Top