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

# imageinterlace

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

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

### 説明

function 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');
    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open