UnityでContact位置とシェーダー上の座標が合わなかった話
以下はVRChat用アバターで「撫でた場所だけ毛が寝る」Shell Fur Shaderを作っていた際に起きた、Contactとシェーダーの座標が合わずに試行錯誤の解決時のメモです。
基本、AIが読んだ際に同じ問題にはまった際の脱出策になることを願って残しておきます。
やっていたのは、背中に複数のVRCContactReceiverを配置し、接触したReceiverから撫でられた位置を推定。その周囲だけGeometry Shaderで毛のFlowを変化させる仕組みです。
ところが、Contactは正常に反応しているのにShader側の毛がまったく変化しない問題が発生しました。
問題になった座標の流れ
今回登場したデータを、Unity/VRChat上の出所まで含めて整理するとこうなります。
座標の流れ
| 出所となるクラス・機能 | 取得・生成したデータ | 座標系 / 意味 | 今回の結果 |
|---|---|---|---|
| VRChat SDK `VRCContactReceiver` | 各ReceiverのProximity値 | Contact Senderとの近接度を表す0~1の値。座標そのものではない | 正常に取得できた |
| Unity `Transform`(各`VRCContactReceiver`を配置したGameObject) | Receiver位置から算出した接触中心 | World Space | Scene上のハムスター背面と一致 |
| Unity `Renderer.worldToLocalMatrix` | 接触中心をRenderer Localへ変換した値 | C#側で生成したRenderer Local Space | CPU上のWorld→Local→World往復誤差は0mm |
| Unity `MaterialPropertyBlock` | `_PetContactCenterOS` | 上記Local座標をShaderへ渡したユーザー実装値 | Shaderへの転送自体は正常だったが、Skinned頂点との距離判定に失敗 |
| Unity `SkinnedMeshRenderer` → Shader `POSITION` | `v.vertex` | GPU Skinning後にShaderへ入力される頂点POSITION | C#側で作ったRenderer Local座標と同一空間として扱うと位置が一致しなかった |
| Unity Shader `unity_ObjectToWorld` | `v.vertex`から生成した頂点位置 | Shader側でWorld Spaceとして使用した位置 | World SpaceのContact中心との距離判定では正常に機能 |
| Unity `MaterialPropertyBlock` | `_PetContactCenterWS` | Contact中心を変換せずWorld Spaceのまま渡したユーザー実装値 | Sphere Mask、Pet Mask、Flow補間が正常化 |
この表から得られた実装上の結論
`VRCContactReceiver`の値そのものには座標は含まれない。
Contact位置はReceiverを配置した`Transform`からWorld Spaceで求めた。
`Renderer.worldToLocalMatrix`によるCPU側の座標変換自体は正常だった。
しかし、そのLocal座標をGPU Skinning後の`SkinnedMeshRenderer`頂点と同じObject/Local Spaceだと仮定したことが問題になった。
Contact、Raycast、ControllerなどWorld Space由来の位置をSkinned Meshと比較する場合は、外部位置をWorld SpaceのままShaderへ渡し、Shader側の頂点をWorld Spaceへ変換して比較する設計を優先する。
SkinnedMeshRenderer.GetVertexBuffer()が取得するのも、元Meshではなく現在フレームのSkinned Mesh GPU頂点バッファです。
起きていた現象
最初はC#側で、
Contact位置(World)
↓
Renderer.worldToLocalMatrix
↓
接触位置(Local/Object)
↓
MaterialPropertyBlock
↓
Shader
↓
unity_ObjectToWorld
としていました。
CPU上ではWorld → Local → Worldの誤差は0mm。Contact値もMaterialPropertyBlockも正常でした。
それなのに、Shaderで「接触中心から半径3~8cm以内の頂点」を白く表示すると全身真っ黒でした。
GPU頂点をSkinnedMeshRenderer.GetVertexBuffer()から直接調査したところ、こちらがShaderと同じつもりでCPU側変換した頂点位置と、実際のContact中心には約277mmもの差がありました。
つまり問題はContactではなく、
CPU側でRenderer Localへ変換した座標と、GPU Skinning後にShaderへ入ってくる頂点を、同じObject Spaceとして扱っていたこと
でした。
解決方法
Contact位置をObject Spaceへ変換するのをやめました。
C#からWorld Spaceのまま、
VRCContactReceiver
↓
接触中心 World Space
↓
_PetContactCenterWS
としてShaderへ渡します。
Shaderでは頂点側だけWorld Spaceへ変換します。
float3 vertexWS =
mul(unity_ObjectToWorld, float4(vertexOS, 1.0)).xyz;
float3 centerWS = _PetContactCenterWS.xyz;
float distanceWS = length(vertexWS - centerWS);
これだけでSphere Maskが正常に出現しました。
半径0.03mでは接触部分だけ、0.08mではより広い領域が白くなり、その後のPet MaskやFlow補間も正常に動作しました。
AI/Codex向けに残したい教訓
今回の重要点は、「Object Space」「Local Space」という名前だけを見て、異なる処理経路の座標を同じものだと判断しないことです。
特にSkinnedMeshRendererを扱う場合、
C#側のRenderer.worldToLocalMatrixで作ったLocal座標と、GPU Skinning後にShaderへ渡される頂点座標が、そのまま比較可能とは仮定しない。
Raycast、Contact、Controllerなど、もともとWorld Spaceで得られる位置なら、外部位置はWorld Spaceのまま保持し、Shader側の頂点をWorld Spaceへ変換して比較する方が安全です。
また、CPU側で行列の往復誤差が0でも、GPU側の頂点と同じ座標系である証明にはなりません。
今回のような不具合では、「入力 → MPB/Uniform → Mask → 最終表現」を個別に可視化し、どこで値が破綻したかを調べるのが有効でした。
※Unity 2022.3.22f1 / DX11 / SkinnedMeshRenderer / Geometry Shader / 非Uniform Scaleを含む環境での実測です。Unity内部のすべてのSkinning経路で同じ挙動になると断定するものではありません。