L_AllocateBitmap

# include“l_bitmap.h”

L_LTKRN_APIL_INTL_AllocateBitmap (pBitmap uMemory)

分配存储空间来存放所引用的一个图像位图句柄。

参数

pBITMAPHANDLEpBitmap

位图句柄指针描述分配存储的位图。

L_UINTuMemory

国旗请求类型的内存分配。可能的值是:

价值 意义
TYPE_CONV [0 x0001]使用常规内存如果图像适合,否则交换到磁盘。
TYPE_USER [0 x0002]创建一个位图,用户维护数据指针。
TYPE_TILED [0 x0004]创建平铺的位图。
TYPE_NOTILED [0 x0008]不创建平铺的位图,即使常规内存失败了。
TYPE_DISK [0 x0080]不要使用常规内存。交换到磁盘。
请注意:如果图像作为TYPE_DISK分配,那么图像不应该用于多个线程。
TYPE_NODISK [0 x0100]不交换到磁盘使用领先的虚拟内存。Windows虚拟内存不受影响。
TYPE_COMPRESSED [0 x0200] (文档和医疗成像工具包)分配一个RLE-compressed位图。您可以使用这个标志TYPE_CONV或TYPE_NODISK。有关更多信息,请参考加速1比特文件
TYPE_SUPERCOMPRESSED [0 x0400] (文档和医疗成像工具包)保持图像压缩在内存中。此选项会导致慢速,但非常低的内存使用。此选项可用于1比特,8位灰度,24位图像。

返回

价值 意义
成功 函数是成功的。
< 1 一个错误发生。指返回代码

评论

量分配的大小取决于图像显示位图的处理(宽度、高度和BitsPerPixel)。L_InitBitmap必须调用这个函数之前调用。

这是一个低级的函数使用的只有当你从头创建一个位图L_InitBitmap。通常情况下,负载或创建一个位图的功能分配所需的内存。(在这种情况下,调用L_AllocateBitmap会导致应用程序失去记忆。)

默认的内存类型只能是传统或磁盘。

如果TYPE_USER nMemory,位图被标记为数据指针设置使用L_SetBitmapDataPointer。释放这种类型的位图不会自由设定的数据指针L_SetBitmapDataPointer

有一些速度损失(损失)来访问平铺的位图。因此,不推荐使用的位图。

平铺的位图不默认情况下使用。LEADTOOLS将创建它们只有未能创建传统的位图和TYPE_NOTILED没有指定。

现在有三种不同的类型的位图:

传统(未压缩的和连续的)。这是最常见的类型。

b。压缩(仅1比特)。

c。瓦(未压缩的内部存储多达64 mb瓷砖)。

请注意:如果图像作为TYPE_DISK分配,那么图像不应该用于多个线程。

必需的dll和库

平台

Win32 x64, Linux。

另请参阅

功能

主题

例子

为一个例子,请参考L_ResizeBitmap
为完整的示例代码,参考FEATURE1
的例子。

LEADTOOLS光栅成像C API的帮助
188金宝搏的网址客服|支持|联系我们|知识产权的通知
©1991 - 2021领先的技术公司。保留所有权利。