PHP 8.5.0 Alpha 4 available for testing

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, если возникла ошибка.

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

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

Ошибки

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

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

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

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

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

Примечания пользователей 1 note

up
0
avi at orons dot pro
2 years ago
Usage example:
$image = imagecreatefromjpeg('test.jpg'); //read a jpg file
imageavif($image, 'test.avif'); //save an avif file
To Top