1. IronPDF
  2. Nasıl Yapılır
  3. WebGL Sitelerini İşleme
WebGL Sitelerini PDF'ye C# ile Nasıl Render Edilir

WebGL Sitelerini C# ile Nasıl Çalıştırırım

Curtis Chau
Curtis Chau
Güncellendi:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF, Chrome'un GPU modunu Hardware olarak yapılandırarak ve SingleProcess modunu kullanarak WebGL web sitelerini PDF'ye render etmeyi sağlar, böylece Mapbox gibi sitelerden dinamik 3D grafikleri statik PDF belgelerine yakalayabilirsiniz.

Webgl Logo related to WebGL Sitelerini C# ile Nasıl Çalıştırırım

WebGL, web tarayıcıları içinde etkileşimli 3D grafikler oluşturmak için güçlü bir araçtır, ancak bu dinamik, oldukça etkileşimli deneyimleri statik bir PDF formatına dönüştürmek zordur. WebGL web sitesini PDF'ye dönüştürmek, WebGL bağlamı tarafından üretilen görsel içeriği yakalamak ve PDF belgesi için uygun bir formata dönüştürmek anlamına gelir. Bu süreç, GPU hızlandırmalı grafiklerin HTML'den PDF'ye dönüştürme süreci sırasında düzgün bir şekilde yakalanmasını sağlamak için özel yapılandırma gerektirir.

IronPDF, Mapbox ve WebGL Samples koleksiyonu gibi siteleri yakalayıp çalıştırmak için gerekli araçları sağlar. Standart HTML işleme işleminin aksine, WebGL içeriği GPU'ya erişim ve işleme hattı ile PDF oluşturma arasında uygun senkronizasyon gerektirir. Kütüphanenin Chrome Rendering Engine bu karmaşıklıkları ele alır ve böylece 3D görselleştirmelerin, karmaşık gölgelendiricilerin ve interaktif grafiklerin statik bir PDF formatında korunmasını sağlar.

Hızlı Başlangıç: WebGL İçeriğini .NET'te PDF'ye Dönüştürme

Etkileşimli WebGL grafiklerini IronPDF ile .NET C# içinde statik PDF'lere dönüştürün. Bu kılavuz, web sitelerinden WebGL içeriğini nasıl kurup çalıştıracağınızı gösterir. Chrome GPU modunu Hardware olarak yapılandırarak ve SingleProcess etkinleştirerek dinamik web grafiklerini yakalayabilirsiniz. Bu adımlar, 3D web içeriğini paylaşılabilir PDF belgelerine dönüştürür.

  1. NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronPdf yükleyin

    PM > Install-Package IronPdf

  2. Bu kod parçasını kopyalayıp çalıştırın.

    IronPdf.Installation.SingleProcess = true; IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Hardware;
new IronPdf.ChromePdfRenderer { RenderingOptions = { WaitFor = IronPdf.Rendering.WaitFor.RenderDelay(5000) } }
    .RenderUrlAsPdf("https://example.com/webgl-demo")
    .SaveAs("webgl-output.pdf");

  3. Canlı ortamınızda test etmek için dağıtın

    Bugün projenizde IronPDF kullanmaya başlayın ücretsiz deneme ile

    arrow pointer

Minimal Is Akisi (5 adimda)

  1. IronPDF C# Kütüphanesini indir
  2. Set the SingleProcess property to `true`
  3. Change the ChromeGpuMode property to `Hardware`
  4. Uygun kullanımın sağlanması için işlemden önce bir gecikme uygulayın
  5. PDF'yi URL'den çalıştırın ve sonucu kaydedin


WebGL Web Sitelerini Çalıştırmak İçin IronPDF Nasıl Yapılandırılır?

WebGL işleme işlemini etkinleştirmek için, bu IronPDF ayarlarını yapılandırın:

  • SingleProcess = true. Bu, Chrome'un tüm işleri mevcut süreçte gerçekleştirmesini ve alt süreçler yerine olmasını zorlar. Bu, tüm GPU işlemlerinin aynı süreç bağlamında gerçekleşmesini garantileyerek WebGL işleme için çok önemlidir.
  • ChromeGpuMode = Hardware. Bu, GPU'nun WebGL içeriğini düzgün bir şekilde çalıştırmasını sağlayarak donanım hızlandırmayı etkinleştirir.

Ayrıca, web sitesi düzgün görüntülenmesi için render etmeden önce biraz gecikme gerektiriyorsa, WaitFor.RenderDelay metodunu kullanın. Bu, özellikle karmaşık 3D sahnelerin tamamen yüklenip çalıştırılması birkaç saniye sürebileceği için WebGL içeriği için önemlidir. Daha gelişmiş zamanlama kontrolleri için, PDF çalıştırmayı geciktirmek için WaitFor kullanma kılavuzumuzu inceleyin.

