imagescale

(PHP 5 >= 5.5.0, PHP 7)

imagescale — 幅と高さを指定して、画像の縮尺を変更する

説明

imagescale ( resource $image , int $new_width [, int $new_height = -1 [, int $mode = IMG_BILINEAR_FIXED ]] ) : resource

imagescale() は、指定した補間アルゴリズムを使って画像の縮尺を変更します。

パラメータ

image

imagecreatetruecolor() のような画像作成関数が返す画像リソース。

new_width

変更後の画像の幅。

new_height

変更後の画像の高さ。省略したり負の数を指定したりした場合は、元の画像のアスペクト比を維持します。

警告

PHP 5.5.18 以前、あるいは PHP 5.6.2 以前のバージョンでは、常に高さを指定する必要があります。 これらのバージョンでは、高さを省略した場合のアスペクト比の計算が、正しく行われません。

mode

IMG_NEAREST_NEIGHBOUR、 IMG_BILINEAR_FIXED、 IMG_BICUBIC、 IMG_BICUBIC_FIXED あるいはそれ以外 (2 パスで使います) のいずれか。

注意: IMG_WEIGHTED4 にはまだ対応していません。

返り値

成功した場合に、縮尺を変更した画像リソースを返します。失敗した場合に FALSE を返します。

変更履歴

バージョン 説明
5.5.19/5.6.3 new_height が負の数だったり省略されていたりした場合の、高さの計算の問題が修正されました。 これより前のバージョンでは、アスペクト比を正確に保つことができませんでした。