使用IronPDF渲染WebGL內容的目的是什麼？

IronPDF用於在C#中捕獲GPU加速的WebGL地圖、3D儀表板和模型查看器為靜態PDF。這對於建立可分享的、固定版本的報告、批准以及檔案中使用的交互場景至關重要。

為什麼不能使用標準HTML-to-PDF渲染WebGL內容？

標準HTML-to-PDF渲染無法捕獲WebGL內容，因為它依賴於GPU進行處理。IronPDF的解決方案包括使用GPU加速渲染來準確捕獲這些複雜的場景。

渲染WebGL時使用IronPDF所需的配置是什麼？

要使用IronPDF渲染WebGL內容，您需要啟用單處理模式和硬體GPU模式，並包含一個渲染延遲以在捕獲前讓場景完全載入。

為什麼需要使用真實GPU來渲染IronPDF的WebGL內容？

需要使用真實GPU，因為必須使用硬體GPU模式來處理著色器、紋理和3D變換。軟體渲染無法有效處理這些元素。

我可以使用Docker來渲染IronPDF的WebGL內容嗎？

不能，Docker不支援，因為它是無頭且GPU存取有限。替代方案包括使用虛擬機、專用的支持GPU的伺服器，或將場景預渲染為靜態圖像。

IronPDF渲染的WebGL內容輸出是什麼樣子？

輸出是一個靜態PDF快照，保留了WebGL場景在渲染時間的視覺狀態。它適合文件和檔案，但不保留交互性，如平移或縮放。

我應該如何調整WebGL內容的渲染延遲？

渲染延遲應設置在3,000到10,000毫秒之間，具體取決於場景的複雜性。這可以確保場景有足夠的時間載入而不減慢處理速度。

啟用單處理模式有什麼影響？

啟用單處理模式是渲染WebGL所必須的，但會影響並發性。在高流量服務中應考慮這種權衡。

我可以在哪裡找到更多關於配置IronPDF進行WebGL渲染的資訊？

完整的配置和疑難解答步驟可以在IronPDF網站提供的render WebGL指導中找到。

C# PDF程式庫

Explore IronPDF 開始免費試用

HTML 轉 PDF

Online Demo 查看所有程式碼範例

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

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

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

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

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >

Install-Package IronPdf

產品比較

在 ASP.NET MVC 中生成 PDF：iTextSharp vs IronPDF 指南

Curtis Chau

Updated: 2026年7月5日

交互地圖、3D控制面板和使用WebGL構建的模型查看器在瀏覽器中看起來很棒，但持份者通常需要固定的、可分享的版本：報告中的地圖快照、批准包中的3D設計、存檔中的模擬結果。IronPDF在C#中將GPU加速的WebGL內容捕獲為靜態PDF，保留場景渲染時的視覺狀態。

商業問題

一個物流工具在Mapbox地圖上顯示路線，房地產應用顯示3D地形，工程應用在瀏覽器中渲染CAD模型。每一個都需要一個PDF版本用於報告、記錄或沒有存取實時應用的接收者。普通截圖質量低且手動，而標準HTML到PDF渲染不能捕獲依賴於GPU的WebGL。

配置渲染

WebGL捕獲需要三個設置：單程模式、硬體GPU模式以及場景在捕獲前完成渲染的延遲。

using IronPdf;

// Required for WebGL: GPU operations must complete in one process
IronPdf.Installation.SingleProcess = true;
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Hardware;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Give the 3D scene time to load and render
renderer.RenderingOptions.WaitFor.RenderDelay(5000);

PdfDocument pdf = renderer.RenderUrlAsPdf("https://docs.mapbox.com/mapbox-gl-js/example/geojson-layer-in-slot/");
pdf.SaveAs("webgl.pdf");

using IronPdf;

// Required for WebGL: GPU operations must complete in one process
IronPdf.Installation.SingleProcess = true;
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Hardware;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Give the 3D scene time to load and render
renderer.RenderingOptions.WaitFor.RenderDelay(5000);

PdfDocument pdf = renderer.RenderUrlAsPdf("https://docs.mapbox.com/mapbox-gl-js/example/geojson-layer-in-slot/");
pdf.SaveAs("webgl.pdf");

結果精確捕獲地圖、圖表或模型的外觀，適合於文件、報告和存檔。

需要計劃的要點

此功能要求真實環境條件，並且他們決定它是否適合於給定的部署。

需要真實GPU： 硬體GPU模式是必需的。軟體渲染無法處理著色器、紋理和3D變換，因此主機需要一個當前驅動程式相容的GPU。
不支援Docker： WebGL渲染在標準的無頭Docker容器中無法工作，因為其GPU存取受限。解決方案是VM或支持GPU的專用伺服器、運行於GPU主機上的微服務，或預渲染場景為靜態圖片。
輸出為快照： PDF在渲染時保留視覺狀態。平移、縮放和其他交互性不被保留，因此更適合文件和存檔而非交互式交付。
調整渲染延遲： 複雜場景需要時間載入。 3000到10000毫秒之間的值是一個合理的測試範圍，因為太短會剪掉渲染，太長則浪費時間。
單程模式是全域性的： 這裡需要它但會影響併發，在高流量服務中需要權衡。