WASM2HLSL
ドキュメントバージョン: 0.2.2 · リリース
WASM2HLSL for UdonSharp (com.logiccuteguy.wasm2hlsl) は VRChat ワールド内で WebAssembly を GPU 上で実行します。.wasm ファイルをプロジェクトに置くと、エディターがそれを HLSL に変換します。UdonSharp の WasmGpuRunner がエクスポート関数をレンダーテクスチャの各ピクセルで一度ずつ実行し、結果を Udon に読み戻します。
カーネルは手書きの HLSL ではなく Rust、C/C++、Zig、AssemblyScript、TinyGo で書けます。Udon は遅い(C# の約 1000 分の 1 の速度)ですが、同じロジックを数千ピクセル並列で回すピクセルシェーダーはそうではありません。
0.2.2 の新機能
- VPM 依存関係の Worlds SDK を
3.x.x(>=3.10.5)に緩和しました。VRChat SDK 3.10.6 以降にもインストールできます。
0.2.1 の新機能
標準の UdonSharp に対応し、パッケージ表示名が WASM2HLSL for UdonSharp になりました。LCGUdonSharp は必須ではなくなりました。
0.2.0 の新機能
大きな定数テーブル: .rodata(1 KB 以上の static / const テーブル、include_bytes!)はテクスチャから読まれるようになり、GPU レジスタを使わないため 64000 バイトのメモリ制限の対象外になりました。ソース変更は不要です。インポーターが .wasm アセットに rom テクスチャを追加し、すべての export のマテリアルに _WasmRom として設定します。新しいインポート設定 Texture Constants From (bytes) でしきい値を決めます(デフォルト 1024、0 はすべてレジスタ内)。アセットのサマリーに ROM サイズが「GPU memory per call」の隣に表示されます。
Mandelbrot サンプルは ROM テクスチャ内の 64 KB パレットで滑らかに色づくようになりました。修正: 混雑したインスタンスでオーディオサンプルが途切れなくなる(AudioSource priority 0)、hitch 後に Chroma の write-ahead が伸びる(新 maxLead、131072 フレームの出力リング)、ワールド退出時に WasmGpuRunner が readback を無視するようになり、退出・終了時の Udon 例外が解消。
Importer version 9 で全 .wasm が一度再インポートされ、大きな .rodata を持たないモジュールは従来と同一の HLSL を生成します。CHANGELOG.md を参照。
0.1.0 の新機能
初回リリース: .wasm → HLSL 変換、WasmGpuRunner U# コンポーネント、ソースからの引数/@size/@traps 名読み取り、Trap Check、Node との GPU 整合性テスト、Showcase/Chroma サンプル。
要件
- Unity 2022.3
- VRChat Worlds SDK
3.10.5以降 - UdonSharp — Worlds SDK 標準の UdonSharp で動作します。LCGUdonSharp
>= 0.3.10は任意です
インストール
VCC / ALCOM
- LogicCuteGuy VPM リポジトリを VCC/ALCOM に追加するか、
https://vpm.logiccuteguy.com/index.jsonを手動で追加します。既に追加済みならリストを更新してください。 - Unity プロジェクトの Manage Project を開きます。
- WASM2HLSL for UdonSharp (
com.logiccuteguy.wasm2hlsl) を見つけて 0.2.2 を追加します。 - プロジェクトを Unity で開き、パッケージのインポートを待ちます。
Unity Package Manager / 手動
Window > Package Manager > + > Add package from git URL で次を入力します。
https://github.com/LogicCuteGuy/WASM2HLSL.git#0.2.2
または tag 付きリポジトリを Packages/com.logiccuteguy.wasm2hlsl に置くか、リリースから名前付き com.logiccuteguy.wasm2hlsl-0.2.2.zip をそのフォルダーに展開します(package.json がルートにあること)。GitHub が自動生成する Source code (zip) は使わないでください。
重複を避けるため project ごとに方法を一つだけ選びます。
パイプライン
kernel.rs ──rustc──▶ kernel.wasm ──(import)──▶ .wasm アセット内、export ごと: shader + material + render texture
WasmGpuRunner (U#): args/SetInput → VRCGraphics.Blit → VRCAsyncGPUReadback → int[] resultLo
- wasm 言語でエクスポート関数を書きます。
.wasmインポーターが export ごとにシェーダー、マテリアル、レンダーテクスチャを生成します(すべて.wasmアセット内に格納)。WasmGpuRunnerが引数と入力を設定し、シェーダーをレンダーテクスチャ全体に blit(ピクセルごとに 1 回)して、各プレーンを非同期にresultLo/resultHi/resultFloatへ読み戻します。
カーネル形式、ランナーのインスペクター、Udon API ははじめにを参照してください。
仕組み
AsyncGPUReadback は R32_SINT の整数テクスチャしか読めないため、レンダーテクスチャは行のプレーンを積み重ねます: 下位 32 ビット、次に上位 32 ビット(i64 のときのみ)、次にトラップフラグ(Trap Check 有効時のみ)。各ピクセルは自分の呼び出しを再計算してプレーンの値を書き込みます。メモリはピクセルごとに private で、実行のたびにリセットされます。ピクセル同士は通信できず、出力は戻り値だけです。
パッケージ構成
Editor/ WasmModule.cs (パーサー), WasmToHlsl.cs (変換器), WasmImporter.cs (.wasm インポーター), WasmGpuRunnerEditor.cs (ドラッグ&ドロップ + インスペクター),
SourceNames.cs (引数名・ドキュメント・@size / @traps をソースから), Icons/ (.wasm とランナーのアイコン)
Runtime/ WasmGpuRunner.cs (UdonSharp) + U# assembly definition
Example/ Showcase.unity (Mandelbrot、Juno-6 シンセ、AudioDsp、DeepZoom f64、SimdPlasma v128 を 1 つの VRChat ワールドに)
Chroma/: Juno-6 向けのライブ scale-filter insert とビデオプレーヤー
WasmIntDisplay.shader (readback なしでランナーのレンダーテクスチャを表示)
Tests~/ GPU 整合性テスト (Rust → wasm → HLSL → D3D11 vs Node): run.sh (MVP), types.sh (f64, v128, 参照型)
names/: 言語ごとのソース名パーサーチェック
chroma_check.js: Example/Chroma カーネルの Node 自己検証
Example/Showcase.unity を開いて Play を押してください。DeepZoom / SimdPlasma は一度 Tools > WASM2HLSL > Add f64 + SIMD Examples To Scene を実行し、シーンを保存します。
検証
Tests~/run.sh は Rust カーネル(collatz ループ、64 ビットハッシュ、match → br_table、32/64 ビット div/rem、インメモリソート、浮動小数点演算、i64↔float キャスト、input()、ROM テクスチャ経由で読む 96 KB の .rodata テーブル)をビルドし、D3D11 コンピュートシェーダーとして 1024 回呼び出して結果を Node の WebAssembly と比較します。すべての整数パスはビット一致、hlsl_sin パスは出力の ≤ 1 ulp 差です。Mandelbrot サンプル(ROM テクスチャ内の 64 KB パレット)は 99.7% のピクセルで Node と一致し、残りは hlsl_log2 が GPU の f32 log2 であるためだけに違い、Unity の Graphics.Blit は D3D11 テストとピクセル単位で同一です。
Tests~/types.sh は他の型についても同じことをします(export ごとに 4096 回、すべて Node とビット一致): スカラー f64、あらゆる SIMD レーン形状、実装依存でない relaxed SIMD、参照型。f32x4 の div/sqrt はスカラー f32 と同様に GPU float 精度です。Quest/Vulkan は未検証です。
ドキュメント: はじめに · リポジトリ README · GettingStarted.md