将 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保持纵横比，不会拉伸图像。

Darrius Serrant

已更新:2026年6月28日

Translated

View the article in English

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

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

1.在您的 Maven 项目中添加 IronPDF 依赖关系： ```xml :title=pom.xml

com.ironsoftware ironpdf 2024.9.1


2.加载您的 PDF 文档：
```java
//: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"));

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项目。

创建新的 Maven 项目

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

新项目名称

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

新项目：默认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>

    <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>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>1.7.36</version>
    </dependency>
</dependencies>

XML

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

已添加Maven依赖项

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

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

Milan Jovanovic

微软MVP

查看案例研究

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

Brent Matzelle

首席技术官，OPYN

查看案例研究

如何使用 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"并相应地更新文件扩展名。

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

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保持纵横比，不会拉伸图像。

Darrius Serrant

立即与工程团队聊天

全栈软件工程师（WebOps）

Darrius Serrant 拥有迈阿密大学的计算机科学学士学位，目前在 Iron Software 担任全栈 WebOps 市场工程师。从小就被编码吸引，他认为计算机既神秘又易于接触，使其成为创意和问题解决的理想媒介。

在 Iron Software，Darrius 喜欢创造新事物，并简化复杂概念以使其更易理解。作为我们常驻的开发者之一，他还自愿教授学生，与下一代分享他的专业知识。

对于 Darrius 来说，他的工作令人满意，因为它被重视并产生真正的影响。

准备开始了吗？

版本: 2026.6 刚刚发布

查看许可证

还在滚动吗？

想快速获得证据？
运行示例看着你的HTML代码变成PDF文件。

查看许可证

客户亮点：

开发者焦点：

网络研讨会：

开始免费 30 天试用

本页内容

将 Java PDF 转换为图像文件

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

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

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

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

如何安装 IronPDF for Java？

Milan Jovanovic

Brent Matzelle

David Jones

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

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

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

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

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

常见问题解答

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

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

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

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

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

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

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

还在滚动吗？

您的许可证密钥已发送到您的收件箱

您的演示请求已提交。

钢铁支援团队

开始免费 30 天试用

本页内容

将 Java PDF 转换为图像文件

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

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

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

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

如何安装 IronPDF for Java？

Milan Jovanovic

Brent Matzelle

David Jones

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

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

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

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

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

常见问题解答

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

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

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

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

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

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

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

还在滚动吗？

免费获取

下一步：开始免费 30 天试用

Thank You

下一步：开始免费 30 天试用

想免费将 IronSuite 部署到实际项目中吗？

包括什么？

您的许可证密钥已发送到您的收件箱

您的演示请求已提交。

深受全球数百万工程师信赖

钢铁支援团队