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

IBITMAP_FillRect()
说明：
此函数用于绘制指定颜色的实心矩形。
原型：
int IBITMAP_FillRect
(
IBitmap * po,
const AEERect *prc,
NativeColor color,
AEERasterOp rop
)

 

IBITMAP_DrawHScanline()
说明：
此函数用于绘制水平线段。
原型：
int IBITMAP_DrawHScanline
(
IBitmap * po,
unsigned y,
unsigned xMin,
unsigned xMax,
NativeColor color,
AEERasterOp rop
)

 

IBITMAP_DrawPixel()
说明：
用于在位图中绘制单个像素。
原型：
int IBITMAP_DrawPixel
(
IBitmap * po,
unsigned x,
unsigned y,
NativeColor color,
AEERasterOp rop
)

 

IBITMAP_SetPixels()
说明：
用于绘制多个颜色相同的像素。
原型：
int IBITMAP_SetPixels
(
IBitmap * po,
unsigned cnt,
AEEPoint *pPoint,
NativeColor color,
AEERasterOp rop
)
参数：
pPoint [in]： 二维点数组。

 

IBITMAP_NativeToRGB
说明：
此函数用于以 RGBVAL 格式获取 NativeColor 值的 R-G-B 定义。
每个有效的 NativeColor 都对应一个 R-G-B 值。 NativeColor 值映射的是位图的一个属性。
原型：
RGBVAL IBITMAP_NativeToRGB
(
IBitmap * po,
NativeColor clr
)

 

IBITMAP_RGBToNative()
说明：
此函数用于将 RGBVAL 转换为本地颜色值（像素值）。
本地颜色值是指存储在像素数组中的值；本地和 RGB 值间的映射是位图的一个属性。 如果指定的 RGBVAL 没有完全对应的 NativeColor，则返回近似的匹配值。 此函数不要求返回最近似的匹配；出于性能原因，它可能返回近似（而不是最近似）的匹配。
原型：
NativeColor IBITMAP_RGBToNative
(
IBitmap * po,
RGBVAL RGBColor
)

 

以上函数的示例代码如下：

IBitmap* pDst = NULL; IBitmap* pBuffer = NULL; AEERect rc; AEEPoint pointData[]={10,10,20,20,30,30,40,40,50,50}; SETAEERECT( &rc, 0, 0, 240, 320 ); IDISPLAY_GetDeviceBitmap(pMe->m_pIDisplay, &pDst) ; IBITMAP_CreateCompatibleBitmap(pDst, &pBuffer, 240, 320) ; IBITMAP_FillRect( pBuffer, &rc, MAKE_RGB( 255, 0, 0 ), AEE_RO_COPY ); IBITMAP_DrawHScanline(pBuffer, 40, 40, 60, IBITMAP_RGBToNative(pDst , MAKE_RGB(255,0,0)),AEE_RO_COPY) ; IBITMAP_DrawPixel ( pBuffer, 50, 50, IBITMAP_RGBToNative(pDst,MAKE_RGB(255,0,0)), AEE_RO_COPY ); IBITMAP_SetPixels( pBuffer, 5, pointData, IBITMAP_RGBToNative(pDst,MAKE_RGB(255,0,0)), AEE_RO_COPY ); IBITMAP_BltIn(pDst, 0, 0, 240, 320, pBuffer, 0, 0, AEE_RO_TRANSPARENT) ; //该步不可以缺少 IDISPLAY_Update(pMe->m_pIDisplay) ; if( NULL != pDst ) { IBITMAP_Release( pDst ); pDst = NULL; } if( NULL != pBuffer ) { IBITMAP_Release( pBuffer ); pDst = NULL; }