(PHP 4, PHP 5, PHP 7, PHP 8)
imagepng — PNG イメージをブラウザまたはファイルに出力する
$image,$file = null,$quality = -1,$filters = -1
指定した image
から、PNG 画像を出力あるいは保存します。
imageimagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。
fileファイル保存先のパスあるいはオープン中のリソース (この関数が値を戻した後で自動的にクローズされます)。省略したり null を設定したりした場合は、画像ストリームを直接出力します。
注意:
qualityおよびfiltersを使用しない場合は、nullを指定することはできません。
quality
圧縮レベル。0 (圧縮しない) から 9 までの値です。
デフォルト (-1) は、zlib の圧縮レベルのデフォルトを使います。
詳細は、» zlib マニュアル をご覧ください。
filters
PNG ファイルの大きさを小さくします。
これはビットマスクフィールドで、定数
PNG_FILTER_*
の組み合わせを指定します。
PNG_NO_FILTER や
PNG_ALL_FILTERS を使用すると、
全フィルタを一括で無効にしたり有効にしたりできます。
デフォルト値 (-1) は、フィルタリングを無効にします。
システムにインストールされた libgd は、filters パラメータを無視します。
quality が不正の場合、 ValueError をスローします。
| バージョン | 説明 |
|---|---|
| 8.4.0 |
quality が不正の場合、 ValueError をスローするようになりました。
|
| 8.0.0 |
image は、
GdImage
クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、有効な gd resource が期待されていました。
|
<?php
$im = imagecreatefrompng("test.png");
header('Content-Type: image/png');
imagepng($im);
imagedestroy($im);
?>