Python PDF 到图像的转换

为什么开发者将PDF转换为图像？

PDF到图像的转换解决了软件开发中的若干实际问题。 最常见的需求是预览生成——在Web界面或移动应用程序中显示PDF文档的缩略图，而无需用户下载并打开完整文件。

其他常见用例包括：

• 机器学习管道：OCR模型、布局分析工具和计算机视觉系统接受图像输入，而非PDF
• 档案和合规性：在原始PDF旁边存储视觉快照，以确保长时间可读，即使PDF查看器发生变化
• 报告嵌入：将特定PDF页面作为图像包含在其他文档或电子邮件模板中
• 自动化测试：通过比较渲染页面快照，检测PDF输出的视觉回归

Python的标准库不包括原生的PDF到图像功能。 像pdf2image这样的工具需要安装Poppler作为外部二进制文件，这增加了部署的复杂性。 IronPDF内部处理渲染，因此将PDF到图像转换添加到任何Python项目中只需要一个pip install。

如何将PDF文件转换为图像？

要将PDF转换为图像，在RasterizeToImageFiles。 该方法将每页生成一个图像文件写入指定目录。 输出路径中的星号（assets/images/2.png依此类推。

在调用该方法之前创建输出目录。 如果不存在，IronPDF不会自动创建。

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-pdf-to-image-2.py

from ironpdf import PdfDocument

# Load a PDF from disk
pdf = PdfDocument.FromFile("my-content.pdf")

# Write each page to a PNG file in the "assets/images" folder
# The folder must exist before calling this method
pdf.RasterizeToImageFiles("assets/images/*.png", DPI=96)

DPI参数控制图像分辨率。 更高的DPI产生更清晰的图像，但代价是文件大小更大和处理时间更长。标准值包括：

每个PDF页面生成一个PNG文件的输出目录

如果输出图像显得模糊，请增加DPI值。 在一个50页的文档上处理300 DPI明显比96 DPI要耗时更久——请根据用例的实际质量需求做出选择。

如何将特定页面范围转换为图像？

为了只转换一部分页面，将页面索引作为第二个参数传递给RasterizeToImageFiles。 页面索引是从0开始的整数。

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-pdf-to-image-3.py

from ironpdf import PdfDocument

pdf = PdfDocument.FromFile("my-content.pdf")

# Convert only pages 1, 2, and 3 (zero-based indices: 0, 1, 2)
pdf.RasterizeToImageFiles("assets/images/*.png", [0, 1, 2], DPI=96)

PYTHON

选择性页面提取对仅需预览前几页的文档很有用，避免不必要地处理整个文件。对于提取PDF中已嵌入的图像的工作流，IronPDF提供了单独的提取方法。

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能，比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic

微软MVP

查看案例研究

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本，同时提高生产力，并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle

首席技术官，OPYN

查看案例研究

Iron Suite 在我们的运营中起着至关重要的作用。这些工具提高了业务各方面的效率，包括创建平面图和改善库存管理。

David Jones

首席软件工程师，Agorus Build

查看案例研究

如何将URL转换为图像？

IronPDF可以将网页渲染为PDF，然后在单一工作流中将该PDF转换为图像。 使用RasterizeToImageFiles。 这种方法可以创建网页或生成基于Web内容的预览图像的视觉档案，而无需单独的截屏工具。

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-pdf-to-image-4.py

from ironpdf import ChromePdfRenderer

# Render a web page to PDF
renderer = ChromePdfRenderer()
pdf = renderer.RenderUrlAsPdf("https://www.example.com")

# Convert each rendered page to a PNG image
pdf.RasterizeToImageFiles("assets/images/*.png", DPI=96)

渲染的图像反映了页面在Chromium浏览器中的显示效果，包括CSS样式和JavaScript渲染的内容。 对于需要身份验证或交互的页面，考虑使用IronPDF的HTML到PDF教程来直接提供预渲染标记。 然后可使用上面显示的相同方法栅格化生成的PDF。

从通过IronPDF渲染的URL生成的图像

如何控制输出图像尺寸？

默认情况下，RasterizeToImageFiles生成的图像按DPI因子缩放为本机页面尺寸。 要限制输出大小，设置单位为像素的ImageMaxHeight。

IronPDF根据ImageMaxHeight值保留原始的纵横比。 即使指定的宽度和高度与源页面的比例不同，输出也不会被拉伸或变形。

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-pdf-to-image-5.py

from ironpdf import PdfDocument

pdf = PdfDocument.FromFile("my-content.pdf")

# Generate thumbnail images constrained to 500x500 pixels
pdf.RasterizeToImageFiles(
    "assets/images/*.png",
    ImageMaxWidth=500,
    ImageMaxHeight=500,
    DPI=200
)

将ImageMaxWidth=500, ImageMaxHeight=500设置为200 DPI会生成适合缩略图显示或基于卡片的用户界面布局的图像。 调整这些值以匹配应用程序设计所需的尺寸。 为了生成即将被栅格化的PDF内容，IronPDF还支持从Python创建PDF和合并多个PDF后再进行转换。

PDF到图像转换的下一步是什么？

本指南涵盖了三个核心工作流：将PDF文件转换为图像，将URL转换为图像，控制图像尺寸和质量。 IronPDF支持JPEG、JPG、PNG、TIFF和通过相同RasterizeToImageFiles方法的附加格式。 更改输出路径模式中的文件扩展名以切换格式。

欲实现进一步自动化，请考虑这些后续步骤：

• 批处理：循环遍历PDF目录并依次转换每一个，或使用Python的concurrent.futures模块进行并行处理
• 选择性提取：使用页面索引参数仅提取相关页面
• 图像管道集成：将输出文件输入PIL/Pillow或OpenCV进行进一步处理，如裁剪、注释或格式标准化
• 转换前压缩：使用IronPDF的PDF压缩在栅格化大文档之前减小文件大小
• 表单工作流：编程填写PDF表单，然后将填好的表单页面转换为图像以供审核或存档

要继续使用IronPDF构建，请探索IronPDF for Python文档和栅格化PDF至图像示例。

开始免费使用IronPDF for Python的30天试用以在生产中使用这些功能。 准备部署时，查看许可选项以获取适合项目规模的方案。