Un test unitario revela un error de alineación en WebGPU que puede colgar tu GPU

Testing WebGPU data layouts with Facet

Matt Keeter explica cómo un test unitario detectó que una estructura de datos compartida entre Rust y WGSL tenía offsets distintos: en WGSL, mat3x3 ocupa 48 bytes por el padding, mientras que en Rust solo 36. Usando la reflexión en tiempo de ejecución de Facet, escribe un verificador genérico que compara automáticamente los layouts de Rust y WGSL, evitando fallos catastróficos en shaders de cómputo.

En WGSL, cada fila de un mat3x3 tiene 4 bytes de padding, por lo que cada fila ocupa 16 bytes en total y la matriz completa son 48 bytes. En Rust, un objeto [[f32; 3]; 3] está empaquetado de forma compacta y por lo tanto ocupa solo 36 bytes.
  1. flohofwoe

    FWIW, hay una extensión de WebGPU que 'armoniza' el layout de las estructuras de uniform buffer con otros espacios de direcciones, pero actualmente solo está implementada en navegadores basados en Chromium:

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

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

    Las restricciones de layout al estilo std140 son básicamente un remanente de cuando las GPUs usaban "tablas de registros" vec4 para los datos uniform.

  2. genxy

    > facet es una librería para Rust que proporciona reflexión en tiempo de ejecución. Al anotar tu struct con #[derive(facet::Facet)], obtienes un tipo asociado SHAPE que se puede inspeccionar en tiempo de ejecución.

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

    > Los crates principales le dan a los tipos una constante asociada SHAPE con su kind, layout, campos, documentación, atributos y operaciones específicas del tipo. facet-reflect construye, lee y muta valores a través de esos shapes mientras preserva sus invariantes.

    > Los crates de serialización e integración se construyen sobre esa capa de reflexión: JSON, TOML, YAML, MessagePack, Postcard, ASN.1, XDR, CSV, XML, formularios codificados en URL, SQLite, Axum, generación de esquemas, diffing estructural y más.

    Comparación lado a lado con SERDE https://facet.rs/guide/serde/

  3. scoopr

    Genial, siempre es bueno tener comprobaciones extra.

    Aunque la mayoría de las veces quieres la semántica de memcpy, me pregunto si se podría usar naga para calcular un SHAPE de facet a partir del shader. Quizá podría usarse para "serializar" el formato de la CPU al formato de la GPU, sin que necesiten ser compatibles en padding/repr (¡o incluso compatibles en reordenación de campos!).

    Otra opción, por supuesto, sería parsear el struct con naga y simplemente generar siempre la contraparte en Rust, entonces siempre debería ser compatible y estar actualizado, pero entonces tienes codegen en tu paso de build.

Más de este día

2026-09-30