imagepng

(PHP 4, PHP 5, PHP 7)

imagepng Вывод PNG изображения в браузер или файл

Описание

imagepng ( resource $image [, mixed $to = NULL [, int $quality = -1 [, int $filters = -1 ]]] ) : bool

Выводит или сохраняет PNG изображение image.

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

image

Ресурс изображения, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().

to

Путь, или открытый потоковый ресурс (который автоматически закрывается после завершения функции), для сохранения файла. Если не установлен или равен NULL, изображение будет выведено в поток вывода в бинарном виде.

Замечание:

Недопустимо передавать NULL, если не используются аргументы quality и filters.

quality

Степень сжатия: от 0 (нет сжатия) до 9. По умолчанию (-1) используется значение по умолчанию сжатия zlib. Более подробно читайте в » руководстве по zlib.

filters

Позволяет уменьшить размер PNG файла. Это битовая маска, значением которой может быть комбинация констант PNG_FILTER_XXX. Для включения или выключения всех фильтров удобно воспользоваться константами PNG_NO_FILTER или PNG_ALL_FILTERS соответственно. Значение по умолчанию (-1) отключает фильтрацию.

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

Параметр filters игнорируется системной библиотекой libgd.

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

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

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

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

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

Версия Описание
5.4.0 Добавлена возможность использовать поток типа resource для to.
5.1.3 Добавлен аргумент filters.
5.1.2 Добавлен аргумент quality.

Примеры

<?php
$im 
imagecreatefrompng("test.png");

header('Content-Type: image/png');

imagepng($im);
imagedestroy($im);
?>

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

  • imagegif() - Выводит изображение в браузер или пишет в файл
  • imagewbmp() - Выводит изображение в браузер или пишет в файл
  • imagejpeg() - Выводит изображение в браузер или пишет в файл
  • imagetypes() - Возвращает список типов изображений, поддерживаемых PHP сборкой
  • imagesavealpha() - Сохранять ли полную информацию альфа-канала при сохранении изображений PNG