Skip to content
DemoFAQ

PDF 生成模板编辑器

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

查看 GitHub

PDF 转可搜索PDF ​

概述 ​

通过使用 OCR 向基于图像的 PDF(例如扫描的文档)添加文本和图片来制作可搜索的 PDF。

转换选项 ​

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

选项默认值含义
TransparentTexttruePDF 输入:开启时保留原页面并添加不可见的 OCR 文字层;关闭时以可见文字重建页面,重建的页面不保留矢量图形。图片输入:识别出的文字不可见(开启)或可见(关闭)。
EnableOCRfalse在 OcrOption 选定的页面上添加 OCR 文字层。TransparentText 开启而未开启 OCR 时,输出只是选定的源页面。许可证不含 OCR 权限时不生效。
OcrOptionOCROption.e_AllOCR 处理的范围:OCROption.e_All 识别所有页面;OCROption.e_ScanPage 只识别图片(扫描)页面;OCROption.e_InvalidCharacter 重新识别其他页面上无法读取的字符(只在 TransparentText 关闭时可见);OCROption.e_InvalidCharacterAndScanPage 两者都做。只在 EnableOCR 开启时生效。
Languages{ OCRLanguage.e_ENGLISH }OCR 识别语言;第一种语言同时决定文字层的后备字体。未指定语言时使用英文。
EnableDocumentOrientationClassificationfalseOCR 前检测页面旋转方向并将页面图像转正,页面尺寸随之调整。只在 EnableOCR 开启且页面被重建(TransparentText 关闭或图片输入)时生效。
EnableDocumentDewarpfalseOCR 前对弯曲、变形的页面照片做矫正展平。只在 EnableOCR 开启且页面被重建(TransparentText 关闭或图片输入)时生效。
PageRanges空要转换的页码,如 "1-3,5,7-9";为空时转换所有页。多帧图片输入时用于选择帧。
ContainImagetrue只在页面被重建(TransparentText 关闭或图片输入)时生效:在未经 OCR 识别的页面上保留源图片,且是 ContainPageBackgroundImage 的前提。未开启 OCR 的图片输入只有此项开启时才绘制图片本身。
ContainPageBackgroundImagetrue只在页面被重建且 ContainImage 开启时生效。TransparentText 关闭时,在 OCR 页面的可见文字下方绘制擦除文字后的页面图像(关闭此项则只有文字)。图片输入且 TransparentText 开启时,在不可见文字下方保留源图片(关闭此项则只有不可见文字)。
OutputDocumentPerPagefalse每页输出一个文件,而不是整个文档输出一个文件。文件以输入文件名加页码命名,写入输出路径所在的文件夹;输出路径中的文件名不使用。
EnableAutoPageSizefalse仅图片输入:根据图片分辨率确定页面尺寸,并匹配到最接近的标准纸张;关闭时一个像素对应一个点(pt)。
CustomPageWidth / CustomPageHeight0仅图片输入:以点(pt,1 pt = 1/72 英寸)为单位指定页面宽和高,两者都须大于 0。图片等比放入页面,空白处补白。优先于 EnableAutoPageSize。

调用示例:

c#
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 文件。

c#
string inputFilePath = "***";
string password = "***";
string outputFileName = "***";

PdfOptions pdfOptions = new PdfOptions();
pdfOptions.EnableOCR = true;
ErrorCode error = CPDFConversion.StartPDFToSearchablePDF(inputFilePath, password, outputFileName, pdfOptions);