Skip to content

xiaoyxue/webrtx

 
 

Repository files navigation

WebGPU Ray Tracing eXtension

Introduction

WebGPU Ray Tracing Extension (WebRTX) extends the WebGPU API with ray tracing capabilities. The Javascript programming interface is based on Vulkan's Ray Tracing API and is heavily influenced by the dawn-ray-tracing spec. On GPU side, you can directly use the five shader stages introduced by the GLSL_EXT_ray_tracing extension for building GLSL shaders.

Unlike the dawn-ray-tracing project which requires a new Chromium build for translating WebGPU commands to calls to native backends, WebRTX is not hardware ray tracing and is a pure compute shader implementation. This means WebRTX works as long as your browser supports WebGPU (only tested on Chrome so far).

Specification

See types.ts. Note that the spec is unstable in current state and might change in future development.

Examples

triangle

  • shadowray.gl (project) - a website that allows editing and running WebRTX application in realtime

shadowray

How it works

Ray Tracing Pipeline

[recreated based on Khronos' diagram]

The five stage shaders (light green) are provided by users, while the acceleration structure traversal and the (recursive) invocations of user shader functions are implemented by WebRTX's internal compute shader code.

More specifically,

  • The core WebRTX compute shader code traverses the bounding volume hierarchy (BVH) for ray-primitive intersection and calls user shader functions by looking up function handles and parameters in the Shader Binding Table.
  • The building of BVH happens on host which is then flattened into a buffer for stackless traversal on GPU.
  • A WASM GLSL parser (glsl-lang) parses and manipulates user provided shaders, and combine them with WebRTX's internal shader code into a mega compute shader. The manipulation includes e.g. rewriting shader entry function names, rewriting shader variables (like ray payload and ray attribute) for inter-shader communication etc.
  • The Typescript library code patches WebGPU API object(s) and internally turns the ray tracing pass into a compute pass with necessary states and GPU resources.
  • Because WebGPU does not accept SPIR-V anymore, user provided GLSL_EXT_ray_tracing shader codes are compiled to SPIR-V using glslang.js, then to WGSL using naga.

Development

Code structure

  • /bvh - Rust code for building BVH and serializing it to a format suitable for stackless traversal on GPU.
  • /glsl - Rust code for parsing and manipulating user provided shaders.
  • /naga - WASM binding for naga, based on wasm-naga.
  • /src - All other typescript library code.

Building

Dependencies

  • npm
  • wasm-pack
npm run build

About

WebGPU Ray Tracing eXtension

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 46.6%
  • TypeScript 33.4%
  • GLSL 19.3%
  • JavaScript 0.7%