Communitygithub.com

Bloom(ブルーム)

高輝度HDR信号に対するカメラ/ディスプレイ応答であるブルームを実装するためのエキスパートスキル。Three.js WebGPU/TSL、MRT、BloomNodeを用いた選択的ブルームパイプラインを提供します。

Bloom(ブルーム) とは?

このスキルは、Three.jsのWebGPUレンダラーとTSL(Three.js Shading Language)を活用した、プロダクション品質の選択的ブルーム(Bloom)効果を実装するための詳細なガイドです。ブルームは単なるポストプロセスエフェクトではなく、シーンの輝度情報をHDR信号として保持し、MRT(Multiple Render Targets)のemissive出力からBloomNodeを介して正確に合成するアーキテクチャが求められます。スキルは、`WebGPURenderer`、`RenderPipeline`、`pass()`、`mrt()`、`BloomNode`の具体的な連携方法を説明し、解像度スケーリングや品質段階の設定、診断手法を提供します。対応プラットフォームはClaude Code、Codex、Cursorなどのスキル対応エージェントで、Three.js r185以降のWebGPU環境が前提です。レガシーWebGL実装は対象外で、互換性が必要な場合は別スキルにルーティングします。

対応✓Claude Code✓Codex CLI✓Cursor
npx skills add linegel/threejs-complete-set-of-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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/。

ワークフロー

  1. ブルームがより大きな画像パイプラインの一部である場合は、$threejs-choose-skills プリフライトを実行します。
  2. NodeMaterial マテリアルを使用して emissive コントリビューションをオーサリングし、MRT emissive にルーティングします。
  3. BloomNode を別のシーンレンダリングからではなく、emissive テクスチャノードから供給します。
  4. トーンマップ前の HDR で strength、radius、threshold、smoothWidth、および setResolutionScale() を調整します。
  5. トーンマップと出力変換の所有者は1つだけにします。
  6. ベース、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 を使用します。

関連スキル