C++中BitBlt的使用方法详解
BitBlt
该函数对指定的源设备环境区域中的像素进行位块(bit_block)转换,以传送到目标设备环境。
原型:
BOOLBitBlt( HDChdcDest, intnXDest,intnYDest,intnWidth,intnHeight, HDChdcSrc, intnXSrc,intnYSrc, DWORDdwRop);
参数:
hdcDest:指向目标设备环境的句柄。
nXDest、nYDest:指定目标矩形区域左上角的X轴和Y轴逻辑坐标
nWidth、nHeight:指定源和目标矩形区域的逻辑宽度和逻辑高度。
hdcSrc:指向源设备环境的句柄。
nXSrc、nYSrc:指定源矩形区域左上角的X轴和Y轴逻辑坐标。
dwRop:指定光栅操作代码。这些代码将定义源矩形区域的颜色数据,如何与目标矩形区域的颜色数据组合以完成最后的颜色。下面列出了一些常见的光栅操作代码:
值 描述 BLACKNESS 表示使用与物理调色板的索引0相关的色彩来填充目标矩形区域,(对缺省的物理调色板而言,该颜色为黑色)。 DSTINVERT 表示使目标矩形区域颜色取反。 MERGECOPY 表示使用布尔型AND(与)操作符将源矩形区域的颜色与特定模式组合一起。 MERGEPAINT 通过使用布尔型OR(或)操作符将源矩形区域的颜色取反后与目标矩形区域的颜色合并。 NOTSRCCOPY 将源矩形区域颜色取反,拷贝到目标矩形区域。 NOTSRCERASE 使用布尔类型的OR(或)操作符组合源和目标矩形区域的颜色值,然后将合成的颜色取反。 PATCOPY 将特定的模式拷贝到目标位图上。 PATINVERT 通过使用布尔型XOR(异或)操作符将源和目标矩形区域内的颜色合并。 PATPAINT 通过使用布尔型OR(或)操作符将源矩形区域取反后的颜色值与特定模式的颜色合并。然后使用OR(或)操作符将该操作的结果与目标矩形区域内的颜色合并。 SRCAND 通过使用布尔型AND(与)操作符来将源和目标矩形区域内的颜色合并。 SRCCOPY 将源矩形区域直接拷贝到目标矩形区域。 SRCERASE 通过使用布尔型AND(与)操作符将目标矩形区域颜色取反后与源矩形区域的颜色值合并。 SRCINVERT 通过使用布尔型XOR(异或)操作符将源和目标矩形区域的颜色合并。 SRCPAINT 通过使用布尔型OR(或)操作符将源和目标矩形区域的颜色合并。 WHITENESS 使用与物理调色板中索引1有关的颜色填充目标矩形区域。(对于缺省物理调色板来说,这个颜色就是白色)。
完整的光栅操作(ROP)码,参见TernaryRasterOperations.
返回值:
如果函数成功,那么返回值非零;如果函数失败,则返回值为零。调用GetLastError函数获取扩展错误信息。
说明:
如果在源设备环境中可以实行旋转或剪切变换,那么函数BitBlt返回一个错误。
如果存在其他变换(并且目标设备环境中匹配变换无效),那么目标设备环境中的矩形区域将在需要时进行拉伸、压缩或旋转。
如果源和目标设备环境的颜色格式不匹配,那么BitBlt函数将源场景的颜色格式转换成能与目标格式匹配的格式。
当正在记录一个增强型图元文件时,如果源设备环境标识为一个增强型图元文件设备环境,那么会出现错误。
并不是所有的设备都支持BitBlt函数。更多信息,调用GetDeviceCaps函数,将第二个参数赋值为RC_BITBLT来查看设备是否支持。(Formoreinformation,seetheRC_BITBLTrastercapabilityentryintheGetDeviceCapsfunction,aswellastheMaskBltandStretchBltfunctions.)
如果源和目标设备环境代表不同的设备,那么BitBlt函数返回错误。
更多关于从右到左向位块传输显示信息(Forinformationaboutblittingtodisplayswithright-to-leftorientations),参见CreatingBitmaps。
在WindowsCE1.0和1.01版中,参数dwRop只可以指定为下列值:SRCCOPY、SRCAND、SRCPAINT、SRCINVERT。在WindowsCE2.0及以后版中,参数dwRop可以是任何ROP3代码值。
下面是MSDN上的例子:
HBITMAPCopyBitmap(HBITMAPhbm){ HDChdcSrc=CreateCompatibleDC(NULL); HDChdcDst=CreateCompatibleDC(NULL); HBITMAPhbmOld,hbmOld2,hbmNew; BITMAPbm; GetObject(hbm,sizeof(bm),&bm); hbmOld=SelectObject(hdcSrc,hbm); hbmNew=CreateBitmap(bm.bmWidth,bm.bmHeight,bm.bmPlanes, bm.bmBitsPixel, NULL); hbmOld2=SelectObject(hdcDst,hbmNew); BitBlt(hdcDst,0,0,bm.bmWidth,bm.bmHeight,hdcSrc,0,0,SRCCOPY); SelectObject(hdcSrc,hbmOld); SelectObject(hdcDst,hbmOld2); DeleteDC(hdcSrc); DeleteDC(hdcDst); returnhbmNew; }
如有疑问请留言或者到本站社区交流讨论,感谢阅读,希望能帮助到大家,谢谢大家对本站的支持!