如何將 PDF 光柵化為圖像

如何在C#中將PDF光柵化為影像

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

IronPDF提供了一種簡單的方法,使用RasterizeToImageFiles方法將PDF頁面轉換為PNG、JPEG或TIFF等影像格式,使您的.NET應用程式能輕鬆整合PDF到影像轉換,以生成縮圖、預覽或影像處理。

將PDF光柵化可將其轉換為像JPEG或PNG等基於像素的影像格式。 此過程會將每個頁面轉換為由像素表示的靜態影像。 光柵化可實現PDF內容顯示、縮圖生成、影像處理和安全文件共享。

使用IronPDF,您可以以程式的方式將PDF轉換為影像。 無論您需要在應用程式中整合PDF渲染、生成影像預覽、執行基於影像的操作或增強文件安全性,IronPDF提供了必要的工具。 該程式庫支援多種影像格式,並可控制輸出品質、尺寸和頁面選擇。 您可以利用IronPDF的Chrome PDF渲染引擎進行精確渲染,保留原始文件的外觀。

快速入門:使用IronPDF在.NET中輕鬆進行PDF光柵化

使用IronPDF的簡單API將PDF頁面轉換為影像。 此快速入門展示如何載入PDF並將每個頁面匯出為影像檔案,允許您將光柵化功能整合到您的.NET應用程式中。 非常適合生成縮圖、增強文件安全性或準備檔案供進一步處理。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 複製並運行這段程式碼。

    IronPdf.PdfDocument.FromFile("input.pdf").RasterizeToImageFiles("page_*.png");
  3. 部署到您的生產環境進行測試

    今天就在您的專案中開始使用免費試用IronPDF

    arrow pointer


如何在C#中將PDF頁面轉換為影像?

RasterizeToImageFiles方法從PDF文件匯出影像。 此方法可在PdfDocument對象上獲得,無論是本地導入PDF文件,還是從HTML文件轉PDF轉換指南HTML字符串轉PDF轉換指南URL轉PDF轉換指南渲染。

該方法提供了從PDF文件生成影像的靈活性。 您可以轉換整個文件或特定頁面,控制輸出格式和品質,以及指定自定義尺寸以產生的影像。 這使得它非常適合各種使用情景,從創建縮圖預覽到生成高解析度影像用於列印。

請注意FileNamePattern參數需要文件擴展名如.png、.jpg或.tif。

提示FileNamePattern中包含的星號 (*) 字符將被對應的頁碼替換。

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-rasterize.cs
using IronPdf;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render PDF from web URL
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

// Export images from PDF
pdf.RasterizeToImageFiles("wikipage_*.png");
$vbLabelText   $csharpLabel

對於更複雜的PDF生成方案,探索CSHTML轉PDF或了解自定義渲染選項以在光柵化之前微調您的PDF創建過程。

輸出影像存儲在哪裡?

文件瀏覽器顯示PDF轉換輸出:5個PNG文件(wikipage_1-5.png)位於net6.0構建目錄中

默認情況下,輸出影像被保存到應用程式的目前工作目錄中,通常是專案的bin/Debug或bin/Release資料夾。 您可以指定保存影像到自定位置的絕對或相對路徑。 例如,@"C:\Output\page_*.png"將影像保存到C:\Output目錄。

如果表單欄位值應在輸出影像中可見,在將PDF轉換為影像之前將PDF展平或將true傳遞給方法中的Flatten參數。 使用Flatten方法後,表單將不可檢測。 了解更多關於展平PDF的資料以更好地了解這一過程。

了解如何在文章"如何填寫和編輯PDF表單"中以程序的方式填寫和編輯PDF表單。

如何生成高品質的位圖影像?

在轉換為位圖時保持原始影像解析度,請使用ToBitmapToBitmapHighQuality方法返回從BMP格式解碼的影像。

BMP格式存儲原始像素資料,導致更清晰的影像但較大的文件大小。 JPEG使用有損壓縮,顯著減小文件大小,但代價是輕微模糊。 對於印刷和查看PDF等大多數用途,JPEG影像品質已足夠。 對於需要高視覺保真度的PDF,探索我們的指南像素完美的HTML格式

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-to-bitmap-high-quality.cs
using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("url.pdf");

var image = pdf.ToBitmapHighQuality();
image[0].SaveAs("output.png");
$vbLabelText   $csharpLabel

有哪些高級選項可用於PDF光柵化?

讓我們探索RasterizeToImageFiles方法的額外參數。 IronPDF提供了對光柵化過程的全面控制,允許根據具體需求進行自定義。

我可以輸出到哪些影像格式?

另一個參數允許您為輸出影像指定文件類型。 支持的格式包括BMP、JPEG、PNG、GIF、TIFF和SVG。 每種類型都有對應的方法,可以直接從PdfDocument對象調用:

  • ToBitmap:將PDF光柵化為獨立的AnyBitmap對象,每頁一個Bitmap。
  • ToJpegImages:將PDF頁面渲染為JPEG文件並保存到磁碟。
  • ToPngImages:將PDF頁面渲染為PNG文件並保存到磁碟。
  • ToTiffImages:將PDF頁面渲染為單頁TIFF文件並保存到磁碟。
  • ToMultiPageTiffImage:將PDF頁面渲染為多頁TIFF文件。
  • SaveAsSvg:將PDF轉換為SVG格式並保存到指定路徑。
  • ToSvgString:將特定PDF頁面轉換為SVG格式並作為字符串返回。

為了使用向量圖形,探索我們的指南在PDF生成功能中使用SVG圖像,這補充了SVG匯出的功能。

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-image-type.cs
using IronPdf;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render PDF from web URL
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

// Export images from PDF
pdf.RasterizeToImageFiles("wikipage_*.png", IronPdf.Imaging.ImageType.Png);
$vbLabelText   $csharpLabel

