BREW学习笔记-IBitmap 接口(一)

ISHELL_LoadBitmap();
说明：
直接加载位图文件，并返回位图的 IBitmap * 句柄。

原型：
IBitmap * ISHELL_LoadBitmap( IShell * pIShell, const char * pszFile )

示例：
IBitmap* pBmp = NULL; pBmp = ISHELL_LoadBitmap( pMe->m_pIShell, "test1.bmp" );

备注：

经过试验证明，非bmp图片，非.bmp的扩展名，都无法成功加载。
如果test1.bmp不是bmp图片，比如将一个jpg图片改名为test1.bmp，也无法成功加载。
如果扩展名不是bmp，比如将一个bmp图片改名为test1.jpg，也无法成功加载。
即只能加载bmp图片。

 

ISHELL_LoadResBitmap()
说明：
此函数用于从给定的资源文件中加载位图资源，并返回有效的 IBitmap 接口指针。

原型：
ISHELL_LoadResBitmap( IShell * pIShell, const char * pszResFile, int16 nResID  )

 

 

IDISPLAY_GetDeviceBitmap()
说明：
此函数用于获取设备（屏幕）位图。 设备位图是指调用 IDISPLAY_Update() 时其内容将复制到屏幕的位图。
原型：
int IDISPLAY_GetDeviceBitmap
(
IDisplay *po,
IBitmap **ppIBitmap

)

 

IBITMAP_CreateCompatibleBitmap()
说明：
此函数用于创建与位图接口（第一个参数）兼容的新位图。
原型：
int IBITMAP_CreateCompatibleBitmap
(
IBITMAP *po,
IBitmap **ppIBitmap,
uint16 w,
uint16 h
)

 

以上2个函数的示例代码

//保存游戏时的固定图块在pMe->m_playBg中 { IBitmap *pDeviceBmp = NULL; IDISPLAY_Update( GetDisplay( pMe ) ); IDISPLAY_GetDeviceBitmap( GetDisplay(pMe), &pDeviceBmp); IBITMAP_CreateCompatibleBitmap(pDeviceBmp, &pMe->m_playBg, GetScreenWidth(pMe), GetScreenHeight(pMe)); IBITMAP_BltIn(pMe->m_playBg, 0, 0, GetScreenWidth(pMe), GetScreenHeight(pMe), pDeviceBmp, 0, 0, AEE_RO_COPY); if( NULL != pDeviceBmp ) { IBITMAP_Release(pDeviceBmp); pDeviceBmp = NULL; } }