将 Java PDF 转换为图像文件

Q: 如何在 Java 中将 PDF 文件转换为 PNG 图像？

使用 PdfDocument.fromFile() 加载PDF，调用 toBufferedImages() 获取 BufferedImage 对象列表以代表每个页面，然后使用 ImageIO.write() 将每个图像保存为PNG文件。

Q: 在将PDF页面转换时支持哪些图像格式？

IronPDF的 toBufferedImages 方法返回 BufferedImage 对象。您可以保存这些对象为Java的 ImageIO 类支持的任何格式，包括PNG、JPEG和TIFF。

Q: 是否可以将PDF中仅特定的页面转换为图像？

可以。将 PageSelection 参数传递给 toBufferedImages 。使用 PageSelection.singlePage(0) 转换一个页面，或使用 PageSelection.pageRange(1, 4) 转换一个范围。页面索引是从零开始的。

Q: 如何将 IronPDF 添加到我的 Maven 项目中？

在您的pom.xml的 <dependencies> 块中添加以下依赖项： <dependency><groupId>com.ironsoftware</groupId><artifactId>ironpdf</artifactId><version>2024.9.1</version></dependency>

Q: 我可以将URL直接转换为图像文件吗？

可以。调用 PdfDocument.renderUrlAsPdf(url) 使用内置的Chromium引擎渲染页面，然后将生成的 PdfDocument 传递给 toBufferedImages 来获取页面图像列表。

Q: 如何控制输出图像分辨率？

创建一个 ToImageOptions 实例，调用 setImageMaxHeight() 和 setImageMaxWidth() 设置最大尺寸，然后将其作为第一个参数传递给 toBufferedImages 。IronPDF保持纵横比，不会拉伸图像。

Curtis Chau

Updated: 2026年6月29日

在Java中使用IronPDF的toBufferedImages方法将PDF文档转换为图像格式，如JPEG、PNG或TIFF。加载PDF文件，调用ImageIO将每个图像写入磁盘。整个转换过程的Java代码不到十行。

快速入门：在 Java 中将 PDF 转换为图像

1.在您的 Maven 项目中添加 IronPDF 依赖关系：

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2024.9.1</version>
</dependency>

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2024.9.1</version>
</dependency>

Text

2.加载您的 PDF 文档：

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/load-pdf.java
PdfDocument pdf = PdfDocument.fromFile(Paths.get("document.pdf"));

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/load-pdf.java
PdfDocument pdf = PdfDocument.fromFile(Paths.get("document.pdf"));

Java

