# include“ltsgm.h”
L_LTSGM_APIL_INTL_MrcSaveBitmapList(hSegment, uhSegmentCount, hList, pCmpOption, pszFileName, nFormat)
将位图列表中包含的MRC图像保存到使用MRC LEAD、标准专有T44或PDF格式的文件。
分段句柄数组。方法获得此句柄L_MrcStartBitmapSegmentation函数。
分段句柄数。
存储图像数据的位图列表的句柄。
指向COMPRESSIONOPTIONS结构,该结构包含保存文件时要使用的压缩信息。
包含输出文件名的字符串。
输出文件格式。可能取值为:
价值 | 意义 |
---|---|
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文件,如果你想:
在使用专有格式时,可以利用更多不同的段类型。
创建比保存为标准T44格式更小的文件。
创建比保存为标准T44格式更高质量的文件。
此函数支持的所有格式都会生成多页文件(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;
返回成功;
}