imagepng

(PHP 4, PHP 5, PHP 7)

imagepngPNG イメージをブラウザまたはファイルに出力する

説明

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

指定した image から、PNG 画像を出力あるいは保存します。

パラメータ

image

imagecreatetruecolor() のような画像作成関数が返す画像リソース。

to

ファイル保存先のパスあるいはオープン中のリソース (この関数が値を戻した後で自動的にクローズされます)。省略したり NULL を設定したりした場合は、画像ストリームを直接出力します。

注意:

quality および filters を使用しない場合は、 NULL を指定することはできません。

quality

圧縮レベル。0 (圧縮しない) から 9 までの値です。 現在のデフォルトは 6 です。 詳細は、» zlib マニュアル をご覧ください。

filters

PNG ファイルの大きさを小さくします。 これはビットマスクフィールドで、定数 PNG_FILTER_XXX の組み合わせを指定します。 PNG_NO_FILTERPNG_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 画像を保存する際に(単一色の透過設定ではない)完全な アルファチャネル情報を保存するフラグを設定する