Выводит изображение в браузер или записывает в файл

# imageavif

(PHP 8 >= 8.1.0)

imageavif — Выводит изображение в браузер или записывает в файл

### Описание

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

Функция выводит или сохраняет растровое изображение в формате AVIF, которое указали в параметре `image`.

### Список параметров

`image`
  Объект GdImage, который вернула функция imagecreatetruecolor() или другая функция генерации изображений.
`file`

  Путь или ресурс открытого потока, который функция автоматически закрывает после возврата значения, для сохранения файла. Функция выведет поток необработанного изображения напрямую, если параметр не установили или передали в аргументе значение `null`.

`quality`

  Необязательный параметр `quality` варьируется в диапазоне от 0 (худшее качество, файл меньшего размера) до 100 (лучшее качество, файл большего размера). При передаче значения `-1` для параметра устанавливается значение по умолчанию: `52`.

`speed`

  Необязательный параметр `speed` варьируется в диапазоне от 0 (медленнее, файл меньшего размера) до 10 (быстрее, файл большего размера). При передаче значения `-1` для параметра устанавливается значение по умолчанию: `6`.

### Возвращаемые значения

Функция возвращает `true`, если выполнилась успешно, или `false`, если возникла ошибка.

Предостережение

Функция вернёт значение `true`, если вывести изображение средствами библиотеки libgd невозможно.

### Ошибки

Функция выбрасывает ошибку ValueError, если значение параметра `quality` или `speed` недопустимо.

### Список изменений

Версия | Описание
--- | ---
8.4.0 | Функция теперь выбрасывает ошибку ValueError при недопустимом значении в параметре `quality` или `speed`.

### Смотрите также

- imagepng() - Выводит PNG-изображение в браузер или файл
- imagewbmp() - Выводит изображение в браузер или записывает в файл
- imagejpeg() - Выводит изображение в браузер или записывает в файл
- imagetypes() - Возвращает список типов изображений, поддерживаемых PHP сборкой

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