如何通過DPI設置提高影像清晰度?

默認的DPI為96可能會產生模糊的輸出影像。 為了提高清晰度,在光柵化時指定更高的DPI值。 DPI(每英寸點數)直接影響解析度和文件大小。更高的DPI值生成更清晰的影像,但會導致更大的文件大小。

常見的DPI設置:

  • 96 DPI:標準螢幕解析度,適用於網頁顯示
  • 150 DPI:適合一般文檔查看
  • 300 DPI:高品質列印
  • 600 DPI:專業列印品質
:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-dpi.cs
using IronPdf;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render PDF from web URL
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

// Export images from PDF with DPI 150
pdf.RasterizeToImageFiles("wikipage_*.png", DPI: 150);
$vbLabelText   $csharpLabel

如何將特定頁面轉換為影像?

您可以指定要光柵化為影像的PDF文件的頁面。 以下示例生成PDF頁面1-3的影像。此功能對於創建特定頁面的縮圖或處理大型PDF文件時僅需要某些頁面的圖像時非常有用。

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-page-indexes.cs
using IronPdf;
using System.Linq;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render PDF from web URL
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

// Export images from PDF page 1_3
pdf.RasterizeToImageFiles("wikipage_*.png", Enumerable.Range(1, 3));
$vbLabelText   $csharpLabel

對於高級頁面操作,請探索我們的指南添加、複製和刪除頁面拆分PDF

如何控制輸出影像的維度?

在將PDF文件轉換為影像時,您可以自定義輸出影像的高和寬。 指定的值表示最大尺寸,同時保留原始文檔的縱橫比。 對於縱向PDF文件,指定的高度值將是準確的,而寬度將調整以保持正確的縱橫比。

當影像必須符合特定的尺寸要求,如網頁顯示、縮圖或其他需要一致尺寸的應用時,這一功能至關重要。 縱橫比的保留保證內容不會看起來被拉伸或變形。

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-image-dimensions.cs
using IronPdf;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render PDF from web URL
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

// Export images from PDF
pdf.RasterizeToImageFiles("wikipage_*.png", 500, 500);
$vbLabelText   $csharpLabel

設定維度時會對長寬比造成什麼影響?

輸出影像的維度使用寬乘高格式指定(寬 x 高)。 IronPDF智能地處理縱橫比保留,以確保影像保持原始比例。

File properties showing PNG output from PDF rasterization: 353x500 pixels, 71.3 KB, with Wikipedia page thumbnail
File properties showing rasterized PDF output: 500x353 PNG, 50.5 KB, created 7/13/2023

PDF光柵化的其他考量因素

在您的應用中實現PDF到影像的轉換時,請考慮以下最佳實踐:

  1. 性能優化:對於大型PDF文件或批量處理,使用異步和多執行緒技術來提高性能。

  2. 記憶體管理:高解析度光柵化可能消耗大量記憶體。 監控應用程式的記憶體使用情況,並對大型文檔進行分批處理。

  3. 輸出存儲:對於網頁應用,探討使用Azure Blob Storage進行影像的高效存儲和檢索

  4. 品質與文件大小:根據您的使用場景平衡DPI設定。 較高的DPI會產生更好的品質但會增加文件大小,影響存儲和頻寬需求。

借助IronPDF的全面光柵化能力,您可以將PDF文件轉換為各種影像格式,同時保持對品質、尺寸和輸出規格的完全控制。 無論是建構文件管理系統、創建預覽功能還是生成縮圖,IronPDF提供了高效的PDF到影像轉換的工具。

常見問題解答

如何在 C# 中將 PDF 頁面轉換為影像?

使用 IronPDF,您可以使用 RasterizeToImageFiles 方法將 PDF 頁面轉換成圖片。只需載入 PDF 文件並呼叫此方法即可將頁面匯出為 PNG、JPEG 或 TIFF 圖檔。此方法在 PdfDocument 物件上可用,並支援轉換整個文件或具有自訂尺寸和品質設定的特定頁面。

PDF 轉換支援哪些影像格式?

IronPDF 支援將 PDF 轉換為多種影像格式,包括 PNG、JPEG 和 TIFF。格式會自動由您在 RasterizeToImageFiles 方法中指定的檔案副檔名決定,讓您可以輕鬆地以您偏好的格式產生影像。

我可以控制轉換後影像的品質與尺寸嗎?

是的,IronPDF 在光栅化 PDF 時提供了對輸出质量和尺寸的完全控制。您可以指定自訂的 DPI 設定,以提高清晰度,並根據您的需求設定特定的輸出尺寸,確保產生的影像符合您的確切規格。

PDF 轉換為圖像的常見用例有哪些?

IronPDF 的光柵化功能非常適用於產生縮圖、建立文件預覽、實現安全的文件共享(因為影像無法輕易編輯)、執行基於影像的操作,以及將 PDF 渲染整合至需要影像格式的應用程式。

PDF 轉換為影像的精確度如何?

IronPDF 使用 Chrome PDF 渲染引擎,以確保準確渲染,保留原始文件的外觀。這表示字型、版面設計、圖形和格式都會忠實重現於結果影像中。

我可以將 PDF 的特定頁面轉換成影像嗎?

是的,IronPDF 的 RasterizeToImageFiles 方法可靈活轉換 PDF 文件中的特定頁面或頁面範圍,而不僅是整個文件。這樣,您就可以選擇性地只將所需的頁面導出為圖像。

Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。

準備好開始了嗎?
Nuget 下載 17,803,474 | 版本: 2026.3 剛剛發布
Still Scrolling Icon

還在滾動嗎?

想快速取得證據? PM > Install-Package IronPdf
運行範例看著你的HTML程式碼變成PDF檔。