(PHP 4, PHP 5, PHP 7, PHP 8)
imagepng — Выводит PNG-изображение в браузер или файл
$image,$file = null,$quality = -1,$filters = -1
Функция выводит или сохраняет PNG изображение
image.
imageОбъект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().
fileПуть или ресурс открытого потока, который функция автоматически закрывает
после возврата значения, для сохранения файла. Функция выведет поток необработанного изображения напрямую,
если параметр не установили или передали в аргументе значение null.
Замечание:
Недопустимо передавать значение
nullбез передачи аргументовqualityиfilters.
quality
Уровень сжатия: от 0 до 9, где 0 обозначает — без сжатия.
Значение по умолчанию равняется -1 и устанавливает уровень сжатия библиотеки zlib по умолчанию.
Дополнительную информацию даёт
» руководство по библиотеке zlib.
filters
Параметр разрешает уменьшить размер PNG-файла. Это поле битовой маски, которое
принимает произвольную комбинацию констант семейства PNG_FILTER_*.
Константа PNG_NO_FILTER отключает,
а константа PNG_ALL_FILTERS включает все фильтры.
Значение по умолчанию равняется -1 и отключает фильтрацию.
Системная библиотека libgd игнорирует параметр filters.
Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.
Однако,
если libgd не может вывести изображения, эта функция вернёт true.
Функция выбрасывает ошибку ValueError,
если значение параметра quality недопустимо.
| Версия | Описание |
|---|---|
| 8.4.0 |
Функция теперь выбрасывает ошибку ValueError,
если значение параметра quality недопустимо.
|
| 8.0.0 |
Параметр image теперь ожидает экземпляр класса GdImage;
раньше параметр ждал корректный gd-ресурс (resource).
|
<?php
$im = imagecreatefrompng("test.png");
header('Content-Type: image/png');
imagepng($im);
?>