1. IronPDF
  2. Guides pratiques
  3. Rendre des sites WebGL
Comment rendre des sites WebGL en PDF en C#

Comment rendre des sites WebGL en C#

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

IronPDF permet le rendu de sites WebGL en PDF en configurant le mode GPU de Chrome sur Hardware et en utilisant le mode SingleProcess, ce qui vous permet de capturer des graphiques 3D dynamiques à partir de sites comme Mapbox dans des documents PDF statiques.

Webgl Logo related to Comment rendre des sites WebGL en C#

<TODO : Ajouter une image ici -->

WebGL est un outil puissant pour créer des graphiques 3D interactifs dans les navigateurs web, mais convertir ces expériences dynamiques et hautement interactives en un format PDF statique peut être difficile. Rendre un site WebGL en PDF implique de capturer le contenu visuel généré par le contexte WebGL et de le convertir en un format adapté pour un document PDF. Ce processus nécessite une configuration spécialisée pour s'assurer que les graphiques accélérés par le GPU sont correctement capturés pendant le processus de conversion HTML en PDF.

IronPDF fournit les outils nécessaires pour capturer et rendre les sites Web avec WebGL tels que Mapbox et la collection d'exemples WebGL. Contrairement au rendu HTML standard, le contenu WebGL nécessite un accès au GPU et une synchronisation adéquate entre le pipeline de rendu et la génération de PDF. Le Chrome Rendering Engine de la bibliothèque gère ces complexités, ce qui permet de préserver les visualisations 3D, les shaders complexes et les graphiques interactifs dans un format PDF statique.

comme-titre:2(Démarrage rapide: Rendre le contenu WebGL en PDF dans .NET)

Convertir des graphiques WebGL interactifs en PDF statiques à l'aide d'IronPDF for .NET C#. Ce guide vous montre comment configurer et restituer du contenu WebGL à partir de sites web. En configurant le mode GPU de Chrome sur Hardware et en activant SingleProcess, vous pouvez capturer des graphiques web dynamiques. Ces étapes permettent de transformer du contenu web 3D en documents PDF partageables.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronPDF avec le gestionnaire de packages NuGet

    PM > Install-Package IronPdf

  2. Copiez et exécutez cet extrait de code.

    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. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Flux de travail minimal (5 étapes)

  1. Télécharger la bibliothèque IronPDF C#
  2. Set the SingleProcess property to `true`
  3. Change the ChromeGpuMode property to `Hardware`
  4. Appliquer un délai avant le rendu pour assurer un rendu correct
  5. Rendre le PDF à partir de l'URL et enregistrer le résultat


Comment configurer IronPDF pour le rendu de sites WebGL?

<TODO : Ajouter une image ici -->

Pour activer le rendu WebGL, configurez ces paramètres d'IronPDF :

  • SingleProcess = true. Cela force Chrome à effectuer tout dans le processus actuel plutôt que d'utiliser des sous-processus. Cette précision est cruciale pour le rendu WebGL, car elle permet de s'assurer que toutes les opérations du GPU se déroulent dans le même contexte de processus.
  • ChromeGpuMode = Hardware. Cela permet l'accélération matérielle, permettant au GPU de rendre le contenu WebGL correctement.

En outre, si le site web nécessite un certain délai avant d'être rendu pour s'afficher correctement, utilisez la méthode WaitFor.RenderDelay. Ceci est particulièrement important pour le contenu WebGL, car les scènes 3D complexes peuvent prendre plusieurs secondes pour être entièrement chargées et rendues. Pour des contrôles de synchronisation plus avancés, consultez notre guide sur l'utilisation de WaitFor pour retarder le rendu d'un PDF.

Rendons un exemple de la couche GeoJSON de Mapbox pour notre exemple :

: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

Comprendre les options de configuration

La configuration SingleProcess est essentielle car le rendu WebGL repose sur une mémoire partagée entre le processus principal et les processus GPU. Lorsque Chrome s'exécute en mode multiprocessus (par défaut), il se peut que les opérations du GPU ne se terminent pas correctement avant que la capture du PDF ne se produise. En forçant le mode mono-processus, nous nous assurons que toutes les opérations de rendu se déroulent de manière séquentielle.

Le mode GPU matériel active les fonctions d'accélération matérielle de Chrome. Sans ce paramètre, Chrome se rabat sur le rendu logiciel, qui ne peut pas gérer correctement les fonctionnalités graphiques avancées de WebGL, telles que les shaders, les textures et les transformations 3D. Pour plus de détails sur les options de rendu, consultez notre guide complet sur les options de rendu.

<TODO : Ajouter une image ici -->

À quoi ressemble le PDF WebGL rendu?

Le PDF résultant capture le contenu WebGL au moment du rendu, préservant l'état visuel des graphiques 3D, des visualisations de cartes et des effets de shaders complexes. Bien que les fonctions interactives soient perdues dans le format PDF statique, la fidélité visuelle reste élevée, ce qui le rend adapté à la documentation, aux rapports et à l'archivage.

Scénarios de rendu WebGL courants

Le rendu WebGL est particulièrement utile pour :

  1. Visualisations géographiques : Capturer des cartes avec un terrain en 3D, des superpositions météorologiques ou des visualisations de données géographiques
  2. Tableaux de bord : Convertir des tableaux et graphiques interactifs en 3D en rapports statiques
  3. CAD et modèles 3D : Documentation de conceptions 3D et de visualisations architecturales
  4. Visualisations scientifiques : Préservation des structures moléculaires, des données astronomiques ou des résultats de simulation

