tosijs-3d 0.8.12 → 0.8.14

package/CHANGELOG.md

@@ -6,6 +6,60 @@ All notable changes to **tosijs-3d**. This project is pre-1.0 (`0.x`), so minor
 versions may carry breaking peer-dependency changes — each is called out in a
 **⚠️ Breaking** block in its version section below, with what a consumer must do.
 
+## 0.8.14
+
+**Ambient occlusion that works in a headset, and it is the default.**
+
+### Changed
+
+- **`ssaoMethod` defaults to `projected`.** Scenes with `ssao="on"` or `"auto"`
+  now get the projected method flat, which keeps antialiasing and concentrates
+  its darkening in contacts and corners. **`ssao="on"` now also runs in a
+  headset**, where it used to switch itself off. `auto` still never runs in a
+  headset. Set `ssaoMethod="screen"` for the previous behaviour exactly.
+
+### Added
+
+- **Projected ambient occlusion** (`ssaoMethod`, `ssaoRate` on `<tosi-b3d>`):
+  occlusion computed once from a camera between the eyes and looked up by every
+  material by world position. It is correct in stereo, uses no post-process,
+  and is redrawn `ssaoRate` times a second (default 30) instead of every frame.
+  Checked on a Quest in the SSAO demo: stereo, and no measurable change in
+  frame rate or CPU time. Not yet measured on a heavy scene.
+- Projected occlusion follows **shader vertex animation**: the crowd is
+  occluded in its animated pose, because every mesh draws its own depth with
+  its own material.
+- The Perf Stats readout is **live** and shows frame interval, CPU time in
+  `scene.render()`, and draw calls. It was three labels built once, so the fps
+  was whatever it had been when the popup opened.
+- The SSAO demo has a bust (on the CDN at `tosijs-3d/ariosto-bust.glb`) and a
+  `method` selector; the scene loader demo has shadow, glow and SSAO toggles.
+
+### Fixed
+
+- **Opening a second menu in a panel left the first one open**, one list over
+  the other. A panel now has one anchored popup at a time. (Seen in a headset,
+  reproduced flat.)
+
+## 0.8.13
+
+**A schema for `<tosi-b3d>` itself, and an emulated headset in the repo.**
+
+### Added
+
+- **`sceneSchemas.b3d` / `b3dSchema()`**: the host's scene-level attributes,
+  with ranges, units and useful bands: `clearColor`, `glowLayerIntensity`,
+  `ssao`, `ssaoStrength`, `ssaoRadius`, `timeScale`, `windSpeed`,
+  `windBearingDeg`, `windGust`. The attributes that configure a viewer rather
+  than a scene (camera limits, quality, pixel ratio, gamepad and panel chrome,
+  XR and pause behaviour) are declined by name in `SCENE_OMITTED.b3d`. The
+  drift test covers it like every other schema. `ssao` marks `always` in
+  `x-deprecated-values`. Asked by tosijs-3d-ensemble (#101).
+- **`bun run xr <path>`** (`bin/xr-emulate.ts`, repo tooling, not shipped): an
+  emulated headset. Headless Chrome with a fake WebXR device enters VR on a
+  page, screenshots both eyes and drives controllers from script. It is how
+  0.8.12's headset fixes were found.
+
 ## 0.8.12
 
 **0.8.11's ambient occlusion broke VR, and this takes it out of the headset.**

package/dist/b3d-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"b3d-loader.d.ts","sourceRoot":"","sources":["../src/b3d-loader.ts"],"names":[],"mappings":"AA4FA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAEL,QAAQ,EAGT,MAAM,gBAAgB,CAAA;AAEvB,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE9D,qBAAa,SAAU,SAAQ,QAAQ;IACrC,MAAM,CAAC,gBAAgB,SAAoB;IAE3C,MAAM,CAAC,cAAc;;;;;;;;;;;;;;;MAiBpB;IAED,KAAK,EAAE,GAAG,GAAG,IAAI,CAAO;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,EAAE,CAAA;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,CAAA;IACxB,OAAO,CAAC,SAAS,CAAC,CAAqB;IACvC,mFAAmF;IACnF,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAA;KAAE,KAAK,IAAI,CAAA;IAEzE,yDAAyD;IACzD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,8CAA8C;IAC9C,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,4DAA4D;IAC5D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE;IAIrC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAIlC,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK;IAuC3C,OAAO,CAAC,kBAAkB;IA0C1B,YAAY;CAiBb;AAED,eAAO,MAAM,SAAS,4CAA6B,CAAA"}
+{"version":3,"file":"b3d-loader.d.ts","sourceRoot":"","sources":["../src/b3d-loader.ts"],"names":[],"mappings":"AA6GA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAEL,QAAQ,EAGT,MAAM,gBAAgB,CAAA;AAEvB,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE9D,qBAAa,SAAU,SAAQ,QAAQ;IACrC,MAAM,CAAC,gBAAgB,SAAoB;IAE3C,MAAM,CAAC,cAAc;;;;;;;;;;;;;;;MAiBpB;IAED,KAAK,EAAE,GAAG,GAAG,IAAI,CAAO;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,EAAE,CAAA;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,CAAA;IACxB,OAAO,CAAC,SAAS,CAAC,CAAqB;IACvC,mFAAmF;IACnF,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAA;KAAE,KAAK,IAAI,CAAA;IAEzE,yDAAyD;IACzD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,8CAA8C;IAC9C,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,4DAA4D;IAC5D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE;IAIrC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAIlC,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK;IAuC3C,OAAO,CAAC,kBAAkB;IA0C1B,YAAY;CAiBb;AAED,eAAO,MAAM,SAAS,4CAA6B,CAAA"}

