imageavif

(PHP 8 >= 8.1.0)

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

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`.