imagescale

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

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

説明

imagescale(
    GdImage $image,
    int $width,
    int $height = -1,
    int $mode = IMG_BILINEAR_FIXED
): GdImage|false

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

注意:

他の画像処理関数と異なり、 imagescale() 関数は渡された image を変更しません。 代わりに 新しい 画像が返されます。

パラメータ

image

imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。

width

変更後の画像の幅。

height

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

mode

IMG_NEAREST_NEIGHBOURIMG_BILINEAR_FIXEDIMG_BICUBICIMG_BICUBIC_FIXED あるいはそれ以外 (2 パスで使います) のいずれか。

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

戻り値

成功した場合に、縮尺を変更した画像オブジェクトを返します。失敗した場合に false を返します。

変更履歴

バージョン 説明
8.0.0 成功時には、 この関数は GDImage クラスのインスタンスを返すようになりました。 これより前のバージョンでは、 resource を返していました。
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource が期待されていました。

参考

関連キーワード:  画像, 変更, 縮尺, , 指定, imagescale, 関数, GdImage, int, バージョン