WASM2HLSL
เวอร์ชันเอกสาร: 0.2.2 · Release
WASM2HLSL for UdonSharp (com.logiccuteguy.wasm2hlsl) รัน WebAssembly บน GPU ใน VRChat world วางไฟล์ .wasm ลงในโปรเจกต์แล้ว editor จะแปลงเป็น HLSL จากนั้น UdonSharp WasmGpuRunner จะเรียกฟังก์ชันที่ export ไว้ทีละพิกเซลของ render texture แล้วอ่านผลกลับเข้า Udon
เขียน kernel เป็น Rust, C/C++, Zig, AssemblyScript หรือ TinyGo แทน HLSL ด้วยมือ Udon ช้า (ราว 1000 เท่าช้ากว่า C#) แต่ pixel shader ที่รัน logic เดียวกันพร้อมกันหลายพันพิกเซลไม่ช้า
มีอะไรใหม่ใน 0.2.2
- ปรับ dependency ของ 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 (ตาราง static / const, include_bytes! ขนาด 1 KB ขึ้นไป) ถูกอ่านจากเท็กซ์เจอร์แทน register ของ GPU จึงไม่นับรวมในขีดจำกัดหน่วยความจำ 64000 byte อีกต่อไป โดยไม่ต้องแก้ซอร์ส importer เพิ่มเท็กซ์เจอร์ rom เข้า .wasm asset ตั้งเป็น _WasmRom บน material ของทุก export แล้ว และการตั้ง import ใหม่ Texture Constants From (bytes) กำหนดเกณฑ์ (ค่าเริ่ม 1024; 0 คือเก็บทุกอย่างใน register) summary ของ asset แสดงขนาด ROM ข้าง "GPU memory per call"
ตัวอย่าง Mandelbrot ไล่สีลื่นผ่าน palette 64 KB ในเท็กซ์เจอร์ ROM แล้ว แก้ไข: ตัวอย่างเสียงไม่ขาดอีกเมื่อ instance ยุ่ง (AudioSource priority 0), write-ahead ของ Chroma ขยายหลัง hitch (ฟิลด์ใหม่ maxLead, output ring 131072 เฟรม) และ WasmGpuRunner เพิกเฉยต่อ readback ที่มาหลัง world ถูกทำลาย ไม่มี Udon exception ตอนออกจากหรือปิด world
Importer version 9 ทำให้ .wasm ทุกตัว import ใหม่หนึ่งครั้ง และโมดูลที่ไม่มี .rodata ใหญ่ได้ HLSL เดิมทุกประการ ดูCHANGELOG.md
สิ่งใหม่ใน 0.1.0
release แรก: แปลง .wasm → HLSL, คอมโพเนนต์ U# WasmGpuRunner, อ่านชื่อ argument/@size/@traps จากซอร์ส, Trap Check, ทดสอบความสอดคล้องบน GPU เทียบกับ Node และตัวอย่าง Showcase/Chroma
ข้อกำหนด
- Unity 2022.3
- VRChat Worlds SDK
3.10.5หรือใหม่กว่า - UdonSharp — ใช้ UdonSharp มาตรฐานจาก Worlds SDK ได้ LCGUdonSharp
>= 0.3.10เป็นตัวเลือก
การติดตั้ง
VCC / ALCOM
- เพิ่ม LogicCuteGuy VPM repository ใน VCC/ALCOM หรือเพิ่ม
https://vpm.logiccuteguy.com/index.jsonด้วยมือ หากเพิ่มแล้วให้ refresh รายการ - เปิด Manage Project ของโปรเจกต์ Unity
- หา WASM2HLSL for UdonSharp (
com.logiccuteguy.wasm2hlsl) แล้วเพิ่ม 0.2.2 - เปิดโปรเจกต์ใน Unity แล้วรอให้ import เสร็จ
Unity Package Manager / ติดตั้งเอง
ใน Window > Package Manager > + > Add package from git URL ใส่:
https://github.com/LogicCuteGuy/WASM2HLSL.git#0.2.2
หรือวาง repository ที่ tag ไว้ที่ Packages/com.logiccuteguy.wasm2hlsl หรือแตก com.logiccuteguy.wasm2hlsl-0.2.2.zip ที่มีชื่อชัดเจนจากrelease ลงโฟลเดอร์นั้น โดยให้ package.json อยู่ที่ root ห้ามใช้ Source code (zip) ที่ GitHub สร้างอัตโนมัติ
เลือกวิธีติดตั้งเพียงวิธีเดียวต่อโปรเจกต์เพื่อหลีกเลี่ยงสำเนาซ้ำ
ไปป์ไลน์
kernel.rs ──rustc──▶ kernel.wasm ──(import)──▶ ภายใน .wasm asset ต่อหนึ่ง export: shader + material + render texture
WasmGpuRunner (U#): args/SetInput → VRCGraphics.Blit → VRCAsyncGPUReadback → int[] resultLo
- เขียนฟังก์ชัน export เป็นภาษา wasm
.wasmimporter จะสร้าง shader/material/render texture หนึ่งชุดต่อ export เก็บไว้ใน.wasmasset เองWasmGpuRunnerตั้ง argument กับ input แล้ว blit shader ลง render texture (หนึ่งครั้งต่อพิกเซล) อ่าน plane กลับแบบ asynchronous เข้าresultLo/resultHi/resultFloat
รูปแบบ kernel, inspector ของ runner และ Udon API ดูที่เริ่มต้นใช้งาน
หลักการทำงาน
AsyncGPUReadback อ่านได้เฉพาะเท็กซ์เจอร์ R32_SINT แบบจำนวนเต็ม ดังนั้น render texture จึงวางแถวเป็นชั้น (plane): ส่วนล่าง 32 บิตก่อน ตามด้วยส่วนบน 32 บิต (เฉพาะ i64) แล้วจึงแฟล็ก trap (เฉพาะตอนเปิด Trap Check) พิกเซลแต่ละตัวคำนวณการเรียกของตัวเองใหม่แล้วเขียนค่าลง plane ของตน หน่วยความจำเป็นของส่วนตัวต่อพิกเซลและรีเซตทุกครั้งที่รัน พิกเซลคุยกันไม่ได้ ผลลัพธ์ที่ return เท่านั้นคือ output
โครงสร้างแพ็กเกจ
Editor/ WasmModule.cs (ตัวแยกวิเคราะห์), WasmToHlsl.cs (ตัวแปลง), WasmImporter.cs (ตัว import .wasm), WasmGpuRunnerEditor.cs (ลากวาง + inspector),
SourceNames.cs (ชื่อ argument, เอกสาร, @size / @traps จากซอร์ส), Icons/ (ไอคอน .wasm และ runner)
Runtime/ WasmGpuRunner.cs (UdonSharp) + U# assembly definition
Example/ Showcase.unity (Mandelbrot, เสียงสังเคราะห์ Juno-6, AudioDsp, DeepZoom f64, SimdPlasma v128 ใน VRChat world เดียว)
Chroma/: scale-filter insert สดสำหรับ Juno-6 และ video player
WasmIntDisplay.shader (แสดง render texture ของ runner โดยไม่ readback)
Tests~/ ทดสอบความสอดคล้องบน GPU (Rust → wasm → HLSL → D3D11 เทียบ Node): run.sh (MVP), types.sh (f64, v128, reference types)
names/: ตรวจตัวแยกชื่อจากซอร์สต่อภาษา
chroma_check.js: ตรวจ kernel ของ Example/Chroma เองใน Node
เปิด Example/Showcase.unity แล้วกด Play สำหรับ DeepZoom / SimdPlasma: รัน Tools > WASM2HLSL > Add f64 + SIMD Examples To Scene หนึ่งครั้ง แล้ว save scene
การตรวจสอบ
Tests~/run.sh build kernel Rust (ลูป collatz, hash 64 บิต, match → br_table, div/rem 32/64 บิต, sort ในหน่วยความจำ, คำนวณทศนิยม, cast i64↔float, input(), ตาราง .rodata 96 KB ที่อ่านผ่าน ROM texture) รันเป็น D3D11 compute shader 1024 ครั้ง แล้วเทียบทุกผลกับ WebAssembly ของ Node: ทุกเส้นทางจำนวนเต็มตรงเป๊ะทุกบิต เส้นทาง hlsl_sin ต่างไม่เกิน 1 ulp ของผลลัพธ์ ตัวอย่าง Mandelbrot (palette 64 KB ใน ROM texture) ตรงกับ Node 99.7% ของพิกเซล ที่เหลือต่างเพราะ hlsl_log2 เป็น log2 f32 ของ GPU เท่านั้น และ Graphics.Blit บน Unity ตรงกับ D3D11 test ทุกพิกเซล
Tests~/types.sh ทำแบบเดียวกันกับ type อื่น เรียก 4096 ครั้งต่อ export ตรงทุกบิตกับ Node: f64 สเกลาร์, รูปทรง lane ของ SIMD ทุกแบบ, relaxed SIMD ที่ผลไม่ขึ้นกับ implementation และ reference types ส่วน f32x4 div/sqrt รันที่ความแม่นยำ float ของ GPU เหมือน f32 สเกลาร์ ยังไม่ได้ทดสอบบน Quest/Vulkan
เอกสาร: เริ่มต้นใช้งาน · README ของ repository · GettingStarted.md