Pour traiter les contenus à forte teneur en JavaScript au-delà de WebPDF, consultez notre guide sur la conversion JavaScript en PDF.

Limitations et solutions de contournement de Docker

Il n'est actuellement pas possible de rendre WebGL dans un environnement Docker. Le rendu WebGL sur Docker peut être difficile parce que les conteneurs Docker sont souvent des environnements sans interface graphique (GUI). WebGL repose sur l'accès au GPU pour rendre les graphiques, et dans un environnement sans interface graphique, l'accès au GPU est limité ou inexistant.

Nos développeurs enquêtent encore sur cette possibilité. Si vous devez déployer IronPDF avec la prise en charge de WebGL, envisagez :

  1. Utiliser une VM ou un serveur dédié au lieu de conteneurs
  2. Mise en œuvre d'une architecture de microservices dans laquelle le rendu WebGL s'effectue sur un hôte doté d'un GPU
  3. <Pré-rendu du contenu WebGL en images statiques lorsque cela est possible

Pour les déploiements Docker standard sans exigences en matière de WebGL, consultez notre guide d'installation Docker. Si vous souhaitez être informé lorsqu'une conclusion aura été trouvée concernant la prise en charge de Docker WebGL, veuillez contacter support@ironsoftware.com.

Dépannage du rendu WebGL

Si vous rencontrez des problèmes avec le rendu WebGL :

  1. Vérifier la disponibilité du GPU : assurez-vous que votre système dispose d'un GPU compatible et de pilotes mis à jour
  2. Vérifier les dépendances Chrome : WebGL nécessite des composants Chrome spécifiques. Voir notre Guide de dépannage des dépendances Chrome
  3. Adapter les délais de rendu : Les scènes WebGL complexes peuvent nécessiter des délais plus longs. Expérimentez avec des valeurs comprises entre 3000 et 10000 millisecondes
  4. Surveiller l'utilisation de la mémoire : Le rendu WebGL peut être gourmand en mémoire. Veillez à ce que les ressources du système soient suffisantes

Pour les problèmes persistants, consultez notre guide d'optimisation des performances ou soumettez une demande d'assistance technique.

Techniques avancées de rendu WebGL

Pour des scénarios WebGL plus complexes, combinez les capacités de rendu d'IronPDF avec des options supplémentaires :

  • Tailles d'affichage personnalisées : Utilisez les paramètres de visualisation et de zoom pour capturer des parties spécifiques du contenu WebGL
  • Captures de pages multiples : Pour les visualisations WebGL de grande taille, pensez à capturer plusieurs vues et à fusionner les PDF
  • Traitement ultérieur : Appliquer compression pour réduire la taille des fichiers des PDF à forte teneur en graphiques

Prêt à voir ce que vous pouvez faire d'autre? Consultez notre page de didacticiels ici : Fonctionnalités supplémentaires. Pour en savoir plus sur les fonctionnalités HTML vers PDF, explorez notre tutoriel complet HTML vers PDF.

Questions Fréquemment Posées

Qu'est-ce que WebGL et pourquoi est-il difficile de le convertir en PDF ?

WebGL est un outil puissant permettant de créer des graphiques 3D interactifs dans les navigateurs web. La conversion de WebGL en PDF est un défi car elle implique de capturer des graphiques dynamiques, accélérés par le GPU, et de les convertir dans un format statique. IronPDF relève ce défi en fournissant des options de configuration spécialisées qui permettent un accès approprié au GPU et une synchronisation entre le pipeline de rendu et la génération de PDF.

Comment activer le rendu WebGL dans IronPdf ?

Pour activer le rendu WebGL dans IronPDF, vous devez configurer deux paramètres clés : Définir SingleProcess = true pour forcer Chrome à effectuer toutes les opérations dans le processus en cours, et définir ChromeGpuMode = Hardware pour activer l'accélération matérielle. Ces paramètres garantissent un accès approprié au GPU pour le rendu du contenu WebGL.

Quels types de sites WebGL peuvent être convertis en PDF ?

IronPDF peut assurer le rendu de divers sites WebGL, notamment des services de cartographie comme Mapbox et la collection WebGL Samples. Le moteur de rendu Chrome de la bibliothèque gère les visualisations 3D complexes, les shaders et les graphiques interactifs, en les préservant au format PDF statique.

Pourquoi un délai de rendu est-il nécessaire lors de la conversion de WebGL en PDF ?

Un délai de rendu est recommandé lors de la conversion de contenu WebGL car ces graphiques nécessitent souvent plus de temps pour être complètement chargés et rendus. IronPDF vous permet de définir un WaitFor.RenderDelay() pour vous assurer que le contenu WebGL est complètement rendu avant que la génération du PDF ne commence.

Quel est le flux de travail minimal pour rendre WebGL au format PDF ?

Le flux de travail minimal comprend 5 étapes : 1) Télécharger la bibliothèque IronPDF C#, 2) Définir la propriété SingleProcess sur true, 3) Modifier ChromeGpuMode sur Hardware, 4) Appliquer un délai de rendu pour un rendu correct, et 5) Utiliser RenderUrlAsPdf() pour convertir la page WebGL et enregistrer le résultat.

IronPDF peut-il capturer des graphiques 3D complexes et des shaders à partir de WebGL ?

Oui, le moteur de rendu Chrome d'IronPDF est capable de capturer et de préserver des visualisations 3D complexes, des shaders et des graphiques interactifs à partir de sites WebGL. La prise en charge de l'accélération matérielle garantit que le contenu rendu par le GPU est correctement capturé au cours du processus de conversion.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 17,012,929 | Version : 2025.12 vient de sortir