Output a BMP image to browser or file

# imagebmp

(PHP 7 >= 7.2.0)

imagebmp — Output a BMP image to browser or file

### 説明

imagebmp ( resource `$image` [, mixed `$to` = `NULL` [, bool `$compressed` = `TRUE` ]] ) : bool

Outputs or saves a BMP version of the given `image`.

### パラメータ

`image`

  imagecreatetruecolor() のような画像作成関数が返す画像リソース。

`to`

  ファイル保存先のパスあるいはオープン中のリソース (この関数が値を戻した後で自動的にクローズされます)。省略したり `NULL` を設定したりした場合は、画像ストリームを直接出力します。

  > 注意:

  > `NULL` is invalid if the `compressed` arguments is not used.

`compressed`

  Whether the BMP should be compressed with run-length encoding (RLE), or not.

### 返り値

成功した場合に `TRUE` を、失敗した場合に `FALSE` を返します。

警告

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

### 例

例1 Saving a BMP file

`<?php
// Create a blank image and add some text
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'BMP with PHP', $text_color);
// Save the image
imagebmp($im, 'php.bmp');
// Free up memory
imagedestroy($im);
?>`