Communitygithub.com

motor cinematográfico WebGL

Renderizado en tiempo real de calidad cinematográfica en el navegador con WebGL2 puro (o Three.js): raymarching en pantalla completa, escenas geodésicas/raytrazadas, antialiasing temporal, resolución dinámica, bloom físico, mapeo de tonos ACES, granulado, horneado de cielo, escenas multiescala y trucos de compilación de shaders para Windows/ANGLE. Úsalo para cualquier trabajo de escenas 3D/WebGL/GLSL/shader/Three.js, agujeros negros, volumetría, o cuando una escena se vea plana, con aliasing, parpadeante, lenta o 'CG'.

¿Qué es motor cinematográfico WebGL?

Este skill implementa un pipeline de renderizado de alta calidad para el navegador, diseñado para producción cinematográfica en tiempo real. Soporta WebGL2 puro y Three.js, ofreciendo técnicas avanzadas como raymarching en pantalla completa, antialiasing temporal (TAA), bloom basado en física, mapeo de tonos ACES, y un sistema de resolución dinámica que se adapta al rendimiento del dispositivo. Es especialmente útil para escenas complejas como agujeros negros, volumetría (galaxias, nebulosas), campos de estrellas con paralaje real, y mundos multiescala que van desde una galaxia hasta un planeta sin cortes. Incluye optimizaciones críticas para Windows/ANGLE que reducen drásticamente los tiempos de compilación de shaders, y un sistema de depuración integrado. El skill está basado en una implementación de referencia de ~1,300 líneas sin dependencias, y toda la lógica está detallada en el SKILL.md con órdenes precisos de pipeline, recetas de raymarching, manejo de texturas, portabilidad a Three.js y un harness de depuración. Está diseñado para funcionar en GPUs de escritorio y teléfonos de gama media.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/forpc1428-eng/cosmic-forge/tree/HEAD/skills/webgl-cinematic-engine

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace motor cinematográfico WebGL?

Implementación de referencia: templates/event-horizon/js/blackhole.js (~1300 líneas, cero dependencias). Léelo. Reutilízalo. El pipeline que sigue está probado en GPUs de escritorio y teléfonos de gama media.

1. Pipeline de fotogramas (mantener este orden exacto)

  1. Pase de escena → target raw RGBA16F a una resolución interna dinámica (solo viewport — nunca reasignar). Jitter Halton(2,3) sub-píxel en la proyección, ciclo de 8 fotogramas.
  2. Resolución TAA → ping-pong de historial. Clamping de vecindario 3×3 en espacio mapeado de tonos (c/(1+luma)), mezcla 0.86 − motion*6, piso 0.3. Reiniciar historial al cambiar escala o escena. Elimina el centelleo de estrellas, el shimmer, los escalones y permite usar 30–50 % menos muestras.
  3. Upscale a resolución completa del canvas con un suave sharpen de 4 taps (0.08 + 0.35*(1−scale)).
  4. Bloom: cadena de 6 mipmaps. Primer downsampling = filtro CoD de 13 taps con media de Karis + umbral soft-knee (~1.6–1.8 HDR); upsampling = tienda de 9 taps, aditiva. Cantidad 0.05–0.08. Nunca aplicar bloom a la UI.
  5. Composición: aberración cromática pequeña (≤ 0.004 — más mancha las estrellas), exposición ~0.95–1.05, ACES fitted, gamma, viñeta 0.7–1.0, granulado triangular 0.025 (también ditheriza el bandeado de 8 bits), fundido opcional.

Render targets RGBA16F cuando exista EXT_color_buffer_float, si no RGBA8. Triángulo en pantalla completa, no quad.

2. Reglas de velocidad que importan más que nada

  • Trampa de compilación en Windows/ANGLE: D3D desenrolla bucles y lo inlinea todo → tiempos de enlace de 7 s+. Añade uniform int uZero; (siempre 0) y escribe cada bucle como for(int i=uZero; i<N; i++). Medido: enlace de shader de agujero negro de 7 s → 0.9 s.
  • KHR_parallel_shader_compile: inicia todos los linkProgram inmediatamente, consulta COMPLETION_STATUS_KHR con setTimeout (rAF se pausa en pestañas ocultas), solo espera los programas que necesita la primera pantalla. Compila escenas posteriores en segundo plano.
  • Hornea lo que no se mueve: cielos solo direccionales (nebulosas, galaxias lejanas, Vía Láctea vista desde dentro) → cubemap una vez al cargar (384–768 px/cara). El fbm por píxel es el coste #1 de GPU.
  • Resolución dinámica: mide el ms promedio por fotograma cada 0.6 s; >19.5 ms → escala −0.06 y establece un techo (escala−0.02) para que nunca oscile; <17.6 ms durante 4 ventanas → +0.04. Rango 0.42–1.0.
  • Límite de píxeles: maxPixels 3.2 MP escritorio, 1.0 MP teléfono; tope de DPR 1.5 escritorio / 1.25 teléfono.
  • Sin asignaciones por fotograma en JS; sin lecturas de layout en el bucle de fotogramas (almacenar en caché offsets al redimensionar).
  • Pausar en visibilitychange; manejar webglcontextlost (preventDefault) / restored (recargar).
  • Calentamiento: renderizar 2–3 fotogramas de la primera escena detrás del cargador, gl.finish(), luego mostrar.

