Skip to content
DemoFAQ

PDF 生成模板编辑器

开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。

查看 GitHub

PDF 转 OFD ​

概述 ​

ComPDF Conversion SDK 支持将 PDF 文档转换为 OFD 文档。与可搜索 PDF 类似,OFD 转换也支持 OCR、页面背景保留和透明文本层。

转换选项 ​

该格式只使用 ConvertOptions 中的以下选项,其他选项不生效:

选项默认值含义
enable_ocrFalse文字层来自 ocr_option 选定页面上的 OCR 结果;关闭时来自 PDF 自身的文字。未开启 OCR 的图片输入没有文字层。许可证不含 OCR 权限时不生效。
ocr_optionOCROption.ALLOCR 处理的范围:OCROption.ALL 识别所有页面;OCROption.SCAN_PAGE 只识别图片(扫描)页面;OCROption.INVALID_CHARACTER 重新识别其他页面文字层中无法读取的字符;OCROption.INVALID_CHARACTER_AND_SCAN_PAGE 两者都做。只在 enable_ocr 开启时生效。
languages[]OCR 识别语言;未指定语言时使用英文。只在 enable_ocr 开启时生效。
enable_document_orientation_classificationFalseOCR 前将页面图像转正,页面尺寸随之调整。只在 enable_ocr 开启时生效。
enable_document_dewarpFalseOCR 前对弯曲、变形的页面照片做矫正展平。只在 enable_ocr 开启时生效。
page_ranges空要转换的页码,如 "1-3,5,7-9";为空时转换所有页。多帧图片输入时用于选择帧。
enable_ai_layoutTrue只影响未经 OCR 识别页面上不可见文字的分组以及页眉页脚判断;可见的页面图像不受影响。
formula_to_imageTrue开启时,AI 版面分析找到的公式文字会从不可见文字层中移除(无法再复制或搜索);关闭可保留。页面图像不变。只对未经 OCR 识别的页面、且 enable_ai_layout 开启时生效。
output_document_per_pageFalse每页输出一个文件,而不是整个文档输出一个文件。文件以输入文件名加页码命名,写入输出路径所在的文件夹;输出路径中的文件名不使用。
enable_auto_page_sizeFalse仅图片输入:根据图片分辨率确定页面尺寸,并匹配到最接近的标准纸张;关闭时一个像素对应一个点(pt)。
custom_page_width / custom_page_height0仅图片输入:以点(pt,1 pt = 1/72 英寸)为单位指定页面宽和高,两者都须大于 0。图片等比放入页面,空白处补白。优先于 enable_auto_page_size。

调用示例:

python
options = ConvertOptions()
options.enable_ocr = True
options.enable_document_orientation_classification = True
options.output_document_per_page = True
error = CPDFConversion.start_pdf_to_ofd("input.pdf", "password", "path/output.ofd", options)

示例 ​

python
LibraryManager.set_document_ai_model("path/documentai.model")

options = ConvertOptions()
options.enable_ocr = True
options.languages = [OCRLanguage.ENGLISH]
options.contain_page_background_image = True
options.transparent_text = True

CPDFConversion.start_pdf_to_ofd("scan.pdf", "", "output.ofd", options)