PHP 8.4.0 RC4 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, используется значение по умолчанию 30.

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