PHP 8.4.1 Released!

imagebmp

(PHP 7 >= 7.2.0, PHP 8)

imagebmpビットマップ画像をブラウザかファイルに出力する

説明

imagebmp(GdImage $image, resource|string|null $file = null, bool $compressed = true): bool

与えられた 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);
?>

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top