imageinterlace

    (PHP 4, PHP 5, PHP 7, PHP 8)

    imageinterlace — インターレースを有効もしくは無効にする

    説明

    imageinterlace(GdImage$image, ?bool$enable = null): bool

    imageinterlace() は、インターレースビットをon またはoffに切り替えます。

    インターレースビットがonでかつその画像が JPEG の場合、 その画像はプログレッシブ JPEG として生成されています。

    パラメータ

    image

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

    interlace

    true の場合はインターレース画像となり、 false の場合はインターレースビットを off にします。 null を渡すと、インターレースに関する振る舞いは変更されません。

    戻り値

    画像のインターレースビットが設定されている場合に true 、 それ以外の場合に false を返します。

    変更履歴

    バージョン説明
    8.0.5imageinterlace() は、 bool を返すようになりました。 これより前のバージョンでは、int を返していました。 (インターレース画像の場合は 0 でない値を、 そうでない場合は 0 を返していました)
    8.0.0image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な gdresource が期待されていました。
    8.0.0enable は、 bool の値を期待するようになりました。 これより前のバージョンでは、数値型を期待していました。

    例

    例1 imageinterlace() によるインターレース処理の有効化

    <?php
    // 画像のインスタンスを作成します
    $im = imagecreatefromgif('php.gif');

    // インターレースを有効にします
    imageinterlace($im, true);

    // 画像を保存します
    imagegif($im, './php_interlaced.gif');
    imagedestroy($im);
    ?>
    To Top