Bloom
Bloom est une réponse de la caméra/affichage à un signal HDR lumineux. Traitez-le comme un effet de pipeline de nœud unique alimenté par la luminance de scène créée, et non comme la seule forme visible d'un objet ou d'effets.
Architecture d'abord
Le chemin de production est le dernier WebGPURenderer de Three.js depuis three/webgpu, TSL depuis three/tsl, RenderPipeline, pass(), mrt({ output, emissive }) et BloomNode depuis bloom().
Construisez un bloom sélectif à partir de la sortie MRT emissive du passage de scène :
passage de scène avec sortie MRT + emissive
-> nœud de texture de couleur de scène
-> nœud de texture de contribution emissive
-> bloom(emissive).setResolutionScale(...)
-> couleur de scène + bloom
-> un seul propriétaire renderOutput / outputColorTransform
C'est l'architecture de premier ordre pour cette compétence : un rendu de scène, contribution sélective directe MRT, signal HDR préservé jusqu'à la transformation de sortie finale, et mise à l'échelle de résolution par passage pour le travail coûteux de flou.
Lisez references/hdr-bloom-system.md pour le squelette WebGPU/TSL de l'ère r185, la porte de capacité, les niveaux de qualité, les budgets, les règles de couleur, les diagnostics et les notes de remplacement.
Exemple canonique WebGPU/TSL : examples/node-selective-bloom/.
Workflow
- Exécutez
$threejs-choose-skillsen pré-vérification lorsque bloom fait partie d'un pipeline d'images plus large. - Créez une contribution emissive avec des matériaux
NodeMaterialet acheminez-la vers MRTemissive. - Alimentez
BloomNodeà partir du nœud de texture emissive, pas à partir d'un rendu de scène séparé. - Réglez
strength,radius,threshold,smoothWidthetsetResolutionScale()en HDR avant la carte tonale. - Gardez exactement un propriétaire de carte tonale et de conversion de sortie.
- Validez les vues de base, de contribution emissive, de bloom seul et de sortie finale aux budgets de bureau-discrète, bureau-intégrée et mobile.
Porte de capacité
Toute implémentation utilisant MRT ou des ressources de stockage doit passer par une porte après l'initialisation du rendu :
await renderer.init();
if ( renderer.backend.isWebGPUBackend !== true ) {
throw new Error(
'Le backend WebGPU est requis pour threejs-bloom. Si l'utilisateur demande explicitement comment appliquer un repli lorsque WebGPU n'est pas disponible, acheminez vers threejs-compatibility-fallbacks.'
);
}
// Les niveaux WebGPU peuvent réduire bloomScale, pixelRatioCap, le nombre de contributeurs, ou
// désactiver bloom tout en préservant une scène de base lisible.
Implémentation WebGL héritée (obsolète, ne pas étendre) : aucune dans ce dossier de compétence ; les demandes de repli explicites sont acheminées vers $threejs-compatibility-fallbacks.
Conditions d'échec
- bloom crée la seule forme visible d'un effet ;
- l'albédo ordinaire ou les surfaces éclairées fuient dans la cible de contribution emissive ;
- tous les matériaux brillants partagent un seul multiplicateur d'émission arbitraire ;
- le seuil est réglé après la carte tonale ou la conversion d'affichage ;
- plusieurs systèmes possèdent la carte tonale ou la conversion de couleur de sortie ;
- le passage bloom s'exécute en pleine résolution par défaut sur des appareils à bande passante limitée ;
- les chemins de redimensionnement omettent
setSize()ou la validation de l'échelle de résolution ; - les hautes lumières deviennent grises car l'énergie HDR est écrasée avant bloom.
Frontière de routage
Utilisez $threejs-exposure-color-grading pour la mesure, l'adaptation, la carte tonale et les LUTs. Utilisez $threejs-image-pipeline lorsque bloom doit partager la profondeur, les normales, l'occlusion ambiante, l'anti-aliasing temporel ou d'autres ressources d'espace d'image. Utilisez $threejs-visual-validation pour les diagnostics de passage à vue fixe et les preuves de temps GPU.