Communitygithub.com

WebGL シネマティックエンジン

ブラウザ上で映画品質のリアルタイムレンダリングを実現するWebGL2(またはThree.js)スキル。フルスクリーンレイマーチング、測地線/レイトレースシーン、テンポラルアンチエイリアシング、動的解像度、物理ベースブルーム、ACESトーンマッピング、グレイン、スカイベイク、マルチスケールシーン、Windows/ANGLEのシェーダコンパイル最適化を提供。3D/WebGL/GLSL/シェーダ/Three.jsのあらゆるシーン、ブラックホール、ボリュメトリクス、またはシーンが平坦、エイリアス、ちらつき、遅い、または「CGっぽい」場合に使用。

WebGL シネマティックエンジン とは?

このスキルは、ブラウザ上で映画品質のリアルタイムレンダリングを実現するための高度なWebGL2(Three.jsも対応)パイプラインを提供します。主な特徴として、動的解像度によるパフォーマンス最適化、テンポラルアンチエイリアシング(TAA)によるノイズ除去、物理ベースのブルーム、ACESトーンマッピング、グレイン効果など、ポストプロダクション品質のビジュアル処理を順序立てて適用します。特にブラックホールのレイマーチング、ボリューメトリックレンダリング、3D星野、惑星/衛星などの解析オブジェクト、そして銀河から惑星までシームレスに遷移するマルチスケール世界を実現するための具体的な実装レシピが含まれています。パフォーマンス面では、Windows/ANGLE環境でのシェーダコンパイル時間を劇的に短縮するテクニック、動的解像度制御、アセットのベイク処理、メモリ割り当ての最小化など、実戦的な最適化手法を多数収録。Three.jsユーザ向けの移植ガイドも付属しています。シェーダコーディングからデバッグ、プロファイリングまでを網羅した、本格的なWebGLエンジニア向けのスキルです。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/forpc1428-eng/cosmic-forge/tree/HEAD/skills/webgl-cinematic-engine

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

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

ドキュメント

WebGL シネマティックエンジン は何をしますか?

リファレンス実装: templates/event-horizon/js/blackhole.js (約1,300行、依存関係ゼロ)。 それを読み、再利用してください。以下のパイプラインは、デスクトップGPUとミッドレンジの電話で実証済みです。

1. フレームパイプライン(この順序を厳守)

  1. シーンパス → 動的な内部解像度のraw RGBA16Fターゲット(ビューポートのみ、再割り当ては行わない)。 射影にサブピクセル Halton(2,3) ジッター、8フレームサイクル。
  2. TAA 解決 → 履歴ピンポン。トーンマップ空間での3×3近傍クランプ (c/(1+luma))、ブレンド 0.86 − motion*6、フロア0.3。スケール変更またはシーンスイッチ時に履歴をリセット。 星のきらめき、シャマー、階段状ノイズを除去し、サンプル数を30~50%削減可能。
  3. アップスケール → マイルドな4タップシャープン(0.08 + 0.35*(1−scale))でフルキャンバス解像度に。
  4. ブルーム: 6-ミップチェーン。最初のダウンサンプルは Karis平均 + ソフトニースレッショルド(約1.6~1.8 HDR)を備えた13タップCoDフィルター。アップサンプルは9タップテント、加算。量は0.05~0.08。UIをブルームさせない。
  5. コンポジット: 小さなCA(≤ 0.004 — これ以上は星がにじむ)、露出約0.95~1.05、ACES適合、ガンマ、ビネット0.7~1.0、三角グレイン0.025(8ビットバンディングのディザリングも兼ねる)、オプションのフェード。

レンダーターゲットは、EXT_color_buffer_floatが存在する場合はRGBA16F、それ以外はRGBA8。クアッドではなくフルスクリーントライアングル。

2. 何よりも重要な速度ルール

  • Windows/ANGLE コンパイルトラップ: D3Dはループを展開し、すべてをインライン化する → 7秒以上のリンク時間。 uniform int uZero;(常に0)を追加し、すべてのループを for(int i=uZero; i<N; i++) と記述。 実測値: ブラックホールシェーダのリンクが7秒 → 0.9秒に短縮。
  • KHR_parallel_shader_compile: すべてのlinkProgramを即座に開始し、COMPLETION_STATUS_KHRをsetTimeoutでポーリングする(rAFは非表示タブで一時停止)。最初の画面に必要なプログラムだけを待機。後続のシーンはバックグラウンドでコンパイル。
  • 動かないものをベイクする: 方向のみの空(星雲、遠方の銀河、内側から見た天の川など) → ロード時に一度キューブマップにベイク(384~768 px/面)。ピクセル単位のfbmはGPUコストの最大の原因。
  • 動的解像度: 0.6秒ごとに平均フレームミリ秒を計測。>19.5 ms → スケールを-0.06し、上限(scale−0.02)を設定して振動を防止。17.6 ms未満が4ウィンドウ続いた場合 → +0.04。範囲は0.42~1.0。
  • ピクセル上限: maxPixels デスクトップ3.2 MP、電話1.0 MP。DPR上限はデスクトップ1.5 / 電話1.25。
  • JSでフレームごとの割り当てを行わない。フレームループ内でレイアウト読み取りを行わない(リサイズ時にオフセットをキャッシュ)。
  • visibilitychangeで一時停止。webglcontextlost(preventDefault)/ restored(リロード)を処理。
  • ウォームアップ: ローダーの背後で最初のシーンを2~3フレームレンダリング、gl.finish()、その後表示。

