1. .NET
  2. Nasıl Yapılır
  3. WebGL Sitelerini İşle
C# içinde WebGL Sitelerini PDF'ye Dönüştürme

WebGL Sitelerini C# İle Nasıl Render Edebilirim?

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 sitelerinin PDF'ye dönüştürülmesini sağlar; böylece Mapbox gibi sitelerden dinamik 3D grafikleri yakalayarak statik PDF belgelerine aktarabilirsiniz.

Webgl Logo related to WebGL Sitelerini C# İle Nasıl Render Edebilirim?

WebGL, web tarayıcılarında etkileşimli 3D grafikler oluşturmak için güçlü bir araçtır, ancak bu dinamik, son derece etkileşimli deneyimleri statik bir PDF formatına dönüştürmek zor olabilir. Bir WebGL web sitesini PDF'ye render etmek, WebGL bağlamı tarafından oluşturulan görsel içeriği yakalamayı ve bir PDF belgesi için uygun bir formata dönüştürmeyi içerir. Bu işlem, GPU ile hızlandırılmış grafiklerin HTML'den PDF'ye dönüştürme süreci sırasında uygun şekilde yakalanmasını sağlamak için özel yapılandırma gerektirir.

Mapbox ve WebGL Örnek koleksiyonu gibi WebGL içeren web sitelerini yakalamak ve render etmek için ihtiyaç duyulan araçları IronPDF sağlar. Standart HTML render etmenin aksine, WebGL içeriği, GPU'ya erişim ve render hattı ile PDF üretimi arasında uygun bir senkronizasyon gerektirir. Kütüphanenin Chrome Rendering Engine, bu karmaşıklıkları ele alır ve 3 boyutlu görselleştirmeler, karmaşık gölgelendiriciler ve etkileşimli grafikleri statik bir PDF formatında korumayı mümkün kılar.

Hızlı Başlat: WebGL İçeriğini PDF'ye Render Edin .NET

IronPDF kullanarak etkileşimli WebGL grafiklerini statik PDF'lere dönüştürün. Bu kılavuz, web sitelerinden WebGL içeriğini nasıl ayarlayacağınızı ve render edeceğinizi gösterecektir. Chrome GPU modunu Hardware olarak yapılandırıp SingleProcess'yi etkinleştirerek dinamik web grafiklerini yakalayabilirsiniz. Bu adımlar, 3D web içeriğini paylaşılabilir PDF belgelerine dönüştürür.

  1. IronPDF aşağıdaki NuGet Paket Yöneticisi ile yükleyin

    PM > Install-Package IronPdf

  2. Bu kod parçacığını kopyalayın ve ç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 için dağıtım yapın

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

    arrow pointer

Asgari İş Akışı (5 adım)

  1. IronPDF C# Kütüphanesini İndirin
  2. SingleProcess özelliğini true olarak ayarlayın
  3. ChromeGpuMode özelliğini Hardware olarak değiştirin
  4. Uygun render için render öncesi bir gecikme uygulayın
  5. PDF'yi URL'den render edin ve sonucu kaydedin


IronPDF'i WebGL Web Sitelerini Render Etmek İçin Nasıl Yapılandırırım?

WebGL render etmeyi etkinleştirmek için bu IronPDF ayarlarını yapılandırın:

  • SingleProcess = true. Bu, Chrome'un her şeyi alt süreçler yerine geçerli süreç içinde gerçekleştirmeye zorlar. Bu, tüm GPU işlemlerinin aynı işlem bağlamı içinde gerçekleşmesini sağladığı için WebGL render etme için kritiktir.
  • ChromeGpuMode = Hardware. Bu, donanım hızlandırmayı etkinleştirir ve GPU'nun WebGL içeriğini uygun şekilde render etmesine olanak tanır.

Ayrıca, web sitesinin düzgün görüntülenebilmesi için işlenmeden önce bir süre beklemesi gerekiyorsa, WaitFor.RenderDelay yöntemini kullanın. Bu, özellikle WebGL içeriği için önemlidir, çünkü karmaşık 3D sahnelerin tamamen yüklenmesi ve render edilmesi birkaç saniye sürebilir. Daha gelişmiş zamanlama kontrolleri için, PDF oluşturmayı geciktirmek üzere WaitFor kullanma kılavuzumuza bakın.

Örneğimiz için Mapbox'ın GeoJSON Katmanı'ndan bir örnek render edelim:

: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 Anlamak

WebGL işleme, ana işlem ile GPU işlemleri arasındaki paylaşılan belleğe dayandığından, SingleProcess yapılandırması çok önemlidir. Chrome çoklu işlem modunda (varsayılan), GPU işlemleri, PDF yakalama gerçekleşmeden önce uygun şekilde tamamlanmayabilir. Tek işlem modunu zorlayarak, tüm render işlemlerinin ardışık olarak tamamlanmasını sağlarız.

Donanım GPU modu, Chrome'un donanım hızlandırma özelliklerini etkinleştirir. Bu ayar olmadan, Chrome yazılım render etmeye geçer ve WebGL' in gelişmiş grafik özelliklerini, gölgelendiriciler, dokular ve 3D dönüşümleri gibi, uygun şekilde ele alamaz. Render seçenekleri hakkında daha fazla ayrıntı için kapsamlı render seçenekleri kılavuzumuzu inceleyin.

Render Edilmiş WebGL PDF Ne Görünür?

Ortaya çıkan PDF, WebGL içeriğini render anında yakalar ve 3D grafiklerin, harita görselleştirmelerinin ve karmaşık gölgelendirici efektlerinin görsel durumunu korur. Etkileşimli özellikler statik PDF formatında kaybolurken, görsel doğruluk yüksek kalır ve bu da onu belgeler, raporlar ve arşivleme amacı için uygun kılar.

Sık Kullanılan WebGL Render Senaryoları

WebGL render etme özellikle aşağıdaki durumlar için faydalıdır:

  1. Coğrafi Görselleştirmeler: 3D arazi ile haritaları, hava durumu katmanlarını veya coğrafi veri görselleştirmelerini yakalayın
  2. Veri Panoları: Etkileşimli 3D grafik ve çizelgeleri 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 ötesinde, JavaScript yoğun içeriği ele almak için JavaScript'ten PDF'ye dönüştürme kılavuzumuzu inceleyin.

Docker Sınırlamaları ve Çözümleri

Şu anda Docker yapılandırmasında WebGL render etmek mümkün değil. Docker'da WebGL render etmek zordur, çünkü Docker kapsayıcıları tipik olarak grafik kullanıcı arayüzü (GUI) olmayan başsız ortamlardır. WebGL, grafik render etmek için GPU'ya erişime dayanır ve başsız bir ortamda GPU erişimi sınırlı veya yoktur.

Geliştiricilerimiz hala bu olasılığı araştırıyor. IronPDF'i WebGL desteğiyle dağıtmanız gerekiyorsa, şu seçenekleri değerlendirin:

  1. VM veya özel sunucu kullanma konteynerler yerine
  2. Bir mikroservis mimarisi uygulama, burada WebGL renderlaması GPU'lu bir ana bilgisayarda gerçekleşir
  3. WebGL içeriğini önceden renderlama mümkün olduğunda statik görüntüler olarak

WebGL gereklilikleri olmadan standart Docker dağıtımları için Docker kurulum kılavuzumuzu inceleyin. Docker WebGL desteği ile ilgili sonuç belirlendiğinde bilgilendirilmek isterseniz, lütfen support@ironsoftware.com adresiyle iletişime geçin.

WebGL Render Sorun Giderme

WebGL render etme ile ilgili sorunlar yaşıyorsanız:

  1. GPU varlığını doğrulama: Sisteminizde uyumlu bir GPU ve güncellenmiş sürücüler olduğundan emin olun
  2. Chrome bağımlılıklarını kontrol edin: WebGL belirli Chrome bileşenlerini gerektirir. Chrome bağımlılıkları sorun giderme rehberimizi görün
  3. Render gecikmelerini ayarlayın: Karmaşık WebGL sahneleri daha uzun gecikmelere ihtiyaç duyabilir. Değerleri 3000-10000 milisaniye arasında deneyin
  4. Bellek kullanımını izleyin: WebGL renderlaması bellek tüketici olabilir. Yeterli sistem kaynakları olduğundan emin olun