Mapbox'ın GeoJSON Katmanından örnek bir örnek çalıştıralım:

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

// Configure IronPdf settings
IronPdf.Installation.SingleProcess = true;
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Hardware;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set delay before rendering
renderer.RenderingOptions.WaitFor.RenderDelay(5000);

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

pdf.SaveAs("webGL.pdf");
Imports IronPdf

' Configure IronPdf settings
IronPdf.Installation.SingleProcess = True
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Hardware

Dim renderer As New ChromePdfRenderer()

' Set delay before rendering
renderer.RenderingOptions.WaitFor.RenderDelay(5000)

' Render from URL
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://docs.mapbox.com/mapbox-gl-js/example/geojson-layer-in-slot/")

pdf.SaveAs("webGL.pdf")
$vbLabelText   $csharpLabel

Yapılandırma Seçeneklerini Anlama

SingleProcess yapılandırması, WebGL renderinin ana işlem ve GPU işlemleri arasındaki paylaşılan belleğe dayanması nedeniyle önemlidir. Chrome, çok süreçli modda çalıştığında (varsayılan), GPU işlemleri PDF yakalama işlemi gerçekleşmeden önce düzgün bir şekilde tamamlanamayabilir. Tek süreç modunu zorlayarak tüm işlem görevlerinin sırayla tamamlanmasını sağlıyoruz.

Donanım GPU modu, Chrome'un donanım hızlandırma özelliklerini etkinleştirir. Bu ayar olmadan, Chrome yazılım çalıştırmaya geçer ve bu, WebGL'nin gölgeler, dokular ve 3D dönüşümler gibi gelişmiş grafik özelliklerini düzgün bir şekilde çalıştıramaz. Çalıştırma seçenekleri hakkında daha fazla ayrıntı için kapsamlı çalıştırma seçenekleri kılavuzumuzu ziyaret edin.

İşlem WebGL PDF'si Nasıl Görünür?

Ortaya çıkan PDF, WebGL içeriğini işleme anında yakalar, 3D grafikleri, harita görselleştirmelerini ve karmaşık gölge efektlerinin görsel durumunu korur. Etkileşimli özellikler statik PDF formatında kaybolurken, görsel sadakat yüksek kalır ve bu, belgeleme, raporlama ve arşivleme amaçları için uygundur.

Ortak WebGL İşleme Senaryoları

WebGL işleme, özellikle şu durumlar için kullanışlıdır:

  1. Coğrafi Görselleştirmeler: 3D arazi, hava durumu katmanları veya coğrafi veri görselleştirmeleri içeren haritaları yakalama
  2. Veri Panoları: Etkileşimli 3D grafik ve grafikleri statik raporlara dönüştürme
  3. CAD ve 3D Modeller: 3D tasarımları ve mimari görselleştirmeleri belgeleme
  4. Bilimsel Görselleştirmeler: Moleküler yapıları, astronomik verileri veya simülasyon sonuçlarını koruma

WebGL'nin ötesinde JavaScript ağırlıklı içeriklerle başa çıkmak için JavaScript'ten PDF'ye dönüştürme kılavuzumuzu inceleyin.

Docker Sınırlamaları ve Çözüm Yolları

Şu anda Docker kurulumunda WebGL çalıştıramazsınız. Docker'da WebGL çalıştırmak zordur çünkü Docker konteynerleri tipik olarak grafik kullanıcı arayüzü (GUI) olmayan başsız ortamlardır. WebGL, grafik çalıştırmak için GPU'ya erişime dayanır ve başsız bir ortamda, GPU'ya erişim sınırlı veya mevcut değildir.

Geliştiricilerimiz bu olasılığı hala araştırıyor. WebGL desteğine sahip IronPDF'yi dağıtmanız gerekiyorsa, şunları dikkate alın:

  1. Konteynerler yerine VM veya özel sunucu kullanma
  2. WebGL işleme işlemlerinin GPU olanaklı bir ev sahibi üzerinde gerçekleştiği bir mikro hizmet mimarisi uygulama
  3. WebGL içeriğini mümkün olduğunda statik görüntülere dönüştürme

WebGL gereksinimi olmayan standart Docker dağıtımları için Docker kurulum kılavuzumuzu inceleyin. Docker WebGL desteği için bir sona varıldığında haberdar edilmek isterseniz, lütfen support@ironsoftware.com ile iletişime geçin.

WebGL İşleme Sorunlarını Giderme

WebGL işleme sorunlarıyla karşılaşırsanız:

  1. GPU kullanılabilirliğini doğrulayın: Sisteminizin uyumlu bir GPU'ya ve güncellenmiş sürücülere sahip olduğundan emin olun
  2. Chrome bağımlılıklarını kontrol edin: WebGL, belirli Chrome bileşenleri gerektirir. Chrome bağımlılıkları sorun giderme kılavuzumuza bakın
  3. Render gecikmelerini ayarlayın: Karmaşık WebGL sahnelerinin daha uzun gecikmelere ihtiyaçı olabilir. 3000-10000 milisaniye arasında değerlerle deney yapın
  4. Hafıza kullanımını izleyin: WebGL işleme işlemi hafıza yoğun olabilir. Yeterli sistem kaynaklarına sahip olduğundan emin olun

Sürekli sorunlar için performans optimizasyon kılavuzumuza bakın veya bir mühendislik desteği isteği gönderin.

Gelişmiş WebGL Çalıştırma Teknikleri

Daha karmaşık WebGL senaryoları için IronPDF'nin çalıştırma yeteneklerini ek seçeneklerle birleştirin:

Başka neler yapabileceğinizi görmek için hazır mısınız? Eğitim sayfamızı burada inceleyin: Ekstra Özellikler. Daha fazla HTML'den PDF'ye yeteneği için kapsamlı HTML'den PDF'ye öğretici eğitimimizi inceleyin.

Sıkça Sorulan Sorular

WebGL nedir ve PDF'ye dönüştürmek neden zordur?

WebGL, web tarayıcıları içinde etkileşimli 3D grafikler oluşturmak için güçlü bir araçtır. WebGL'yi PDF'ye dönüştürmek zordur çünkü dinamik, GPU hızlandırmalı grafiklerin yakalanması ve bunların statik bir formata dönüştürülmesi gerektirir. IronPDF, uygun GPU erişimi ve işleme hattı ile PDF oluşturma arasında eşzamanlılık sağlayan özel yapılandırma seçenekleri sunarak bu zorluğun üstesinden gelir.

IronPDF'de WebGL işleme nasıl etkinleştirilir?

IronPDF'de WebGL işlemesini etkinleştirmek için iki ana ayarı yapılandırmanız gerekir: Mevcut işlemde tüm işlemlerin gerçekleştirilmesi için Chrome'u zorlayan SingleProcess ayarını true olarak ayarlayın ve donanım ivmelendirmeyi etkinleştirmek için ChromeGpuMode ayarını Donanım olarak ayarlayın. Bu ayarlar, WebGL içeriğinin işlenmesi için uygun GPU erişimini sağlar.

Hangi tür WebGL web siteleri PDF'ye dönüştürülebilir?

IronPDF, Mapbox gibi harita hizmetleri ve WebGL Örnekleri koleksiyonu dahil olmak üzere çeşitli WebGL web sitelerini PDF'ye dönüştürebilir. Kitaplıktaki Chrome Rendering Engine, karmaşık 3D görselleştirmeleri, gölgelendiricileri ve etkileşimli grafikleri işleyerek bunları statik PDF formatında korur.

WebGL'yi PDF'ye dönüştürürken neden bir gösterim gecikmesi gereklidir?

WebGL içeriğini dönüştürürken bir gösterim gecikmesi önerilir çünkü bu grafiklerin tamamen yüklenip işlenmesi genellikle ek zaman gerektirir. IronPDF, WebGL içeriğinin PDF oluşturma başlamadan önce tamamen işlenmesini sağlamak için bir WaitFor.RenderDelay() ayarlamanıza olanak tanır.

WebGL'yi PDF'ye dönüştürmek için asgari iş akışı nedir?

Asgari iş akışı 5 adım içerir: 1) IronPDF C# Kütüphanesini indirin, 2) SingleProcess özelliğini true olarak ayarlayın, 3) ChromeGpuMode ayarını Donanım olarak değiştirin, 4) Uygun işlem için bir gösterim gecikmesi uygulayın, ve 5) WebGL sayfasını dönüştürmek ve sonucu kaydetmek için RenderUrlAsPdf() kullanın.

IronPDF, WebGL'den karmaşık 3D grafik ve gölgelendiricileri yakalayabilir mi?

Evet, IronPDF'nin Chrome Rendering Engine'i WebGL web sitelerinden karmaşık 3D görselleştirmeleri, gölgelendiricileri ve etkileşimli grafikleri yakalama ve koruma kapasitesine sahiptir. Donanım ivmelendirme desteği, GPU-da işlenen içeriğin dönüşüm süreci sırasında düzgün bir şekilde yakalanmasını sağlar.

Curtis Chau
Curtis Chau
  Mühendislik takımıyla şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget Indirmeler 18,332,619 | Sürüm: 2026.4 yeni yayınlandı
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package IronPdf
bir örnek çalıştır HTML'nizin PDF olduğunu izleyin.