Three.js WebXR VR Headset Preview (Stereo & Lens Distortion)

A WebXR VR session demo in Three.js that detects immersive-vr, immersive-ar and inline support, enters VR on supported headsets, and previews stereo rendering on desktop with adjustable IPD, barrel lens distortion and chromatic aberration.

Key topics: webxr vr, vr headset preview, stereo rendering, lens distortion, three.js webxr, immersive-vr

What this code does

- Session Support: `navigator.xr.isSessionSupported()` is queried for each mode, and Enter VR appears only when immersive-vr is available.
- Animation Loop: XR sessions only fire `renderer.setAnimationLoop`, so the demo base switches to it (window rAF pauses while presenting).
- Stereo Rig: THREE.StereoCamera derives left and right eye cameras from the head camera with eyeSep = IPD, and each eye renders to its own target.
- Lens Preview: a full-screen pass barrel-distorts each eye's UVs by (1 + k₁r² + k₂r⁴), with slightly different k per colour channel for chromatic aberration.
- Depth Cues: objects sit at 1–5.4 m with a 1 m reference cube; simulated head motion shows the parallax between eyes.
- Controls: desktop view, IPD, lens coefficients, chromatic aberration and head motion.

Continue Learning

JavaScript Implementation

ES6+
// Enter VR when available; otherwise preview the stereo pair on the desktop
renderer.xr.enabled = true
renderer.setAnimationLoop(render)                         // required: XR drives the frame loop
if (await navigator.xr?.isSessionSupported('immersive-vr')) {
  button.onclick = async () => renderer.xr.setSession(await navigator.xr.requestSession('immersive-vr', { optionalFeatures: ['local-floor'] }))
}
const stereo = new THREE.StereoCamera(); stereo.eyeSep = 0.063  // interpupillary distance (m)
stereo.update(camera)
renderer.setRenderTarget(leftRT); renderer.render(scene, stereo.cameraL)
renderer.setRenderTarget(rightRT); renderer.render(scene, stereo.cameraR)
// composite side by side; barrel-distort uv by (1 + k1 r² + k2 r⁴) per colour channel