Moteur cinématographique WebGL
Implémentation de référence : templates/event-horizon/js/blackhole.js (≈1 300 lignes, zéro dépendance).
Lisez-la, réutilisez-la. Le pipeline ci-dessous est validé sur les GPU de bureau et les téléphones de milieu de gamme.
1. Pipeline d'image (respecter cet ordre exact)
- Passe de scène → cible
rawRGBA16F à une résolution interne dynamique (viewport seulement — jamais réallouer). Sous-pixel Halton(2,3) jitter sur la projection, cycle de 8 trames. - Résolution TAA → ping-pong d'historique. Clamp de voisinage 3×3 dans l'espace mappé de tons
(
c/(1+luma)), blend0,86 − motion*6, floor 0,3. Réinitialiser l'historique lors d'un changement d'échelle ou de scène. Élimine le scintillement des étoiles, le shimmer, les marches d'escalier et permet d'utiliser 30 à 50 % d'échantillons en moins. - Suréchantillonnage à la résolution complète du canvas avec un léger sharpen 4-tap (
0,08 + 0,35*(1−scale)). - Bloom : chaîne de 6 mipmaps. Premier downsample = filtre CoD 13-tap avec moyenne de Karis + seuil soft-knee (~1,6–1,8 HDR) ; upsample = tente 9-tap, additif. Quantité 0,05–0,08. Ne jamais bloomer l'interface.
- Composite : petite CA (≤ 0,004 — plus étale les étoiles), exposition ~0,95–1,05, ACES fitted, gamma, vignette 0,7–1,0, grenaille triangulaire 0,025 (dither aussi le banding 8-bit), fondu optionnel.
Cibles de rendu RGBA16F quand EXT_color_buffer_float existe, sinon RGBA8. Triangle plein écran, pas de quad.
2. Règles de performance qui comptent plus que tout
- Piège de compilation Windows/ANGLE : D3D déroule les boucles et inline tout → temps de link 7 s+.
Ajoutez
uniform int uZero;(toujours 0) et écrivez chaque boucle commefor(int i=uZero; i<N; i++). Mesuré : temps de link du shader de trou noir de 7 s → 0,9 s. - KHR_parallel_shader_compile : lancez tous les
linkProgramimmédiatement, interrogezCOMPLETION_STATUS_KHRavecsetTimeout(rAF se met en pause dans les onglets cachés), attendez seulement les programmes dont la première scène a besoin. Compilez les scènes ultérieures en arrière-plan. - Cuisez ce qui ne bouge pas : ciels directionnels (nébuleuses, galaxies lointaines, Voie lactée vue de l'intérieur) → cubemap une fois au chargement (384–768 px/face). Le fbm par pixel est le coût GPU n°1.
- Résolution dynamique : mesurez le temps moyen par trame toutes les 0,6 s ; >19,5 ms → échelle −0,06 et fixez un plafond (scale−0,02) pour éviter les oscillations ; <17,6 ms pendant 4 fenêtres → +0,04. Plage 0,42–1,0.
- Limite de pixels :
maxPixels3,2 MP bureau, 1,0 MP téléphone ; plafond DPR 1,5 bureau / 1,25 téléphone. - Pas d'allocations par trame en JS ; pas de lectures de layout dans la boucle d'image (mettre en cache les décalages lors du redimensionnement).
- Mettre en pause sur
visibilitychange; gérerwebglcontextlost(preventDefault) /restored(recharger). - Échauffement : rendre 2–3 trames de la première scène derrière le loader,
gl.finish(), puis révéler.
3. Recettes de raymarching
Trou noir (Schwarzschild, rs = 1) — intégrer les chemins de photons avec Verlet de vitesse :
a = −1,5·h²·p/r⁵, h = |p × v|, pas dt = clamp(0,075·r, 0,008, 2,6), premier pas jitteré par
bruit de gradient entrelacé. Capturer à r < 1 ; s'échapper quand r > far et se déplace vers l'extérieur.
Disque mince : détecter le changement de signe de y, interpoler le croisement, composition alpha de l'avant vers l'arrière.
Ombrage du disque → voir space-realism §Trou noir. 220 pas bureau, 150 téléphone.
Volumes (galaxie, nébuleuse, nuages) : intersecter une dalle/une sphère englobante, marcher 36 (bureau) /
24 (téléphone) échantillons avec espacement quadratique t = t0 + (t1−t0)·f² (dense près de l'œil),
jitteré par pixel et par trame ; accumuler col += T·emission·dt; T *= exp(−extinction·dt);
sortie anticipée à T < 0,02. Le TAA transforme le bruit en gradients lisses.
Champs d'étoiles 3D avec vrai parallaxe : 3D-DDA à travers des cellules de grille (22 pas), une étoile hachée par cellule, luminosité ∝ 1/t² (clampée), empreinte Gaussienne ≥ 0,75 px, densité issue de la distribution de masse de la scène. Réduire la taille de cellule avec le niveau de zoom pour que les étoiles défilent toujours.
Objets analytiques (planètes, anneaux, lunes) : sph() rayon–sphère, anneau = impact plan + bande de rayon,
ombres par un second rayon vers la lumière. Moins cher et plus net que les maillages pour les sphères.
4. Mondes multi-échelles transparents (galaxie → planète sans coupure)
Float32 ne peut pas contenir « galaxie » et « planète » dans un seul système de coordonnées. Utilisez deux trames qui
partagent la même orientation de caméra : unités galactiques et unités système avec K = 1e5.
Calculez les deux positions de l'œil en doubles JS : eyeS = (eyeG − sunG)·K. Rendre la galaxie
depuis eyeG, les planètes depuis eyeS. Au loin, le soleil est un point semblable à une étoile dont le flux suit
(angularRadius/pixel)² — il devient naturellement le disque résolu. Fondre la galaxie volumétrique
en un véritable panorama (ou cube cuit) une fois à l'intérieur. Résultat : un zoom ininterrompu de 10⁸×.
5. Textures
- Cartes équirectangulaires échantillonnées avec
eqUV(n) = (0,5 + atan(n.z,n.x)/2π, 0,5 − asin(n.y)/π). - Pas de couture : utilisez
textureLodavec un LOD analytique issu de l'empreinte du pixel (log2(texW·0,159·pixAng·t/R/μ) − 0,5), jamaistexture()avec des dérivées dans les branches. - Téléchargez une texture par trame depuis une file d'attente (décodage hors thread avec
createImageBitmap),SRGB8_ALPHA8pour la couleur,RGBA8pour les données (nuages, alpha), mipmaps + anisotropy 8×. - Liez un dummy 1×1 à chaque sampler jusqu'à l'arrivée de la vraie texture (évite les erreurs de conflit de type).
- Relief à partir d'une photo : différences finies de la luminance de l'albedo → perturber la normale (k≈5 rocheux, ≈1 gazeux).
6. Port Three.js (quand l'utilisateur insiste)
Mêmes règles : WebGLRenderer({antialias:false, powerPreference:'high-performance'}),
EffectComposer avec cibles HalfFloat, votre propre TAA ou TAARenderPass, UnrealBloomPass
(threshold ≥ 1,5, strength ≤ 0,6), OutputPass avec ACES. Effets de raymarching plein écran comme un
ShaderMaterial sur un triangle plein écran. Ne pas mélanger 50 maillages + post FX sur les téléphones.
7. Harness de débogage (à livrer, caché derrière ?debug)
Exposez window.__engine. Chronométrez une scène : rendre une fois, gl.finish(), rendre ×4, readPixels
1 px pour forcer la synchronisation, diviser. Détectez les NaN par readPixels(FLOAT) sur les cibles — un pixel NaN
se propage dans le bloom et noircit toute l'image. Sources courantes de NaN : pow(neg, x),
smoothstep(e,e,x), Inf dans ACES. Clamper les entrées.