User manual - デバイス制御ライブラリリファレンスマニュアル(2014年10月10日)

181
11.7.20 bmp_iDisplayBmpData
指定した BMP 画像のデータを指定した座標に表示します。
int bmp_iDisplayBmpData(
char * pszBMPData ,
unsigned char ucRow ,
unsigned char ucClm
);
パラメータ
pszBMPData
BMP 形式のデータの先頭アドレスを指定します。
ucRow
表示する y 座標を 0～127 の範囲で指定します。
ucClm
表示する x 座標を 0～127 の範囲で指定します。
戻り値
下記の値を返します。
BMP_OPERATONOK
：正常終了
BMP_NOMEMORY
：メモリが足りません。
BMP_NOFILEOPEN
：ファイルが開けません。
BMP_NOFILEREAD
：ファイルが読めません。
BMP_NOFILESEEK
：ファイルのシークができません。
BMP_INVALIDTYPE
：BMP 形式画像ではありません。
BMP_INVALIDWIDTH
：画像が画面の右にはみ出しています。
BMP_INVALIDHEIGHT
：画像が画面の下にはみ出しています。
BMP_NEGATIVEHEIGHT
：BMP ヘッダ情報の画像の高さの値が不正です。
BMP_INVALIDPLANES
：BMP ヘッダ情報のプレーン数の値が不正です。
BMP_INVALIDBITCNT
：白黒画像ではありません。
BMP_COMPRESSED
：圧縮形式の BMP 画像です。
BMP_NOPIXELDATA
：BMP データ開始位置が不正です。
BMP_INVALIDROW
：y 座標の値が不正です。
BMP_INVALIDCLM
：x 座標の値が不正です。
解説
本関数は指定した BMP 形式画像のデータを指定した座標に表示します。表示座標は、左上が始点
(0,0)となります。
本関数は、bmp_iDisplayBmpImage関数とほぼ同等です。bmp_iDisplayBmpImage関数では、ファ
イルのデータを直接表示に反映するのに対し、本関数はRAMに展
開されたデータを表示に反映しま
す。
表示できる画像は白黒のみです。カラー画像の場合は BMP_INVALIDBITCNT エラーとなります。
圧縮形式の BMP 画像は扱えません。圧縮形式の場合は BMP_COMPRESSED エラーとなります。
本関数を使用する場合は、DTBMP.H をインクルードしてください。