Mapas interactivos, paneles 3D y visores de modelos construidos con WebGL se ven geniales en un navegador, pero a menudo los interesados necesitan una versión fija y compartible: una instantánea del mapa en un informe, un diseño 3D en un paquete de aprobación, un resultado de simulación en un archivo. IronPDF captura contenido WebGL acelerado por GPU como un PDF estático en C#, preservando el estado visual de la escena al momento de renderizar.

El problema empresarial

Una herramienta de logística muestra rutas en un mapa de Mapbox, una aplicación inmobiliaria despliega terreno 3D, una aplicación de ingeniería renderiza un modelo CAD en el navegador. Cada uno necesita una versión PDF para un informe, un registro o un destinatario que no tiene acceso a la aplicación en vivo. Una captura de pantalla normal es de baja calidad y manual, y la renderización estándar de HTML a PDF no captura WebGL, que depende de la GPU.

Configurando el Renderizado

La captura de WebGL necesita tres configuraciones: modo de proceso único, modo GPU de hardware, y un retraso para que la escena termine de renderizar antes de capturar.

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

El resultado captura el mapa, gráfico o modelo exactamente como apareció, adecuado para documentación, informes y archivo.

Puntos a planificar

Esta característica conlleva requisitos reales del entorno, quienes deciden si se adapta a una implementación dada.

• Se requiere una GPU real: El modo GPU de hardware es mandatorio. La renderización de software no puede manejar shaders, texturas y transformaciones 3D, así que el anfitrión necesita una GPU compatible con controladores actuales.
• Docker no es compatible: La renderización WebGL no funciona en contenedores Docker estándar, que son sin cabeza con acceso limitado a GPU. Las soluciones alternativas son una VM o un servidor dedicado habilitado para GPU, un microservicio ejecutándose en un anfitrión con GPU, o prerenderizar escenas a imágenes estáticas.
• La salida es una instantánea: El PDF preserva el estado visual en el momento de la renderización. No se retiene el desplazamiento, el zoom y otras interactividades, por lo que esto es adecuado para documentación y archivo en lugar de entrega interactiva.
• Ajuste el retraso de renderizado: Las escenas complejas necesitan tiempo para cargar. Valores entre 3000 y 10000 milisegundos son un rango razonable para probar, ya que demasiado corto recorta el renderizado y demasiado largo desperdicia tiempo.
• El modo de proceso único es global: Es requerido aquí pero afecta la concurrencia, lo cual vale la pena considerar en un servicio de alto volumen.

Resultado

Con el modo GPU habilitado y un anfitrión adecuado, los equipos convierten mapas WebGL en vivo, paneles y modelos 3D en PDFs estáticos que se transportan a informes y archivos. La configuración completa y los pasos de resolución de problemas están en la guía de renderizado de WebGL.