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.5 imageinterlace() は、 bool を返すようになりました。 これより前のバージョンでは、int を返していました。 (インターレース画像の場合は 0 でない値を、 そうでない場合は 0 を返していました)
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource が期待されていました。
8.0.0 enable は、 bool の値を期待するようになりました。 これより前のバージョンでは、数値型を期待していました。

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

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

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

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

関連キーワード:  imageinterlace, 画像, ビット, 期待, バージョン, GdImage, 変更, 関数, off, imagegrabwindow