PDF 生成模板编辑器
开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。
ComPDF Conversion SDK 支持将 PDF 文档转换为 OFD 文档。与可搜索 PDF 类似,OFD 转换也支持 OCR、页面背景保留和透明文本层。
该格式只使用 ConvertOptions 中的以下选项,其他选项不生效:
| 选项 | 默认值 | 含义 |
|---|---|---|
enable_ocr | False | 文字层来自 ocr_option 选定页面上的 OCR 结果;关闭时来自 PDF 自身的文字。未开启 OCR 的图片输入没有文字层。许可证不含 OCR 权限时不生效。 |
ocr_option | OCROption.ALL | OCR 处理的范围:OCROption.ALL 识别所有页面;OCROption.SCAN_PAGE 只识别图片(扫描)页面;OCROption.INVALID_CHARACTER 重新识别其他页面文字层中无法读取的字符;OCROption.INVALID_CHARACTER_AND_SCAN_PAGE 两者都做。只在 enable_ocr 开启时生效。 |
languages | [] | OCR 识别语言;未指定语言时使用英文。只在 enable_ocr 开启时生效。 |
enable_document_orientation_classification | False | OCR 前将页面图像转正,页面尺寸随之调整。只在 enable_ocr 开启时生效。 |
enable_document_dewarp | False | OCR 前对弯曲、变形的页面照片做矫正展平。只在 enable_ocr 开启时生效。 |
page_ranges | 空 | 要转换的页码,如 "1-3,5,7-9";为空时转换所有页。多帧图片输入时用于选择帧。 |
enable_ai_layout | True | 只影响未经 OCR 识别页面上不可见文字的分组以及页眉页脚判断;可见的页面图像不受影响。 |
formula_to_image | True | 开启时,AI 版面分析找到的公式文字会从不可见文字层中移除(无法再复制或搜索);关闭可保留。页面图像不变。只对未经 OCR 识别的页面、且 enable_ai_layout 开启时生效。 |
output_document_per_page | False | 每页输出一个文件,而不是整个文档输出一个文件。文件以输入文件名加页码命名,写入输出路径所在的文件夹;输出路径中的文件名不使用。 |
enable_auto_page_size | False | 仅图片输入:根据图片分辨率确定页面尺寸,并匹配到最接近的标准纸张;关闭时一个像素对应一个点(pt)。 |
custom_page_width / custom_page_height | 0 | 仅图片输入:以点(pt,1 pt = 1/72 英寸)为单位指定页面宽和高,两者都须大于 0。图片等比放入页面,空白处补白。优先于 enable_auto_page_size。 |
调用示例:
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)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)