Bloom
Bloom ist eine Kamera-/Display-Reaktion auf helle HDR-Signale. Lehre es als Einen Node-Pipeline-Effekt, der von der autorierten Szenenluminanz gespeist wird, nicht als die einzige sichtbare Form eines Objekts oder Effekts.
Architektur zuerst
Der Produktionspfad ist der aktuelle Three.js WebGPURenderer aus three/webgpu,
TSL aus three/tsl, RenderPipeline, pass(), mrt({ output, emissive }),
und BloomNode aus bloom().
Baue selektives Bloom aus dem Szenen-Pass-MRT-Emissionsausgabe:
Szenen-Pass mit MRT output + emissive
-> Szenen-Farb-Texture-Node
-> Emissionsbeitrags-Texture-Node
-> bloom(emissive).setResolutionScale(...)
-> Szenenfarbe + bloom
-> Einzelner renderOutput / outputColorTransform-Eigentümer
Dies ist die Top-Level-Architektur für diesen Skill: Ein einziger Szenen-Render, direkter MRT-selektiver Beitrag, HDR-Signal bis zur finalen Ausgabe-Transformation erhalten, und passweise Auflösungsskalierung für die teure Unschärfearbeit.
Lies references/hdr-bloom-system.md für das r185-Ära WebGPU/TSL-Skelett, Fähigkeiten-Gate, Qualitätsstufen, Budgets, Farbenregeln, Diagnostik und Ersetzungshinweise.
Kanonisches WebGPU/TSL-Beispiel: examples/node-selective-bloom/.
Arbeitsablauf
- Führe
$threejs-choose-skillsPreflight aus, wenn Bloom Teil einer größeren Bildpipeline ist. - Autorisiere Emissionsbeiträge mit
NodeMaterial-Materialien und leite sie zum MRTemissive. - Speise
BloomNodeaus dem Emissions-Texture-Node, nicht aus einem separaten Szenen-Render. - Stimme
strength,radius,threshold,smoothWidthundsetResolutionScale()im Pre-Tone-Map-HDR ab. - Behalte genau einen Tone-Map- und Ausgabe-Konvertierungseigentümer.
- Validiere Basis-, Emissionsbeitrags-, Bloom-only- und finale Ausgabe-Ansichten mit Desktop-diskreten, Desktop-integrierten und mobilen Budgets.
Fähigkeiten-Gate
Jede Implementierung, die MRT- oder Speicherressourcen verwendet, muss nach der Renderer-Initialisierung ein Tor haben:
await renderer.init();
if ( renderer.backend.isWebGPUBackend !== true ) {
throw new Error(
'WebGPU-Backend erforderlich für threejs-bloom. Wenn der Benutzer explizit fragt, wie ein Fallback anzuwenden ist, wenn WebGPU nicht verfügbar ist, leite zu threejs-compatibility-fallbacks weiter.'
);
}
// WebGPU-Stufen können bloomScale, pixelRatioCap, Beitragszähler reduzieren oder
// Bloom deaktivieren, während eine lesbare Basisszene erhalten bleibt.
Legacy-WebGL-Implementierung (veraltet, nicht erweitern): Keine in diesem Skill-Ordner; explizite Fallback-Anfragen werden an $threejs-compatibility-fallbacks weitergeleitet.
Fehlerbedingungen
- Bloom erzeugt die einzige sichtbare Form eines Effekts;
- gewöhnliche Albedo- oder beleuchtete Oberflächen lecken in das Emissionsbeitragsziel;
- alle hellen Materialien teilen sich einen willkürlichen Emissionsmultiplikator;
- Threshold wird nach Tone Mapping oder Display-Konvertierung eingestellt;
- mehrere Systeme besitzen Tone Mapping oder Ausgabe-Farbkonvertierung;
- der Bloom-Pass läuft standardmäßig in voller Auflösung auf bandbreitenbegrenzten Geräten;
- Größenänderungs-Pfade lassen
setSize()oder Auflösungsskalen-Validierung aus; - Spitzen werden grau, weil HDR-Energie vor Bloom abgeschnitten wird.
Routing-Grenze
Verwende $threejs-exposure-color-grading für Belichtungsmessung, Anpassung, Tone Mapping und LUTs. Verwende $threejs-image-pipeline, wenn Bloom Tiefe, Normalen, AO, TAA oder andere Bildraum-Ressourcen teilen muss. Verwende $threejs-visual-validation für Fixansicht-Pass-Diagnostik und GPU-Zeitmessungsnachweise.