PDF 生成模板编辑器
开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。
ComPDF Conversion SDK 提供了 PDF 转图片的 API。集成 ComPDF Conversion SDK 到您的应用程序中,轻松将 PDF 转换成各种图片格式。
该格式只使用 ImageOptions 中的以下选项,其他选项不生效:
| 选项 | 默认值 | 含义 |
|---|---|---|
ImageType | ImageType.JPG | 输出图片的格式和扩展名。图片输入时,只有 PNG、TIFF、WEBP(以及支持时的 JPEG 2000)保留透明度,只有 PNG、TIFF、JPEG 2000 保留 16 位色深;其他格式合成到白底并转为 8 位。 |
ImageColorMode | ImageColorMode.Color | ImageColorMode.Color 保留彩色;ImageColorMode.Gray 转为灰度;ImageColorMode.Binary 转为黑白。 |
ImageScaling | 4.0f | PDF 输入时像素尺寸 = 页面点数 × 缩放比例;图片输入时像素尺寸 = 源图像素 × 缩放比例(大于 1 会放大输入图片)。必须大于 0。长边不超过内部上限。 |
PathEnhance | false | 加深、加粗矢量线条和笔画。仅 PDF 输入。 |
PageRanges | 空 | 要导出的页(或图片帧);为空时导出所有页。只选一页时,若输出路径以该图片格式的扩展名结尾,则直接作为文件名;选多页时,输出路径作为文件夹,在其中写入按序号命名的文件。 |
调用示例:
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 中,支持的图片格式包括:
在 ComPDF Conversion SDK 中,支持的图片色彩模式包括:
在 ComPDF Conversion SDK 中,支持设置图片缩放比例,默认图片缩放比例为1.0,即保持原始 PDF 页面尺寸。如果您希望将图像放大一倍则可以将 ImageScaling 设置为2.0,同理如果您希望将图像缩小一倍可以将 ImageScaling 设置为0.5。
在 ComPDF Conversion SDK 中,支持设置图片路径增强显示image_path_enhance,这在您想增强 PDF 页面内的路径的显示效果时可以开启该选项。
PathEnhance选项(原始PDF渲染效果): 
PathEnhance选项: 
PDF 转图片接口同时接受 PDF 和 SDK 已支持的图片文件作为输入,可用于图片格式互转。
ImageType 指定,ImageScaling 和 ImageColorMode 控制缩放和色彩模式。PageRanges 选择帧;不会合并输出为多页 TIFF。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 格式。
string inputFilePath = "***";
string password = "***";
string outputFileName = "***";
ImageOptions imageOptions = new ImageOptions();
ErrorCode error = CPDFConversion.StartPDFToImage(inputFilePath, password, outputFileName, imageOptions);