« Imagick::thresholdImage
Imagick::tintImage »

Imagick::thumbnailImage

(PECL imagick 2, PECL imagick 3)

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

説明

public function 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();
}

?>

関連キーワード:
画像   Imagick   thumbnailImage   imagick   bestfit   columns   rows   fill   legacy   最大値   両方   ボックス   imagePath   thresholdImage   tintImage   関連   プロパティ   ウェブ   サムネイル   マッチ   縮小   挙動   拡大   ベスト   フィット
関連する関数・ページ:
imagick.scaleimage   imagick.tostring   imagick.addimage   imagick.removeimage   imagick.adaptiveresizeimage   imagick.setimageextent