PDF 生成模板编辑器
开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。
通过使用 OCR 向基于图像的 PDF(例如扫描的文档)添加文本和图片来制作可搜索的 PDF。
该格式只使用 SearchablePdfOptions 中的以下选项,其他选项不生效:
| 选项 | 默认值 | 含义 |
|---|---|---|
TransparentText | true | PDF 输入:开启时保留原页面并添加不可见的 OCR 文字层;关闭时以可见文字重建页面,重建的页面不保留矢量图形。图片输入:识别出的文字不可见(开启)或可见(关闭)。 |
EnableOCR | false | 在 OcrOption 选定的页面上添加 OCR 文字层。TransparentText 开启而未开启 OCR 时,输出只是选定的源页面。许可证不含 OCR 权限时不生效。 |
OcrOption | OCROption.e_All | OCR 处理的范围:OCROption.e_All 识别所有页面;OCROption.e_ScanPage 只识别图片(扫描)页面;OCROption.e_InvalidCharacter 重新识别其他页面上无法读取的字符(只在 TransparentText 关闭时可见);OCROption.e_InvalidCharacterAndScanPage 两者都做。只在 EnableOCR 开启时生效。 |
Languages | { OCRLanguage.e_ENGLISH } | OCR 识别语言;第一种语言同时决定文字层的后备字体。未指定语言时使用英文。 |
EnableDocumentOrientationClassification | false | OCR 前检测页面旋转方向并将页面图像转正,页面尺寸随之调整。只在 EnableOCR 开启且页面被重建(TransparentText 关闭或图片输入)时生效。 |
EnableDocumentDewarp | false | OCR 前对弯曲、变形的页面照片做矫正展平。只在 EnableOCR 开启且页面被重建(TransparentText 关闭或图片输入)时生效。 |
PageRanges | 空 | 要转换的页码,如 "1-3,5,7-9";为空时转换所有页。多帧图片输入时用于选择帧。 |
ContainImage | true | 只在页面被重建(TransparentText 关闭或图片输入)时生效:在未经 OCR 识别的页面上保留源图片,且是 ContainPageBackgroundImage 的前提。未开启 OCR 的图片输入只有此项开启时才绘制图片本身。 |
ContainPageBackgroundImage | true | 只在页面被重建且 ContainImage 开启时生效。TransparentText 关闭时,在 OCR 页面的可见文字下方绘制擦除文字后的页面图像(关闭此项则只有文字)。图片输入且 TransparentText 开启时,在不可见文字下方保留源图片(关闭此项则只有不可见文字)。 |
OutputDocumentPerPage | false | 每页输出一个文件,而不是整个文档输出一个文件。文件以输入文件名加页码命名,写入输出路径所在的文件夹;输出路径中的文件名不使用。 |
EnableAutoPageSize | false | 仅图片输入:根据图片分辨率确定页面尺寸,并匹配到最接近的标准纸张;关闭时一个像素对应一个点(pt)。 |
CustomPageWidth / CustomPageHeight | 0 | 仅图片输入:以点(pt,1 pt = 1/72 英寸)为单位指定页面宽和高,两者都须大于 0。图片等比放入页面,空白处补白。优先于 EnableAutoPageSize。 |
调用示例:
SearchablePdfOptions pdfOptions = new SearchablePdfOptions();
pdfOptions.EnableOCR = true;
pdfOptions.OcrOption = OCROption.e_ScanPage;
pdfOptions.Languages = new List<OCRLanguage> { OCRLanguage.e_ENGLISH };
pdfOptions.TransparentText = true;
ErrorCode error = CPDFConversion.StartPDFToSearchablePDF("input.pdf", "password", "path/output.pdf", pdfOptions);以下是完整的示例代码,演示了如何将 PDF 文档转换为可编辑 PDF 文件。
string inputFilePath = "***";
string password = "***";
string outputFileName = "***";
PdfOptions pdfOptions = new PdfOptions();
pdfOptions.EnableOCR = true;
ErrorCode error = CPDFConversion.StartPDFToSearchablePDF(inputFilePath, password, outputFileName, pdfOptions);