WebGPUのデータレイアウト不一致をFacetで自動検出する

Testing WebGPU data layouts with Facet

GPUコンピュートシェーダーでは、ホストとシェーダー間で設定データを共有する際に、RustとWGSLのレイアウト規則の微妙な違いが問題になる。例えばmat3x3はWGSLでは48バイトだがRustでは36バイトだ。筆者はFacetのランタイムリフレクションを使い、ユニットテストで自動的にオフセットとサイズを照合する仕組みを構築。既存の設定オブジェクトに問題は見つからなかったが、今後のシェーダー追加時の安全性が大きく向上した。

WGSLでは、mat3x3の各行に4バイトのパディングが入るため、各行は合計16バイトで行列全体は48バイトになる。Rustでは[[f32; 3]; 3]は密にパックされるため、わずか36バイトしか占めない。
  1. genxy

    > facetはRust向けのライブラリで、実行時リフレクションを提供します。構造体に #[derive(facet::Facet)] を付けると、実行時に検査できるSHAPE関連型が得られます。

    https://github.com/facet-rs/facet

    > コアクレートは、型にその種類、レイアウト、フィールド、ドキュメント、属性、型固有の操作を持つSHAPE関連定数を与えます。facet-reflectは、それらの形状を通じて値の構築、読み取り、変更を行い、不変条件を維持します。

    > シリアライゼーションと統合クレートはそのリフレクション層の上に構築されています:JSON、TOML、YAML、MessagePack、Postcard、ASN.1、XDR、CSV、XML、URLエンコードフォーム、SQLite、Axum、スキーマ生成、構造的差分など。

    SERDEとの比較 https://facet.rs/guide/serde/

  2. flohofwoe

    参考までに、ユニフォームバッファの構造体レイアウトを他のアドレス空間と「調和」させるWebGPU拡張がありますが、現在はChromiumベースのブラウザでのみ実装されています:

    チケット: https://github.com/gpuweb/gpuweb/issues/4973

    Caniuse: https://caniuse.com/?search=uniform_buffer_standard_layout

    std140スタイルのレイアウト制限は、GPUがユニフォームデータにvec4の「レジスタテーブル」を使っていた時代の名残です。

  3. scoopr

    いいですね、追加のチェックがあるのはいつでも歓迎です。

    ほとんどの場合、memcpyのセマンティクスが欲しいわけですが、nagaを使ってシェーダーからfacetのSHAPEを計算できないかと思っています。もしかしたら、CPUフォーマットをGPUフォーマットに「シリアライズ」するのに使えて、パディングやreprの互換性(あるいはフィールドの順序の互換性さえも!)を必要としないかもしれません。

    もちろん別の選択肢として、nagaで構造体をパースして常にRustの対応物を生成するという手もあります。そうすれば常に互換性があり最新の状態になりますが、ビルドステップにコード生成が入り込むことになります。

この日のほかの記事

2026-09-30