(PHP 7 >= 7.2.0, PHP 8)
imagebmp — ビットマップ画像をブラウザかファイルに出力する
与えられた 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);
?>