imagepng
(PHP 4, PHP 5, PHP 7)
imagepng — PNG イメージをブラウザまたはファイルに出力する
説明
指定した image
から、PNG 画像を出力あるいは保存します。
パラメータ
-
image -
imagecreatetruecolor() のような画像作成関数が返す画像リソース。
-
to -
ファイル保存先のパスあるいはオープン中のリソース (この関数が値を戻した後で自動的にクローズされます)。省略したり
NULLを設定したりした場合は、画像ストリームを直接出力します。注意:
qualityおよびfiltersを使用しない場合は、NULLを指定することはできません。 -
quality -
圧縮レベル。0 (圧縮しない) から 9 までの値です。 現在のデフォルトは 6 です。 詳細は、» zlib マニュアル をご覧ください。
-
filters -
PNG ファイルの大きさを小さくします。 これはビットマスクフィールドで、定数 PNG_FILTER_XXX の組み合わせを指定します。
PNG_NO_FILTERやPNG_ALL_FILTERSを使用すると、 全フィルタを一括で無効にしたり有効にしたりできます。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
警告
しかしながら、libgd がイメージの出力に失敗した場合、この関数は TRUE を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 5.4.0 |
ストリームリソースを
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 画像を保存する際に（単一色の透過設定ではない）完全な アルファチャネル情報を保存するフラグを設定する