array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.imagepng.php', 1 => 'imagepng', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Функции GD и функции для работы с изображениями', ), 'prev' => array ( 0 => 'function.imagepalettetotruecolor.php', 1 => 'imagepalettetotruecolor', ), 'next' => array ( 0 => 'function.imagepolygon.php', 1 => 'imagepolygon', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/image/functions/imagepng.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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.
По умолчанию (-1
) используется значение по умолчанию сжатия zlib.
Более подробно читайте в » руководстве по zlib.
filters
Позволяет уменьшить размер PNG файла. Это битовая маска, значением которой
может быть комбинация констант PNG_FILTER_XXX
.
Для включения или выключения всех фильтров удобно воспользоваться
константами PNG_NO_FILTER
или
PNG_ALL_FILTERS
соответственно.
Значение по умолчанию (-1
) отключает фильтрацию.
Параметр filters
игнорируется системной библиотекой libgd.
Возвращает true
в случае успешного выполнения или false
, если возникла ошибка.
Однако,
если libgd не может вывести изображения, эта функция вернёт true
.
Версия | Описание |
---|---|
8.0.0 |
Параметр image теперь ожидает экземпляр класса GdImage;
раньше параметр ждал корректный gd -ресурс (resource).
|
<?php
$im = imagecreatefrompng("test.png");
header('Content-Type: image/png');
imagepng($im);
imagedestroy($im);
?>