Python PDF 轉圖像轉換

開發者為何要將 PDF 轉換為圖片？

PDF 轉圖像的功能可解決軟體開發中的若干實際問題。 最常見的需求是預覽生成——在網頁介面或行動應用程式中顯示 PDF 文件的縮圖，而無需強制使用者下載並開啟完整檔案。

其他常見應用情境包括：

• 機器學習管道：OCR 模型、版面配置分析工具及電腦視覺系統接受圖像輸入，而非 PDF 檔案
• 歸檔與合規性：在原始 PDF 旁儲存視覺快照，可確保即使 PDF 檢視器變更，文件仍能長期保持可讀性
• 報告嵌入：將特定 PDF 頁面作為圖片嵌入其他文件或電子郵件範本中
• 自動化測試：透過比對渲染後的頁面快照，以偵測 PDF 輸出中的視覺退化

Python 的標準函式庫中並未內建 PDF 轉圖像的功能。 像 pdf2image 這樣的工具需要安裝 Poppler 作為外部二進位檔，這增加了部署的複雜性。 IronPDF 會在內部處理渲染，因此要在任何 Python 專案中加入 PDF 轉圖像功能，只需添加單一 pip install 即可。

如何將 PDF 檔案轉換為圖片？

若要將 PDF 轉換為圖片，請在 PdfDocument 實例上呼叫 RasterizeToImageFiles。 此方法會將每頁內容寫入一個影像檔案，並儲存至指定目錄中。 輸出路徑中的星號 (*) 將被 1 起始的頁碼所取代，因此 assets/images/*.png 會產生 assets/images/2.png，以此類推。

在呼叫該方法之前，請先建立輸出目錄。 若該檔案不存在，IronPDF 將不會自動建立。

#:path=/static-assets/pdf/content-code-examples/how-to/python-pdf-to-image/convert-pdf-to-images.py
from ironpdf import PdfDocument

# Load a PDF from disk
pdf = PdfDocument.FromFile("my-content.pdf")

# Write each page to a PNG file in the "assets/images" folder
# The folder must exist before calling this method
pdf.RasterizeToImageFiles("assets/images/*.png", DPI=96)

#:path=/static-assets/pdf/content-code-examples/how-to/python-pdf-to-image/convert-pdf-to-images.py
from ironpdf import PdfDocument

# Load a PDF from disk
pdf = PdfDocument.FromFile("my-content.pdf")

# Write each page to a PNG file in the "assets/images" folder
# The folder must exist before calling this method
pdf.RasterizeToImageFiles("assets/images/*.png", DPI=96)

DPI 參數用於控制圖片解析度。 較高的 DPI 會產生更清晰的圖像，但代價是檔案大小增加且處理時間較長。標準值：

輸出目錄中，每頁 PDF 對應一個 PNG 檔案

若輸出影像出現模糊，請增加 DPI 的數值。 處理一份 50 頁、300 DPI 的文件所需時間明顯比 96 DPI 更長——請根據實際使用情境的品質需求進行選擇。

#:path=/static-assets/pdf/content-code-examples/how-to/python-pdf-to-image/convert-page-range.py
from ironpdf import PdfDocument

pdf = PdfDocument.FromFile("my-content.pdf")

# Convert only pages 1, 2, and 3 (zero-based indices: 0, 1, 2)
pdf.RasterizeToImageFiles("assets/images/*.png", [0, 1, 2], DPI=96)

#:path=/static-assets/pdf/content-code-examples/how-to/python-pdf-to-image/convert-page-range.py
from ironpdf import PdfDocument

pdf = PdfDocument.FromFile("my-content.pdf")

# Convert only pages 1, 2, and 3 (zero-based indices: 0, 1, 2)
pdf.RasterizeToImageFiles("assets/images/*.png", [0, 1, 2], DPI=96)

如何將 URL 轉換為圖片？

IronPDF 能夠將網頁渲染為 PDF，並在單一工作流程中將該 PDF 轉換為圖像。 請使用 ChromePdfRenderer 擷取並渲染 URL，然後對生成的 PdfDocument 呼叫 RasterizeToImageFiles。 此方法可建立網頁的視覺化存檔，或為網頁內容產生預覽圖像，無需額外使用截圖工具。

#:path=/static-assets/pdf/content-code-examples/how-to/python-pdf-to-image/url-to-images.py
from ironpdf import ChromePdfRenderer

# Render a web page to PDF
renderer = ChromePdfRenderer()
pdf = renderer.RenderUrlAsPdf("https://www.example.com")

# Convert each rendered page to a PNG image
pdf.RasterizeToImageFiles("assets/images/*.png", DPI=96)

#:path=/static-assets/pdf/content-code-examples/how-to/python-pdf-to-image/url-to-images.py
from ironpdf import ChromePdfRenderer

# Render a web page to PDF
renderer = ChromePdfRenderer()
pdf = renderer.RenderUrlAsPdf("https://www.example.com")

# Convert each rendered page to a PNG image
pdf.RasterizeToImageFiles("assets/images/*.png", DPI=96)

渲染的圖片呈現了頁面在 Chromium 瀏覽器中的顯示效果，包含 CSS 樣式及 JavaScript 渲染的內容。 若遇到需驗證或需要互動的頁面，請考慮使用 IronPDF 的 HTML 轉 PDF 教學指南，直接提供預渲染的標記碼。 隨後可採用上述相同方法將生成的 PDF 進行點陣化處理。

透過 IronPDF 渲染自 URL 所生成的圖片

如何控制輸出圖片的尺寸？

預設情況下，RasterizeToImageFiles 會根據 DPI 係數，以原始頁面尺寸生成圖片。 若需限制輸出大小，請設定 ImageMaxWidth 和 ImageMaxHeight，兩者皆以像素為單位。

IronPDF 會根據 ImageMaxHeight 的值來保留原始的長寬比。 即使指定寬高比例與原始頁面不同，輸出內容也不會被拉伸或變形。

#:path=/static-assets/pdf/content-code-examples/how-to/python-pdf-to-image/constrained-dimensions.py
from ironpdf import PdfDocument

pdf = PdfDocument.FromFile("my-content.pdf")

# Generate thumbnail images constrained to 500x500 pixels
pdf.RasterizeToImageFiles(
    "assets/images/*.png",
    ImageMaxWidth=500,
    ImageMaxHeight=500,
    DPI=200
)

#:path=/static-assets/pdf/content-code-examples/how-to/python-pdf-to-image/constrained-dimensions.py
from ironpdf import PdfDocument

pdf = PdfDocument.FromFile("my-content.pdf")

# Generate thumbnail images constrained to 500x500 pixels
pdf.RasterizeToImageFiles(
    "assets/images/*.png",
    ImageMaxWidth=500,
    ImageMaxHeight=500,
    DPI=200
)

將 ImageMaxWidth=500, ImageMaxHeight=500 設定為 200 DPI，可產生適合縮圖顯示或卡片式 UI 佈局的圖像。 請根據應用程式設計所需的尺寸調整這些數值。 為了產生即將被光柵化的 PDF 內容，IronPDF 亦支援透過 Python 建立 PDF 檔案，並在轉換前合併多個 PDF 檔案。

PDF 轉圖像的下一步是什麼？

本指南涵蓋了三個核心工作流程：將 PDF 檔案轉換為圖片、將網址轉換為圖片，以及控制圖片尺寸與畫質。 IronPDF 支援 JPEG、JPG、PNG、TIFF 以及透過相同 RasterizeToImageFiles 方法處理的其他格式。 請變更輸出路徑模式中的檔案副檔名以切換格式。

若需進一步自動化，請考慮以下步驟：

• 批次處理：遍歷 PDF 檔案目錄並依序轉換每個檔案，或使用 Python 的 concurrent.futures 模組進行平行處理
• 選擇性擷取：使用 page index 參數，僅擷取與使用案例相關的頁面
• 影像處理流程整合：將輸出檔案導入 PIL/Pillow 或 OpenCV 進行後續處理，例如裁切、標註或格式標準化
• 轉換前壓縮：使用 IronPDF 的 PDF 壓縮功能，在將大型文件轉為點陣圖前先縮小檔案大小
• 表單工作流程：透過程式化方式填寫 PDF 表單，並將填妥的表單頁面轉換為圖像，以便審閱或歸檔

若要繼續使用 IronPDF 進行開發，請參閱 IronPDF for Python 文件以及"將 PDF 渲染為圖像"範例。

立即開始 IronPDF for Python 的 30 天試用，將這些功能應用於實際生產環境中。 準備部署時，請查看適合專案規模的方案授權選項。