imageinterlace

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

説明

bool imageinterlace(GdImage $image, boolnull $enable = null)

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

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

パラメータ

image

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

interlace

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

戻り値

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

変更履歴

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

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

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

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

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