imagepng

(PHP 4, PHP 5, PHP 7, PHP 8)

imagepngOutput a PNG image to either the browser or a file

Опис

imagepng(
    GdImage $image,
    resource|string|null $file = null,
    int $quality = -1,
    int $filters = -1
): bool

Outputs or saves a PNG image from the given image.

Параметри

image

Об'єкт GdImage, що повертається однією з функцій створення зображення, такою як imagecreatetruecolor().

file

Шлях або відкритий ресурс потоку (котрий автоматично закривається після повернення з цієї функції) для збереження файла. Якщо не встановлено або дорівнює null, буде виведено двійковий код зображення.

Зауваження:

null is invalid if the quality and filters arguments are not used.

quality

Compression level: from 0 (no compression) to 9. The default (-1) uses the zlib compression default. For more information see the » zlib manual.

filters

Allows reducing the PNG file size. It is a bitmask field which may be set to any combination of the PNG_FILTER_* constants. PNG_NO_FILTER or PNG_ALL_FILTERS may also be used to respectively disable or activate all filters. The default value (-1) disables filtering.

Застереження

The filters parameter is ignored by system libgd.

Значення, що повертаються

Повертає true у разі успіху або false в разі помилки.

Застереження

Проте, якщо libgd не може вивести зображення, ця функція повертає true.

Помилки/виключення

Throws a ValueError if quality is invalid.

Журнал змін

Версія Опис
8.4.0 Now throws a ValueError if quality is invalid.
8.0.0 Тепер image має бути примірником GdImage. Раніше очікувався gd-resource.

Приклади

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

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

imagepng($im);
?>

Прогляньте також

  • imagegif() - Вивід зображення в браузер чи файл.
  • imagewbmp() - Вивід зображення в браузер чи файл.
  • imagejpeg() - Вивід зображення в браузер чи файл.
  • imagetypes() - Return the image types supported by this PHP build
  • imagesavealpha() - Whether to retain full alpha channel information when saving images