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
- 最大値を強制的に使用するかどうか。
返り値
成功した場合に true
を返します。
エラー / 例外
エラー時に ImagickException をスローします。
例
例1 Imagick::thumbnailImage()
<?phpfunction 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();}?>