Bloom(ブルーム) は何をしますか?
ブルームは、明るいHDR信号に対するカメラ/ディスプレイ応答です。これを1つのノードパイプラインエフェクトとして扱い、オーサリングされたシーンの輝度に基づいて適用します。オブジェクトやエフェクトの唯一可視な形態として使用してはいけません。
アーキテクチャ優先
プロダクションパスは、three/webgpu からの最新の WebGPURenderer、three/tsl からの TSL、RenderPipeline、pass()、mrt({ output, emissive })、および bloom() からの BloomNode を使用します。
シーンパス MRT の emissive 出力から選択的ブルームを構築します:
MRT output + emissive を持つシーンパス
-> シーンカラーテクスチャノード
-> emissive コントリビューションテクスチャノード
-> bloom(emissive).setResolutionScale(...)
-> シーンカラー + bloom
-> 単一の renderOutput / outputColorTransform の所有者
これがこのスキルの最上位アーキテクチャです:1回のシーンレンダリング、直接的な MRT 選択的コントリビューション、最終出力変換まで保持される HDR 信号、および高コストなブラー処理に対するパスごとの解像度スケーリング。
詳細については、references/hdr-bloom-system.md を参照してください。r185 時代の WebGPU/TSL スケルトン、機能ゲート、品質段階、予算、カラー設定、診断、および置き換えに関する注意事項が含まれています。
正規の WebGPU/TSL 例:examples/node-selective-bloom/。
ワークフロー
- ブルームがより大きな画像パイプラインの一部である場合は、
$threejs-choose-skillsプリフライトを実行します。 NodeMaterialマテリアルを使用して emissive コントリビューションをオーサリングし、MRTemissiveにルーティングします。BloomNodeを別のシーンレンダリングからではなく、emissive テクスチャノードから供給します。- トーンマップ前の HDR で
strength、radius、threshold、smoothWidth、およびsetResolutionScale()を調整します。 - トーンマップと出力変換の所有者は1つだけにします。
- ベース、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 コントリビューションターゲットに漏れる。
- すべての明るいマテリアルが1つの任意のエミッション乗数を持つ。
- トーンマッピングまたはディスプレイ変換後にしきい値が調整される。
- 複数のシステムがトーンマッピングまたは出力カラー変換を所有する。
- ブルームパスが帯域幅制限のあるデバイスでデフォルトでフル解像度で実行される。
- リサイズパスが
setSize()または解像度スケールの検証を省略する。 - ブルーム前に HDR エネルギーがクランプされるため、ハイライトが灰色になる。
ルーティング境界
露出計測、アダプテーション、トーンマッピング、LUT には $threejs-exposure-color-grading を使用します。ブルームが深度、法線、AO、TAA、または他のイメージスペースリソースを共有する必要がある場合は、$threejs-image-pipeline を使用します。固定ビューパス診断と GPU タイミングの証拠には $threejs-visual-validation を使用します。