Ray tracing and path tracing on WebGPU, in the browser. Two packages:
@pmndrs/raytracertraces rays against a BVH from your own WGSL: closest hit, any hit, interval queries, surface data, materials and lights. Use it for reflections, shadows, AO, GI probes or baking inside your own renderer.@pmndrs/pathtraceris a physically based path tracer built on it: OpenPBR materials, many lights, textures and glTF, two GPU schedulers, and modes from converged reference images to one sample per pixel per frame.
Documentation · Examples · Classroom showcase · npm
npm install @pmndrs/pathtracer @pmndrs/raytracerYou need a browser with WebGPU (Chrome or Edge 113+, Safari 26, Firefox 141+ on Windows) and an ES module bundler. With Vite, add optimizeDeps: { exclude: ['@pmndrs/bvh'] } so the BVH build workers load. See Installation and Browser and GPU support.
import { buildGpuScene, detectCaps, requestDeviceForCaps, type SceneCopyInput } from '@pmndrs/raytracer';
import { PtMegakernel, ptSceneOptions } from '@pmndrs/pathtracer';
const adapter = await navigator.gpu.requestAdapter({ powerPreference: 'high-performance' });
const { device, caps } = await requestDeviceForCaps(adapter!, detectCaps(adapter!));
// A floor and a lamp above it (OpenPBR materials; anything left out takes its OpenPBR default).
const identity = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
const input: SceneCopyInput = {
meshes: [
{ positions: new Float32Array([-3, 0, 3, 3, 0, 3, 3, 0, -3, -3, 0, -3]), indices: [0, 1, 2, 0, 2, 3] },
{ positions: new Float32Array([-0.5, 2, -0.5, 0.5, 2, -0.5, 0.5, 2, 0.5, -0.5, 2, 0.5]), indices: [0, 1, 2, 0, 2, 3] },
],
instances: [
{ meshIndex: 0, instanceIndex: 0, objectToWorld: identity, material: 0 },
{ meshIndex: 1, instanceIndex: 1, objectToWorld: identity, material: 1 },
],
materials: [
{ baseColor: [0.8, 0.8, 0.8], specularRoughness: 0.4 },
{ baseColor: [0, 0, 0], specularWeight: 0, emissionColor: [20, 18, 15] },
],
environment: { radiance: [0.15, 0.2, 0.3] },
};
const scene = await buildGpuScene(device, input); // BVH + scene copy, uploaded
const pt = await PtMegakernel.create(device, caps, ptSceneOptions(scene)); // a kernel compiled for this scene
pt.setScene(scene.trace, scene.buffers);
pt.setFilm(640, 360);
pt.setCamera({ position: [0, 1.5, 5], target: [0, 0.5, 0], up: [0, 1, 0], yFovDeg: 45 });
for (let done = 0; done < 256; done += 16) {
const encoder = device.createCommandEncoder();
pt.encode(encoder, 16); // 16 samples per pixel
device.queue.submit([encoder.finish()]);
}
const image = await pt.readImage(); // linear HDR RGBA float32, the mean of all samplesThe full walkthrough shows the image on a canvas. Loading glTF loads a model in one call (loadGltf).
| Trace core | BVH from @pmndrs/bvh (binary, BVH4, CWBVH8), watertight triangle tests, inline WGSL or a batch tracer, interval queries, ray cones |
| Materials | OpenPBR: metal, dielectric, coat, fuzz, thin film, transmission, thin-walled, anisotropy; glTF PBR and the common KHR_materials_* extensions; textures with GPU mips, normal maps, alpha cutouts |
| Lights | Area lights, sun, sky colour, HDR environment maps with importance sampling, light selection by power |
| Integrator | Next-event estimation with MIS, Owen-Sobol, PCG or blue-noise sampling, Russian roulette |
| Schedulers | Megakernel or wavefront (queues, refill, sorting), the same images per pixel |
| Real time | One sample per frame, demodulated frame planes and motion vectors for a denoiser and upscaler, ReSTIR DI |
| Experimental | Volumes (fog, density grids), spectral rendering and dispersion, ReSTIR GI, MaterialX graphs |
Every feature is checked against pbrt-v4 and Mitsuba 3 references, analytic expectations or a CPU twin before it ships.
The gallery runs in the browser. Run it locally with:
pnpm install
pnpm examples- Getting started: Hello, path tracer · glTF models
- Ray tracer: Hit inspector · Ambient occlusion · One-bounce shading · Batch tracing
- Path tracer: Megakernel or wavefront · Alpha cutouts · Many lights · Fog and clouds · Spectral · MaterialX
Version 0.1. The APIs can still change between minor versions; pages marked Experimental in the docs change more often. Where the project stands: STATUS.md. Open work: TASKS.md.
pnpm workspace, TypeScript (strict, ESM), Node 22+.
pnpm install
pnpm test # unit tests, no GPU
pnpm typecheck
pnpm examples # the examples gallery (Vite)
node scripts/build-site.mjs --docs # docs + examples site into dist/siteContributor notes: CLAUDE.md (rules, conventions and known traps), DECISIONS.md, DIVERGES.md (where we depart from a paper or renderer, and why). Research records: research/BRIEF.md, research/notes/, spec/SPEC-draft.md. Design notes: docs/internal/design/. The bench (bench/) holds the reference renders, competitor comparisons and GPU check pages.
MIT, see LICENSE. Ported code and third-party assets: THIRD_PARTY.md.