GPU 컴퓨트 셰이더에서 데이터 레이아웃 버그를 잡는 Facet 활용법
Testing WebGPU data layouts with Facet
Rust와 WebGPU의 메모리 레이아웃 규칙 차이로 인한 버그를 Facet의 런타임 리플렉션으로 자동 검증하는 방법을 소개한다. mat3x3 행렬의 패딩 차이 같은 문제를 유닛 테스트로 잡아내며, 기존 수동 검사보다 안전하고 편리하다.
GPU 컴퓨트 셰이더를 작성하다 보면 호스트와 셰이더 간에 구성 데이터 조각을 공유하고 싶을 때가 흔합니다.
- genxy
> facet은 Rust용 라이브러리로, 런타임 리플렉션을 제공합니다. 구조체에 #[derive(facet::Facet)]를 붙이면 런타임에 검사할 수 있는 SHAPE 연관 타입을 얻을 수 있습니다.
https://github.com/facet-rs/facet
> 핵심 크레이트는 타입에 SHAPE 연관 상수를 부여하는데, 여기에는 종류(kind), 레이아웃, 필드, 문서, 속성, 타입별 연산이 포함됩니다. facet-reflect는 이러한 shape를 통해 값을 생성, 읽기, 변경하면서 불변성을 유지합니다.
> 직렬화 및 통합 크레이트는 이 리플렉션 계층 위에 구축됩니다: JSON, TOML, YAML, MessagePack, Postcard, ASN.1, XDR, CSV, XML, URL 인코딩 폼, SQLite, Axum, 스키마 생성, 구조적 diff 등이 있습니다.
SERDE와의 나란히 비교: https://facet.rs/guide/serde/
- flohofwoe
참고로, WebGPU에는 uniform 버퍼 구조체 레이아웃을 다른 주소 공간과 '조화'시키는 확장이 있지만, 현재는 Chromium 기반 브라우저에서만 구현되어 있습니다:
이슈: https://github.com/gpuweb/gpuweb/issues/4973
Caniuse: https://caniuse.com/?search=uniform_buffer_standard_layout
std140 스타일 레이아웃 제한은 기본적으로 GPU가 uniform 데이터에 vec4 "레지스터 테이블"을 사용하던 시절의 잔재입니다.
- scoopr
좋네요, 추가 검사가 있으면 항상 반갑습니다.
대부분의 경우 memcpy 시맨틱을 원하지만, naga를 사용해 셰이더로부터 facet SHAPE를 계산할 수 있을지 궁금하네요. 아마도 CPU 포맷을 GPU 포맷으로 "직렬화"하는 데 사용할 수 있을 텐데, 패딩/repr 호환성(또는 필드 재정렬 호환성까지도!)이 필요 없을 겁니다.
물론 또 다른 옵션은 naga로 구조체를 파싱하고 항상 Rust 대응물을 생성하는 것인데, 그러면 항상 호환되고 최신 상태를 유지할 수 있지만 빌드 단계에 코드 생성이 들어가게 됩니다.