Bloom
Bloom(泛光)是攝影機/顯示器對明亮 HDR 訊號的反應。請將其視為一個由場景亮度驅動的節點管線效果,而非物體或效果的唯一可見形式。
架構優先
生產路徑使用最新的 Three.js WebGPURenderer(來自 three/webgpu)、TSL(來自 three/tsl)、RenderPipeline、pass()、mrt({ output, emissive }),以及來自 bloom() 的 BloomNode。
透過場景傳遞的 MRT emissive 輸出來建立選擇性泛光:
scene pass with MRT output + emissive
-> scene color texture node
-> emissive contribution texture node
-> bloom(emissive).setResolutionScale(...)
-> scene color + bloom
-> single renderOutput / outputColorTransform owner
這是本技能的最高層級架構:一次場景渲染、直接的 MRT 選擇性貢獻、HDR 訊號保留至最終輸出轉換,以及針對昂貴模糊工作的逐通道解析度縮放。
請閱讀 references/hdr-bloom-system.md 以了解 r185 時代的 WebGPU/TSL 骨架、能力閘、品質分級、預算、色彩規則、診斷與替代方案說明。
標準 WebGPU/TSL 範例:examples/node-selective-bloom/。
工作流程
- 當泛光屬於較大影像管線的一部分時,執行
$threejs-choose-skills前檢查。 - 使用
NodeMaterial材質建立 emissive 貢獻,並將其路由至 MRTemissive。 - 從 emissive 紋理節點(而非單獨的場景渲染)饋送
BloomNode。 - 在色調映射前的 HDR 空間中調整
strength、radius、threshold、smoothWidth與setResolutionScale()。 - 維持剛好一個色調映射與輸出轉換擁有者。
- 分別在桌上型獨立顯卡、桌上型整合顯卡與行動裝置的預算限制下,驗證基礎場景、emissive 貢獻、僅泛光與最終輸出等四個視圖。
能力閘
任何使用 MRT 或儲存資源的實作,必須在渲染器初始化之後進行能力檢查:
await renderer.init();
if ( renderer.backend.isWebGPUBackend !== true ) {
throw new Error(
'WebGPU backend required for threejs-bloom. If the user explicitly asks how to apply fallback when WebGPU is unavailable, route to threejs-compatibility-fallbacks.'
);
}
// WebGPU 分級可能降低 bloomScale、pixelRatioCap、貢獻者數量,或
// 停用泛光但保留可讀的基礎場景。
舊版 WebGL 實作(已棄用,請勿擴展):此技能資料夾中沒有;明確的降級請求請路由至 $threejs-compatibility-fallbacks。
失敗條件
- 泛光成為效果的唯一可見形式;
- 一般反照率或光照表面洩漏至 emissive 貢獻目標;
- 所有明亮材質共享一個任意的自發光乘數;
- 在色調映射或顯示轉換之後調整 threshold;
- 多個系統擁有色調映射或輸出色彩轉換;
- 在某些頻寬有限的裝置上,泛光通道預設以全解析度運行;
- resize 路徑遺漏
setSize()或解析度縮放驗證; - 因為 HDR 能量在泛光之前被截斷,導致高光變成灰色。
路由邊界
使用 $threejs-exposure-color-grading 進行測光、適應、色調映射與 LUT。當泛光需要與深度、法線、AO、TAA 或其他影像空間資源共用時,使用 $threejs-image-pipeline。對於固定視圖通道診斷與 GPU 時間證據,使用 $threejs-visual-validation。