画像をブラウザあるいはファイルに出力する

# imageavif

(PHP 8 >= 8.1.0)

imageavif — 画像をブラウザあるいはファイルに出力する

### 説明

function imageavif(
GdImage `$image`,
resource|string|null `$file` = `null`,
int `$quality` = -1,
int `$speed` = -1
): bool

指定された `image` から、 AVIF ラスタ画像を出力、または保存します。

### パラメータ

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

  ファイル保存先のパスあるいはオープン中のリソース (この関数が値を戻した後で自動的にクローズされます)。省略したり `null` を設定したりした場合は、画像ストリームを直接出力します。

`quality`

  `quality` はオプションで、 0 (画質は最悪、小さなファイル) から 100 (最高画質、大きなファイル) までの値を取ります。 `-1` を指定した場合、 デフォルト値 `52` を使います。

`speed`

  `speed` はオプションで、 0 (ゆっくり、小さなファイル) から 10 (速い、大きなファイル) までの値を取ります。 `-1` を指定した場合、 デフォルト値 `6` を使います。

### 戻り値

成功した場合に `true` を、失敗した場合に `false` を返します。

警告

しかしながら、libgd がイメージの出力に失敗した場合、この関数は `true` を返します。

### エラー / 例外

`quality` または、`speed` が不正の場合、 ValueError をスローします。

### 変更履歴

バージョン | 説明
--- | ---
8.4.0 | `quality` または、`speed` が不正の場合、 ValueError をスローするようになりました。

### 参考

- imagepng() - PNG イメージをブラウザまたはファイルに出力する
- imagewbmp() - 画像をブラウザあるいはファイルに出力する
- imagejpeg() - 画像をブラウザあるいはファイルに出力する
- imagetypes() - この PHP がサポートしている画像形式を返す

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