3. レイマーチングレシピ

ブラックホール (シュワルツシルト、rs = 1) — 速度ベルレで光子経路を積分: a = −1.5·h²·p/r⁵、h = |p × v|、ステップ dt = clamp(0.075·r, 0.008, 2.6)、最初のステップはインターリーブドグラディエントノイズでジッター。r < 1で捕捉。r > farかつ外側に移動している場合に脱出。 薄い円盤: yの符号変化を検出し、交差を補間、前から後ろへのアルファコンポジット。 円盤シェーディング → space-realism §ブラックホールを参照。デスクトップ220ステップ、電話150ステップ。

ボリューム (銀河、星雲、雲): 境界スラブ/球と交差させ、二次間隔 t = t0 + (t1−t0)·f²(目に近いほど密)で36(デスクトップ)/ 24(電話)サンプルをマーチング、ピクセル/フレームごとにジッター。col += T·emission·dt; T *= exp(−extinction·dt) を累積。T < 0.02で早期終了。TAAがノイズを滑らかなグラデーションに変える。

実際の視差を伴う3D星野: グリッドセルを通る3D-DDA(22ステップ)、セルごとに1つのハッシュ化された星、輝度は∝ 1/t²(クランプ)、ガウスフットプリント ≥ 0.75 px、密度はシーンの質量分布から。ズームレベルに応じてセルサイズを縮小し、星が常に流れるようにする。

解析オブジェクト (惑星、環、衛星): sph() 光線-球、環 = 平面との交点 + 半径バンド、影は光源に向かう2本目の光線で計算。球に対してメッシュよりも安価でシャープ。

4. シームレスなマルチスケール世界(カットなしの銀河→惑星)

Float32では、1つの座標系で「銀河」と「惑星」を保持できません。1つのカメラ方向を共有する2つのフレームを使用: 銀河単位と、K = 1e5を持つシステム単位。 両方の視点位置をJS倍精度で計算: eyeS = (eyeG − sunG)·K。銀河をeyeGから、惑星をeyeSからレンダリング。遠くにいる間、太陽は星のような点であり、そのフラックスは(angularRadius/pixel)²に従う — 自然に分解された円盤になる。内部に入ると、ボリューメトリック銀河を実際のパノラマ(またはベイクされたキューブマップ)にクロスフェード。結果: 10⁸倍の途切れないズーム。

5. テクスチャ

  • 正距円筒図法マップは eqUV(n) = (0.5 + atan(n.z,n.x)/2π, 0.5 − asin(n.y)/π) でサンプリング。
  • 継ぎ目なし: ピクセルフットプリントからの解析LOD(log2(texW·0.159·pixAng·t/R/μ) − 0.5)でtextureLodを使用。分岐内で微分を持つtexture()は決して使用しない。
  • キューから1フレームに1つのテクスチャをアップロード(createImageBitmapでオフスレッドデコード)。色はSRGB8_ALPHA8、データ(雲、アルファ)はRGBA8、ミップマップ + 8×異方性。
  • 実際のテクスチャが到着するまで、すべてのサンプラーに1×1のダミーをバインド(型競合エラーを回避)。
  • 写真からのレリーフ: アルベド輝度を有限差分 → 法線を摂動(k≈5 岩、≈1 ガス)。

6. Three.js移植(ユーザーが主張する場合)

同じルール: WebGLRenderer({antialias:false, powerPreference:'high-performance'})、HalfFloatターゲットのEffectComposer、独自のTAAまたはTAARenderPass、UnrealBloomPass(threshold ≥ 1.5、strength ≤ 0.6)、ACESのOutputPass。フルスクリーントライアングルのShaderMaterialとしてのフルスクリーンレイマーチングエフェクト。電話で50メッシュ + ポストFXを混在させない。

7. デバッグハーネス(?debugでゲートされて出荷)

window.__engineを公開。シーンの時間計測: 一度レンダリング、gl.finish()、さらに4回レンダリング、readPixelsで1ピクセルを読み取り強制同期、除算。NaNsの調査はターゲット上でreadPixels(FLOAT) — 1つのNaNピクセルがブルームを通じて広がり、フレーム全体を黒くする。一般的なNaNソース: pow(neg, x)、smoothstep(e,e,x)、ACES内のInf。入力をクランプ。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル