如何在 Node.js 中將 PDF 轉換為圖像文件

How to Convert a PDF to an Image File

This article was translated from English: Does it need improvement?
Translated
View the article in English

要將PDF文件轉換為圖像,請使用 IronPDF 的 NodeJS 模塊提供的 rasterizeToImageFiles 方法。 你可以配置此方法以支持多種 PDF 到圖像的轉換操作。 將 PDF 轉換為 JPG、PNG 和其他圖像格式。 將每一頁PDF轉換為JPEG或PNG圖像,或者只轉換幾頁。 IronPDF 給予你完全的控制。

繼續閱讀以了解如何使用 IronPDF for Node.js 完成 PDF 到圖像的任務!

使用 NPM 安裝 IronPDF

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

從 NPM 安裝 IronPDF 的 Node.js 模塊以將 PDF 轉換為 PNG、JPG(或 JPEG)、GIF 和其他圖像類型。

將 PDF 轉換為圖像格式

假設我們正在處理一個包含占位符文字的單頁樣本 PDF 文件

如何將 PDF 轉換為圖像文件,圖1 一張圖像顯示我們的樣本 PDF 文件在 PDF 查看器應用程序中打開。 從 Learning Container 下載此 PDF 文件及其他文件以供測試。

下面的源代碼將 PDF 文件轉換為 PNG 文件。

import { PdfDocument } from "@ironsoftware/ironpdf";

// Convert PDF File to a PNG File
// The operation is performed asynchronously with promises
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/sample-pdf-file.png");
    return pdf;
});

我們使用 PdfDocument.fromFile 方法將樣本文件加載到 Node 庫中。 This function gives a PdfDocument class in IronPDF representing our sample file. Since the object we need is contained in a Promise, we attach a callback function to run when the promise resolves the PdfDocument.

在回調中,我們調用 IronPDF 中rasterizeToImageFiles 函數在解析的對像上將單頁文檔轉換為圖像。 如上所示,我們將新圖像的目標路徑(其中包括文件名和文件擴展名)作為參數進行指定。

如何將 PDF 轉換為圖像文件,圖2 這張圖是從上面的源代碼生成的。 IronPDF 僅用三行代碼就將我們的樣本 PDF 轉換為 PNG 文件!

Learning Container 提供樣本 PDF 文件,你可以在你的項目中用於測試。 你可以免費從網站下載此示例中使用的樣本 PDF 文件(以及類似的樣本文件)。隨意在其他不同大小和複雜性的 PDF 上嘗試上述示例。

下一節提供了值得考慮的額外 PDF 到圖像轉換細節。

高級圖像轉換選項

將 PDF 轉換為 JPEG

默認情況下,rasterizeToImageFiles 根據目標路徑中指定的文件類型轉換文檔。

因此,要將以前示例中使用的樣本 PDF 轉換為 JPG 文件(而不是將 PDF 轉換為 PNG),我們可以簡單地更改目標文件路徑中使用的文件名擴展名:

// Convert PDF to JPG (not to PNG)
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");

另一種做到這一點的方法是在 IronPDF 中指定ImageType 選項ImageType 值優先於目標路徑中聲明的圖像文件類型。 這會使 rasterizeToImageFiles 在進行轉換時不考慮文件名。

你可以在下一個示例中看到這個。 在這裡,我們在調用 rasterizeToImageFiles 時包含一個帶有 ImageType 的 JSON 選項參數。

import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert PDF to JPEG Format using ImageType.JPG
const options = {
   type: ImageType.JPG
};
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.png", options);
    return pdf;
});

運行上述程序也會像我們之前的示例一樣創建一個 JPG 圖像。 不過,請注意,目標文件名仍然使用 PNG 文件擴展名。 rasterizeToImageFiles 忽略了路徑中使用的 .PNG 文件名擴展名,而是遵循 ImageType.JPG 類型值。

你可以調整此示例以將 PDF 轉換為其他圖像類型,包括 GIF 格式和位圖格式。

提示:在某些情況下,無法或不希望將文件名更改為特定類型時,使用這種方法尤其有用。

轉換包含多個頁面的 PDF 文件

要將包含多個頁面的文檔轉換為所需的圖像類型(PNG、JPG、位圖等),我們也可以像以前一樣使用 rasterizeToImageFiles 方法。 方法調用時,會為每個頁面在指定類型中創建一個單獨的圖像。

如何將 PDF 轉換為圖像,圖3 一個兩頁的樣本 PDF 文檔。

