如何將 PDF 文件轉換為圖像文件
要在 Node.js 中將 PDF 檔案轉換為影像,請使用 IronPDF 的 rasterizeToImageFiles 方法。 此方法支援將 PDF 轉換為 JPG、PNG、GIF 及其他格式,並可選擇轉換所有頁面或特定頁面。 函式庫能有效率地處理轉換過程,維持高影像品質,同時提供輸出格式選擇的彈性。
快速入門:將 PDF 轉換為影像。
1.安裝 IronPdf:npm安裝 @ironsoftware/ironpdf 2.匯入 PdfDocument 類別 3.使用 PdfDocument.fromFile() 載入您的 PDF 檔案 4.使用您的輸出路徑呼叫 rasterizeToImageFiles() 5.該方法可從檔案副檔名自動偵測格式
:title=Quick PDF to PNG Conversion
import { PdfDocument } from "@ironsoftware/ironpdf";
PdfDocument.fromFile("./sample.pdf").then((pdf) => {
pdf.rasterizeToImageFiles("./output.png");
});_若要將 PDF 檔案轉換為影像,請使用 IronPDF 的 Node.js 模組所提供的 rasterizeToImageFiles 方法。 配置此方法可將 PDF 轉換為 JPG、PNG 及其他影像格式。 轉換每個頁面或選擇特定頁面。 IronPDF 可讓您完全控制轉換過程。
如何安裝 IronPDF for PDF to Image Conversion? ```shell npm install @ironsoftware/ironpdf ``` 從 NPM 安裝 IronPDF 的 Node.js 模組,將 PDF 轉換為 PNG、JPG、GIF 及其他圖片類型。 在將 PDF 轉換為影像之前,[如果在生產中使用 IronPDF,請先設定您的授權金鑰](https://ironpdf.com/nodejs/get-started/license-keys/)。 該函式庫需要在您的系統上安裝 [IronPdfEngine](https://ironpdf.com/nodejs/get-started/use-ironpdfengine/),以處理 PDF 的渲染作業。如何將 PDF 轉換成圖片? 我們將使用包含占位符文字的 [ 單頁 PDF 文件範例](https://www.learningcontainer.com/wp-content/uploads/2019/09/sample-pdf-file.pdf)。 對於較複雜的情況,可考慮[先將 HTML 轉換為 PDF](https://ironpdf.com/nodejs/tutorials/html-to-pdf/),再將結果轉換為影像。 。 **一張圖片展示了我們的範例 PDF 檔案在 PDF 檢視器應用程式中開啟的情況。 從[Learning Container](https://www.learningcontainer.com/)下載此 PDF 檔案及其他檔案以進行測試。** 以下原始程式碼將 PDF 檔案轉換為 PNG 檔案。 ```nodejs 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; }).catch((error) => { console.error("Error converting PDF to image:", error); }); ``` 我們使用 `PdfDocument.fromFile` 來載入我們的範例文件。 這個函式會返回一個 `PdfDocument` 類,代表我們的範例檔案。由於該物件包含在 [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises) 中,因此我們附加一個回呼函式,以便在 promise 解析時執行。 在回呼內部,我們會在解析的物件上呼叫 `rasterizeToImageFiles` 以將單頁文件轉換為影像。 我們指定目標路徑(包括檔案名稱和檔案副檔名)作為參數。 該方法支援各種格式,類似於 IronPDF 處理 PDF 中 [ 圖片嵌入的方式](https://ironpdf.com/nodejs/examples/embed-image-base64/)。 。 **該圖像由上述原始碼產生。 IronPDF 只用三行程式碼就將我們的範例 PDF 檔案轉換成了 PNG 檔案!** Learning Container 提供 [ 樣本 PDF 檔案](https://www.learningcontainer.com/sample-pdf-files-for-testing/?expand_article=1)以供測試。 [免費下載本範例中使用的 PDF 範例檔案](https://www.learningcontainer.com/wp-content/uploads/2019/09/sample-pdf-file.pdf)。 在其他不同大小和複雜度的 PDF 上嘗試上述範例。 如需更詳細的圖片轉換範例,請參閱 [全面的 PDF 至圖片指南](https://ironpdf.com/nodejs/examples/rasterize-a-pdf-to-images/)。有哪些進階影像轉換選項?如何將 PDF 轉換為 JPEG 格式? 預設情況下, `rasterizeToImageFiles`會根據目標路徑中指定的檔案類型轉換文件。 此自動格式偵測功能可輕鬆切換影像格式,而無需變更程式碼。 若要將範例 PDF 轉換為 JPG 檔案,請變更目的地路徑中的檔案副檔名: ```nodejs // Convert PDF to JPG (not to PNG) pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg"); ``` 或者,指定 `ImageType` 選項。 `ImageType` 值會覆寫目標路徑中宣告的影像檔案類型。 這將強制 `rasterizeToImageFiles` 在執行轉換時忽略檔案名稱,提供對輸出格式的明確控制。 下一個範例在呼叫 `rasterizeToImageFiles` 時包含了一個 JSON 選項參數,該參數宣告了一個 `ImageType` 。 ```nodejs import { PdfDocument, ImageType } from "@ironsoftware/ironpdf"; // Convert PDF to JPEG Format using ImageType.JPG const options = { type: ImageType.JPG, dpi: 300 // High quality output }; PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => { pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.png", options); return pdf; }); ``` 此程式會建立 JPG 影像。 注意目的地檔案名稱仍使用 PNG 檔案副檔名。 `rasterizeToImageFiles` 會忽略 .PNG 副檔名,而遵循 ImageType.JPG 值。 此方法類似於 IronPDF 處理 [ 其他轉換作業](https://ironpdf.com/nodejs/examples/converting-a-url-to-a-pdf/)的方式,其中明確的類型規範優先。 您可以調整本範例,將 PDF 轉換為其他影像類型,包括 GIF 和 Bitmap 格式。 **提示:**當將檔案名稱變更為特定類型並不可行時,例如使用自動檔案命名系統或在不同的輸出格式中維持一致的命名慣例時,此方法非常有用。如何將多頁 PDF 轉換為圖片? 若要轉換具有多頁的文件,請以相同的方式使用 `rasterizeToImageFiles` 方法。 該方法會以指定類型將每頁建立為獨立的影像,並自動在檔案名稱後追加頁碼。 此功能在建立圖庫或處理 [ 多頁文件](https://ironpdf.com/nodejs/examples/merge-pdfs/)時非常有用。 。 **一份兩頁的PDF文件範例。** 下一段範例程式碼將從上面所示的兩頁 PDF 檔案範例中產生兩個 PNG 檔案。 ```nodejs 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檔案使用`rasterizeToImageFiles`方法的結果。該方法會為原始文件的每一頁建立一個圖像。**如何只轉換特定頁面? 使用具有 `fromPages` 屬性的 JSON 物件,將多頁文件中的特定頁面光柵化。 當您處理只需要某些頁面的大型 PDF 時,這種選擇性轉換非常有用,類似於 [從 PDF 中移除特定頁面](https://ironpdf.com/nodejs/examples/remove-page-from-pdf/)。 以下程式碼範例僅將此 [大型範例檔案](https://www.learningcontainer.com/wp-content/uploads/2019/09/sample-pdf-with-images.pdf)的第一頁、第四頁、第六頁和第九頁轉換為點陣圖。 ```nodejs 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 (0-indexed) dpi: 150 // Balance quality and file size }; PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => { pdf.rasterizeToImageFiles("./images/multipage-selective-pdf/multipage-pdf-page.bmp", options); }).catch((error) => { console.error("Failed to convert pages:", error); }); ```  **IronPDF 僅對我們在`options`參數中指定的頁面執行了 PDF 轉圖像操作。** 選擇性的頁面轉換功能適用於所有支援的影像格式,並維持您指定的品質設定。 如需更複雜的頁面操作,請參閱 [ 全面的 API 參考資料](https://ironpdf.com/nodejs/object-reference/api/),其中詳述了所有可用的選項和方法。開始使用 IronPdf
我在哪裡可以找到更多資源?在哪裡可以找到 API 文件? 請閱讀 [ `PdfDocument` class](https://ironpdf.com/nodejs/object-reference/api/) 及其 `rasterizeToImageFiles` 方法的 API 文件,以獲得更多關於如何調整該方法以滿足您需求的啟示。 說明文件提供所有可用參數和選項的詳細資訊。還有哪些其他的程式碼範例? - [**使用 IronPDF 將 PDF 轉換為影像**](https://ironpdf.com/nodejs/examples/rasterize-a-pdf-to-images/):請參閱 `rasterizeToImageFiles` 以稍微不同的方式使用,並提供額外的組態選項。 - [**Convert Images to PDF Files using IronPDF**](https://ironpdf.com/nodejs/examples/image-to-pdf/):瞭解如何將一個或多個影像轉換為單一 PDF 檔案,基本上是反向操作。 - [**Multi-Frame TIFF to PDF Conversion**](https://ironpdf.com/nodejs/examples/multi-frame-tiff-to-pdf/):探索在轉換為 PDF 時如何處理多頁影像格式,這與多頁 PDF 轉換為影像有類似的概念。
有哪些進階影像轉換選項?如何將 PDF 轉換為 JPEG 格式? 預設情況下, `rasterizeToImageFiles`會根據目標路徑中指定的檔案類型轉換文件。 此自動格式偵測功能可輕鬆切換影像格式,而無需變更程式碼。 若要將範例 PDF 轉換為 JPG 檔案,請變更目的地路徑中的檔案副檔名: ```nodejs // Convert PDF to JPG (not to PNG) pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg"); ``` 或者,指定 `ImageType` 選項。 `ImageType` 值會覆寫目標路徑中宣告的影像檔案類型。 這將強制 `rasterizeToImageFiles` 在執行轉換時忽略檔案名稱,提供對輸出格式的明確控制。 下一個範例在呼叫 `rasterizeToImageFiles` 時包含了一個 JSON 選項參數,該參數宣告了一個 `ImageType` 。 ```nodejs import { PdfDocument, ImageType } from "@ironsoftware/ironpdf"; // Convert PDF to JPEG Format using ImageType.JPG const options = { type: ImageType.JPG, dpi: 300 // High quality output }; PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => { pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.png", options); return pdf; }); ``` 此程式會建立 JPG 影像。 注意目的地檔案名稱仍使用 PNG 檔案副檔名。 `rasterizeToImageFiles` 會忽略 .PNG 副檔名,而遵循 ImageType.JPG 值。 此方法類似於 IronPDF 處理 [ 其他轉換作業](https://ironpdf.com/nodejs/examples/converting-a-url-to-a-pdf/)的方式,其中明確的類型規範優先。 您可以調整本範例,將 PDF 轉換為其他影像類型,包括 GIF 和 Bitmap 格式。 **提示:**當將檔案名稱變更為特定類型並不可行時,例如使用自動檔案命名系統或在不同的輸出格式中維持一致的命名慣例時,此方法非常有用。如何將多頁 PDF 轉換為圖片? 若要轉換具有多頁的文件,請以相同的方式使用 `rasterizeToImageFiles` 方法。 該方法會以指定類型將每頁建立為獨立的影像,並自動在檔案名稱後追加頁碼。 此功能在建立圖庫或處理 [ 多頁文件](https://ironpdf.com/nodejs/examples/merge-pdfs/)時非常有用。 。 **一份兩頁的PDF文件範例。** 下一段範例程式碼將從上面所示的兩頁 PDF 檔案範例中產生兩個 PNG 檔案。 ```nodejs 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檔案使用`rasterizeToImageFiles`方法的結果。該方法會為原始文件的每一頁建立一個圖像。**如何只轉換特定頁面? 使用具有 `fromPages` 屬性的 JSON 物件,將多頁文件中的特定頁面光柵化。 當您處理只需要某些頁面的大型 PDF 時,這種選擇性轉換非常有用,類似於 [從 PDF 中移除特定頁面](https://ironpdf.com/nodejs/examples/remove-page-from-pdf/)。 以下程式碼範例僅將此 [大型範例檔案](https://www.learningcontainer.com/wp-content/uploads/2019/09/sample-pdf-with-images.pdf)的第一頁、第四頁、第六頁和第九頁轉換為點陣圖。 ```nodejs 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 (0-indexed) dpi: 150 // Balance quality and file size }; PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => { pdf.rasterizeToImageFiles("./images/multipage-selective-pdf/multipage-pdf-page.bmp", options); }).catch((error) => { console.error("Failed to convert pages:", error); }); ```  **IronPDF 僅對我們在`options`參數中指定的頁面執行了 PDF 轉圖像操作。** 選擇性的頁面轉換功能適用於所有支援的影像格式,並維持您指定的品質設定。 如需更複雜的頁面操作,請參閱 [ 全面的 API 參考資料](https://ironpdf.com/nodejs/object-reference/api/),其中詳述了所有可用的選項和方法。開始使用 IronPdf
我在哪裡可以找到更多資源?在哪裡可以找到 API 文件? 請閱讀 [ `PdfDocument` class](https://ironpdf.com/nodejs/object-reference/api/) 及其 `rasterizeToImageFiles` 方法的 API 文件,以獲得更多關於如何調整該方法以滿足您需求的啟示。 說明文件提供所有可用參數和選項的詳細資訊。還有哪些其他的程式碼範例? - [**使用 IronPDF 將 PDF 轉換為影像**](https://ironpdf.com/nodejs/examples/rasterize-a-pdf-to-images/):請參閱 `rasterizeToImageFiles` 以稍微不同的方式使用,並提供額外的組態選項。 - [**Convert Images to PDF Files using IronPDF**](https://ironpdf.com/nodejs/examples/image-to-pdf/):瞭解如何將一個或多個影像轉換為單一 PDF 檔案,基本上是反向操作。 - [**Multi-Frame TIFF to PDF Conversion**](https://ironpdf.com/nodejs/examples/multi-frame-tiff-to-pdf/):探索在轉換為 PDF 時如何處理多頁影像格式,這與多頁 PDF 轉換為影像有類似的概念。
如何將多頁 PDF 轉換為圖片? 若要轉換具有多頁的文件,請以相同的方式使用 `rasterizeToImageFiles` 方法。 該方法會以指定類型將每頁建立為獨立的影像,並自動在檔案名稱後追加頁碼。 此功能在建立圖庫或處理 [ 多頁文件](https://ironpdf.com/nodejs/examples/merge-pdfs/)時非常有用。 。 **一份兩頁的PDF文件範例。** 下一段範例程式碼將從上面所示的兩頁 PDF 檔案範例中產生兩個 PNG 檔案。 ```nodejs 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檔案使用`rasterizeToImageFiles`方法的結果。該方法會為原始文件的每一頁建立一個圖像。**如何只轉換特定頁面? 使用具有 `fromPages` 屬性的 JSON 物件,將多頁文件中的特定頁面光柵化。 當您處理只需要某些頁面的大型 PDF 時,這種選擇性轉換非常有用,類似於 [從 PDF 中移除特定頁面](https://ironpdf.com/nodejs/examples/remove-page-from-pdf/)。 以下程式碼範例僅將此 [大型範例檔案](https://www.learningcontainer.com/wp-content/uploads/2019/09/sample-pdf-with-images.pdf)的第一頁、第四頁、第六頁和第九頁轉換為點陣圖。 ```nodejs 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 (0-indexed) dpi: 150 // Balance quality and file size }; PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => { pdf.rasterizeToImageFiles("./images/multipage-selective-pdf/multipage-pdf-page.bmp", options); }).catch((error) => { console.error("Failed to convert pages:", error); }); ```  **IronPDF 僅對我們在`options`參數中指定的頁面執行了 PDF 轉圖像操作。** 選擇性的頁面轉換功能適用於所有支援的影像格式,並維持您指定的品質設定。 如需更複雜的頁面操作,請參閱 [ 全面的 API 參考資料](https://ironpdf.com/nodejs/object-reference/api/),其中詳述了所有可用的選項和方法。開始使用 IronPdf
我在哪裡可以找到更多資源?在哪裡可以找到 API 文件? 請閱讀 [ `PdfDocument` class](https://ironpdf.com/nodejs/object-reference/api/) 及其 `rasterizeToImageFiles` 方法的 API 文件,以獲得更多關於如何調整該方法以滿足您需求的啟示。 說明文件提供所有可用參數和選項的詳細資訊。還有哪些其他的程式碼範例? - [**使用 IronPDF 將 PDF 轉換為影像**](https://ironpdf.com/nodejs/examples/rasterize-a-pdf-to-images/):請參閱 `rasterizeToImageFiles` 以稍微不同的方式使用,並提供額外的組態選項。 - [**Convert Images to PDF Files using IronPDF**](https://ironpdf.com/nodejs/examples/image-to-pdf/):瞭解如何將一個或多個影像轉換為單一 PDF 檔案,基本上是反向操作。 - [**Multi-Frame TIFF to PDF Conversion**](https://ironpdf.com/nodejs/examples/multi-frame-tiff-to-pdf/):探索在轉換為 PDF 時如何處理多頁影像格式,這與多頁 PDF 轉換為影像有類似的概念。
開始使用 IronPdf
我在哪裡可以找到更多資源?在哪裡可以找到 API 文件? 請閱讀 [ `PdfDocument` class](https://ironpdf.com/nodejs/object-reference/api/) 及其 `rasterizeToImageFiles` 方法的 API 文件,以獲得更多關於如何調整該方法以滿足您需求的啟示。 說明文件提供所有可用參數和選項的詳細資訊。還有哪些其他的程式碼範例? - [**使用 IronPDF 將 PDF 轉換為影像**](https://ironpdf.com/nodejs/examples/rasterize-a-pdf-to-images/):請參閱 `rasterizeToImageFiles` 以稍微不同的方式使用,並提供額外的組態選項。 - [**Convert Images to PDF Files using IronPDF**](https://ironpdf.com/nodejs/examples/image-to-pdf/):瞭解如何將一個或多個影像轉換為單一 PDF 檔案,基本上是反向操作。 - [**Multi-Frame TIFF to PDF Conversion**](https://ironpdf.com/nodejs/examples/multi-frame-tiff-to-pdf/):探索在轉換為 PDF 時如何處理多頁影像格式,這與多頁 PDF 轉換為影像有類似的概念。
還有哪些其他的程式碼範例? - [**使用 IronPDF 將 PDF 轉換為影像**](https://ironpdf.com/nodejs/examples/rasterize-a-pdf-to-images/):請參閱 `rasterizeToImageFiles` 以稍微不同的方式使用,並提供額外的組態選項。 - [**Convert Images to PDF Files using IronPDF**](https://ironpdf.com/nodejs/examples/image-to-pdf/):瞭解如何將一個或多個影像轉換為單一 PDF 檔案,基本上是反向操作。 - [**Multi-Frame TIFF to PDF Conversion**](https://ironpdf.com/nodejs/examples/multi-frame-tiff-to-pdf/):探索在轉換為 PDF 時如何處理多頁影像格式,這與多頁 PDF 轉換為影像有類似的概念。
常見問題解答
如何在 Node.js 中將 PDF 轉換為影像?
使用 IronPDF 的 `rasterizeToImageFiles` 方法在 Node.js 中將 PDF 檔案轉換為影像。首先使用 `npm install @ironsoftware/ironpdf` 安裝 IronPDF,然後使用 `PdfDocument.fromFile()` 載入您的 PDF,並使用您所需的輸出路徑呼叫 `rasterizeToImageFiles()` 。此方法會自動從檔案副檔名偵測影像格式。
轉換 PDF 時支援哪些影像格式?
IronPDF 支援將 PDF 轉換為多種圖像格式,包括 JPG、PNG、GIF 和其他常見格式。`rasterizeToImageFiles` 方法會根據您在輸出路徑中指定的檔案副檔名自動決定輸出格式。
我可以將 PDF 的特定頁面轉換成影像嗎?
是的,IronPDF 允許您在使用 `rasterizeToImageFiles` 方法時轉換所有頁面或選擇特定頁面。這樣您就可以完全控制 PDF 文件中哪些頁面轉換為圖像文件。
PDF 至影像轉換的安裝需求為何?
若要將 PDF 轉換為影像,您需要使用 `npm install @ironsoftware/ironpdf` 安裝 IronPDF。這個函式庫也需要在您的系統上安裝 IronPDF Engine,它會處理 PDF 的渲染作業。若要投入生產使用,您需要配置您的授權金鑰。
轉換是否能維持高影像品質?
是的,IronPDF 可以高效地處理轉換過程,同時保持高影像品質。`rasterizeToImageFiles` 方法可確保您的 PDF 內容精確地呈現為影像,而不會有明顯的品質損失。
PDF 至影像的轉換過程是非同步的嗎?
是的,IronPDF 中的轉換操作是使用承諾非同步執行的。您可以使用`.then()`來處理成功的轉換,或使用`.catch()`來處理 PDF 至圖片轉換過程中可能發生的任何錯誤。





