¿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)
- Pase de escena → target
rawRGBA16F 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. - Resolución TAA → ping-pong de historial. Clamping de vecindario 3×3 en espacio mapeado de tonos
(
c/(1+luma)), mezcla0.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. - Upscale a resolución completa del canvas con un suave sharpen de 4 taps (
0.08 + 0.35*(1−scale)). - 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.
- 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 comofor(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
linkPrograminmediatamente, consultaCOMPLETION_STATUS_KHRconsetTimeout(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:
maxPixels3.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; manejarwebglcontextlost(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
textureLodcon un LOD analítico desde la huella del píxel (log2(texW·0.159·pixAng·t/R/μ) − 0.5), nuncatexture()con derivadas en ramas. - Subir una textura por fotograma desde una cola (decodificar fuera del hilo con
createImageBitmap),SRGB8_ALPHA8para color,RGBA8para 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.