接下來的樣本代碼塊從上面顯示的兩頁 PDF 文件示例生成兩個 PNG 文件。

import { PdfDocument } from "@ironsoftware/ironpdf";

// Convert PDF with two pages to a set of images.
PdfDocument.fromFile("./multipage-pdf.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-pdf/multipage-pdf-page.png");
});

如何將 PDF 轉換為圖像,圖4 使用 rasterizeToImageFiles 方法在一個兩頁 PDF 文件上運行的結果。該方法為原始文件的每個頁面創建一個圖像。

將特定的 PDF 頁面轉換為圖像

聲明一個有 fromPages 屬性的 JSON 對像使我們能夠從多頁文檔中光柵化一個或多個頁面(而不是所有頁面)。

下面的代碼示例僅將此 大樣本文件的第一、第四、第六和第九頁轉換為位圖。

import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert PDF containing many pages to BMP images.
const options = {
    type: ImageType.BMP,
    fromPages: [0, 3, 5, 8]  // Select only the desired pages
};
PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-selective-pdf/multipage-pdf-page.bmp", options);
});

如何將 PDF 轉換為圖像,圖5 IronPDF 僅在options參數中指定的頁面上執行 PDF 到圖像操作。

開始使用IronPDF

進一步閱讀

API 參考

閱讀 PdfDocument 類的 API 文檔及其 rasterizeToImageFiles 方法,了解更多如何使此方法適應你的需求。

代碼示例

常見問題解答

如何使用 Node.js 將 PDF 轉換為圖像文件?

您可以使用 IronPDF 的 `rasterizeToImageFiles` 方法在 Node.js 中將 PDF 轉換為圖像文件。首先,使用 npm install @ironsoftware/ironpdf 安裝 IronPDF 包。然後,使用 PdfDocument.fromFile 加載您的 PDF 文檔並調用 rasterizeToImageFiles 將其轉換為您想要的圖像格式,如 PNG 或 JPG。

在 Node.js 項目中安裝 IronPDF 的步驟是什麼?

要在 Node.js 項目中安裝 IronPDF,請使用 npm 包管理器,命令為 npm install @ironsoftware/ironpdf。這會將 IronPDF 添加到您項目的依賴項中,允許您使用其 PDF 轉換功能。

我可以將 PDF 文件轉換為多種圖像格式嗎?

是的,使用 IronPDF,您可以將 PDF 文件轉換為多種圖像格式,如 PNG、JPG、GIF 和 Bitmap。您可以在 rasterizeToImageFiles 方法中使用 ImageType 選項指定所需的格式。

是否可以只將某些 PDF 頁面轉換為圖像?

是的,IronPDF 允許您將 PDF 的特定頁面轉換為圖像。您可以使用具有 fromPages 屬性的 JSON 對象指定要轉換的頁面,指示頁面的索引。

如何將多頁 PDF 轉換為單獨的圖像文件?

您可以使用 IronPDF 的 rasterizeToImageFiles 方法將多頁 PDF 轉換為單獨的圖像文件。此方法會為 PDF 的每一頁生成單獨的圖像。

使用 IronPDF 的 'ImageType' 選項有什麼優勢?

IronPDF 中的 'ImageType' 選項允許您直接指定輸出圖像的格式,確保轉換結果為正確的圖像類型,即使路徑中指定的文件擴展名不同。

我可以從哪裡下載樣本 PDF 文件以測試轉換?

您可以從像 Learning Container 和 africau.edu 這樣的網站下載樣本 PDF 文件以測試轉換。這些資源提供各種 PDF 樣本,可用於測試 IronPDF 的功能。

如何確保轉換後的圖像保留原始 PDF 的質量?

要確保轉換後的圖像保留原始 PDF 的質量,請使用 IronPDF 的默認設置或在 rasterizeToImageFiles 方法中調整分辨率設置以滿足您的質量要求。

Darrius Serrant
全棧軟件工程師 (WebOps)

Darrius Serrant 擁有邁阿密大學計算機科學學士學位,目前任職於 Iron Software 的全栈 WebOps 市場營銷工程師。從小就迷上編碼,他認為計算既神秘又可接近,是創意和解決問題的完美媒介。

在 Iron Software,Darrius 喜歡創造新事物,並簡化複雜概念以便於理解。作為我們的駐場開發者之一,他也自願教學生,分享他的專業知識給下一代。

對 Darrius 來說,工作令人滿意因為它被重視且有實際影響。

準備好開始了嗎?
版本: 2025.11 剛剛發布