Skip to content
DemoFAQ

PDF 生成模板编辑器

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

查看 GitHub

PDF 转 图片 ​

概述 ​

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

转换选项 ​

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

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

调用示例:

c#
ImageOptions imageOptions = new ImageOptions();
imageOptions.ImageType = ImageType.PNG;
imageOptions.ImageColorMode = ImageColorMode.Gray;
imageOptions.ImageScaling = 2.0f;
imageOptions.PageRanges = "1-3";
ErrorCode error = CPDFConversion.StartPDFToImage("input.pdf", "password", "path/output", imageOptions);

设置图片格式 ​

在 ComPDF Conversion SDK 中,支持的图片格式包括:

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

设置图片色彩模式 ​

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

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

设置图片缩放比例 ​

在 ComPDF Conversion SDK 中,支持设置图片缩放比例,默认图片缩放比例为1.0,即保持原始 PDF 页面尺寸。如果您希望将图像放大一倍则可以将 ImageScaling 设置为2.0,同理如果您希望将图像缩小一倍可以将 ImageScaling 设置为0.5。

设置图片路径增强显示 ​

在 ComPDF Conversion SDK 中,支持设置图片路径增强显示image_path_enhance,这在您想增强 PDF 页面内的路径的显示效果时可以开启该选项。

  • 不启用PathEnhance选项(原始PDF渲染效果): image-20250603162605558
  • 启用PathEnhance选项: image-20250603162651769

图片输入 ​

PDF 转图片接口同时接受 PDF 和 SDK 已支持的图片文件作为输入,可用于图片格式互转。

  • 图片互转不执行 OCR 或版面分析,不依赖 AI 模型。
  • 输出格式由 ImageType 指定,ImageScaling 和 ImageColorMode 控制缩放和色彩模式。
  • 多页 TIFF:每个所选帧生成一张图片,通过 PageRanges 选择帧;不会合并输出为多页 TIFF。
c#
ImageOptions imageOptions = new ImageOptions();
imageOptions.ImageType = ImageType.PNG;
imageOptions.PageRanges = "1-2";   // 多页 TIFF 中要转换的帧
ErrorCode error = CPDFConversion.StartPDFToImage("input.tiff", "", outputFileName, imageOptions);

注意事项 ​

  • 图片 ImageScaling 缩放比例设置越大,生成的图片分辨率越大,但是运行时占用的内存也越大,且速度越慢。
  • 并非设置的 ImageScaling 越高图片的清晰度就越高,清晰度还依靠原文档的图片分辨率。

示例 ​

以下是完整的示例代码,演示了如何将 PDF 文档转换为 PNG 格式。

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

ImageOptions imageOptions = new ImageOptions();
ErrorCode error = CPDFConversion.StartPDFToImage(inputFilePath, password, outputFileName, imageOptions);