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

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

    戻り値

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

    変更履歴

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

    参考

    To Top