3. Recetas de raymarching

Agujero negro (Schwarzschild, rs = 1) — integrar trayectorias de fotones con Verlet de velocidad: a = −1.5·h²·p/r⁵, h = |p × v|, paso dt = clamp(0.075·r, 0.008, 2.6), primer paso jittereado por ruido de gradiente intercalado. Capturar en r < 1; escapar cuando r > far y moviéndose hacia afuera. Disco delgado: detectar cambio de signo de y, interpolar el cruce, composición alfa de frente a atrás. Sombreado del disco → ver space-realism §Agujero negro. 220 pasos escritorio, 150 teléfono.

Volúmenes (galaxia, nebulosa, nubes): intersectar una losa/caja delimitadora, marchar 36 (escritorio) / 24 (teléfono) muestras con espaciado cuadrático t = t0 + (t1−t0)·f² (denso cerca del ojo), jittereado por píxel por fotograma; acumular col += T·emisión·dt; T *= exp(−extinción·dt); salida temprana en T < 0.02. El TAA convierte el ruido en gradientes suaves.

Campos de estrellas 3D con paralaje real: DDA 3D a través de celdas de cuadrícula (22 pasos), una estrella hasheada por celda, brillo ∝ 1/t² (clampeado), huella gaussiana ≥ 0.75 px, densidad según la distribución de masa de la escena. Reducir el tamaño de celda con el nivel de zoom para que las estrellas siempre fluyan.

Objetos analíticos (planetas, anillos, lunas): sph() rayo–esfera, anillo = impacto en plano + banda de radio, sombras con un segundo rayo hacia la luz. Más barato y nítido que las mallas para esferas.

4. Mundos multiescala sin fisuras (galaxia → planeta sin corte)

Float32 no puede contener "galaxia" y "planeta" en un mismo sistema de coordenadas. Usa dos fotogramas que comparten una orientación de cámara: unidades de galaxia y unidades de sistema con K = 1e5. Calcula ambas posiciones de ojo en dobles de JS: eyeS = (eyeG − sunG)·K. Renderiza la galaxia desde eyeG, los planetas desde eyeS. Mientras esté lejos, el sol es un punto similar a una estrella cuyo flujo sigue (radioAngular/píxel)² — se convierte naturalmente en el disco resuelto. Transiciona con fundido la galaxia volumétrica a un panorama real (o cubemap horneado) una vez dentro. Resultado: un zoom ininterrumpido de 10⁸×.

5. Texturas

  • Mapas equirrectangulares muestreados con eqUV(n) = (0.5 + atan(n.z,n.x)/2π, 0.5 − asin(n.y)/π).
  • Sin costura: usar textureLod con un LOD analítico desde la huella del píxel (log2(texW·0.159·pixAng·t/R/μ) − 0.5), nunca texture() con derivadas en ramas.
  • Subir una textura por fotograma desde una cola (decodificar fuera del hilo con createImageBitmap), SRGB8_ALPHA8 para color, RGBA8 para datos (nubes, alfa), mipmaps + anisotropía 8×.
  • Enlazar un dummy 1×1 a cada sampler hasta que llegue el real (evita errores de conflicto de tipo).
  • Relieve desde una foto: diferencias finitas de la luminancia del albedo → perturbar la normal (k≈5 rocoso, ≈1 gas).

6. Puerto a Three.js (cuando el usuario insista)

Mismas reglas: WebGLRenderer({antialias:false, powerPreference:'high-performance'}), EffectComposer con targets HalfFloat, tu propio TAA o TAARenderPass, UnrealBloomPass (umbral ≥ 1.5, intensidad ≤ 0.6), OutputPass con ACES. Efectos de raymarching en pantalla completa como un ShaderMaterial sobre un triángulo en pantalla completa. No mezclar 50 mallas + post FX en teléfonos.

7. Arnés de depuración (enviarlo, oculto tras ?debug)

Exponer window.__engine. Cronometrar una escena: renderizar una vez, gl.finish(), renderizar ×4, readPixels 1 px para forzar sincronía, dividir. Detectar NaNs con readPixels(FLOAT) en los targets — un NaN se propaga por el bloom y oscurece todo el fotograma. Fuentes comunes de NaN: pow(neg, x), smoothstep(e,e,x), Inf en ACES. Clampear entradas.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills relacionados