Facet deckt Layout-Fehler in WebGPU-Shadern auf

Testing WebGPU data layouts with Facet

Matt Keeter zeigt, wie er mit der Rust-Bibliothek Facet die Speicherlayouts von WebGPU-Compute-Shadern automatisch testet. Ein Beispiel: In WGSL belegt eine mat3x3 durch Zeilenpadding 48 Bytes, in Rust nur 36 – ein Offset-Fehler, der zu endlos drehenden GPU-Threads führen kann. Statt manueller Prüfungen vergleicht ein generischer Checker per Laufzeitreflexion die Structs von Rust und WGSL. Die Tests laufen nur bei Bedarf und ergänzen bestehende Tools wie wgsl_to_wgpu.

In WGSL hat jede Zeile einer mat3x3 4 Bytes Padding, sodass jede Zeile insgesamt 16 Bytes belegt und die gesamte Matrix 48 Bytes groß ist. In Rust ist ein [[f32; 3]; 3]-Objekt dicht gepackt und belegt daher nur 36 Bytes.
  1. flohofwoe

    FWIW, es gibt eine WebGPU-Erweiterung, die das Layout von Uniform-Buffer-Structs mit anderen Address Spaces ‚harmonisiert‘, aber derzeit ist sie nur in Chromium-basierten Browsern implementiert:

    Ticket: https://github.com/gpuweb/gpuweb/issues/4973

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

    Die Layout-Beschränkungen im std140-Stil sind im Grunde ein Überbleibsel aus der Zeit, als GPUs vec4-„Registertabellen“ für Uniform-Daten verwendeten.

  2. genxy

    > facet ist eine Bibliothek für Rust, die Laufzeit-Reflexion bietet. Indem man sein Struct mit #[derive(facet::Facet)] annotiert, erhält man einen SHAPE associated type, der zur Laufzeit inspiziert werden kann.

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

    > Die Core-Crates geben Typen eine SHAPE associated constant mit ihrem Kind, Layout, Feldern, Dokumentation, Attributen und typspezifischen Operationen. facet-reflect baut, liest und verändert Werte durch diese Shapes, während es ihre Invarianten bewahrt.

    > Serialisierungs- und Integrations-Crates bauen auf dieser Reflexionsschicht auf: JSON, TOML, YAML, MessagePack, Postcard, ASN.1, XDR, CSV, XML, URL-codierte Formulare, SQLite, Axum, Schema-Generierung, strukturelles Diffing und mehr.

    Direkter Vergleich mit SERDE https://facet.rs/guide/serde/

  3. scoopr

    Schön, zusätzliche Überprüfung ist immer gut.

    Während man die meiste Zeit die memcpy-Semantik will, frage ich mich, ob naga verwendet werden könnte, um aus dem Shader eine facet SHAPE zu berechnen. Vielleicht könnte es verwendet werden, um das CPU-Format in das GPU-Format zu „serialisieren“, ohne dass sie padding-/repr-kompatibel sein müssen (oder sogar feldreihenfolgekompatibel!).

    Eine andere Option wäre natürlich, das Struct mit naga zu parsen und einfach immer das Rust-Gegenstück zu generieren; dann sollte es immer kompatibel und aktuell sein, aber dann hat man Codegen in seinem Build-Schritt.

Mehr von diesem Tag

2026-09-30