跳转到主要内容
此对象用于通过 ABBYY FineReader Engine 的导出函数,调整将识别文本导出为 PDF (PDF/A) 格式时的Parameter。指向此对象的指针会作为输入Parameter传递给导出方法,因此会影响导出结果。新创建的此类型对象的所有属性都会设置为合理的默认值。 我们建议按以下顺序调整Parameter:
  1. 首先设置 Scenario 属性。此属性会针对某些Parameter优化导出效果,例如质量、文件大小和/或导出速度。选择此属性的值后,PDFExportParams 对象及其子对象的属性将被设置为适合所选任务的值。
属性设置可能会因输入数据而有所不同。
  1. 之后,您可以进一步自定义其他Parameter,使其尽可能符合您的任务需求。有关详细信息,请参阅 调整导出Parameter
PDFExportParams 对象的属性优先于其子对象的属性。这意味着,如果您更改 PDFExportParams 对象中某个属性的值,其子对象中的属性值可能会被自动改写。相反,如果您更改某个子对象中某个属性的值,PDFExportParams 对象的属性值则不会发生变化。
PDFExportParams 对象是一个持久对象。这意味着,可以将该对象的当前状态写入持久性存储。之后,可以通过从持久性存储中读取对象状态来重新创建该对象。以下方法可用于实现对象持久化: Linux:SaveToFileLoadFromFile Windows SaveToFileLoadFromFileSaveToMemoryLoadFromMemory

属性

,只读

返回 Engine 对象。

指定导出为 PDF (PDF/A) 格式的方案,该方案可针对以下参数进行优化:质量、文件大小和/或导出速度。

如果更改此属性的值,PDFExportFeatures 子对象的FontEmbeddingMode,TextAndBackgroundColorMode,WriteXmpMetadata,WriteTaggedPDF属性以及 PDFPictureCompressionParams 子对象的ColorPictureFormats,GrayPictureFormats,BwPictureFormats属性将被重置为默认值。

默认值为 PES_Balanced。

请注意,根据所选方案,某些内部导出设置可能会随之改变,进而影响以下 PDFExportParams 属性的值:

指定导出格式:PDF、PDF/A-1a、PDF/A-1b、PDF/A-2a、PDF/A-2b、PDF/A-2u、PDF/A-3a、PDF/A-3b 或 PDF/A-3u。

此属性的值会影响导出时可用的设置。如果此属性的值不为 PCM_None (即执行导出为 PDF/A 格式) :

  • 属性 (PDFEncryptionInfo 子对象) 不能设置为 TRUE
  • PDFExportFeatures 子对象的属性只能设置为 PVN_Auto 或 PVN_Version14 (适用于 PDF/A-1a、PDF/A-1b)
  • 如果格式为 PDF/A-1a、PDF/A-2a 或 PDF/A-3a,则PDFExportFeatures 子对象的属性不能设置为 TSPV_No (文件始终带有标签)
  • PDFExportFeatures 子对象的属性不能设置为 TSPV_No
  • PDFExportFeatures 子对象的属性不能设置为 FEM_DontEmbed
  • PDFPictureCompressionParams 子对象的属性不能设置为 CPF_J2K (仅适用于 PDF/A-1a、PDF/A-1b) 或 CPF_LZW
  • PDFPictureCompressionParams 子对象的属性不能设置为 GPF_J2K (仅适用于 PDF/A-1a、PDF/A-1b) 或 GPF_LZW
  • PDFExportFeatures 子对象的属性不能对 PDF/A-1a、PDF/A-1b、PDF/A-2a、PDF/A-2b、PDF/A-2u 设置为 TRUE。

如果不满足上述要求,将返回错误。

默认情况下,该值为 PCM_None,表示执行导出为 PDF 的操作。

指定将识别文本导出为 PDF (PDF/A) 格式的模式。可选模式包括:仅文本和图片、文本叠加于页面图像之上、文本置于页面图像之下、仅页面图像、仅文本。

如果此属性设置为 PEM_TextOnly,则PDFPictureCompressionParams子对象的 BwPictureFormats、ColorPictureFormats 和 GrayPictureFormats 属性值将被忽略。

此属性的默认值为 PEM_ImageOnText。

指定输出 PDF (PDF/A) 文件时的使用模式。

导出为黑白 PDF 时,此属性的值将被忽略。

此属性的默认值为 MRC_Auto。

,read-only

指定其他导出参数:加密信息、PDF 版本等。

用于保留输出 PDF (PDF/A) 文件的颜色,或将其保存为灰度或黑白格式。对于彩色文档,若无需保留颜色且希望减小输出文件大小,可将此属性设置为 PCM_ForceToGray。

如果 CorrectColorDepth 属性设置为 TRUE,ABBYY FineReader Engine 还可以对文档的色深进行额外校正。例如,若将 Colority 设置为 PCM_ForceToGray 且 CorrectColorDepth 为 TRUE,FineReader Engine 将把彩色图像转换为灰度图像,然后检测灰度图像的色深,并在必要时将部分图像转换为黑白格式。

此属性的默认值为 PCM_KeepColority。

将此属性设置为 TRUE 可使 ABBYY FineReader Engine 自动校正文档的色深。若将该属性设置为 FALSE,ABBYY FineReader Engine 将按照 Colority 属性中定义的颜色保存文档。

默认情况下,此属性的值为 TRUE。

返回附加到输出 PDF 文件的用户自定义图像集合。若要向此集合添加图像,请使用方法 (属于对象) ,并通过对象的方法设置图像在页面上的位置。

,只读

指定将图像写入 PDF (PDF/A) 文件时所用的参数,包括 MRC 参数。通过这些参数,您可以覆盖所选导出方案中定义的参数。

指定图片分辨率 (单位:dpi) 。 ResolutionType 属性指定如何解释此属性的值。

指定的分辨率不能高于原始分辨率。

此属性的默认值为 300 dpi。

定义如何使用 Resolution 属性中指定的图片分辨率值。该值可用作:

  • 绝对分辨率 (适用于所有图片) ,
  • 期望分辨率 (仅当原始分辨率高于期望分辨率时有效,程序将自动选择最接近期望分辨率的最优 dpi 值) ,
  • 或忽略该值 (直接使用原始分辨率) 。

默认情况下,此属性的值为 PRT_Desired。

方法

名称描述
CopyFrom用另一个对象中对应属性的值初始化当前对象的相应属性。
LoadFromFile从磁盘文件中恢复对象内容。
LoadFromMemory <Note> : 仅限 Windows。 </Note>从全局内存中恢复对象内容。
SaveToFile将对象内容保存到磁盘文件中。
SaveToMemory <Note> : 仅限 Windows。 </Note>将对象内容保存到全局内存中。
PDFExportParams 对象图

输出 Parameter

此对象是Engine对象的 CreatePDFExportParams 方法的输出 Parameter。

输入Parameter

此对象作为输入Parameter传递给以下方法:

示例

FREngine.IEngine engine;
FREngine.IFRDocument frDocument;
// 假定该文档已经完成识别和合成
// 调整导出参数
FREngine.IPDFExportParams pdfParams = Engine.CreatePDFExportParams();
pdfParams.Scenario = FREngine.PDFExportScenarioEnum.PES_Balanced;
// 使用指定参数保存结果
frDocument.Export( "D:\\Demo.pdf", FREngine.FileExportFormatEnum.FEF_PDF, pdfParams );
该对象用于以下代码示例:

另请参阅

调整导出参数 使用配置文件 使用属性 符合 ZUGFeRD 标准的电子发票