1. IronPDF
  2. Anleitungen
  3. WebGL-Seiten rendern
Wie man WebGL-Websites zu PDFs in C# rendert

Wie rendere ich WebGL-Seiten in C#35;

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

IronPDF ermöglicht das Rendern von WebGL-Websites in PDF, indem der GPU-Modus von Chrome auf Hardware konfiguriert wird und der SingleProcess-Modus verwendet wird. So können Sie dynamische 3D-Grafiken von Websites wie Mapbox in statische PDF-Dokumente übertragen.

Webgl Logo related to Wie rendere ich WebGL-Seiten in C#35;

WebGL ist ein leistungsstarkes Werkzeug zur Erstellung interaktiver 3D-Grafiken in Webbrowsern. Die Umwandlung dieser dynamischen, hoch-interaktiven Erfahrungen in ein statisches PDF-Format kann jedoch eine Herausforderung darstellen. Das Rendern einer WebGL-Website zu PDF beinhaltet das Erfassen der visuellen Inhalte, die vom WebGL-Kontext erzeugt werden, und deren Umwandlung in ein für ein PDF-Dokument geeignetes Format. Dieser Prozess erfordert eine spezielle Konfiguration, um sicherzustellen, dass GPU-beschleunigte Grafiken während des HTML-zu-PDF-Konvertierungsprozesses richtig erfasst werden.

IronPDF bietet die Werkzeuge, die benötigt werden, um Websites mit WebGL wie Mapbox und der WebGL Samples Sammlung zu erfassen und zu rendern. Im Gegensatz zum Standard-HTML-Rendering erfordern WebGL-Inhalte den Zugriff auf den Grafikprozessor und die richtige Synchronisation zwischen der Rendering-Pipeline und der PDF-Generierung. Die Chrome Rendering Engine der Bibliothek bewältigt diese Komplexität und macht es möglich, 3D-Visualisierungen, komplexe Shader und interaktive Grafiken in einem statischen PDF-Format zu erhalten.

als-Überschrift:2(Schnellstart: WebGL-Inhalte in PDF in .NET rendern)

Konvertieren Sie interaktive WebGL-Grafiken in statische PDFs mit IronPDF in .NET C#. Dieser Leitfaden zeigt Ihnen, wie Sie WebGL-Inhalte von Websites einrichten und rendern können. Wenn Sie den Chrome GPU-Modus auf Hardware konfigurieren und SingleProcess aktivieren, können Sie dynamische Webgrafiken erfassen. Diese Schritte wandeln 3D-Webinhalte in gemeinsam nutzbare PDF-Dokumente um.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    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. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer

Minimaler Arbeitsablauf (5 Schritte)

  1. Download der IronPDF C# Bibliothek
  2. Set the SingleProcess property to `true`
  3. Change the ChromeGpuMode property to `Hardware`
  4. Verzögerung vor dem Rendern für korrektes Rendering anwenden
  5. Rendern Sie das PDF von der URL und speichern Sie das Ergebnis


Wie konfiguriere ich IronPDF für das Rendern von WebGL-Websites?

Um das WebGL-Rendering zu aktivieren, konfigurieren Sie diese IronPDF-Einstellungen:

  • SingleProcess = true. Dies zwingt Chrome, alles im aktuellen Prozess auszuführen, anstatt Unterprozesse zu verwenden. Dies ist für das WebGL-Rendering von entscheidender Bedeutung, da es sicherstellt, dass alle GPU-Operationen innerhalb desselben Prozesskontextes stattfinden.
  • ChromeGpuMode = Hardware. Dies ermöglicht die Hardware-Beschleunigung, so dass der Grafikprozessor WebGL-Inhalte richtig darstellen kann.

Wenn die Website eine gewisse Verzögerung benötigt, bevor sie richtig angezeigt wird, verwenden Sie die Methode WaitFor.RenderDelay. Dies ist besonders wichtig für WebGL-Inhalte, da komplexe 3D-Szenen mehrere Sekunden zum vollständigen Laden und Rendern benötigen können. Weitere fortgeschrittene Zeitsteuerungen finden Sie in unserem Leitfaden zur Verwendung von WaitFor zur Verzögerung des PDF-Renderings.

Lassen Sie uns ein Beispiel aus Mapbox's GeoJSON Layer für unser Beispiel rendern:

: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");
$vbLabelText   $csharpLabel

Verständnis der Konfigurationsoptionen

