imagepng

(PHP 4, PHP 5, PHP 7, PHP 8)

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

説明

imagepng(
    GdImage $image,
    resource|string|null $file = null,
    int $quality = -1,
    int $filters = -1
): bool

指定した 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 を返します。

変更履歴

バージョン 説明
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource が期待されていました。

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

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

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

参考

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