transmission
English | 日本語
概要
transmissionは、透明PBR surface越しの背景透過と画面空間屈折を比較するテスト用アプリです。球、厚い板、トーラスへ独立したmaterial値を設定し、法線勾配、silhouette、Transmission、IORによって、物体へ入ってから出る光線とレンガ目地やOak木目の見え方が変わることを確認します。
透明体の背後にあった色付き立方体群は置かず、幅16、高さ9の壁全体へbrick.running.redのレンガtextureを貼っています。床には柾目と板目を板単位で混ぜたwood.oak.mixed-sawnのOak textureを貼り、板の長軸が画面の奥行き方向へ向くようにしています。どちらもコアのProceduralMaterials.createPreset()で生成し、applyTo()でShapeへ登録します。presetが持つ物理寸法からUVの反復回数を求めるため、模様を壁や床の全面へ1回だけ引き伸ばさず、レンガの目地、表面の凹凸、床板の継ぎ目、木目を一貫した大きさで表示できます。
レンガの規則的な目地は、透明体を通った背景位置がどちらへどれだけ移動したかを確認する基準になります。Oak床は斜めに見える面で屈折と吸収を確認しやすくし、Color textureだけでなくNormal textureも使うことで、不透明背景自体がPBR照明へどう反応するかも同じ画面で観察できます。texture生成またはShader検証に失敗した場合は起動エラーとして報告し、原因を確認できるようにします。
処理順序は次のとおりです。
不透明G-buffer
→ Deferred PBR照明
→ 透明前面のoct法線、Transmission、entry距離mask
→ 透明前面materialの吸収色と吸収距離target
→ 透明裏面のexit距離、oct法線、IOR target
→ entryで空気から媒質への第1屈折
→ SSR方式の内部ray marchとbinary searchによるexit探索
→ exitで媒質から空気への第2屈折
→ 不透明G-buffer depthに対する背景ray march
→ 背景未到達時は明示したclearColor/固定色、またはHDR環境radiance
→ 内部光路長によるBeer-Lambert吸収
→ roughnessによるFrost
→ 透明PBR surfaceのForward合成
→ Tone Mapping
操作
- Canvasのdouble clickまたは
/でCommandPaletteを開きます Transmissionで屈折を有効/無効にしますSphere、Slab、Torusボタンで編集するmaterialを直接選びますTransmission値は吸収後の屈折光へ配分する割合です。残りはPBR surface側へ配分しますIORは1.0から2.5で、entryとexitにおけるSnellの法則の屈折率として使いますAbsorption R/G/Bは吸収距離を通過した後に残る線形RGBの割合ですAbsorption Distは上記RGB割合まで減衰する距離で、小さいほど吸収が強くなりますRoughnessは屈折後の背景をFrost pyramidでぼかしますSurface AlphaはTransmission 1.0で屈折背景の上へ重ねるPBR surfaceの基準Alphaです。Transmissionを下げると非透過分がsurface側へ加わりますTでTransmission、SpaceでPause、Rで初期値へ戻せます- このサンプルは背景色を使う構成で、背景との交点が得られないrayに
transmissionRayMissFallback: "clear"を明示しているため、アプリのclearColorを使います - CommandPaletteの
Ray Debugを有効にすると、屈折rayがfallbackを使った理由を色分けします。赤は同一pixelのvolume不成立、橙はentry屈折不能、紫は初回または内部reflection後の境界未発見、黄は1回reflectionした後も残る全反射、水色は外部探索距離なし、緑は背景未発見です - Helpの
FPSは0.2秒間のframe数を実経過時間で割った平均値で、0.2秒ごとに更新します。同じ表示には平均frame間隔に対するComputeEffectPipeline、G-buffer Render、両者のGPU合計、JavaScript処理時間の割合も表示します。GPU合計の集計範囲は、ComputeEffectPipelineとG-buffer Renderです。画面への最終copyは集計範囲外です。GPU timestampを利用できる環境では実測値を表示し、それ以外ではunavailableと表示します
周期的な停止を解析するため、このサンプルは20 ms以上の長いframe、透明batch分断数16以上への到達、batch数の16以上の増加、queue CPU時間4 ms以上への到達、global sort状態の変化だけを最大64件のring bufferへ記録します。詳細objectやJSONの生成は、上記の記録条件を満たすframeに限定します。ブラウザconsoleでgetTransmissionAnomalyLog()を実行すると、時系列順の記録を取得できます。各記録には透明Nodeのlocal/world角度(degree、yaw/pitch/roll)と位置、投影境界、干渉pair、triangle数、instance別batch run数、queue CPU時間、各passの最新CPU/GPU時間が含まれます。GPU timestampは非同期readbackの最新値であり、停止frameとの対応は、各値の計測時刻も合わせて確認してください。
透明instanceの干渉判定は、まずlocal AABBの8 cornerで安価な候補判定を行い、候補となったinstanceだけ実際の透明triangle頂点からtightな投影boundsを求めます。実際の表面の投影範囲を使うことで、AABB cornerが作る過剰なscreen overlapを絞れます。tight boundsで残った重なりも、重なり矩形の短辺がrender target上で8 pixel以下なら、細い境界部分の描画順よりframe時間を優先して独立instanceとして扱います。除外pair数と最大除外幅はDiagnosticsと異常ログへ記録します。
ray探索はコア既定値の最大距離42、交差許容厚み0.10、基準48 stepを使います。透明物内部と透明物を出た後の背景探索は、どちらも画面上のray主軸で約8 pixel間隔を目標にstep数を増やし、既定条件では48から最大96 stepの範囲になります。交差候補を見つけた後は5回の二分探索で区間を1/32まで狭めます。交差許容厚みは、離散的に進むrayをdepth surfaceへ到達したと判定する範囲です。
実装の意味
TransparencyPassは透明物用の処理で既存の不透明depthを参照し、最前面のentry maskを作ります。entry targetはRGへoctahedral encodeした完全なview-space法線、BへTransmission、Aへlinear view depthを保存します。別のReverse-Z depth付きtargetへback faceだけを描き、Rへexit depth、GBへexit法線のoct encode、AへIORを保存します。octahedral encodeは単位法線のXYZを二成分へ畳み込み、Compute Shader側で前後方向を含む法線へ復元できる形式です。
Compute Shaderは次の順で二つの境界面と背景までの光線を追跡します。
entryPosition = reconstructViewPosition(entryUV, entryDepth)
insideDirection = refract(cameraRay, entryNormal, 1 / IOR)
exitPosition = rayMarchTransparentFrontAndBack(entryPosition, insideDirection)
outsideDirection = refract(insideDirection, -exitNormal, IOR)
if totalInternalReflection:
reflectedDirection = reflect(insideDirection, exitNormal)
exitPosition = rayMarchTransparentFrontAndBack(exitPosition, reflectedDirection)
outsideDirection = refract(reflectedDirection, -exitNormal, IOR)
backgroundPosition = rayMarchOpaqueDepth(exitPosition, outsideDirection)
opticalDistance = sumOfInternalRaySegments
transmittance.rgb = attenuationColor.rgb ^ (opticalDistance / attenuationDistance)
absorbedRefraction.rgb = refractedBackground.rgb × transmittance.rgb
effectiveTransmission = materialTransmission × passTransmissionStrength
surfaceAlpha = 1 - effectiveTransmission × (1 - materialSurfaceAlpha)
entryではcameraから表面へ向かう入射rayとentry法線から、空気から媒質へ進む方向をWGSLのrefract()で求めます。内部rayはentry targetのfront surfaceとexit targetのback surfaceを同時に調べ、先に横切った境界区間を5回のbinary searchで絞ります。frontとbackの両surfaceを出口の候補にするため、凹形状の内側や内部reflection後にfront surfaceへ到達する経路も探索できます。
最初の境界で媒質から空気へのrefract()が全反射を返した場合は、reflect()で媒質内を進む方向を求め、同じfront/back境界探索をもう一度行います。2つ目の境界で空気へ出られた場合は、その位置から不透明G-buffer depthへ進めて最初の背景surfaceを探します。Beer-Lambert吸収の光路長にはreflection前後の両区間を加えます。背景surfaceがなくrayが画面内の遠方へ向く場合は、その方向をscreen UVへ投影してHDR sceneを読みます。
画面外や未観測領域へ進み、screen-space情報だけでは背景を決められないrayには、transmissionRayMissFallbackを使います。"auto"はHDR環境に元のradianceがあればray方向の環境色、なければrenderScene()へ渡したclearColorを選びます。"environment"はHDR radianceを必須とします。radianceの不足は設定エラーとして、必要な入力を示す例外で通知します。"clear"は常にclearColor、"constant"はtransmissionRayMissColorで指定した固定色を使います。固定色とclearColorは表示用sRGBで指定し、TransparencyPassがTone Mapping前の線形色へ一度だけ変換します。
pipeline.encode(gpu.commandEncoder, {
// ...ほかのeffect設定
transparency: {
transmissionEnabled: true,
transmissionRayMissFallback: "constant",
transmissionRayMissColor: [0.04, 0.06, 0.10, 1.0]
}
});
transmissionRayMissColorは"constant"でだけ受け付けます。"constant"では色を必須とし、色の指定はこのmodeで受け付けます。組み合わせは初期化時に検証します。内部境界が得られない場合や2回目の境界でも全反射する場合は、外向きレイ方向が未確定となるため、environment modeでもclearColorを使います。constant modeでは、この場合にも指定固定色を使います。
正常にhitしたpixelでは、吸収後の屈折色をそのまま背景として使い、背景色をその屈折色へ置き換えます。Transmissionの非透過分は後段PBR Forwardのsurface Alphaへ配分します。Transmission 1.0では指定したSurface Alphaを使い、Transmissionを下げるほどsurface側が不透明へ近づきます。これによりsurface radianceと屈折光の二成分を合成し、正位置の背景がghost像として残ることを防ぎます。
吸収色は白、吸収距離は無限大が既定値で、この組合せでは透過率が1となり、既存材質の色を保ちます。Transmission全体が無効、または個々のmaterialでTransmissionが0ならAlpha surfaceとして描画します。処理はTone Mapping前のrgba16float線形HDRで行います。
現在の制限
これは、画面に記録された境界面を使うscreen-spaceの近似です。normal textureをentry屈折法線へ反映し、targetへ記録された表面との交点を探索します。正確な体積追跡、多層屈折、色分散が必要な場合は、それぞれに対応する幾何データと光学モデルを用意する構成へ拡張します。背景交点が得られないrayには、選択したenvironment、clearColor、constantを使います。交点の探索範囲はtargetへ記録された幾何形状です。内部reflectionは1回まで追跡し、2つ目の境界でも全反射する経路は、上記の背景色選択へ進みます。Beer-Lambert吸収にはreflectionを含むview-space内部光路長を使います。
Ray Debugは通常表示で選択したfallbackとは別の分類表示です。Debugを有効にした場合はfallback色より診断色を優先します。Debugを無効にしてもfront/back両surface探索と1回の内部reflectionは実行されます。紫は初回またはreflection後に次の境界を発見できなかった領域、黄はreflection後の2つ目の境界でも全反射した領域として、追加改善が必要な経路を残します。
このサンプルではwebgの材質パラメーターでTransmission、IOR、Volume吸収を直接設定します。glTFのKHR_materials_transmission、KHR_materials_ior、KHR_materials_volumeの読み込みとAlpha 1の物理Transmission材質は、ここで説明する対応範囲の外です。