L_GetOverlayBitmap

# include“l_bitmap.h”

L_LTKRN_APIL_INTl_geoverlaybitmap (pBitmap, nIndex, pOverlayBitmap, uStructSize, uFlags)

获取指定索引的覆盖位图。

参数

pBITMAPHANDLEpBitmap

指向引用主位图的位图句柄的指针。

L_INTnIndex

正在检索的覆盖的索引。该索引从零开始。

pBITMAPHANDLEpOverlayBitmap

指向在指定索引处用覆盖位图更新的覆盖位图句柄的指针。不能为NULL。

L_UINTuStructSize

指向的BITMAPHANDLE结构的大小pOverlayBitmap.通过sizeof (BITMAPHANDLE)。

L_UINTuFlags

确定如何检索位图的标志。您不能合并这些标志。可能取值为:

价值 意义
OVERLAY_COPY [0x0000]从覆盖列表中检索覆盖位图的副本。
OVERLAY_NOCOPY [0x0001]获取实际的覆盖位图。没有复制。在修改覆盖位图时应该小心,因为您可以修改/使覆盖位图列表中的条目无效。
OVERLAY_MOVE [0x0003]获取实际的覆盖位图。位图也从覆盖列表中删除。建议使用OVERLAY_NOCOPY。

返回

价值 意义
成功 活动很成功。
< 1 发生错误。指返回代码

评论

这个函数可以用来获得叠加位图的副本(OVERLAY_COPY),也可以用来获得没有复制的位图(OVERLAY_NOCOPY或OVERLAY_MOVE)。

获得覆盖位图的最快方法是避免复制。有关使用OVERLAY_NOCOPY的更多信息,请参阅的“注释”部分L_SetOverlayBitmap

如果在OVERLAY_MOVE中设置uFlags,对应索引的覆盖位图将失效。

pOverlayBitmap假定为未分配和未初始化的。它将在不释放现有数据的情况下填充。

必需的dll和库

平台

Win32, x64, Linux。

另请参阅

功能

主题

例子

这个例子将获得叠加位图,并将它们保存到单独的文件中。

L_INT geoverlaybitmapexample (HWND HWND, pBITMAPHANDLE pBitmap)L_INT nRet;BITMAPHANDLE OverlayBitmap;L_INT我;L_TCHAR s [MAX_PATH];(i = 0;i < max_overlay;我+ +)//注意我正在使用OVERLAY_NOCOPY,所以我不应该释放覆盖位图!nRet = l_geoverlaybitmap (pBitmap, i, &OverlayBitmap,运算符(BITMAPHANDLE) OVERLAY_NOCOPY);如果(nRet == SUCCESS)wsprintf(年代,MAKE_IMAGE_PATH(文本(“叠加% d_copy.cmp”),我);nRet = L_SaveBitmap(s, &OverlayBitmap, FILE_LEAD1BIT, 1,1, NULL);如果(nRet != SUCCESS)对话框(hWnd,文本(“保存文件错误!”), s, MB_OK);返回nRet;其他的返回nRet;返回成功;

栅格成像C API帮助
188金宝搏的网址客服|支持|联系我们|知识产权公告
©1991 - 2021领德科技有限公司版权所有。