L_SaveBitmapList

# include“l_bitmap.h”

L_LTFIL_APIL_INTL_SaveBitmapList (lpszFile、hList nFormat、nBits nQFactor, pSaveOptions)

保存位图在多页文件的列表。

参数

L_TCHAR* lpszFile

字符串包含输出文件的名字。

HBITMAPLISThList

处理位图的列表。

L_INTnFormat

输出文件格式。您可以保存多页图像图形文件,GIF,大多数TIFF文件格式(包括JTIF,但不包括EXIF)。为可能的值,请参考输出文件的格式

单一的图像格式也有效的(尽管只有一个图像可以存储)。

L_INTnBits

生成的文件的像素的深度。为可能的值,请参考输出文件的格式。如果nBits为0,该文件将存储使用衣柜BitsPerPixel价值支持的格式。例如,如果一个文件格式支持1,4,和24 BitsPerPixel pBitmap - > BitsPerPixel是5,文件将存储为24位。同样,如果pBitmap - > BitsPerPixel是2,文件将存储为4位。

L_INTnQFactor

这个参数时使用一个图像保存到文件格式,支持品质因数(QFactor)。QFactor是一个数决定压缩过程中损失的程度。

为可能的值,请参考压缩质量的因素

pSAVEFILEOPTIONpSaveOptions

指针可选的扩展保存选项。通过零使用默认的保存选项。

返回

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

评论

幅图片格式也有效输出,但只有第一个图像保存在列表中。

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

这个函数支持签名数据图像,但只有DICOM和TIFF格式支持签名数据。这个函数将返回一个错误代码,如果你试图拯救一个签署了非DICOM格式或TIFF图像。

如果位图有一个地区,该地区中存储位图将被保存(如果图像保存为一个TIFF文件格式)。

你可以将一个文件格式转换成另一个当你保存一个文件。您还可以使用高级功能,L_FileConvert,将任何可能的格式转换成任何其他可能的格式。

LEADTOOLS版本17,在保存一个彩色图像时(比如每像素24位映像)双调的(每像素比特),工具箱将不会使用任何转换图像数据时犹豫不决。不推荐这样做,因为犹豫不决时,将彩色图像包含文本文档处理OCR和条形码等。犹豫不决的原因产生的文本识别引擎来处理模糊和努力。保存与Floyd-Stein双调的彩色图像抖动(LEADTOOLS 16.5和更早的行为),使用ESO_USEDITHERINGMETHOD BITMAPHANDLE。DitheringMethod如下图所示:

/ /“pBitmap”是一个彩色BITMAPHANDLE/ /设置FloydStein抖动:bitmapHandle。DitheringMethod = FLOYD_STEIN_DITHERING;SAVEFILEOPTION saveOptions = {0};L_GetDefaultSaveFileOption(其运算符(SAVEFILEOPTION));其。旗帜| = ESO_USEDITHERINGMETHOD;/ /保存位图与auto-dithering 1-bpp:L_SaveBitmap(文件名,&bitmapHandle FILE_CCITT_GROUP4 1 0 saveoptions);/ /或任何其他L_SaveBitmapXyz或L_SaveFileXyz等功能:/ / L_SaveFile(文件名,&bitmapHandle FILE_CCITT_GROUP4 1 0 0,空,空,其)

必需的dll和库

平台

Win32 x64, Linux。

另请参阅

功能

主题

例子

为完整的示例代码,指的是孩子。演示的C模块
的例子。
这个例子中保存的列表8位位图作为一个GIF动画文件。

L_INT SaveBitmapListExample (HBITMAPLIST hList,pBITMAPHANDLE LeadBitmap){L_INT nRet;BITMAPHANDLE TmpBitmap;* / / *临时位图处理SAVEFILEOPTION SAVEFILEOPTION;在保存* / / *文件选项/ *得到一份第一图像的位图处理* /nRet = L_GetBitmapListItem (hList 0 &TmpBitmap,运算符(BITMAPHANDLE));如果(nRet ! =成功)返回nRet;/ *得到默认的SAVEFILEOPTION值* /nRet = L_GetDefaultSaveFileOption (&SaveFileOption,运算符(SAVEFILEOPTION));如果(nRet ! =成功)返回nRet;/ *使用目标位图的板随着全球面板* /nRet = L_GetBitmapColors (LeadBitmap 0 256, SaveFileOption.GlobalPalette);如果(nRet ! =成功)返回nRet;/ *分配其他SAVEFILEOPTION字段* /SaveFileOption。旗帜= ESO_GLOBALBACKGROUND | ESO_GLOBALPALETTE;SaveFileOption。GlobalWidth = TmpBitmap.Width;SaveFileOption。GlobalHeight = TmpBitmap.Height;SaveFileOption。GlobalLoop = 0;SaveFileOption。GlobalBackground = LeadBitmap - >背景;/ *保存位图作为GIF动画文件列表* /nRet = L_SaveBitmapList (MAKE_IMAGE_PATH(文本(“testan.gif”))、hList FILE_GIF 8 0, &SaveFileOption);如果(nRet ! =成功)返回nRet;返回成功;}

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