L_LoadBitmap

# include“l_bitmap.h”

L_LTFIL_APIL_INTL_LoadBitmap(pszFile, pBitmap, uStructSize, nBitsPerPixel, nOrder, pLoadOptions, pFileInfo)

将图像文件加载到位图中。该文件可以是任何支持的图像文件格式和每像素位，无论是压缩的还是未压缩的。

请注意:中有更多选项LOADFILEOPTION结构。

参数

L_TCHAR* pszFile

字符串，包含要加载的文件的名称。

pBITMAPHANDLEpBitmap

指向引用目标位图的位图句柄的指针。

L_UINTuStructSize

所指向结构的大小(以字节为单位)pBitmap，用于版本控制。使用sizeof (BITMAPHANDLE)。

L_INTnBitsPerPixel

产生的位图像素深度。以下是有效值:

价值 意义
0 保持原始文件的像素深度(不进行转换)。关于加载12位和16位灰度图像的特别说明．
1 ~ 8 合成位图中每个像素的指定位。
12 在合成位图中，每像素12位。
16 在合成位图中，每像素16位。
24 合成位图中每像素24位。
32 在合成位图中每像素32位。
48 合成位图中每像素48位。
64 在合成位图中每像素64位。

L_INT北方

颜色顺序为16位、24位、32位、48位和64位位图。如果生成的位图小于每像素16位，这将不起作用，因为托盘化的图像没有顺序。以下是有效值:

价值 意义
ORDER_RGB [0]内存中红、绿、蓝的颜色顺序
ORDER_BGR [1]内存中蓝、绿、红的颜色顺序
ORDER_GRAY [2] 12位或16位灰度图像。中仅支持12位和16位灰度图像文件和医疗成像工具包。
ORDER_RGBORGRAY 将图像加载为红色、绿色、蓝色或12位或16位灰度图像。中支持12位和16位灰度图像文件和医疗成像工具包。
ORDER_BGRORGRAY 将图像加载为蓝色、绿色、红色或12位或16位灰度图像。中支持12位和16位灰度图像文件和医疗成像工具包。
ORDER_ROMM [5] rom顺序。ROMM仅支持24位和48位映像。
ORDER_BGRORGRAYORROMM 将图像加载为红色、绿色、蓝色或作为12位或16位灰度图像或作为rom。中支持12位和16位灰度图像文件和医疗成像工具包。rom只支持24位和48位彩色图像。

pLOADFILEOPTIONpLoadOptions

指向可选扩展加载选项的指针。传递NULL以使用默认的加载选项。

pFILEINFOpFileInfo

指向FILEINFO结构。该结构可以包含加载图像时使用的文件信息，也可以使用有关正在加载的文件的信息进行更新。

如果对文件一无所知，则为该参数传递NULL，或声明一个类型变量FILEINFO并设置FILEINFO。标记为0，然后传递FILEINFO结构。在这种情况下，如果a的地址FILEINFO结构传递时，FILEINFO的结果将对结构进行更新L_FileInfo．

如果只知道文件类型，则设置pFileInfo。Format为文件类型，设置pFileInfo。指向FILEINFO_FORMATVALID的标志。这也可以做到如果L_FileInfo以前已调用，但影响加载图像大小的值已被更改(例如，通过调用L_SetPCDResolution或L_SetWMFResolution)．在这种情况下FILEINFO的结果将更新pFileInfo指向的结构L_FileInfo．

如果L_FileInfo在调用此函数之前已经被调用，并且没有对L_FileInfo填充的结构的内容进行更改，那么填充的地址FILEINFO结构可以为此参数传递。在本例中，FILEINFO。Flags成员应该设置为FILEINFO_INFOVALID。的L_FileInfo函数将设置FILEINFO。指向FILEINFO_INFOVALID的标志。在这种情况下，加载会更快，因为这个函数不需要查询文件类型的文件过滤器。

请注意:局部变量没有初始化(因为它们被放置在堆栈上)。如果你有一个FILEINFO结构作为局部变量时，其Flags参数的值是未定义的，可能设置了FILEINFO_INFOVALID或FILEINFO_FORMATVALID。这就是初始化FILEINFO很重要的原因。属性的地址之前FILEINFO函数的结构。

返回

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

评论

支持12位和16位灰度图像文件和医疗成像工具包。

有关支持的格式，请参见应用程序中包含的文件．

在调用此函数之前，您可能需要获取或设置文件信息，例如多页文件的页码或PCD文件的分辨率。指获取和设置文件信息．

该函数将初始化位图句柄并分配存储图像所需的存储空间。如果文件的每像素位数大于8位，图像数据将以与传递给函数的相同的颜色顺序加载北方．

由于函数分配存储空间来保存映像，因此由您通过调用来释放此存储空间L_FreeBitmap．

警告:如果nOrder被设置为ORDER_GRAY并且图像文件不是每像素12位或16位，该函数将返回ERROR_INV_PARAMETER。

请注意：

必需的dll和库

平台

Win32, x64, Linux。

另请参阅

功能

主题

例子

要获得完整的示例代码，请参阅FEATURE1示例。
这个例子加载一个位图

L_INT LoadBitmapExample (L_VOID)｛L_INT nRet;/*存放加载图像的位图句柄。* /BITMAPHANDLE LeadBitmap;/*加载位图，保持文件的每像素位nRet = L_LoadBitmap (MAKE_IMAGE_PATH(TEXT(“IMAGE1。CMP”&LeadBitmap)),运算符(bitmaphandle)， 0, order_bgr, null, null);如果(nRet != SUCCESS)返回nRet;如果(LeadBitmap.Flags.Allocated)L_FreeBitmap (&LeadBitmap);返回成功;｝

栅格成像C API帮助
简介
版本历史
开始
应用程序中包含的文件
文档编写者-与您的应用程序包含的文件
LEADTOOLS光栅成像功能
快速参考
教程
函数引用
回调函数
特点概述
附录
188金宝搏的网址客服|支持|联系我们|知识产权公告
©1991 - 2021领德科技有限公司版权所有。