package/dist/b3d-loader.js

@@ -27,12 +27,24 @@ model, or remove the element to free it.)
 ## Demo
 
 ```js
-import { b3d, b3dSun, b3dSkybox, b3dLoader, b3dReflections, slider3d } from 'tosijs-3d'
+import { b3d, b3dSun, b3dSkybox, b3dLoader, b3dReflections, slider3d, toggle3d } from 'tosijs-3d'
 import { orbitCam } from 'tosijs-3d/demo-utils'
 import { tosi, elements } from 'tosijs'
 const { div, span } = elements
 
-const { demo } = tosi({ demo: { time: 10 } })
+const { demo } = tosi({ demo: { time: 10, shadows: true, glow: false, ssao: false } })
+
+// Three effects that change how every material in the file reads.
+let host = null
+function applyEffects() {
+  if (host == null || host.scene == null) return
+  host.scene.shadowsEnabled = demo.shadows.value
+  host.glowLayerIntensity = demo.glow.value ? 1 : 0
+  host.ssao = demo.ssao.value ? 'on' : 'off'
+}
+demo.shadows.observe(applyEffects)
+demo.glow.observe(applyEffects)
+demo.ssao.observe(applyEffects)
 
 const formatTime = (v) => {
   const h = Math.floor(v)
@@ -45,8 +57,13 @@ preview.append(
     {
       scenePanel: () => [
         slider3d({ label: 'time of day', value: demo.time, min: 0, max: 24, step: 0.1 }),
+        toggle3d({ label: 'shadows', value: demo.shadows }),
+        toggle3d({ label: 'glow', value: demo.glow }),
+        toggle3d({ label: 'ssao', value: demo.ssao }),
       ],
       sceneCreated(el, BABYLON) {
+        host = el
+        applyEffects()
         const camera = orbitCam(el, {
           alpha: -Math.PI / 2, beta: Math.PI / 4, radius: 20, target: [0, 1, 0],
         })

package/dist/b3d-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"b3d-loader.js","sourceRoot":"","sources":["../src/b3d-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"b3d-loader.js","sourceRoot":"","sources":["../src/b3d-loader.ts"],"names":[],"mappings":"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"}

package/dist/b3d-ssao-projected.d.ts

@@ -0,0 +1,59 @@
+import * as BABYLON from '@babylonjs/core';
+export interface ProjectedAoParams {
+    active: boolean;
+    /** How dark a fully occluded crease gets. */
+    strength: number;
+    /** Metres a surface looks for occluders. */
+    radius: number;
+    samples: number;
+    /** Resolution as a fraction of the frame. */
+    ratio: number;
+    /** Redraws per second. 0 = every frame. */
+    rate: number;
+}
+/**
+ * Owns the projected-occlusion textures for one scene and the hook on every
+ * material that reads them. `<tosi-b3d>` drives it.
+ */
+export declare class ProjectedAoController {
+    private _scene;
+    private _camera;
+    private _depth;
+    private _ao;
+    private _blur;
+    private _plugins;
+    private _frameObs;
+    private _materialObs;
+    private _built;
+    private _params;
+    private _lastDraw;
+    private _warmUp;
+    private _drawing;
+    private _tan;
+    /** The view-projection the textures were last drawn with. */
+    readonly viewProjection: BABYLON.Matrix;
+    /** Debug: how many times the occlusion has been redrawn. */
+    draws: number;
+    constructor(_scene: BABYLON.Scene);
+    get running(): boolean;
+    get texture(): BABYLON.Nullable<BABYLON.BaseTexture>;
+    get depthTexture(): BABYLON.Nullable<BABYLON.BaseTexture>;
+    get attachedCount(): number;
+    private _blank;
+    /** A 1x1 stand-in for a sampler that must not point at the depth texture. */
+    get blank(): BABYLON.BaseTexture;
+    /** True while the scene is drawing this controller's depth picture. */
+    get drawingDepth(): boolean;
+    update(p: ProjectedAoParams): void;
+    dispose(): void;
+    private _disposeTextures;
+    private _attach;
+    /**
+     * Point the middle camera where the viewer is looking, with a frustum that
+     * covers everything either eye can see. Returns false if there is no viewer.
+     */
+    private _aim;
+    private _build;
+    private _frame;
+}
+//# sourceMappingURL=b3d-ssao-projected.d.ts.map

package/dist/b3d-ssao-projected.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"b3d-ssao-projected.d.ts","sourceRoot":"","sources":["../src/b3d-ssao-projected.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAE1C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAA;IACf,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAA;CACb;AA2FD;;;GAGG;AACH,qBAAa,qBAAqB;IAqBpB,OAAO,CAAC,MAAM;IApB1B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,GAAG,CAAyC;IACpD,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,SAAS,CAA0D;IAC3E,OAAO,CAAC,YAAY,CACd;IACN,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,IAAI,CAAiB;IAE7B,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,iBAA4B;IACnD,4DAA4D;IAC5D,KAAK,SAAI;gBAEW,MAAM,EAAE,OAAO,CAAC,KAAK;IAEzC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAEnD;IAED,IAAI,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAExD;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,OAAO,CAAC,MAAM,CAAkC;IAEhD,6EAA6E;IAC7E,IAAI,KAAK,IAAI,OAAO,CAAC,WAAW,CAW/B;IAED,uEAAuE;IACvE,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,MAAM,CAAC,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAiBlC,OAAO,IAAI,IAAI;IAoBf,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,OAAO;IAkBf;;;OAGG;IACH,OAAO,CAAC,IAAI;IA2CZ,OAAO,CAAC,MAAM;IAiFd,OAAO,CAAC,MAAM;CAsEf"}

package/dist/b3d-ssao-projected.js

@@ -0,0 +1,473 @@
+/*
+PROJECTED AMBIENT OCCLUSION — the default method, and the only kind that can run
+in a headset. `<tosi-b3d ssao="on">`.
+
+Babylon's SSAO is a post-process: it composites one full-frame image, and on a
+WebXR camera that is one image across both eyes (see b3d-ssao.ts, "Screen").
+This does the same sum somewhere else. Occlusion is computed ONCE, from a
+camera between the eyes, into a texture. Every lit material then looks its own
+pixel up in that texture BY WORLD POSITION, the way cloud shadows and caustics
+do. So:
+
+- it is correct in stereo: each eye shades its own pixels, and the darkening is
+  glued to the surface, not to the screen;
+- nothing is post-processed, so the canvas keeps its antialiasing (and a
+  headset keeps foveation);
+- it need not be recomputed every frame. The lookup uses the matrix the
+  texture was drawn with, so a stale texture stays where it was in the world
+  while the head moves. `rate` is how many times a second it is redrawn.
+
+What it costs: one depth pass over the opaque scene per update, plus two small
+full-screen passes, plus two texture reads per lit pixel.
+
+What it cannot do: darken a surface the middle camera could not see. Those
+pixels fail the depth check and are left alone, which shows as a thin
+unoccluded sliver beside a near object, never as a ghost.
+*/
+import * as BABYLON from '@babylonjs/core';
+const AO_SHADER = 'tosiProjectedAo';
+const BLUR_SHADER = 'tosiProjectedAoBlur';
+const MAX_SAMPLES = 32;
+BABYLON.Effect.ShadersStore[`${AO_SHADER}PixelShader`] = `
+precision highp float;
+varying vec2 vUV;
+uniform sampler2D depthSampler;
+// xy = tan(half fov) for x and y, zw = 1 / texture size
+uniform vec4 aoFrustum;
+// x = radius (m), y = strength, z = sample count
+uniform vec3 aoParams;
+
+vec3 viewPos(vec2 uv) {
+  float z = texture2D(depthSampler, uv).r;
+  return vec3((uv * 2.0 - 1.0) * aoFrustum.xy * z, z);
+}
+
+void main(void) {
+  vec3 p = viewPos(vUV);
+  if (p.z <= 0.0) { gl_FragColor = vec4(1.0); return; }
+
+  // The normal from depth alone: of each pair of neighbours take the one
+  // nearer in depth, so the normal does not smear across a silhouette.
+  vec2 px = aoFrustum.zw;
+  vec3 l = viewPos(vUV - vec2(px.x, 0.0)), r = viewPos(vUV + vec2(px.x, 0.0));
+  vec3 d = viewPos(vUV - vec2(0.0, px.y)), u = viewPos(vUV + vec2(0.0, px.y));
+  vec3 dx = abs(l.z - p.z) < abs(r.z - p.z) ? p - l : r - p;
+  vec3 dy = abs(d.z - p.z) < abs(u.z - p.z) ? p - d : u - p;
+  vec3 n = normalize(cross(dy, dx));
+
+  // Each sample is a real point on a real neighbouring surface, and counts by
+  // how far it rises above this pixel's tangent plane. (Testing a point in
+  // space against the depth buffer instead darkens every silhouette, because
+  // a point just behind a curved edge is hidden without being an occluder.)
+  float spin = 6.2831853 * fract(52.9829189 * fract(dot(gl_FragCoord.xy, vec2(0.06711056, 0.00583715))));
+  float count = aoParams.z;
+  float radius = aoParams.x;
+  // The radius as a fraction of the picture at this depth, capped so a
+  // close-up does not sample half the screen.
+  vec2 reach = min(vec2(radius) / (p.z * aoFrustum.xy) * 0.5, vec2(0.25));
+  float occlusion = 0.0;
+  for (int i = 0; i < ${MAX_SAMPLES}; i++) {
+    if (float(i) >= count) break;
+    float t = (float(i) + 0.5) / count;
+    float a = spin + float(i) * 2.3999632;
+    vec2 uv = vUV + vec2(cos(a), sin(a)) * reach * t;
+    if (uv.x < 0.0 || uv.x > 1.0 || uv.y < 0.0 || uv.y > 1.0) continue;
+    vec3 q = viewPos(uv);
+    if (q.z <= 0.0) continue;
+    vec3 v = q - p;
+    float far = dot(v, v) / (radius * radius);
+    float rise = dot(n, v) / (length(v) + 0.0001);
+    occlusion += max(0.0, rise - 0.1) * max(0.0, 1.0 - far);
+  }
+  // Tuned by eye on a headset against the screen method. Averaged over a
+  // frame the two darken about equally at 2.5, but this one puts its darkness
+  // into contacts and corners where the screen method spreads it, so at equal
+  // averages it LOOKS about twice as strong.
+  occlusion *= 1.4;
+  float ao = clamp(1.0 - aoParams.y * occlusion / count, 0.0, 1.0);
+  gl_FragColor = vec4(ao, ao, ao, 1.0);
+}`;
+BABYLON.Effect.ShadersStore[`${BLUR_SHADER}PixelShader`] = `
+precision highp float;
+varying vec2 vUV;
+uniform sampler2D aoSampler;
+uniform sampler2D depthSampler;
+uniform vec2 aoTexel;
+
+void main(void) {
+  float z = texture2D(depthSampler, vUV).r;
+  float sum = 0.0;
+  float weight = 0.0;
+  for (int x = -2; x <= 2; x++) {
+    for (int y = -2; y <= 2; y++) {
+      vec2 uv = vUV + vec2(float(x), float(y)) * aoTexel;
+      float zs = texture2D(depthSampler, uv).r;
+      // Do not blur across a depth edge.
+      float w = 1.0 / (1.0 + 400.0 * abs(zs - z) / max(z, 0.01));
+      sum += texture2D(aoSampler, uv).r * w;
+      weight += w;
+    }
+  }
+  float ao = sum / max(weight, 0.0001);
+  gl_FragColor = vec4(ao, ao, ao, 1.0);
+}`;
+/**
+ * Owns the projected-occlusion textures for one scene and the hook on every
+ * material that reads them. `<tosi-b3d>` drives it.
+ */
+export class ProjectedAoController {
+    _scene;
+    _camera = null;
+    _depth = null;
+    _ao = null;
+    _blur = null;
+    _plugins = [];
+    _frameObs = null;
+    _materialObs = null;
+    _built = { width: 0, height: 0 };
+    _params = null;
+    _lastDraw = -Infinity;
+    _warmUp = 0;
+    _drawing = false;
+    _tan = { x: 1, y: 1 };
+    /** The view-projection the textures were last drawn with. */
+    viewProjection = BABYLON.Matrix.Identity();
+    /** Debug: how many times the occlusion has been redrawn. */
+    draws = 0;
+    constructor(_scene) {
+        this._scene = _scene;
+    }
+    get running() {
+        return this._blur != null;
+    }
+    get texture() {
+        return this._blur;
+    }
+    get depthTexture() {
+        return this._depth;
+    }
+    get attachedCount() {
+        return this._plugins.length;
+    }
+    _blank = null;
+    /** A 1x1 stand-in for a sampler that must not point at the depth texture. */
+    get blank() {
+        this._blank ??= BABYLON.RawTexture.CreateRGBATexture(new Uint8Array([255, 255, 255, 255]), 1, 1, this._scene, false, false, BABYLON.Texture.NEAREST_SAMPLINGMODE);
+        return this._blank;
+    }
+    /** True while the scene is drawing this controller's depth picture. */
+    get drawingDepth() {
+        return this._drawing;
+    }
+    update(p) {
+        const scene = this._scene;
+        if (!p.active || scene.activeCamera == null || scene.isDisposed) {
+            this.dispose();
+            return;
+        }
+        this._params = p;
+        if (this._frameObs == null) {
+            this._frameObs = scene.onBeforeRenderObservable.add(() => this._frame());
+            this._materialObs = scene.onNewMaterialAddedObservable.add((m) => 
+            // A material is announced from its constructor, before a subclass has
+            // finished building: attach once it exists.
+            setTimeout(() => this._attach(m), 0));
+        }
+    }
+    dispose() {
+        const scene = this._scene;
+        if (this._frameObs != null) {
+            scene.onBeforeRenderObservable.remove(this._frameObs);
+            scene.onNewMaterialAddedObservable.remove(this._materialObs);
+            this._frameObs = null;
+            this._materialObs = null;
+        }
+        for (const plugin of this._plugins) {
+            plugin.isEnabled = false;
+            plugin.controller = null;
+        }
+        this._plugins = [];
+        this._disposeTextures();
+        this._camera?.dispose();
+        this._camera = null;
+        this._blank?.dispose();
+        this._blank = null;
+    }
+    _disposeTextures() {
+        const scene = this._scene;
+        this._depth?.dispose();
+        this._ao?.dispose();
+        this._blur?.dispose();
+        this._depth = null;
+        this._ao = null;
+        this._blur = null;
+        this._built = { width: 0, height: 0 };
+    }
+    _attach(material) {
+        if (this._frameObs == null)
+            return;
+        // Only materials that take plugins, and only ones something might light.
+        if (!(material instanceof BABYLON.StandardMaterial) &&
+            !(material instanceof BABYLON.PBRBaseMaterial)) {
+            return;
+        }
+        let plugin = material.pluginManager?.getPlugin('ProjectedAo');
+        if (plugin == null)
+            plugin = new ProjectedAoPlugin(material);
+        if (!this._plugins.includes(plugin))
+            this._plugins.push(plugin);
+        plugin.controller = this;
+        plugin.isEnabled = true;
+    }
+    /**
+     * Point the middle camera where the viewer is looking, with a frustum that
+     * covers everything either eye can see. Returns false if there is no viewer.
+     */
+    _aim() {
+        const scene = this._scene;
+        const viewer = scene.activeCamera;
+        if (viewer == null)
+            return false;
+        if (this._camera == null) {
+            const cam = new BABYLON.FreeCamera('projected-ao', BABYLON.Vector3.Zero(), scene, false);
+            cam.rotationQuaternion = BABYLON.Quaternion.Identity();
+            // It is never the active camera and never takes input.
+            scene.removeCamera(cam);
+            this._camera = cam;
+        }
+        const cam = this._camera;
+        // The widest half-angle any eye needs, plus the little the eyes sit apart.
+        let tanX = 0;
+        let tanY = 0;
+        const eyes = viewer.rigCameras.length > 0 ? viewer.rigCameras : [viewer];
+        for (const eye of eyes) {
+            const m = eye.getProjectionMatrix().m;
+            if (m[0] === 0 || m[5] === 0)
+                continue;
+            tanX = Math.max(tanX, (1 + Math.abs(m[8])) / Math.abs(m[0]));
+            tanY = Math.max(tanY, (1 + Math.abs(m[9])) / Math.abs(m[5]));
+        }
+        if (tanX === 0 || tanY === 0)
+            return false;
+        if (eyes.length > 1) {
+            tanX *= 1.08;
+            tanY *= 1.04;
+        }
+        this._tan = { x: tanX, y: tanY };
+        viewer
+            .getWorldMatrix()
+            .decompose(undefined, cam.rotationQuaternion, cam.position);
+        cam.minZ = viewer.minZ;
+        cam.maxZ = viewer.maxZ;
+        cam.fov = 2 * Math.atan(tanY);
+        cam.fovMode = BABYLON.Camera.FOVMODE_VERTICAL_FIXED;
+        return true;
+    }
+    _build(width, height) {
+        const scene = this._scene;
+        const cam = this._camera;
+        this._disposeTextures();
+        // Full floats where the device can draw to them. Half floats step by
+        // several millimetres ten metres out, and a normal worked out from depth
+        // turns those steps into stripes across any surface seen at a glancing angle.
+        const depthType = scene.getEngine().getCaps().textureFloatRender
+            ? BABYLON.Constants.TEXTURETYPE_FLOAT
+            : BABYLON.Constants.TEXTURETYPE_HALF_FLOAT;
+        /*
+        EVERY MESH DRAWS ITS OWN DEPTH, WITH ITS OWN MATERIAL. The plugin below is
+        on that material and, while this texture is being drawn, replaces the
+        material's output with camera-space depth and returns before any lighting.
+    
+        Not Babylon's DepthRenderer, though it is the obvious tool. It draws with
+        its own depth shader, which follows bones but knows nothing about a
+        material plugin that moves vertices, so a baked vertex-animated crowd was
+        occluded in its rest pose. Going through the material itself is one path
+        for skinning, morphs, vertex animation and instances alike.
+        */
+        const map = new BABYLON.RenderTargetTexture('projected-ao-depth', { width, height }, scene, false, true, depthType, false, BABYLON.Texture.NEAREST_SAMPLINGMODE, true, false, false, BABYLON.Constants.TEXTUREFORMAT_R);
+        // 0 where there is nothing (the sky): depth is in metres and never 0.
+        map.clearColor = new BABYLON.Color4(0, 0, 0, 1);
+        map.activeCamera = cam;
+        map.renderParticles = false;
+        map.renderSprites = false;
+        map.ignoreCameraViewport = true;
+        // Only what can write depth this way: a material carrying the hook, and
+        // nothing see-through or pinned to the horizon.
+        map.renderListPredicate = (mesh) => {
+            const material = mesh.material;
+            if (material == null || mesh.infiniteDistance)
+                return false;
+            if (material.needAlphaBlendingForMesh(mesh))
+                return false;
+            const plugin = material.pluginManager?.getPlugin('ProjectedAo');
+            return plugin != null && plugin.isEnabled;
+        };
+        map.wrapU = BABYLON.Texture.CLAMP_ADDRESSMODE;
+        map.wrapV = BABYLON.Texture.CLAMP_ADDRESSMODE;
+        // Not in `scene.customRenderTargets`: `_frame` calls `render()` itself,
+        // because when it is drawn is the whole point of `rate`.
+        this._depth = map;
+        const pass = (name, shader) => {
+            const t = new BABYLON.ProceduralTexture(name, { width, height }, shader, scene, null, false);
+            t.wrapU = BABYLON.Texture.CLAMP_ADDRESSMODE;
+            t.wrapV = BABYLON.Texture.CLAMP_ADDRESSMODE;
+            t.refreshRate = 0;
+            return t;
+        };
+        this._ao = pass('projected-ao', AO_SHADER);
+        this._blur = pass('projected-ao-blur', BLUR_SHADER);
+        this._ao.setTexture('depthSampler', map);
+        this._blur.setTexture('aoSampler', this._ao);
+        this._blur.setTexture('depthSampler', map);
+        this._blur.setVector2('aoTexel', new BABYLON.Vector2(1 / width, 1 / height));
+        this._built = { width, height };
+    }
+    _frame() {
+        const p = this._params;
+        const scene = this._scene;
+        if (p == null || scene.activeCamera == null)
+            return;
+        const now = performance.now();
+        // Shaders compile asynchronously and a mesh whose depth shader is not
+        // ready is simply left out of that drawing. So the first drawings after a
+        // build are not rate-limited, or a slow rate would keep a picture with
+        // holes in it.
+        const limited = p.rate > 0 && this._warmUp <= 0;
+        if (limited && now - this._lastDraw < 1000 / p.rate - 1)
+            return;
+        if (this._warmUp > 0)
+            this._warmUp--;
+        if (!this._aim())
+            return;
+        this._lastDraw = now;
+        const engine = scene.getEngine();
+        // The middle camera's picture is wider than one eye's, so size it by the
+        // frame's HEIGHT and its own aspect.
+        const height = Math.max(64, Math.round(engine.getRenderHeight() * p.ratio * 0.5) * 2);
+        const width = Math.max(64, Math.round((height * this._tan.x) / this._tan.y / 2) * 2);
+        if (this._blur == null ||
+            this._built.width !== width ||
+            this._built.height !== height) {
+            this._build(width, height);
+            this._warmUp = 30;
+            for (const material of scene.materials)
+                this._attach(material);
+        }
+        const cam = this._camera;
+        // Frozen, because a camera works out its aspect from whatever is bound
+        // when it is asked, and that is not reliably this texture.
+        const projection = BABYLON.Matrix.PerspectiveFovLH(cam.fov, width / height, cam.minZ, cam.maxZ, engine.isNDCHalfZRange);
+        cam.freezeProjectionMatrix(projection);
+        // What the lookup must use is the matrix THIS drawing was made with.
+        cam.getViewMatrix(true).multiplyToRef(projection, this.viewProjection);
+        this._ao.setColor4('aoFrustum', new BABYLON.Color4(this._tan.x, this._tan.y, 1 / width, 1 / height));
+        this._ao.setVector3('aoParams', new BABYLON.Vector3(p.radius, p.strength, Math.min(MAX_SAMPLES, Math.max(4, p.samples))));
+        this._drawing = true;
+        try {
+            this._depth.render(false, false);
+        }
+        finally {
+            this._drawing = false;
+        }
+        this._ao.resetRefreshCounter();
+        this._blur.resetRefreshCounter();
+        this.draws++;
+    }
+}
+class ProjectedAoPlugin extends BABYLON.MaterialPluginBase {
+    controller = null;
+    _isEnabled = false;
+    constructor(material) {
+        super(material, 'ProjectedAo', 220, { PROJECTED_AO: false });
+    }
+    get isEnabled() {
+        return this._isEnabled;
+    }
+    set isEnabled(enabled) {
+        if (this._isEnabled === enabled)
+            return;
+        this._isEnabled = enabled;
+        this.markAllDefinesAsDirty();
+        this._enable(enabled);
+    }
+    prepareDefines(defines) {
+        defines.PROJECTED_AO = this._isEnabled && this.controller?.texture != null;
+    }
+    getClassName() {
+        return 'ProjectedAoPlugin';
+    }
+    getSamplers(samplers) {
+        samplers.push('projectedAoSampler', 'projectedAoDepthSampler');
+    }
+    getUniforms() {
+        return {
+            ubo: [
+                { name: 'projectedAoMatrix', size: 16, type: 'mat4' },
+                { name: 'projectedAoMode', size: 4, type: 'vec4' },
+            ],
+            fragment: `#ifdef PROJECTED_AO
+        uniform mat4 projectedAoMatrix;
+        uniform vec4 projectedAoMode;
+      #endif`,
+        };
+    }
+    bindForSubMesh(uniformBuffer) {
+        const c = this.controller;
+        const ao = c?.texture;
+        const depth = c?.depthTexture;
+        if (!this._isEnabled || c == null || ao == null || depth == null)
+            return;
+        uniformBuffer.updateMatrix('projectedAoMatrix', c.viewProjection);
+        // x = 1 while this material is being used to draw the depth picture.
+        uniformBuffer.updateFloat4('projectedAoMode', c.drawingDepth ? 1 : 0, 0, 0, 0);
+        uniformBuffer.setTexture('projectedAoSampler', ao);
+        /*
+        NEVER the depth texture while it is the thing being drawn. Sampling the
+        texture you are rendering into is a feedback loop: WebGL raises
+        INVALID_OPERATION and drops the draw, with nothing in the console, so the
+        depth picture comes out empty and the only symptom is no occlusion. The
+        shader does not read it in that pass, but a sampler left pointing at it is
+        enough.
+        */
+        uniformBuffer.setTexture('projectedAoDepthSampler', c.drawingDepth ? c.blank : depth);
+    }
+    getCustomCode(shaderType) {
+        if (shaderType !== 'fragment')
+            return null;
+        return {
+            CUSTOM_FRAGMENT_DEFINITIONS: `#ifdef PROJECTED_AO
+        uniform sampler2D projectedAoSampler;
+        uniform sampler2D projectedAoDepthSampler;
+      #endif`,
+            // Drawing the depth picture with this material: write camera-space
+            // depth (for a perspective camera, 1 / gl_FragCoord.w) and leave before
+            // the material does any of its own work.
+            CUSTOM_FRAGMENT_MAIN_BEGIN: `#ifdef PROJECTED_AO
+        if (projectedAoMode.x > 0.5) {
+          gl_FragColor = vec4(1.0 / gl_FragCoord.w, 0.0, 0.0, 1.0);
+          return;
+        }
+      #endif`,
+            CUSTOM_FRAGMENT_MAIN_END: `#ifdef PROJECTED_AO
+      {
+        vec4 aoClip = projectedAoMatrix * vec4(vPositionW, 1.0);
+        if (aoClip.w > 0.0) {
+          vec2 aoUv = aoClip.xy / aoClip.w * 0.5 + 0.5;
+          // Fade out toward the edge of what the middle camera saw, so a
+          // stale picture ends softly as the head turns.
+          vec2 aoEdge = smoothstep(vec2(0.0), vec2(0.04), aoUv) * smoothstep(vec2(0.0), vec2(0.04), 1.0 - aoUv);
+          float aoSeen = texture2D(projectedAoDepthSampler, aoUv).r;
+          // Only where the middle camera saw THIS surface: clip w is its depth.
+          float aoMatch = 1.0 - smoothstep(0.02, 0.05, abs(aoSeen - aoClip.w) / aoClip.w);
+          float aoValue = texture2D(projectedAoSampler, aoUv).r;
+          gl_FragColor.rgb *= mix(1.0, aoValue, aoEdge.x * aoEdge.y * aoMatch);
+        }
+      }
+      #endif`,
+        };
+    }
+}
+// In the registry, or Material.clone() throws on a material that carries it
+// (the same trap cloud-shadows documents).
+BABYLON.RegisterMaterialPlugin('ProjectedAoPlugin', (material) => new ProjectedAoPlugin(material));
+//# sourceMappingURL=b3d-ssao-projected.js.map