3.转换为图像并保存：

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-and-save.java
List<BufferedImage> images = pdf.toBufferedImages();
for (int i = 0; i < images.size(); i++) {
    ImageIO.write(images.get(i), "PNG", new File("page_" + i + ".png"));
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-and-save.java
List<BufferedImage> images = pdf.toBufferedImages();
for (int i = 0; i < images.size(); i++) {
    ImageIO.write(images.get(i), "PNG", new File("page_" + i + ".png"));
}

Java

如何在 Java 中将 PDF 转换为图像

安装IronPDF Java库
使用PdfDocument.fromFile()加载PDF文件
调用toBufferedImages()以获取List<BufferedImage>
若有需要，使用ToImageOptions设置输出尺寸
使用ImageIO.write()将每个图像写入磁盘

什么是 PDF 到图像的转换，为什么需要转换？

PDF到图像转换将PDF文档的每一页转换为独立的图像文件（JPEG、PNG或TIFF），可以显示、嵌入或在没有PDF查看器的情况下进行处理。 Java的标准库没有提供内置的机制，这使得需要文档预览、缩略图生成器或存档管道的开发人员感到不断的痛点。

常见用途包括为文档管理系统生成缩略图预览、为Web应用程序产生页面级截图，以及为报告或演示提取视觉内容。 IronPDF内部处理所有渲染的复杂性，因此应用程序代码保持简短，并且输出与源PDF中的字体、矢量图形或表单字段无关，像素准确。要了解将图像放入PDF的逆操作，请参见图像到PDF指南。

什么是 IronPDF for Java，它能提供哪些帮助？

IronPDF for Java是一个用于在基于Maven的项目中创建、读取和编辑PDF文件的库。开发人员使用它从HTML生成PDF、修改现有文档和在服务器上未安装Adobe Acrobat或任何PDF查看器的情况下提取内容。

该库支持自定义标题和页脚、数字签名、表单创建、密码保护和多线程渲染。其PDF到图像功能通过PageSelection以控制分辨率和页面范围。有关完整的功能概述，请访问IronPDF for Java 文档。完整的API参考，请参阅Java API参考。

除了基本的转换，IronPDF还支持HTML到PDF的渲染、自定义水印、背景和前景以及表单创建。它还在Sonatype Maven中央仓库上发布Maven工件，因此依赖管理遵循标准的Maven或Gradle工作流程。

开始之前我需要哪些先决条件？

在开始之前，请确认已准备好以下内容：

Java已安装，并在环境变量中设置了路径。请参阅官方Java 安装指南。
已安装Java IDE； Eclipse或IntelliJ都很好用。下载Eclipse或IntelliJ IDEA。
IDE中集成了Maven。请参阅此Maven设置教程。
许可证密钥已配置，在生产环境中部署之前。

如何安装 IronPDF for Java？

一旦所有先决条件就绪，安装就是一个单一的Maven依赖声明。有关详细的设置步骤，请查阅入门文档。

打开JetBrains IntelliJ IDEA并创建一个新的Maven项目。

IntelliJ IDEA 新建项目对话框，已选择 Maven 并为 IronPDF 安装配置了 Java 16 SDK

创建新的 Maven 项目

出现新窗口。输入项目名称并单击完成。

IntelliJ IDEA 新建项目对话框，显示项目名称输入字段和作为项目位置的 Desktop 文件夹

新项目名称

点击完成后，新项目默认显示pom.xml。将以下依赖项添加到该文件。可选的SLF4J条目在开发过程中抑制日志噪声；如果您的项目已经包含日志框架，请将其删除。

IntelliJ IDEA 显示带有 Java 10 编译器设置的空 Maven pom.xml，可添加 IronPDF 依赖项

新项目：默认pom.xml

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/pom-dependencies.xml
<dependencies>
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>2024.9.1</version>
    </dependency>
    <!-- Optional: SLF4J logging - remove if your project already uses a logging framework -->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>1.7.36</version>
    </dependency>
</dependencies>

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/pom-dependencies.xml
<dependencies>
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>2024.9.1</version>
    </dependency>
    <!-- Optional: SLF4J logging - remove if your project already uses a logging framework -->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>1.7.36</version>
    </dependency>
</dependencies>

XML

将依赖项添加到pom.xml后，Maven同步图标会出现在编辑器的右上角。

IntelliJ IDEA 中的 Maven pom.xml 文件，突出显示 IronPDF 和 SLF4J 依赖块，并可见 Maven 同步图标

已添加Maven依赖项

点击同步图标以下载IronPDF JAR。下载时间取决于连接速度，通常在两分钟内。安装后，查看Java API参考以查看所有可用方法和配置选项。对于云部署目标，IronPDF提供经过测试的指南，适用于AWS、Azure和Google Cloud。

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

在List<BufferedImage>，其中每个元素对应一个从小到大的PDF页码。然后可以将结果写入磁盘，传递给图像处理管道，或直接返回给Web响应。

IronPDF还能即时将URLs和HTML字符串转换为PDF，因此可以在没有单独渲染步骤的情况下，通过单一管道捕获任何网页或渲染的HTML文档为图像。

如何将现有 PDF 文档转换为图像？

PageSelection参数用于指定特定页面。当没有传递参数时，所有页面都会以其自然分辨率转换。

以下示例将PDF的所有页面转换为PNG文件，使用ToImageOptions将每个输出图像限制为800x500像素：

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-pdf-to-images.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.List;

public class Main {
    public static void main(String[] args) throws IOException {
        // Load the PDF document from disk
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("business_plan.pdf"));

        // Configure output image dimensions
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert all pages to BufferedImage objects with the configured dimensions
        List<BufferedImage> pages = pdf.toBufferedImages(options, PageSelection.allPages());

        // Write each page image to the assets/images folder (create the folder first)
        int pageIndex = 1;
        for (BufferedImage page : pages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(page, "PNG", new File(fileName));
        }
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-pdf-to-images.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.List;

public class Main {
    public static void main(String[] args) throws IOException {
        // Load the PDF document from disk
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("business_plan.pdf"));

        // Configure output image dimensions
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert all pages to BufferedImage objects with the configured dimensions
        List<BufferedImage> pages = pdf.toBufferedImages(options, PageSelection.allPages());

        // Write each page image to the assets/images folder (create the folder first)
        int pageIndex = 1;
        for (BufferedImage page : pages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(page, "PNG", new File(fileName));
        }
    }
}

Java

输出图像保存到1开始编号。在运行程序前创建该文件夹，因为ImageIO.write不会创建缺失的目录。 setImageMaxWidth调用设置了每个维度的上限； IronPDF保留原始的纵横比，并不会拉伸图像。

如果要以JPEG格式保存而非PNG格式，请将"JPEG"并相应地更新文件扩展名。

Windows 文件资源管理器显示 PDF 转图像后 assets/images 文件夹中的 11 个编号 PNG 图像文件

PDF到图像输出 - 11个PNG文件，每页一个

欲获得更多的转换示例，请访问PDF栅格化示例页面。

如何使用IronPDF将URL转换为图像？

PdfDocument。这使得可以直接捕获任何公开可访问的网页为一系列图像。

下面的示例将一个亚马逊产品页面渲染为PDF，然后将每个生成的页面保存为PNG文件：

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-url-to-images.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.List;

public class Main {
    public static void main(String[] args) throws IOException {
        // Render a URL to a PDF document using the Chromium rendering engine
        PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://www.amazon.com");

        // Configure output image dimensions
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert all pages and write to disk
        List<BufferedImage> pages = pdf.toBufferedImages(options, PageSelection.allPages());
        int pageIndex = 1;
        for (BufferedImage page : pages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(page, "PNG", new File(fileName));
        }
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-url-to-images.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.List;

public class Main {
    public static void main(String[] args) throws IOException {
        // Render a URL to a PDF document using the Chromium rendering engine
        PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://www.amazon.com");

        // Configure output image dimensions
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert all pages and write to disk
        List<BufferedImage> pages = pdf.toBufferedImages(options, PageSelection.allPages());
        int pageIndex = 1;
        for (BufferedImage page : pages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(page, "PNG", new File(fileName));
        }
    }
}

Java

Windows 文件资源管理器显示使用 IronPDF 将 URL 转换为图像后 assets/images 文件夹中的 5 个编号 PNG 文件

URL到图像输出 - 5个PNG文件

对于渲染前需认证或会话Cookie的页面，请参阅网站登录指南。

请注意: 为renderUrlAsPdf提供支持的Chromium渲染引擎应用与现代桌面浏览器相同的CSS和JavaScript支持。依赖于客户端JavaScript加载内容的页面将正确呈现，包括单页应用程序。

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

PageSelection提供几种工厂方法来针对一部分页面而不是整个文档。这在只需提取封面、总结部分或已知页面范围时非常有用。

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/page-selection.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.List;

public class PageSelectionExample {
    public static void main(String[] args) throws IOException {
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("report.pdf"));
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert only the first page (page index is zero-based)
        List<BufferedImage> coverPage = pdf.toBufferedImages(options, PageSelection.singlePage(0));
        ImageIO.write(coverPage.get(0), "PNG", new File("cover.png"));

        // Convert pages 2 through 5 (zero-based indices 1 through 4)
        List<BufferedImage> excerpt = pdf.toBufferedImages(options, PageSelection.pageRange(1, 4));
        for (int i = 0; i < excerpt.size(); i++) {
            ImageIO.write(excerpt.get(i), "PNG", new File("excerpt_" + (i + 1) + ".png"));
        }
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/page-selection.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.List;

public class PageSelectionExample {
    public static void main(String[] args) throws IOException {
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("report.pdf"));
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert only the first page (page index is zero-based)
        List<BufferedImage> coverPage = pdf.toBufferedImages(options, PageSelection.singlePage(0));
        ImageIO.write(coverPage.get(0), "PNG", new File("cover.png"));

        // Convert pages 2 through 5 (zero-based indices 1 through 4)
        List<BufferedImage> excerpt = pdf.toBufferedImages(options, PageSelection.pageRange(1, 4));
        for (int i = 0; i < excerpt.size(); i++) {
            ImageIO.write(excerpt.get(i), "PNG", new File("excerpt_" + (i + 1) + ".png"));
        }
    }
}

Java

PageSelection.singlePage(0)仅针对第一页，这对于生成封面缩略图非常有用。 PageSelection.pageRange(1, 4)使用基于零的索引提取第二到第五页。两者都返回List<BufferedImage>，因此无论选择多少页，循环模式都是相同的。

重要: 1，以此类推。传递超出范围的索引会在运行时抛出IndexOutOfBoundsException。

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

本指南涵盖了三种常见模式：转换现有PDF的所有页面，将URL捕获为一组页面图像，以及提取目标页面范围。 IronPDF通过ImageIO处理分辨率控制和格式选择，使调用代码简短且可预测。

要继续使用IronPDF for Java进行构建，请探索以下相关资源：

Java栅格化示例 - 额外的PDF到图像代码示例
从PDF中提取图像和文本 - 从现有PDF文件中提取嵌入的图像
在Java中压缩PDF - 减小存储或传输前的文件大小
自定义水印 - 在保存前为输出图像或PDF添加水印
IronPDF for Java文档 - 完整的API参考和设置指南

IronPDF for Java免费用于开发。商业部署需要许可证。开始您的免费试用或查看许可证选项以查看哪个计划适合您的项目。

准备看看IronPDF还能做些什么吗？查看完整的IronPDF for Java教程页面。

常见问题解答

如何在 Java 中将 PDF 文件转换为 PNG 图像？

使用PdfDocument.fromFile()加载PDF，调用toBufferedImages()获取BufferedImage对象列表以代表每个页面，然后使用ImageIO.write()将每个图像保存为PNG文件。

在将PDF页面转换时支持哪些图像格式？

IronPDF的toBufferedImages方法返回BufferedImage对象。您可以保存这些对象为Java的ImageIO类支持的任何格式，包括PNG、JPEG和TIFF。

是否可以将PDF中仅特定的页面转换为图像？

可以。将PageSelection参数传递给toBufferedImages。使用PageSelection.singlePage(0)转换一个页面，或使用PageSelection.pageRange(1, 4)转换一个范围。页面索引是从零开始的。

在Java中，PDF转图像转换的常见用例是什么？

常见用例包括为文档管理系统生成缩略图预览，为Web应用程序生成页面级截图，提取用于演示的视觉内容，以及将不支持PDF渲染的系统中的文档归档为图像文件。

如何将 IronPDF 添加到我的 Maven 项目中？

在您的pom.xml的<dependencies>块中添加以下依赖项：<dependency><groupId>com.ironsoftware</groupId><artifactId>ironpdf</artifactId><version>2024.9.1</version></dependency>

我可以将URL直接转换为图像文件吗？

可以。调用PdfDocument.renderUrlAsPdf(url)使用内置的Chromium引擎渲染页面，然后将生成的PdfDocument传递给toBufferedImages来获取页面图像列表。

如何控制输出图像分辨率？

创建一个ToImageOptions实例，调用setImageMaxHeight()和setImageMaxWidth()设置最大尺寸，然后将其作为第一个参数传递给toBufferedImages。IronPDF保持纵横比，不会拉伸图像。

What are the output image formats that IronPDF supports?

IronPDF supports converting PDFs to various image formats, including JPEG, PNG, and TIFF.

How does IronPDF handle conversion of multi-page PDFs?

IronPDF converts each page of a multi-page PDF into a standalone image, maintaining the order and allowing for individual processing or storage.

What Java prerequisites are needed for using IronPDF?

Before using IronPDF, ensure that Java is installed, along with a Java IDE like Eclipse or IntelliJ, and that Maven is set up and integrated with the IDE.