imagepng

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

説明

bool imagepng(
    GdImage $image,
    resourcestringnull $file = null,
    int $quality = -1,
    int $filters = -1
)

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

パラメータ

image

imagecreatetruecolorのような画像作成関数が返す GdImage オブジェクト。

file

ファイル保存先のパスあるいはオープン中のリソース (この関数が値を戻した後で自動的にクローズされます)。省略したり 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 を返します。

エラー / 例外

quality が不正の場合、 ValueError をスローします。

変更履歴

バージョン 説明
8.4.0 quality が不正の場合、 ValueError をスローするようになりました。
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な gd resource が期待されていました。

<?php
$im = imagecreatefrompng("test.png");

header('Content-Type: image/png');

imagepng($im);
imagedestroy($im);
?>

参考

  • imagegif
  • imagewbmp
  • imagejpeg
  • imagetypes
  • imagesavealpha