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 オブジェクト。
enable: 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');
?>