用 Facet 自动检测 WebGPU 数据布局
Testing WebGPU data layouts with Facet
在开发 GPU 计算着色器时,Rust 和 WGSL 的数据布局规则差异常导致难以察觉的 bug,甚至引发 GPU 死锁。我通过手动对比发现矩阵填充导致的偏移量错误,随后决定利用 Facet 库的运行时反射能力,构建了一套通用的单元测试框架。这套方案能自动验证 Rust 结构体与 WGSL 结构体的字段偏移及大小是否一致,完美处理了运行时数组等复杂情况。现在,只需在测试中为结构体添加 Facet 派生,就能轻松确保所有配置数据的正确性,让 GPU 编程更加安心。
不幸的是,我正在编写在计算着色器中运行的字节码虚拟机,而它们的故障模式通常是:恭喜,你的 GPU 现在有了持续旋转的线程,只能通过重启电脑来终止。
- genxy
> facet 是一个 Rust 库,提供运行时反射功能。通过在你的结构体上添加 #[derive(facet::Facet)] 注解,你可以获得一个 SHAPE 关联类型,该类型可以在运行时被检查。
https://github.com/facet-rs/facet
> 核心 crates 为类型提供了一个包含其种类、布局、字段、文档、属性以及特定类型操作的 SHAPE 关联常量。facet-reflect 通过这些形状来构建、读取和修改值,同时保持其不变性。
> 序列化和集成 crates 构建在该反射层之上:支持 JSON、TOML、YAML、MessagePack、Postcard、ASN.1、XDR、CSV、XML、URL 编码表单、SQLite、Axum、模式生成、结构差异比对等。
与 SERDE 的并排对比:https://facet.rs/guide/serde/
- flohofwoe
顺便提一下,有一个 WebGPU 扩展可以“统一”uniform buffer 结构体布局与其他地址空间的布局,但目前仅在基于 Chromium 的浏览器中实现:
Ticket: https://github.com/gpuweb/gpuweb/issues/4973
Caniuse: https://caniuse.com/?search=uniform_buffer_standard_layout
std140 风格的布局限制基本上是因为 GPU 过去使用 vec4 “寄存器表”来存储 uniform 数据而遗留下来的。
- scoopr
不错,多一层检查总是好的。
虽然大多数时候你确实想要 memcpy 的语义,但我想知道是否可以用 naga 从 shader 计算出一个 facet SHAPE。也许它可以用来将 CPU 格式“序列化”为 GPU 格式,而无需它们具备 padding/repr 兼容性(甚至字段顺序兼容性)!
当然,另一个选项是用 naga 解析结构体并始终生成对应的 Rust 代码,这样它应该总是兼容且最新的,但这意味着你的构建步骤中需要包含代码生成。