L_MrcSaveBitmapList

# include“ltsgm.h”

L_LTSGM_APIL_INTL_MrcSaveBitmapList(hSegment, uhSegmentCount, hList, pCmpOption, pszFileName, nFormat)

将位图列表中包含的MRC图像保存到使用MRC LEAD、标准专有T44或PDF格式的文件。

参数

HSEGMENTATION* hSegment

分段句柄数组。方法获得此句柄L_MrcStartBitmapSegmentation函数。

L_UINTuhSegmentCount

分段句柄数。

HBITMAPLISThList

存储图像数据的位图列表的句柄。

pCOMPRESSIONOPTIONSpCmpOption

指向COMPRESSIONOPTIONS结构,该结构包含保存文件时要使用的压缩信息。

L_TCHAR* pszFileName

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

L_INTnFormat

输出文件格式。可能取值为:

价值 意义
FILE_TIF_MRC [177]带有标准MRC压缩的标记图像文件(标准T44)。(支持多页)。
FILE_PDF_LEAD_MRC [338]使用MRC分割技术的PDF压缩。
FILE_TIF_LEAD_MRC [315]带标记的图像文件与LEAD专有MRC。(支持多页)。默认文件扩展名为*. tif。

返回

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

评论

使用此函数将位图列表保存为使用标准T44格式的TIF文件(如果nFormat值为FILE_TIF_MRC),保存为具有LEAD MRC子类型格式的TIF文件(如果nFormat值为FILE_TIF_LEAD_MRC),或保存为使用分割功能的多页PDF(如果nFormat值为FILE_PDF_LEAD_MRC)。如果nFormat为FILE_TIF_MRC或FILE_TIF_LEAD_MRC,则*. tif为默认文件扩展名。当nFormat为FILE_PDF_LEAD_MRC时,*. pdf为默认文件扩展名。

使用L_MrcSaveBitmapList函数将位图列表保存为标准T44子类型格式的TIF文件,LEAD MRC子类型格式,或基于LEAD分割技术的PDF文件,如果你想:

此函数支持的所有格式都会生成多页文件(TIF或PDF)。文件中的页面数是uhSegmentCount或hList中的图像数,以较小者为准。

使用L_MrcSaveBitmapT44,或L_MrcSaveBitmap函数来保存单个图像或追加,插入覆盖到已经存在的TIF文件。

在调用L_MrcSaveBitmapList函数之前,最好对列表中的所有图像进行分割。方法可以自动执行分割L_MrcSegmentBitmap函数,或通过调用L_MrcCreateNewSegment函数。

调用L_MrcStartBitmapSegmentation函数,然后再调用任何分割方法。段的句柄不再需要时,调用L_MrcStopBitmapSegmentation函数。有关分段的更多信息,请参阅一般的分割Auto-Segmentation,手动分割

当使用L_MrcSaveBitmapList函数时,段可以是以下任何类型:

SEGTYPE_BACKGROUND

SEGTYPE_ONECOLOR

SEGTYPE_TEXT_1BIT_BW

SEGTYPE_TEXT_1BIT_COLOR

SEGTYPE_TEXT_2BITBW

SEGTYPE_TEXT_2BIT_COLOR

SEGTYPE_GRAYSCALE_2BIT

SEGTYPE_GRAYSCALE_8BIT

SEGTYPE_PICTURE

如果hSegmentation数组为NULL,或者有任何NULL元素,那么函数将通过调用hList自动分割位图L_MrcSegmentBitmap.L_MrcSegmentBitmap函数将文本、灰度和图片分段映射到T.44标准的NLS*模型中定义的层(掩码、背景和前景层)。段是位图上的矩形区域,可以根据其区域中使用的颜色数量分为文本、灰度或图片。混合光栅内容(MRC)格式由国际电信联盟开发,是ITU-T T.44号建议的一部分。有关混合光栅内容(MRC)格式的更多信息,请参阅一般信息

如果pCmpOption参数为NULL,则该函数将对掩码层(1位)使用Fax G4压缩,对24位图像段使用JPEG压缩,质量因子为2,对8位灰度段使用JPEG压缩,质量因子为2,对2位文本和2位灰度段使用JBIG压缩。有关更多信息,请参阅COMPRESSIONOPTIONS.注意,COMPRESSIONOPTIONS结构的nGrayscale2BitCoder、nGrayscale8BitCoder和nGrayscale8BitQFactor成员仅用于FILE_TIF_LEAD_MRC格式。COMPRESSIONOPTIONS结构的nText2BitCoder成员仅用于FILE_TIF_LEAD_MRC和FILE_PDF_LEAD_MRC格式。

必需的dll和库

另请参阅

功能

主题

例子

L_INT MrcSaveBitmapListExample(HSEGMENTATION* HSEGMENTATION,L_UINT uhSegments,HBITMAPLIST hList,L_TCHAR * pszFileName)L_INT nRet;COMPRESSIONOPTIONS CmpOption;/*初始化压缩结构*/CmpOption。uStructSize =运算符(COMPRESSIONOPTIONS);CmpOption。nMaskCoder = MRC_MASK_COMPRESSION_FAX_G3_1D;CmpOption。nPictureCoder = MRC_PICTURE_COMPRESSION_JPEG;CmpOption。nPictureQFactor = 10;CmpOption。nGrayscale8BitCoder = MRC_GRAYSCALE_COMPRESSION_GRAYSCALE_CMW_8BIT;CmpOption。nGrayscale8BitFactor = 2;CmpOption。nGrayscale2BitCoder = MRC_GRAYSCALE_COMPRESSION_JBIG_2BIT;CmpOption。nText2BitCoder = MRC_TEXT_COMPRESSION_JBIG_2BIT;/*保存MRC位图列表使用LEAD专有T44格式*/nRet = L_MrcSaveBitmapList(hSegmentation, uhSegments, hList, &CmpOption, pszFileName, FILE_TIF_LEAD_MRC);如果(nRet != SUCCESS)返回nRet;返回成功;
混合栅格内容(MRC) C API帮助
188金宝搏的网址客服|支持|联系我们|知识产权公告
©1991 - 2021领德科技有限公司版权所有。