Php/docs/function.imagepng

提供:Dev Guides
< Php
移動先:案内検索

imagepng

(PHP 4, PHP 5, PHP 7)

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


説明

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

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


パラメータ

image

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

to

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

注意:

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

quality

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

filters

PNG ファイルの大きさを小さくします。 これはビットマスクフィールドで、定数 PNG_FILTER_XXX の組み合わせを指定します。 PNG_NO_FILTERPNG_ALL_FILTERS を使用すると、 全フィルタを一括で無効にしたり有効にしたりできます。 デフォルト値 (-1) は、フィルタリングを無効にします。

警告

システムにインストールされた libgd は、filters パラメータを無視します。


返り値

成功した場合に true を、失敗した場合に false を返します。

警告 しかしながら、libgd がイメージの出力に失敗した場合、この関数は true を返します。


<?php$im = imagecreatefrompng("test.png");header('Content-Type: image/png');imagepng($im);imagedestroy($im);?>

参考

  • imagegif() - 画像をブラウザあるいはファイルに出力する
  • imagewbmp() - 画像をブラウザあるいはファイルに出力する
  • imagejpeg() - 画像をブラウザあるいはファイルに出力する
  • imagetypes() - この PHP がサポートしている画像形式を返す
  • imagesavealpha() - PNG 画像を保存する際に、完全なアルファチャネル情報を保存するかどうかを指定する