PHP マニュアル: ビットマップ画像をブラウザかファイルに出力する

説明

bool imagebmp(GdImage $image, resourcestringnull $file = null, bool $compressed = true)

与えられた image のビットマップ版を保存するか出力します。

パラメータ

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

注意:
引数 compressed が指定されない場合、 null は不正な値になります。
compressed: ビットマップをランレングス法(RLE)を使って圧縮するかどうか。

戻り値

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

警告

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

変更履歴

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

例

例1 ビットマップファイルを保存する

<?php
// 空の画像を生成し、いくつかテキストを加えます。
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);

imagestring($im, 1, 5, 5,  'BMP with PHP', $text_color);

// 画像を保存します。
imagebmp($im, 'php.bmp');

// メモリを解放します。
imagedestroy($im);
?>