如何將 PDF 文件轉換為圖像文件
若要在Node.js中將 PDF 檔案轉換為映像,請使用 IronPDF 的 rasterizeToImageFiles 方法。 此方法支援將 PDF 檔案轉換為 JPG、PNG、GIF 等格式,並可選擇轉換所有頁面或特定頁面。 該庫能夠有效率地處理轉換過程,在保持高影像品質的同時,還能靈活選擇輸出格式。
快速入門:將 PDF 轉換為圖片
- 安裝IronPDF:
npm install @ironsoftware/ironpdf - 導入
PdfDocument類 - 使用
PdfDocument.fromFile()載入您的 PDF 文件 - 使用你的輸出路徑呼叫
rasterizeToImageFiles() - 此方法可自動從檔案副檔名偵測檔案格式。
:title=Quick PDF to PNG Conversion
import { PdfDocument } from "@ironsoftware/ironpdf";
PdfDocument.fromFile("./sample.pdf").then((pdf) => {
pdf.rasterizeToImageFiles("./output.png");
});若要將 PDF 檔案轉換為影像,請使用IronPDF for Node.js模組提供的 rasterizeToImageFiles 方法。 設定此方法可將 PDF 檔案轉換為 JPG、PNG 和其他影像格式。 轉換所有頁面或選擇特定頁面。 IronPDF讓您完全掌控轉換過程。
如何安裝IronPDF來進行 PDF 轉圖像轉換?
npm install @ironsoftware/ironpdfnpm install @ironsoftware/ironpdf從 NPM 安裝 IronPDF for Node.js模組,即可將 PDF 檔案轉換為 PNG、JPG、GIF 和其他圖像類型。
如果在生產環境中使用IronPDF ,請在將 PDF 轉換為圖像之前配置您的許可證密鑰。 該庫需要在您的系統上安裝IronPDF引擎,該引擎負責處理 PDF 渲染操作。
如何將PDF檔案轉換為圖片?
我們將使用一份包含佔位符文字的單頁 PDF 文件作為範例。 對於更複雜的情況,可以考慮先將 HTML 轉換為 PDF ,然後再將結果轉換為圖片。
一張圖片展示了我們的範例 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;
}).catch((error) => {
console.error("Error converting PDF to image:", error);
});我們使用 PdfDocument.fromFile 來載入我們的範例文件。 此函數傳回一個代表我們範例文件的類別。由於該物件包含在一個Promise中,因此我們為其附加一個回調函數,以便在 Promise 解析時運行。
在回調函數中,我們對已解析的物件呼叫 rasterizeToImageFiles,將單頁文件轉換為映像。 我們將目標路徑(包括檔案名稱和檔案副檔名)指定為參數。 此方法支援多種格式,類似於IronPDF處理PDF 中影像嵌入的方式。
該圖像由上述原始碼產生。 IronPDF只用三行程式碼就將我們的範例 PDF 檔案轉換成了 PNG 檔案!
Learning Container 提供用於測試的範例 PDF 檔案。 免費下載本範例中使用的PDF範本文件。 請嘗試將上述範例套用至其他不同大小和複雜程度的 PDF 檔案。 有關更詳細的圖像轉換範例,請查看全面的 PDF 轉圖像指南。
有哪些進階影像轉換選項?
如何將PDF格式轉換為JPEG格式?
預設情況下,rasterizeToImageFiles 會根據目標路徑中指定的檔案類型轉換文件。 這種自動格式偵測功能無需更改程式碼即可輕鬆切換影像格式。
若要將範例 PDF 檔案轉換為 JPG 文件,請變更目標路徑中的檔案副檔名:
// Convert PDF to JPG (not to PNG)
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");或者,指定 ImageType 選項。 ImageType 值會覆寫目標路徑中聲明的影像檔案類型。 這強制 rasterizeToImageFiles 在執行轉換時忽略檔名,從而對輸出格式進行明確控制。
下一個範例包含一個 JSON 選項參數,用於呼叫 rasterizeToImageFiles,該參數聲明了 ImageType。
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處理其他轉換操作的方式類似,其中明確類型規範優先。
您可以參考這個例子,將 PDF 檔案轉換為其他影像類型,包括 GIF 和點陣圖格式。
提示:當無法將檔案名稱變更為特定類型時,例如在使用自動檔案命名系統或在不同的輸出格式中保持一致的命名約定時,這種方法非常有用。
如何將多頁PDF檔案轉換為影像?
若要轉換多頁文檔,請以相同方式使用 rasterizeToImageFiles 方法。 此方法將每一頁建立為指定類型的單獨影像,並自動將頁碼附加到檔案名稱。 在建立圖片庫或處理多頁文件時,此功能非常有用。
一份兩頁的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");
});
使用 rasterizeToImageFiles 方法處理一個兩頁的 PDF 檔案後,會產生一個影像。該方法會為原始文件的每一頁建立一個圖像。
如何只轉換特定頁面?
使用帶有 fromPages 屬性的 JSON 物件來柵格化多頁文件中的特定頁面。 這種選擇性轉換在處理大型 PDF 檔案時非常有用,因為你只需要某些頁面,類似於從 PDF 檔案中刪除特定頁面的方式。
以下程式碼範例僅將此 大型範例檔案的第一頁、第四頁、第六頁和第九頁轉換為點陣圖。
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 參考文檔,其中詳細介紹了所有可用的選項和方法。
哪裡可以找到更多資源?
在哪裡可以找到API文件?
請閱讀PdfDocument 類別及其 rasterizeToImageFiles 方法的 API 文檔,以了解更多關於如何調整方法以滿足您的需求的資訊。 文件提供了所有可用參數和選項的詳細資訊。
還有哪些程式碼範例可供參考?
-使用IronPDF將 PDF 轉換為圖像:請參閱 rasterizeToImageFiles,它以略微不同的方式使用,並具有額外的配置選項。 -使用IronPDF將影像轉換為 PDF 文件:學習如何將一個或多個影像轉換為單一 PDF 文件,本質上是相反的操作。 -多幀 TIFF 到 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 至圖片轉換過程中可能發生的任何錯誤。





