imagepng
PNG イメージをブラウザまたはファイルに出力する
説明
bool imagepng(
GdImage $image,
resourcestringnull $file = null,
int $quality = -1,
int $filters = -1
)
パラメータ
-
image
-
imagecreatetruecolorのような画像作成関数が返す 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 パラメータを無視します。
戻り値
成功した場合に true を、失敗した場合に false を返します。
警告しかしながら、libgd がイメージの出力に失敗した場合、この関数は true を返します。
エラー / 例外
quality が不正の場合、 ValueError をスローします。
参考
- imagegif
- imagewbmp
- imagejpeg
- imagetypes
- imagesavealpha