L_LoadBitmapResize

# include“l_bitmap.h”

L_LTFIL_APIL_INTL_LoadBitmapResize (pszFile、pSmallBitmap uStructSize、nDestWidth nDestHeight, nDestBits, uFlags,北方,pLoadOptions, pFileInfo)

一个图像文件装入位图,调整位图加载,所需的宽度,高度,和每像素比特。任何受支持的图像文件格式的文件可以和比特每像素是否压缩的和未压缩的。

请注意:更多的选项可用LOADFILEOPTION结构。

参数

L_TCHAR* pszFile

字符串包含文件的名称。

pBITMAPHANDLEpSmallBitmap

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

L_UINTuStructSize

结构大小的字节,指向pBitmap,版本控制。使用sizeof (BITMAPHANDLE)。

L_INTnDestWidth

新图像的宽度。

L_INTnDestHeight

图片的新高度。

L_INTnDestBits

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

价值 意义
0 保留原始文件的像素深度(不要转换)。特别注意装载12和16位灰度图像。
1到8 指定的位/像素的位图
12 12位/像素的位图
16 16位/像素的位图
24 每像素24位合成图
32 32位/像素的位图
48 48比特每像素的位图
64年 64比特每像素的位图

L_UINTuFlags

国旗表明调整使用的类型。可能的值是:

价值 意义
SIZE_NORMAL [0 x0]正常的调整。
SIZE_RESAMPLE (0 x2)线性插值调整。
SIZE_BICUBIC (0 x4)双立方插值调整。

L_INT北方

颜色为16 - 24 - 32 - 48和64位的位图。如果生成的位图小于16位/像素,这将因为托盘化的图像没有订单没有影响。以下是有效值:

价值 意义
ORDER_RGB [0]红、绿、蓝的顺序在内存中
ORDER_BGR [1]蓝色,绿色和红色的顺序在内存中
ORDER_GRAY [2]12或16位灰度图像。12和16位灰度图像只支持文档和医疗成像工具包。
ORDER_RGBORGRAY [3]加载形象红、绿、蓝或12或16位灰度图像。支持12和16位灰度图像文档和医疗成像工具包。
ORDER_BGRORGRAY [4]加载形象蓝色、绿色、红色或12或16位灰度图像。支持12和16位灰度图像文档和医疗成像工具包。
ORDER_ROMM [5]罗姆秩序。罗姆只支持24和48比特位图像。
ORDER_BGRORGRAYORROMM [6]加载形象红、绿、蓝或12或16位灰度图像或罗姆。支持12和16位灰度图像文档和医疗成像工具包。罗姆只支持24和48比特位彩色图像。

pLOADFILEOPTIONpLoadOptions

指针指向一个LOADFILEOPTION结构可选的扩展加载选项。通过零使用默认加载选项。

pFILEINFOpFileInfo

指针指向一个FILEINFO结构。这种结构可以包含文件信息用于加载一个图像,或者它可能是更新信息文件被加载。

如果不知道该文件,为这个参数传递NULL或声明一个变量类型的FILEINFO并设置FILEINFO。国旗为0,然后通过FILEINFO结构这个参数的地址。在这种情况下,如果FILEINFO结构传递的地址,FILEINFO结构将被更新的结果L_FileInfo。

如果文件类型,设置pFileInfo。格式的文件类型并设置pFileInfo。FILEINFO_FORMATVALID旗帜。这样做也可以L_FileInfo被称为以前,但价值观影响图像加载的大小变化(例如,通过调用L_SetPCDResolution或L_SetWMFResolution)。指出,在这种情况下FILEINFO结构pFileInfo将被更新的结果L_FileInfo。

如果L_FileInfo被称为调用这个函数之前,并没有改变结构的内容了吗L_FileInfo的地址,然后填充FILEINFO结构为这个参数可以传递。在这种情况下,FILEINFO。旗帜应该设置为FILEINFO_INFOVALID成员。的L_FileInfoFILEINFO函数集。FILEINFO_INFOVALID旗帜。在这种情况下,负载将更快因为这个函数没有查询文件类型的文件过滤器。

请注意:局部变量没有初始化(因为它们放在堆栈)。如果你有一个FILEINFO结构作为一个局部变量,其标志参数的值是未定义的,可能有FILEINFO_INFOVALID或FILEINFO_FORMATVALID集。这就是为什么重要的是初始化FILEINFO。旗帜之前FILEINFO结构函数的地址。

返回

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

评论

文件加载,这个函数修改尺寸到所需的宽度、高度和比特每像素。注意,原始文件并非完全加载到内存中。这个函数是理想的采样大图像(即生成缩略图)没有加载的内存开销大文件本身。

为支持的格式,请参考文件包含在您的应用程序。

请注意:你不应该通过未初始化FILEINFO这个函数。

必需的dll和库

平台

Win32 x64, Linux。

另请参阅

功能

主题

例子

这个示例加载和调整图像,400像素高。
位图的宽度是由纵横比。
双立方插值是用于调整。
的位图加载原始比特每像素。

L_INT LoadBitmapResizeExample (pBITMAPHANDLE pSmallBitmap, L_TCHAR * pszFile){L_INT nRet;如果(pSmallBitmap - > Flags.Allocated)L_FreeBitmap (pSmallBitmap);nRet = L_LoadBitmapResize (pszFile,/ /加载文件的名称pSmallBitmap,/ /指针到目标位图句柄运算符(BITMAPHANDLE),0,/ /新图像的宽度400年,/ /图片的新高度0,/ /新的比特每像素的图像SIZE_BICUBIC,ORDER_BGR,/ /颜色顺序空,/ /指针可选的扩展加载选项零/ /指向一个结构的指针);返回nRet;}

LEADTOOLS光栅成像C API的帮助
介绍
版本历史
开始
文件包含在您的应用程序
文档作者——文件包含您的应用程序
LEADTOOLS光栅成像特性
快速参考
教程
函数引用
回调函数
总结的特性
附录
188金宝搏的网址客服|支持|联系我们|知识产权的通知
©1991 - 2021领先的技术公司。保留所有权利。