Les cartes interactives, les tableaux de bord 3D et les visionneuses de modèles construits avec WebGL sont magnifiques dans un navigateur, mais les parties prenantes ont souvent besoin d'une version fixe et partageable : une capture de carte dans un rapport, un design 3D dans un dossier d'approbation, un résultat de simulation dans une archive. IronPDF capture le contenu WebGL accéléré par GPU sous forme de PDF statique en C#, préservant l'état visuel de la scène au moment où elle est rendue.

Le problème d'entreprise

Un outil logistique montre des itinéraires sur une carte Mapbox, une application immobilière affiche un terrain en 3D, une application d'ingénierie rend un modèle CAO dans le navigateur. Chacune nécessite une version PDF pour un rapport, un dossier, ou un destinataire qui n'a pas accès à l'application en direct. Une capture d'écran normale est de mauvaise qualité et manuelle, et le rendu standard de HTML en PDF ne capture pas WebGL, qui dépend du GPU.

Configuration du Rendu

La capture WebGL nécessite trois réglages : le mode mono-processus, le mode GPU matériel, et un délai pour que la scène finisse de rendre avant la capture.

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");

Le résultat capture la carte, le graphique ou le modèle exactement tel qu'il apparaissait, adapté pour la documentation, les rapports et l'archivage.

Points à planifier

Cette fonctionnalité impose des exigences environnementales réelles, qui décident si elle convient à un déploiement donné.

• Un GPU réel est requis : Le mode GPU matériel est obligatoire. Le rendu logiciel ne peut pas gérer les shaders, les textures et les transformations 3D, donc l'hôte a besoin d'un GPU compatible avec des pilotes à jour.
• Docker n'est pas pris en charge : Le rendu WebGL ne fonctionne pas dans les conteneurs Docker standard, qui sont sans affichage avec un accès limité au GPU. Les solutions de contournement sont un serveur VM ou dédié avec GPU activé, un microservice fonctionnant sur un hôte GPU, ou le pré-rendu des scènes en images statiques.
• La sortie est une capture : Le PDF préserve l'état visuel au moment du rendu. Le panoramique, le zoom et d'autres interactivités ne sont pas conservés, c'est pourquoi ceci convient pour la documentation et l'archivage plutôt que pour une diffusion interactive.
• Ajuster le délai de rendu : Les scènes complexes nécessitent du temps de chargement. Des valeurs entre 3 000 et 10 000 millisecondes sont une plage raisonnable à tester, car trop court coupe le rendu et trop long gaspille du temps.
• Le mode mono-processus est global : Il est requis ici mais affecte la concurrence, ce qui vaut la peine d'évaluer dans un service à fort volume.

Résultat

Avec le mode GPU activé et un hôte approprié, les équipes transforment les cartes WebGL, tableaux de bord et modèles 3D en PDF statiques qui s'intègrent dans les rapports et les archives. La configuration complète et les étapes de dépannage se trouvent dans le guide de rendu WebGL.