Skip to content
DemoFAQ

PDF 生成模板编辑器

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

查看 GitHub

PDF 转 图片 — C ​

PDF 转 图片 ​

概述 ​

ComPDFKit Conversion SDK 提供了 PDF 转图片的 API。集成 ComPDFKit Conversion SDK 到您的应用程序中,轻松将 PDF 转换成各种图片格式。

转换选项 ​

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

选项默认值含义
image_typee_CJPG输出图片的格式和扩展名。图片输入时,只有 PNG、TIFF、WEBP(以及支持时的 JPEG 2000)保留透明度,只有 PNG、TIFF、JPEG 2000 保留 16 位色深;其他格式合成到白底并转为 8 位。
image_color_modee_CColore_CColor 保留彩色;e_CGray 转为灰度;e_CBinary 转为黑白。
image_scaling4.0fPDF 输入时像素尺寸 = 页面点数 × 缩放比例;图片输入时像素尺寸 = 源图像素 × 缩放比例(大于 1 会放大输入图片)。必须大于 0。长边不超过内部上限。
image_path_enhancefalse加深、加粗矢量线条和笔画。仅 PDF 输入。
page_ranges空要导出的页(或图片帧);为空时导出所有页。只选一页时,若输出路径以该图片格式的扩展名结尾,则直接作为文件名;选多页时,输出路径作为文件夹,在其中写入按序号命名的文件。

调用示例:

c
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 中,支持的图片格式包括:

  • JPG
  • JPEG
  • JPEG2000
  • PNG
  • BMP
  • TIFF
  • TGA
  • GIF
  • WEBP

设置图片色彩模式 ​

在 ComPDFKit Conversion SDK 中,支持的图片色彩模式包括:

  • **Color:**彩色模式,图片效果与原始 PDF 页面效果一致。
  • **Gray:**灰度模式,灰度图效果。
  • **Binary:**黑白模式,在原始效果的基础上进行二值化之后的效果。

设置图片缩放比例 ​

在 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 格式。

c
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 或版面分析,不依赖模型。

  • 多页 TIFF:每个所选帧生成一张图片,page_ranges 用于选择帧;不会合并输出多页 TIFF。
  • 输出格式仍由 image_type 指定,image_scaling 与 image_color_mode 同样生效。
c
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_sizefalse开启后按图片自身分辨率推算页面大小,并匹配最接近的标准纸张;关闭时一个像素对应一个页面点
custom_page_width0指定输出页宽,单位为点(1 点 = 1/72 英寸);0 表示不指定
custom_page_height0指定输出页高,单位为点
  • custom_page_width 和 custom_page_height 同时设置时直接指定页面大小,优先于 enable_auto_page_size;尺寸按给定值使用(含方向),图片等比缩放放入页内,不裁剪。
  • 示例:A4 为 595.28 × 841.89,日本 B5 为 515.91 × 728.50。
c
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 时保留原图 ​

关闭 OCR(默认)并将图片文件转换为可承载图片的格式时,输出完整的源图,不生成识别文字。多页 TIFF 的所选帧按原顺序保留。

转 TXT 与 CSV ​

TXT 和 Excel CSV 无法承载图片。图片文件转换为 TXT 或 Excel CSV 且未开启 OCR 时,接口返回 e_CErrUnsupportedFeature(95),请开启 OCR(enable_ocr = true)。