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_NEIGHBOUR、 IMG_BILINEAR_FIXED、 IMG_BICUBIC、 IMG_BICUBIC_FIXED あるいはそれ以外 (2 パスで使います) のいずれか。

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

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

width または height がオーバーフローやアンダーフローを引き起こす場合、 ValueError をスローします。

mode が不正の場合、 ValueError をスローします。

バージョン	説明
8.4.0	`width` または `height` がオーバーフローやアンダーフローを引き起こす場合でも、 ValueError をスローするようになりました。
8.4.0	`mode` が不正の場合、 ValueError をスローするようになりました。
8.0.0	成功時には、この関数は GDImage クラスのインスタンスを返すようになりました。これより前のバージョンでは、 resource を返していました。
8.0.0	`image` は、 GdImage クラスのインスタンスを期待するようになりました。これより前のバージョンでは、有効な `gd` resource が期待されていました。