PDF 生成模板编辑器
开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。
ComPDFKit Conversion SDK 提供了 PDF 转图片的 API。集成 ComPDFKit Conversion SDK 到您的应用程序中,轻松将 PDF 转换成各种图片格式。
该格式只使用 CConvertOption 中的以下选项,其他选项不生效:
| 选项 | 默认值 | 含义 |
|---|---|---|
image_type | e_CJPG | 输出图片的格式和扩展名。图片输入时,只有 PNG、TIFF、WEBP(以及支持时的 JPEG 2000)保留透明度,只有 PNG、TIFF、JPEG 2000 保留 16 位色深;其他格式合成到白底并转为 8 位。 |
image_color_mode | e_CColor | e_CColor 保留彩色;e_CGray 转为灰度;e_CBinary 转为黑白。 |
image_scaling | 4.0f | PDF 输入时像素尺寸 = 页面点数 × 缩放比例;图片输入时像素尺寸 = 源图像素 × 缩放比例(大于 1 会放大输入图片)。必须大于 0。长边不超过内部上限。 |
image_path_enhance | false | 加深、加粗矢量线条和笔画。仅 PDF 输入。 |
page_ranges | 空 | 要导出的页(或图片帧);为空时导出所有页。只选一页时,若输出路径以该图片格式的扩展名结尾,则直接作为文件名;选多页时,输出路径作为文件夹,在其中写入按序号命名的文件。 |
调用示例:
CConvertOption option = CPDF_DefaultConvertOption();
option.image_type = e_CPNG;
option.image_color_mode = e_CGray;
option.image_scaling = 2.0f;
strcpy(option.page_ranges, "1-3");
CPDF_StartPDFToImage(CPDF_TEXT("input.pdf"), CPDF_TEXT("password"), CPDF_TEXT("path/output"), option, NULL);在 ComPDFKit Conversion SDK 中,支持的图片格式包括:
在 ComPDFKit Conversion SDK 中,支持的图片色彩模式包括:
在 ComPDFKit Conversion SDK 中,支持设置图片缩放比例,默认图片缩放比例为 4.0;设置为 1.0 时保持原始 PDF 页面尺寸。如果您希望将图像放大一倍则可以将 image_scaling 设置为2.0,同理如果您希望将图像缩小一倍可以将 image_scaling 设置为0.5。
在 ComPDFKit Conversion SDK 中,支持设置图片路径增强显示image_path_enhance,这在您想增强 PDF 页面内的路径的显示效果时可以开启该选项。
image_scaling 缩放比例设置越大,生成的图片分辨率越大,但是运行时占用的内存也越大,且速度越慢。image_scaling 越高图片的清晰度就越高,清晰度还依靠原文档的图片分辨率。以下是完整的示例代码,演示了如何将 PDF 文档转换为 PNG 格式。
CConvertOption option = CPDF_DefaultConvertOption();
// PDF 转 Image(JPEG)。
option.image_type = e_CJPEG;
CPDF_StartPDFToImage(CPDF_TEXT("jpeg.pdf"), CPDF_TEXT("password"), CPDF_TEXT("path/output"), option, NULL);
// PDF 转 Image(PNG)并设置缩放比例将原始 PDF 大小放大两倍。
option.image_type = e_CPNG;
option.image_scaling = 2.0f;
CPDF_StartPDFToImage(CPDF_TEXT("png.pdf"), CPDF_TEXT("password"), CPDF_TEXT("path/output"), option, NULL);转图片接口 CPDF_StartPDFToImage 同时接受 PDF 和 SDK 已支持的图片文件作为输入,因此也可以用于图片格式互转。图片互转不执行 OCR 或版面分析,不依赖模型。
page_ranges 用于选择帧;不会合并输出多页 TIFF。image_type 指定,image_scaling 与 image_color_mode 同样生效。CConvertOption option = CPDF_CONVERT_OPTION_DEFAULT;
option.image_type = e_CPNG;
strcpy(option.page_ranges, "1-2");
CPDF_StartPDFToImage(CPDF_TEXT("multi_page.tiff"), CPDF_TEXT(""), CPDF_TEXT("path/output"), option, NULL);将图片文件转换为文档格式时(例如以图片文件作为输入调用 CPDF_StartPDFToWord),可以通过以下选项控制输出的页面尺寸。这些选项仅在输入为图片文件时生效。
| 选项 | 默认 | 含义 |
|---|---|---|
enable_auto_page_size | false | 开启后按图片自身分辨率推算页面大小,并匹配最接近的标准纸张;关闭时一个像素对应一个页面点 |
custom_page_width | 0 | 指定输出页宽,单位为点(1 点 = 1/72 英寸);0 表示不指定 |
custom_page_height | 0 | 指定输出页高,单位为点 |
custom_page_width 和 custom_page_height 同时设置时直接指定页面大小,优先于 enable_auto_page_size;尺寸按给定值使用(含方向),图片等比缩放放入页内,不裁剪。CConvertOption option = CPDF_CONVERT_OPTION_DEFAULT;
// 按图片分辨率自动匹配最接近的标准纸张。
option.enable_auto_page_size = true;
CPDF_StartPDFToWord(CPDF_TEXT("input.png"), CPDF_TEXT(""), CPDF_TEXT("path/auto.docx"), option, NULL);
// 显式指定 A4,优先于 enable_auto_page_size。
option.custom_page_width = 595.28f;
option.custom_page_height = 841.89f;
CPDF_StartPDFToWord(CPDF_TEXT("input.png"), CPDF_TEXT(""), CPDF_TEXT("path/a4.docx"), option, NULL);关闭 OCR(默认)并将图片文件转换为可承载图片的格式时,输出完整的源图,不生成识别文字。多页 TIFF 的所选帧按原顺序保留。
TXT 和 Excel CSV 无法承载图片。图片文件转换为 TXT 或 Excel CSV 且未开启 OCR 时,接口返回 e_CErrUnsupportedFeature(95),请开启 OCR(enable_ocr = true)。