Imagick::scaleImage

(PECL imagick 2, PECL imagick 3)

Imagick::scaleImage — 画像のサイズを変更する

説明

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

画像のサイズを指定した大きさに変更します。パラメータに 0 を指定すると、そのパラメータを自動的に計算します。

注意: パラメータ bestfit の挙動は Imagick 3.0.0 で変わりました。これより前のバージョンでは、200x150 の画像に対して 400x400 を指定した場合は何もせずそのままになっていました。 Imagick 3.0.0 以降では、この画像は 400x300 に拡大されます。これが、指定したサイズに対して「ベストフィット」する大きさだからです。 bestfit を使う場合は、幅と高さの両方を指定しなければなりません。

パラメータ

columns
rows
bestfit

戻り値

成功した場合に true を返します。

エラー / 例外

エラー時に ImagickException をスローします。

変更履歴

バージョン	説明
PECL imagick 2.1.0	オプションのパラメータ fit が追加され、このメソッドは、比例形式の拡大・縮小をサポートするようになりました。どちらかのパラメータにゼロを渡すと比例形式の拡大・縮小を行います。

例

例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