WebGL シネマティックエンジン は何をしますか?
リファレンス実装: templates/event-horizon/js/blackhole.js (約1,300行、依存関係ゼロ)。
それを読み、再利用してください。以下のパイプラインは、デスクトップGPUとミッドレンジの電話で実証済みです。
1. フレームパイプライン(この順序を厳守)
- シーンパス → 動的な内部解像度の
rawRGBA16Fターゲット(ビューポートのみ、再割り当ては行わない)。 射影にサブピクセル Halton(2,3) ジッター、8フレームサイクル。 - TAA 解決 → 履歴ピンポン。トーンマップ空間での3×3近傍クランプ
(
c/(1+luma))、ブレンド0.86 − motion*6、フロア0.3。スケール変更またはシーンスイッチ時に履歴をリセット。 星のきらめき、シャマー、階段状ノイズを除去し、サンプル数を30~50%削減可能。 - アップスケール → マイルドな4タップシャープン(
0.08 + 0.35*(1−scale))でフルキャンバス解像度に。 - ブルーム: 6-ミップチェーン。最初のダウンサンプルは Karis平均 + ソフトニースレッショルド(約1.6~1.8 HDR)を備えた13タップCoDフィルター。アップサンプルは9タップテント、加算。量は0.05~0.08。UIをブルームさせない。
- コンポジット: 小さな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。入力をクランプ。