Die SingleProcess-Konfiguration ist wichtig, da das WebGL-Rendering auf gemeinsamem Speicher zwischen dem Hauptprozess und den GPU-Prozessen beruht. Wenn Chrome im Multiprozessmodus ausgeführt wird (Standardeinstellung), werden GPU-Vorgänge möglicherweise nicht ordnungsgemäß abgeschlossen, bevor die PDF-Erfassung erfolgt. Indem wir den Einzelprozessmodus erzwingen, stellen wir sicher, dass alle Rendering-Vorgänge sequentiell abgeschlossen werden.

Der Hardware-GPU-Modus aktiviert die Hardware-Beschleunigungsfunktionen von Chrome. Ohne diese Einstellung fällt Chrome auf das Software-Rendering zurück, das die erweiterten Grafikfunktionen von WebGL wie Shader, Texturen und 3D-Transformationen nicht richtig verarbeiten kann. Weitere Einzelheiten zu den Rendering-Optionen finden Sie in unserem umfassenden Rendering-Optionen-Leitfaden.

Wie sieht die gerenderte WebGL-PDF aus?

Die resultierende PDF-Datei erfasst den WebGL-Inhalt zum Zeitpunkt des Renderns, wobei der visuelle Zustand von 3D-Grafiken, Kartenvisualisierungen und komplexen Shader-Effekten erhalten bleibt. Während interaktive Funktionen im statischen PDF-Format verloren gehen, bleibt die visuelle Wiedergabetreue hoch, so dass es sich für Dokumentation, Berichte und Archivierungszwecke eignet.

Gängige WebGL-Rendering-Szenarien

WebGL-Rendering ist besonders nützlich für:

  1. Geografische Visualisierungen: Erfassen von Karten mit 3D-Gelände, Wetterüberlagerungen oder geografischen Datenvisualisierungen
  2. Daten-Dashboards: Konvertierung interaktiver 3D-Diagramme und Grafiken in statische Berichte
  3. CAD- und 3D-Modelle: Dokumentieren von 3D-Entwürfen und Architekturvisualisierungen
  4. Wissenschaftliche Visualisierungen: Erhaltung von Molekularstrukturen, astronomischen Daten oder Simulationsergebnissen

Für den Umgang mit JavaScript-lastigen Inhalten, die über WebGL hinausgehen, siehe unseren Leitfaden zur JavaScript-zu-PDF-Konvertierung.

Docker-Einschränkungen und Umgehungsmöglichkeiten

Es ist derzeit nicht möglich, WebGL in einer Docker-Umgebung zu rendern. Das Rendern von WebGL auf Docker kann herausfordernd sein, da Docker-Container normalerweise headless-Umgebungen sind, was bedeutet, dass sie keine grafische Benutzeroberfläche (GUI) haben. WebGL hängt vom Zugriff auf die GPU ab, um Grafiken zu rendern. In einer headless-Umgebung ist der Zugriff auf die GPU begrenzt oder nicht vorhanden.

Unsere Entwickler untersuchen diese Möglichkeit noch. Wenn Sie IronPDF mit WebGL-Unterstützung einsetzen möchten, sollten Sie dies in Betracht ziehen:

  1. Verwendung einer VM oder eines dedizierten Servers anstelle von Containern
  2. Implementierung einer Microservice-Architektur, bei der WebGL-Rendering auf einem GPU-fähigen Host stattfindet
  3. Pre-Rendering von WebGL-Inhalten in statische Bilder, wenn möglich

Für Standard-Docker-Installationen ohne WebGL-Anforderungen lesen Sie bitte unser Docker-Installationshandbuch. Wenn Sie benachrichtigt werden möchten, sobald eine Lösung für die Unterstützung von Docker WebGL gefunden wurde, kontaktieren Sie bitte support@ironsoftware.com.

Fehlerbehebung bei WebGL-Rendering

Wenn Sie Probleme mit dem Rendering von WebGL haben:

  1. Verfügbarkeit des Grafikprozessors prüfen: Stellen Sie sicher, dass Ihr System über einen kompatiblen Grafikprozessor und aktualisierte Treiber verfügt
  2. Prüfen Sie Chrome-Abhängigkeiten: Für WebGL sind bestimmte Chrome-Komponenten erforderlich. Siehe unsere Anleitung zur Fehlerbehebung bei Chrome-Abhängigkeiten
  3. Anpassen der Rendering-Verzögerungen: Komplexe WebGL-Szenen benötigen möglicherweise längere Verzögerungen. Experimentieren Sie mit Werten zwischen 3000-10000 Millisekunden
  4. Überwachung der Speichernutzung: WebGL-Rendering kann sehr speicherintensiv sein. Sorgen Sie für ausreichende Systemressourcen

Bei hartnäckigen Problemen lesen Sie bitte unseren Leitfaden zur Leistungsoptimierung oder senden Sie eine Anfrage an den technischen Support.

Fortgeschrittene WebGL-Rendering-Techniken

Für komplexere WebGL-Szenarien sollten die Rendering-Funktionen von IronPDF mit zusätzlichen Optionen kombiniert werden:

  • Benutzerdefinierte Viewport-Größen: Verwenden Sie Ansichtsfenster- und Zoomeinstellungen, um bestimmte Teile von WebGL-Inhalten zu erfassen
  • Mehrere Seitenerfassungen: Für große WebGL-Visualisierungen sollten Sie mehrere Ansichten erfassen und PDFs zusammenführen
  • Post-Processing: Wenden Sie Komprimierung an, um die Dateigröße von grafiklastigen PDFs zu reduzieren

Bereit zu sehen, was Sie sonst noch tun können? Sehen Sie sich hier unsere Tutorial-Seite an: Zusätzliche Funktionen. Mehr über die Möglichkeiten von HTML zu PDF erfahren Sie in unserem umfassenden HTML zu PDF Tutorial.

Häufig gestellte Fragen

Was ist WebGL und warum ist es schwierig, es in PDF zu konvertieren?

WebGL ist ein leistungsstarkes Werkzeug zur Erstellung interaktiver 3D-Grafiken in Webbrowsern. Die Konvertierung von WebGL in PDF ist eine Herausforderung, da dynamische, GPU-beschleunigte Grafiken erfasst und in ein statisches Format konvertiert werden müssen. IronPDF löst diese Herausforderung, indem es spezielle Konfigurationsoptionen bereitstellt, die den richtigen GPU-Zugriff und die Synchronisierung zwischen der Rendering-Pipeline und der PDF-Generierung ermöglichen.

Wie aktiviere ich das WebGL-Rendering in IronPDF?

Um das WebGL-Rendering in IronPDF zu aktivieren, müssen Sie zwei wichtige Einstellungen konfigurieren: Setzen Sie SingleProcess = true, um Chrome zu zwingen, alle Operationen im aktuellen Prozess durchzuführen, und setzen Sie ChromeGpuMode = Hardware, um die Hardwarebeschleunigung zu aktivieren. Diese Einstellungen gewährleisten einen ordnungsgemäßen GPU-Zugriff für das Rendern von WebGL-Inhalten.

Welche Arten von WebGL-Websites können im PDF-Format gerendert werden?

IronPDF kann verschiedene WebGL-Websites rendern, darunter Kartendienste wie Mapbox und die WebGL-Samples-Sammlung. Die Chrome Rendering Engine der Bibliothek verarbeitet komplexe 3D-Visualisierungen, Shader und interaktive Grafiken und speichert sie im statischen PDF-Format.

Warum ist bei der Konvertierung von WebGL in PDF eine Renderverzögerung erforderlich?

Bei der Konvertierung von WebGL-Inhalten wird eine Renderverzögerung empfohlen, da diese Grafiken oft zusätzliche Zeit benötigen, um vollständig geladen und gerendert zu werden. IronPDF ermöglicht es Ihnen, eine WaitFor.RenderDelay() zu setzen, um sicherzustellen, dass der WebGL-Inhalt vollständig gerendert wird, bevor die PDF-Generierung beginnt.

Wie sieht der minimale Arbeitsablauf für das Rendern von WebGL in PDF aus?

Der minimale Arbeitsablauf umfasst 5 Schritte: 1) Herunterladen der IronPDF C#-Bibliothek, 2) Einstellen der SingleProcess-Eigenschaft auf true, 3) Ändern des ChromeGpuMode auf Hardware, 4) Anwenden einer Renderverzögerung für das richtige Rendering und 5) Verwenden von RenderUrlAsPdf(), um die WebGL-Seite zu konvertieren und das Ergebnis zu speichern.

Kann IronPDF komplexe 3D-Grafiken und Shader von WebGL erfassen?

Ja, die Chrome Rendering Engine von IronPDF ist in der Lage, komplexe 3D-Visualisierungen, Shader und interaktive Grafiken von WebGL-Websites zu erfassen und zu erhalten. Die Unterstützung der Hardwarebeschleunigung stellt sicher, dass GPU-gerenderte Inhalte während des Konvertierungsprozesses korrekt erfasst werden.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,012,929 | Version: 2025.12 gerade veröffentlicht