O que Mecanismo Cinematográfico WebGL faz?
Implementação de referência: templates/event-horizon/js/blackhole.js (≈1.300 linhas, zero dependências).
Leia-a. Reutilize-a. O pipeline abaixo é comprovado em GPUs de desktop e celulares de médio porte.
1. Pipeline de quadro (mantenha esta ordem exata)
- Passo de cena → alvo
rawRGBA16F em uma resolução interna dinâmica (apenas viewport — nunca realocar). Jitter Halton(2,3) sub-pixel na projeção, ciclo de 8 quadros. - Resolução TAA → histórico ping-pong. Bloqueio de vizinhança 3×3 no espaço mapeado por tom
(
c/(1+luma)), mesclagem0.86 − motion*6, piso 0.3. Redefine histórico em mudança de escala ou troca de cena. Elimina cintilação de estrelas, brilho, serrilhados e permite usar 30–50% menos amostras. - Upscale para resolução total do canvas com um sharpen suave de 4 taps (
0.08 + 0.35*(1−scale)). - Bloom: cadeia de 6 mipmaps. Primeiro downscale = filtro CoD de 13 taps com média de Karis + threshold soft-knee (~1.6–1.8 HDR); upscale = tenda de 9 taps, aditivo. Quantidade 0.05–0.08. Nunca aplique bloom em UI.
- Composição: pequena aberração cromática (≤ 0.004 — mais mancha estrelas), exposição ~0.95–1.05, ACES ajustado, gama, vinheta 0.7–1.0, grão triangular 0.025 (também dither de bandas de 8 bits), fade opcional.
Alvos de renderização RGBA16F quando EXT_color_buffer_float existir, senão RGBA8. Triângulo em tela cheia, não quad.
2. Regras de velocidade que importam mais que qualquer coisa
- Armadilha de compilação Windows/ANGLE: D3D desenrola loops e inlineia tudo → tempos de link de 7 s+.
Adicione
uniform int uZero;(sempre 0) e escreva cada loop comofor(int i=uZero; i<N; i++). Medido: link do shader de buraco negro de 7 s → 0.9 s. - KHR_parallel_shader_compile: inicie todos os
linkProgramimediatamente, consulteCOMPLETION_STATUS_KHRcomsetTimeout(rAF pausa em abas ocultas), apenas aguarde os programas que a primeira tela precisa. Compile cenas posteriores em segundo plano. - Asse o que não se move: céus direcionais (nebulosas, galáxias distantes, Via Láctea vista de dentro) → cubemap uma vez no carregamento (384–768 px/face). Fbm por pixel é o #1 custo de GPU.
- Resolução dinâmica: meça o tempo médio do quadro a cada 0.6 s; >19.5 ms → escala −0.06 e defina um teto (scale−0.02) para que nunca oscile; <17.6 ms por 4 janelas → +0.04. Faixa 0.42–1.0.
- Limite de pixels:
maxPixels3.2 MP desktop, 1.0 MP celular; limite de DPR 1.5 desktop / 1.25 celular. - Sem alocações por quadro em JS; sem leituras de layout no loop do quadro (cache de deslocamentos no redimensionamento).
- Pause em
visibilitychange; lide comwebglcontextlost(preventDefault) /restored(recarregar). - Aquecimento: renderize 2–3 quadros da primeira cena atrás do carregador,
gl.finish(), então revele.
3. Receitas de raymarching
Buraco negro (Schwarzschild, rs = 1) — integre caminhos de fótons com Verlet de velocidade:
a = −1.5·h²·p/r⁵, h = |p × v|, passo dt = clamp(0.075·r, 0.008, 2.6), primeiro passo jittered por
ruído de gradiente intercalado. Capture em r < 1; escape quando r > far e movendo-se para fora.
Disco fino: detecte mudança de sinal em y, interpole a travessia, composição alfa de frente para trás.
Sombreamento de disco → veja space-realism §Buraco negro. 220 passos desktop, 150 celular.
Volumes (galáxia, nebulosa, nuvens): intersecte uma caixa/laje delimitadora, marche 36 (desktop) /
24 (celular) amostras com espaçamento quadrático t = t0 + (t1−t0)·f² (denso perto do olho),
jittered por pixel por quadro; acumule col += T·emissão·dt; T *= exp(−extinção·dt);
saída antecipada em T < 0.02. TAA transforma o ruído em gradientes suaves.
Campos de estrelas 3D com paralaxe real: 3D-DDA através de células de grade (22 passos), uma estrela hasheada por célula, brilho ∝ 1/t² (clamado), footprint gaussiano ≥ 0.75 px, densidade da distribuição de massa da cena. Reduza o tamanho da célula com o nível de zoom para que as estrelas sempre fluam.
Objetos analíticos (planetas, anéis, luas): sph() raio–esfera, anel = hit de plano + banda de raio,
sombras por um segundo raio em direção à luz. Mais barato e mais nítido que malhas para esferas.
4. Mundos em múltiplas escalas sem costura (galáxia → planeta sem corte)
Float32 não pode conter "galáxia" e "planeta" em um sistema de coordenadas. Use dois quadros que
compartilham uma orientação de câmera: unidades de galáxia e unidades de sistema com K = 1e5.
Calcule ambas as posições do olho em JS doubles: eyeS = (eyeG − sunG)·K. Renderize a galáxia
a partir de eyeG, os planetas a partir de eyeS. Enquanto estiver longe, o sol é um ponto parecido com estrela cujo fluxo segue
(angularRadius/pixel)² — ele se torna o disco resolvido naturalmente. Faça cross-fade da galáxia volumétrica
em um panorama real (ou cubo assado) uma vez dentro dela. Resultado: um zoom ininterrupto de 10⁸×.
5. Texturas
- Mapas equirretangulares amostrados com
eqUV(n) = (0.5 + atan(n.z,n.x)/2π, 0.5 − asin(n.y)/π). - Sem costura: use
textureLodcom um LOD analítico a partir do footprint do pixel (log2(texW·0.159·pixAng·t/R/μ) − 0.5), nuncatexture()com derivadas em branches. - Carregue uma textura por quadro de uma fila (decodifique fora da thread com
createImageBitmap),SRGB8_ALPHA8para cor,RGBA8para dados (nuvens, alfa), mipmaps + anisotropia 8×. - Vincule um dummy 1×1 a cada sampler até que o real chegue (evita erros de conflito de tipo).
- Relevo a partir de uma foto: diferenças finitas da luminância do albedo → perturbe a normal (k≈5 rochoso, ≈1 gasoso).
6. Port para Three.js (quando o usuário insistir)
Mesmas regras: WebGLRenderer({antialias:false, powerPreference:'high-performance'}),
EffectComposer com alvos HalfFloat, seu próprio TAA ou TAARenderPass, UnrealBloomPass
(threshold ≥ 1.5, strength ≤ 0.6), OutputPass com ACES. Efeitos de raymarching em tela cheia como um
ShaderMaterial em um triângulo em tela cheia. Não misture 50 malhas + pós-FX em celulares.
7. Harness de depuração (embarque, protegido por ?debug)
Exponha window.__engine. Cronometre uma cena: renderize uma vez, gl.finish(), renderize ×4, readPixels
1 px para forçar sincronização, divida. Probe NaNs por readPixels(FLOAT) em alvos — um pixel NaN
se espalha pelo bloom e escurece o quadro inteiro. Fontes comuns de NaN: pow(neg, x),
smoothstep(e,e,x), Inf no ACES. Clampe entradas.