Kalıcı sorunlar için performans optimizasyon kılavuzumuza veya mühendislik destek talebi sunun.

Gelişmiş WebGL Render Teknikleri

Daha karmaşık WebGL senaryoları için, IronPDF'in render yeteneklerini ek seçeneklerle birleştirin:

  • Özel görünüm boyutları: WebGL içeriklerinin belirli kısımlarını yakalamak için görünüm ve yakınlaştırma ayarlarını kullanın
  • Çoklu sayfa yakalamaları: Büyük WebGL görselleştirmeleri için, birden fazla görünüm yakalamayı ve PDF'leri birleştirmeyi düşünün
  • Son işleme: Grafik ağırlıklı PDF dosyalarının boyutlarını küçültmek için sıkıştırma uygulayın

Başka neler yapabileceğinizi görmek için hazır mısınız? Eğitim sayfamıza buradan göz atın: Ek Özellikler. HTML'den PDF'ye daha fazla yetenekler keşfetmek için kapsamlı HTML'den PDF öğreticimizi inceleyin.

Sıkça Sorulan Sorular

WebGL nedir ve PDF'e dönüştürülmesi neden zordur?

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

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: Chrome'un tüm işlemleri mevcut işlemde gerçekleştirmesini zorlamak için SingleProcess = true olarak ayarlayın ve donanım hızlandırmayı etkinleştirmek için ChromeGpuMode = Hardware olarak ayarlayın. Bu ayarlar, WebGL içeriğini işlemek için uygun GPU erişimini sağlar.

Hangi tür WebGL siteleri PDF olarak işlenebilir?

IronPDF, Mapbox ve WebGL Örnekleri koleksiyonu gibi harita hizmetleri dahil çeşitli WebGL sitelerini işleyebilir. Kütüphanenin Chrome İşleme Motoru, statik PDF formatında korunan karmaşık 3D görselleştirmeler, gölgelendiriciler ve etkileşimli grafikleri işler.

WebGL'den PDF'e dönüştürürken neden bir işleme gecikmesi gereklidir?

WebGL içeriği dönüştürülürken bir işleme gecikmesi önerilir çünkü bu grafikler genellikle tamamen yüklenip işlenmek için ek zaman gerektirir. IronPDF, PDF oluşturma başlamadan önce WebGL içeriğinin tamamen işlenmesini sağlamak için WaitFor.RenderDelay() ayarlamanıza izin verir.

WebGL'den PDF'e işleme için minimal iş akışı nedir?

Minimal iş akışı 5 adım içerir: 1) IronPDF C# Kütüphanesi'ni indirin, 2) SingleProcess özelliğini true olarak ayarlayın, 3) ChromeGpuMode'u Hardware olarak değiştirin, 4) Uygun işleme için bir gecikme uygulayın ve 5) WebGL sayfasını dönüştürmek ve sonucu kaydetmek için RenderUrlAsPdf() kullanın.

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

Evet, IronPDF'in Chrome İşleme Motoru, WebGL web sitelerinden karmaşık 3D görselleştirmeleri, gölgelendiricileri ve etkileşimli grafikleri yakalayabilir ve koruyabilir. Donanım hızlandırma desteği, GPU'da işlenen içeriğin dönüştürme süreci sırasında doğru bir şekilde yakalanmasını sağlar.

Curtis Chau
Curtis Chau
  Mühendislik ekibiyle şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapı...

Daha Fazla Oku
Başlamaya Hazır mısınız?
Nuget İndirmeler 19,014,616 | Sürüm: 2026.5 just released
Still Scrolling Icon

Hâlâ Kaydırıyor Musunuz?

Hızlıca kanıt ister misiniz? PM > Install-Package IronPdf
bir örnek çalıştır HTML'nizi bir PDF'ye dönüştüğünü izleyin.