Imagick::thumbnailImage

(PECL imagick 2, PECL imagick 3)

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

説明

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

画像のサイズを指定したものに変更し、関連付けられたプロパティをすべて削除します。ウェブ上での表示に適した小さなサムネイル画像を作成します。 3 番目のパラメータに true を指定すると、columns や rows にそれぞれの最大値を使用します。両方のパラメータが、マッチするまであるいは指定したパラメータより小さくなるまで縮小されます。

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

パラメータ

columns: 画像の幅。
rows: 画像の高さ。
bestfit: 最大値を強制的に使用するかどうか。
fill: 画像がボックスを完全に埋め尽くさない場合、ボックスは背景色で塗りつぶされます。
legacy: 次元を一番近い整数に丸めるのではなく、小さくなる方向に丸めます。

戻り値

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

エラー / 例外

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

例

例1 Imagick::thumbnailImage()

<?php
function thumbnailImage($imagePath) {
    $imagick = new \Imagick(realpath($imagePath));
    $imagick->setbackgroundcolor('rgb(64, 64, 64)');
    $imagick->thumbnailImage(100, 100, true, true);
    header("Content-Type: image/jpg");
    echo $imagick->getImageBlob();
}

?>