# imageavif

(PHP 8 >= 8.1.0)

imageavif — 输出图象到浏览器或文件。

### 说明

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

Outputs or saves a AVIF Raster image from the given `image`.

### 参数

`image`

  由图象创建函数(例如imagecreatetruecolor())返回的 GdImage 对象。

`file`

  文件保存的路径或者已打开的流资源（此方法返回后自动关闭该流资源），如果未设置或为 `null`，将会直接输出原始图象流。

`quality`

  `quality` is optional, and ranges from 0 (worst quality, smaller file) to 100 (best quality, larger file). If `-1` is provided, the default value `52` is used.

`speed`

  `speed` is optional, and ranges from 0 (slow, smaller file) to 10 (fast, larger file). If `-1` is provided, the default value `6` is used.

### 返回值

成功时返回 `true`， 或者在失败时返回 `false`。

警告

如果 libgd 输出图像失败，函数会返回 `true`。

### 错误／异常

Throws a ValueError if `quality` or `speed` is invalid.

### 更新日志

版本 | 说明
--- | ---
8.4.0 | Now throws a ValueError if `quality` or `speed` is invalid.

### 参见

- imagepng() - 将 PNG 图像输出到浏览器或文件
- imagewbmp() - 输出图象到浏览器或文件。
- imagejpeg() - 输出图象到浏览器或文件。
- imagetypes() - 返回 PHP 内置支持的图像类型

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