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_XXX
の組み合わせを指定します。
PNG_NO_FILTER
や
PNG_ALL_FILTERS
を使用すると、
全フィルタを一括で無効にしたり有効にしたりできます。
デフォルト値 (-1
) は、フィルタリングを無効にします。
警告
システムにインストールされた libgd は、filters
パラメータを無視します。
戻り値
成功した場合に true
を、失敗した場合に false
を返します。
警告しかしながら、libgd がイメージの出力に失敗した場合、この関数は true
を返します。
エラー / 例外
quality
が不正の場合、 ValueError をスローします。
参考
- imagegif
- imagewbmp
- imagejpeg
- imagetypes
- imagesavealpha