@woosh/meep-engine 2.165.7 → 2.167.0

package/src/engine/graphics/ecs/highlight/renderer/OutlineRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OutlineRenderer.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/OutlineRenderer.js"],"names":[],"mappings":"AA+JA;IAQQ;;;OAGG;IACH,wBAAoB;IAEpB;;;OAGG;IACH,eAAkB;IAElB;;;OAGG;IACH,OAFU,KAAK,CAEE;IAEjB;;;;OAIG;IACH,gCAGE;IAEF,gCAA6D;IAC7D,kBAA6B;IAE7B,kCAAoD;IACpD,kCAA6C;IAC7C,gCAAuC;IAEvC,qDAAsF;IAGtF,kBAA6B;IAK7B;;;OAGG;IACH,eAFU,OAAO,CAEQ;IAEzB,sCAMC;IASD,6CAOE;IAEF,6CAOE;IAEF,6CAOE;IAEF,uCAOE;IAEF,uCAOE;IASF;;;;OAIG;IACH,yBAAyB;IAEzB;;;;OAIG;IACH,2BAA2B;IAG3B;;;;OAIG;IACH,4BAA+B;IAGnC,2BAEC;IAED;;;OAGG;IACH,gDAEC;IAED;;;;OAIG;IACH,UAHW,MAAM,KACN,MAAM,QA2BhB;IAED;;;OAGG;IACH,kBAFW,oBAAkB,kBAAkB,QAI9C;IAED;;;;OAIG;IACH,sCAyBC;IAED;;;;OAIG;IACH,6BAmBC;IAED;;;OAGG;IACH,mDAiDC;IAhDG,sCAA4B;IAkDhC;;;OAGG;IACH,2BAFW,MAAM,QA0ChB;IAED;;;;;OAKG;IACH,8BAyBC;IAED,wBAEC;IAED;;OAEG;IACH,uBAIC;IAED;;;;;OAKG;IACH,0CAgBC;IAED,wBAEC;IAGD;;;OAGG;IACH,0CAqBC;IAED,0BAeC;CACJ;sBAxmBM,OAAO;mCAAP,OAAO;+BAAP,OAAO;oCAAP,OAAO;qBAAP,OAAO;4BAAP,OAAO;kCAAP,OAAO"}
+{"version":3,"file":"OutlineRenderer.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/OutlineRenderer.js"],"names":[],"mappings":"AA+JA;IAQQ;;;OAGG;IACH,wBAAoB;IAEpB;;;OAGG;IACH,eAAkB;IAElB;;;OAGG;IACH,OAFU,KAAK,CAEE;IAEjB;;;;OAIG;IACH,gCAGE;IAEF,gCAA6D;IAC7D,kBAA6B;IAE7B,kCAAoD;IACpD,kCAA6C;IAC7C,gCAAuC;IAEvC,qDAAsF;IAGtF,kBAA6B;IAK7B;;;OAGG;IACH,eAFU,OAAO,CAEQ;IAEzB,sCAMC;IASD,6CAOE;IAEF,6CAOE;IAEF,6CAOE;IAEF,uCAOE;IAEF,uCAOE;IASF;;;;OAIG;IACH,yBAAyB;IAEzB;;;;OAIG;IACH,2BAA2B;IAG3B;;;;OAIG;IACH,4BAA+B;IAGnC,2BAEC;IAED;;;OAGG;IACH,gDAEC;IAED;;;;OAIG;IACH,UAHW,MAAM,KACN,MAAM,QA2BhB;IAED;;;OAGG;IACH,kBAFW,oBAAkB,kBAAkB,QAI9C;IAED;;;;OAIG;IACH,sCAyBC;IAED;;;;OAIG;IACH,6BAmBC;IAED;;;OAGG;IACH,mDAiDC;IAhDG,sCAA4B;IAkDhC;;;OAGG;IACH,2BAFW,MAAM,QA0ChB;IAED;;;;;OAKG;IACH,8BAyBC;IAED,wBAEC;IAED;;OAEG;IACH,uBAIC;IAED;;;;;OAKG;IACH,0CAgBC;IAED,wBAEC;IAGD;;;OAGG;IACH,0CAqBC;IAED,0BAeC;IAED;;;;OAIG;IACH,gBAcC;CACJ;sBA7nBM,OAAO;mCAAP,OAAO;+BAAP,OAAO;oCAAP,OAAO;qBAAP,OAAO;4BAAP,OAAO;kCAAP,OAAO"}

package/src/engine/graphics/ecs/highlight/renderer/OutlineRenderer.js

@@ -633,4 +633,25 @@ export class OutlineRenderer {
 
         this.isTargetClear = true;
     }
+
+    /**
+     * Release every GPU resource owned by this renderer. The objects themselves stay usable: three.js
+     * re-uploads a disposed texture/target/program on next use, so the renderer can be resized and
+     * rendered again afterwards.
+     */
+    dispose() {
+        this.__renderTargetObjectId_t0.dispose();
+        this.__renderTargetObjectId_t1.dispose();
+        this.__renderTargetObjectId_t2.dispose();
+        this.__renderTargetColor.dispose();
+        this.__renderTargetFinal.dispose();
+
+        this.__textureParametersColor.dispose();
+
+        this.__material_decode.dispose();
+        this.__material_dilate.dispose();
+        this.__material_blur.dispose();
+
+        this.__ss_mesh.geometry.dispose();
+    }
 }

package/src/engine/graphics/ecs/path/ribbon/RibbonPathBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RibbonPathBuilder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/path/ribbon/RibbonPathBuilder.js"],"names":[],"mappings":"AAaA;IAEQ;;;OAGG;IACH,OAFU,kBAAgB,IAAI,CAEb;IAEjB;;;OAGG;IACH,MAFU,OAAK,IAAI,CAEH;IAEhB;;;OAGG;IACH,QAFU,gBAAc,IAAI,CAEV;IAGtB;;;OAGG;IACH,uCAEC;IAED;;;OAGG;IACH,0BAEC;IAED;;;OAGG;IACH,uCAEC;IAED;;;OAGG;IACH,mBAFW,MAAM,EAAE,QAsFlB;CAEJ;mBAnJkB,2BAA2B"}
+{"version":3,"file":"RibbonPathBuilder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/path/ribbon/RibbonPathBuilder.js"],"names":[],"mappings":"AAYA;IAEQ;;;OAGG;IACH,OAFU,kBAAgB,IAAI,CAEb;IAEjB;;;OAGG;IACH,MAFU,OAAK,IAAI,CAEH;IAEhB;;;OAGG;IACH,QAFU,gBAAc,IAAI,CAEV;IAGtB;;;OAGG;IACH,uCAEC;IAED;;;OAGG;IACH,0BAEC;IAED;;;OAGG;IACH,uCAEC;IAED;;;OAGG;IACH,mBAFW,MAAM,EAAE,QAqElB;CAEJ;mBAjIkB,2BAA2B"}

package/src/engine/graphics/ecs/path/ribbon/RibbonPathBuilder.js

@@ -1,6 +1,5 @@
 import Vector3 from "../../../../../core/geom/Vector3.js";
 import Entity from "../../../../ecs/Entity.js";
-import { EventType } from "../../../../ecs/EventType.js";
 import Renderable from "../../../../ecs/renderable/Renderable.js";
 import { RenderableFlags } from "../../../../ecs/renderable/RenderableFlags.js";
 import { Transform } from "../../../../ecs/transform/Transform.js";
@@ -104,11 +103,13 @@ export class RibbonPathBuilder {
 
 
         const plugin = this.plugin;
-        const engine = plugin.engine;
-
-        const graphics = engine.graphics;
 
         const geometry = ribbon.getGeometry();
+
+        // the `resolution` uniform on this material is not ours to write: every material the plugin
+        // hands out shares one uniform object, which the plugin holds on the render resolution for
+        // its whole lifetime. Tracking it here as well meant one extra viewport subscription per
+        // ribbon entity, all writing that same object, and left the value to whichever fired last
         const material = plugin.obtain_material_x(style.material);
 
         const mesh = ThreeFactory.createMesh(geometry, material);
@@ -124,25 +125,6 @@ export class RibbonPathBuilder {
             .add(renderable)
             .add(new Transform());
 
-        function setResolution() {
-            material.uniforms.resolution.value.copy(graphics.viewport.size);
-        }
-
-        function handleEntityRemoved() {
-
-            graphics.viewport.size.onChanged.remove(setResolution);
-
-        }
-
-        entityBuilder.on.built.add(() => {
-            // set resolution
-            setResolution();
-
-            graphics.viewport.size.onChanged.add(setResolution);
-
-            entityBuilder.addEventListener(EventType.EntityRemoved, handleEntityRemoved);
-        });
-
         destination.push(entityBuilder);
     }
 

package/src/engine/graphics/ecs/path/tube/build/estimatePathViaIterativeIntegral.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"estimatePathViaIterativeIntegral.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/ecs/path/tube/build/estimatePathViaIterativeIntegral.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,sEAFW,MAAM,UA6BhB"}
+{"version":3,"file":"estimatePathViaIterativeIntegral.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/ecs/path/tube/build/estimatePathViaIterativeIntegral.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,sEAFW,MAAM,UA+BhB"}

package/src/engine/graphics/ecs/path/tube/build/estimatePathViaIterativeIntegral.js

@@ -19,14 +19,16 @@ export function estimatePathViaIterativeIntegral(path, epsilon) {
     }
 
     for (let p = epsilon; ; p += epsilon) {
-        const ended = path.sample(p1, p);
+        // sample returns false once the offset is clamped to the last point (offset >= length)
+        const on_path = path.sample(p1, p);
 
-        if (ended) {
+        // close the current segment either way; the final iteration adds the last piece up to the end point
+        sum += p0.distanceTo(p1);
+
+        if (!on_path) {
             break;
         }
 
-        sum += p0.distanceTo(p1);
-
         const swap = p1;
 
         p1 = p0;

package/src/engine/graphics/ecs/water/WaterSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WaterSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterSystem.js"],"names":[],"mappings":";AAaA;IAyBI;;;;OAIG;IACH,sCAmBC;IAhDD,+BAAuB;IAEvB;;;OAGG;IACH,cAFU,GAAG,CAEG;IAGhB,cAAY;IAEZ;;;OAGG;IACH,aAFU,KAAK,EAAE,CAEA;IAEjB;;;;OAIG;IACH,qBAAiB;IAWb,+BAA8B;IAE9B;;;OAGG;IACH,aAFU,cAAY,IAAI,CAEH;IAEvB;;;;OAIG;IACH,wBAA2B;IAK/B,4CASC;IAED,2CAkEC;IAED;;;;OAIG;IACH,gBAHW,KAAK,UACL,MAAM,QAsDhB;IAED;;;;OAIG;IACH,kBAHW,KAAK,UACL,MAAM,QAgBhB;IAED,2BAgCC;IAED;;;;;OAKG;IACH,0BAUC;IAED,6BAcC;CACJ;;;;uBA/RsB,wBAAwB;kBAM7B,YAAY;oBARV,mCAAmC"}
+{"version":3,"file":"WaterSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterSystem.js"],"names":[],"mappings":";AAaA;IAyBI;;;;OAIG;IACH,sCAmBC;IAhDD,+BAAuB;IAEvB;;;OAGG;IACH,cAFU,GAAG,CAEG;IAGhB,cAAY;IAEZ;;;OAGG;IACH,aAFU,KAAK,EAAE,CAEA;IAEjB;;;;OAIG;IACH,qBAAiB;IAWb,+BAA8B;IAE9B;;;OAGG;IACH,aAFU,cAAY,IAAI,CAEH;IAEvB;;;;OAIG;IACH,wBAA2B;IAK/B,4CASC;IAED,2CAwEC;IAED;;;;OAIG;IACH,gBAHW,KAAK,UACL,MAAM,QAsDhB;IAED;;;;OAIG;IACH,kBAHW,KAAK,UACL,MAAM,QAgBhB;IAED,2BAgCC;IAED;;;;;OAKG;IACH,0BAUC;IAED,6BAcC;CACJ;;;;uBArSsB,wBAAwB;kBAM7B,YAAY;oBARV,mCAAmC"}

package/src/engine/graphics/ecs/water/WaterSystem.js

@@ -81,7 +81,12 @@ class WaterSystem extends System {
 
         this.renderLayer = graphicsEngine.layers.create(WaterSystem.RENDER_LAYER_NAME);
 
-        const viewport_size = graphicsEngine.viewport.size;
+        // the water shader reads the shared depth attachment at `gl_FragCoord.xy / vScreenResolution`,
+        // so the uniform has to name that attachment's own texel grid. `output_resolution` is the value
+        // the frame buffers are sized from, whole texels and all; recomputing it here from the CSS
+        // viewport size and a freshly read `window.devicePixelRatio` reproduced it only up to rounding,
+        // and only while the DPR had not moved since the last resize
+        const output_resolution = graphicsEngine.output_resolution;
 
         this.renderLayer.buildVisibleSet = make_bvh_visibility_builder(
             this.entityManager, this.bvh,
@@ -125,7 +130,8 @@ class WaterSystem extends System {
                 return;
             }
 
-            const pixelRatio = graphicsEngine.computeTotalPixelRatio();
+            const resolution_x = output_resolution.x;
+            const resolution_y = output_resolution.y;
 
             dataset.traverseComponents(Water, function (component, entity) {
                 const shader = component.__shader;
@@ -133,7 +139,7 @@ class WaterSystem extends System {
                 shader.uniforms.fCameraNear.value = camera.near;
                 shader.uniforms.fCameraFar.value = camera.far;
 
-                shader.uniforms.vScreenResolution.value.set(viewport_size.x * pixelRatio, viewport_size.y * pixelRatio);
+                shader.uniforms.vScreenResolution.value.set(resolution_x, resolution_y);
 
             });
         }

package/src/engine/graphics/particles/ecs/ParticleEmitterSystem.d.ts

@@ -14,6 +14,18 @@ export class ParticleEmitterSystem extends System<any> {
      */
     renderLayer: RenderLayer | null;
     __handlers: any[];
+    /**
+     * `output_resolution` observer installed in startup, kept so shutdown can detach it
+     * @type {Function|null}
+     * @private
+     */
+    private __viewportSizeHook;
+    /**
+     * preRender hook installed in startup, kept so shutdown can detach it
+     * @type {Function|null}
+     * @private
+     */
+    private __preRenderHook;
     /**
      *
      * @type {GraphicsEngine}

package/src/engine/graphics/particles/ecs/ParticleEmitterSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParticleEmitterSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/particles/ecs/ParticleEmitterSystem.js"],"names":[],"mappings":"AAaA;IAeI;;;;;OAKG;IACH,4BAwBC;IA5CD,4DAA4C;IAE5C,uEAEE;IAEF;;;OAGG;IACH,aAFU,cAAY,IAAI,CAEP;IAEnB,kBAAgB;IAcZ;;;OAGG;IACH,+BAAqC;IAErC;;;OAGG;IACH,2BAAuC;IAEvC;;;OAGG;IACH,gBAFU,gBAAgB,CAE2E;IAIzG,2CA8HC;IAED,4CAEC;IAED;;;;;OAKG;IACH,cAJW,eAAe,aACf,SAAS,qBAoCnB;IAED;;;;;OAKG;IACH,gBAJW,eAAe,aACf,SAAS,qBAenB;IAED,6BAEC;CACJ;uBA3PsB,wBAAwB;0BACrB,qCAAqC;gCAG/B,iDAAiD;4CANrC,uDAAuD;iCAQlE,0CAA0C"}
+{"version":3,"file":"ParticleEmitterSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/particles/ecs/ParticleEmitterSystem.js"],"names":[],"mappings":"AAaA;IA6BI;;;;;OAKG;IACH,4BAwBC;IA1DD,4DAA4C;IAE5C,uEAEE;IAEF;;;OAGG;IACH,aAFU,cAAY,IAAI,CAEP;IAEnB,kBAAgB;IAEhB;;;;OAIG;IACH,2BAA0B;IAE1B;;;;OAIG;IACH,wBAAuB;IAcnB;;;OAGG;IACH,+BAAqC;IAErC;;;OAGG;IACH,2BAAuC;IAEvC;;;OAGG;IACH,gBAFU,gBAAgB,CAE2E;IAIzG,2CAiIC;IAED,4CAsBC;IAED;;;;;OAKG;IACH,cAJW,eAAe,aACf,SAAS,qBAoCnB;IAED;;;;;OAKG;IACH,gBAJW,eAAe,aACf,SAAS,qBAenB;IAED,6BAEC;CACJ;uBAhSsB,wBAAwB;0BACrB,qCAAqC;gCAG/B,iDAAiD;4CANrC,uDAAuD;iCAQlE,0CAA0C"}

package/src/engine/graphics/particles/ecs/ParticleEmitterSystem.js

@@ -26,6 +26,20 @@ export class ParticleEmitterSystem extends System {
 
     __handlers = [];
 
+    /**
+     * `output_resolution` observer installed in startup, kept so shutdown can detach it
+     * @type {Function|null}
+     * @private
+     */
+    __viewportSizeHook = null;
+
+    /**
+     * preRender hook installed in startup, kept so shutdown can detach it
+     * @type {Function|null}
+     * @private
+     */
+    __preRenderHook = null;
+
     /**
      *
      * @extends {System.<ParticleEmitter>}
@@ -124,16 +138,18 @@ export class ParticleEmitterSystem extends System {
         this.particleEngine.setDepthTexture(depthTexture);
 
 
-        function updateViewportSize() {
-            const size = graphicsEngine.viewport.size;
-
-            const pixelRatio = graphicsEngine.computeTotalPixelRatio();
-
-            self.particleEngine.setViewportSize(size.x * pixelRatio, size.y * pixelRatio);
+        // device pixels, not CSS pixels. The billboard shader spends this value on the render target's
+        // own grid twice over: `gl_FragCoord.xy / resolution` reads the depth attachment acquired just
+        // above, and `gl_PointSize` is measured in framebuffer pixels. `output_resolution` is what that
+        // attachment is sized from -- rebuilding it here from the CSS size and a freshly read
+        // `window.devicePixelRatio` matched only up to rounding, and only until the DPR moved without
+        // a resize behind it
+        function updateViewportSize(x, y) {
+            self.particleEngine.setViewportSize(x, y);
         }
 
-        graphicsEngine.viewport.size.process(updateViewportSize);
-        graphicsEngine.pixelRatio.onChanged.add(updateViewportSize);
+        this.__viewportSizeHook = updateViewportSize;
+        graphicsEngine.output_resolution.process(updateViewportSize);
 
         function preRenderHook(renderer, camera, scene) {
             //update camera
@@ -183,11 +199,32 @@ export class ParticleEmitterSystem extends System {
             }
         }
 
+        this.__preRenderHook = preRenderHook;
         graphicsEngine.on.preRender.add(preRenderHook);
     }
 
     async shutdown(entityManager) {
-        this.graphicsEngine.layers.remove(this.renderLayer);
+        const graphicsEngine = this.graphicsEngine;
+
+        if (this.__viewportSizeHook !== null) {
+            graphicsEngine.output_resolution.onChanged.remove(this.__viewportSizeHook);
+            this.__viewportSizeHook = null;
+        }
+
+        if (this.__preRenderHook !== null) {
+            // left attached, the hook keeps driving the particle simulation for a system that is gone, and
+            // keeps taking a reference on the ColorAndDepth frame buffer every frame the last visible set
+            // was non-empty, so FrameBufferManager goes on rendering that buffer for nobody
+            graphicsEngine.on.preRender.remove(this.__preRenderHook);
+            this.__preRenderHook = null;
+        }
+
+        graphicsEngine.layers.remove(this.renderLayer);
+
+        // every emitter has already been unlinked by this point: both teardown paths detach the dataset
+        // (EntityManager#shutdown) or remove the system observer (EntityManager#removeSystem) before
+        // calling shutdown, so `unlink` has run for each one
+        this.particleEngine.dispose();
     }
 
     /**

package/src/engine/graphics/particles/particular/engine/ParticularEngine.d.ts

@@ -45,6 +45,11 @@ export class ParticularEngine {
     setCamera(camera: THREE.Camera): void;
     setDepthTexture(texture: any): void;
     setViewportSize(x: any, y: any): void;
+    /**
+     * Hand back the resources held on behalf of the managed emitters. Emitters themselves are owned by
+     * their components and are disposed by {@link ParticleEmitter#dispose} as they are removed.
+     */
+    dispose(): void;
     /**
      * @private
      * @param {ParticleEmitter} emitter

package/src/engine/graphics/particles/particular/engine/ParticularEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParticularEngine.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/particles/particular/engine/ParticularEngine.js"],"names":[],"mappings":"AAUA;IA+BI;;;;;OAKG;IACH,2EAEC;IAtCD;;;OAGG;IACH,QAFU,MAAM,MAAM,GAAC,IAAI,CAEb;IAEd;;;OAGG;IACH,UAFU,qBAAsB,CAEV;IAEtB;;;OAGG;IACH,cAFU,GAAG,CAEG;IAGhB;;;OAGG;IACH,OAFU,wBAAwB,CAOhC;IASE,6BAAsE;IAG1E;;;OAGG;IACH,oCAaC;IAED;;;;OAIG;IACH,kCAFa,OAAO,CAenB;IAED;;;OAGG;IACH,kBAFW,MAAM,MAAM,QAKtB;IAED,oCAEC;IAED,sCAEC;IAED;;;;OAIG;IACH,uBAsEC;IAED;;;;OAIG;IACH,sBAuCC;IAED;;;OAGG;IACH,mBAFW,MAAM,QAWhB;CACJ;iBAnPgB,6CAA6C;oBAD1C,sCAAsC;8BAG5B,2BAA2B"}
+{"version":3,"file":"ParticularEngine.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/particles/particular/engine/ParticularEngine.js"],"names":[],"mappings":"AAUA;IA+BI;;;;;OAKG;IACH,2EAEC;IAtCD;;;OAGG;IACH,QAFU,MAAM,MAAM,GAAC,IAAI,CAEb;IAEd;;;OAGG;IACH,UAFU,qBAAsB,CAEV;IAEtB;;;OAGG;IACH,cAFU,GAAG,CAEG;IAGhB;;;OAGG;IACH,OAFU,wBAAwB,CAOhC;IASE,6BAAsE;IAG1E;;;OAGG;IACH,oCAaC;IAED;;;;OAIG;IACH,kCAFa,OAAO,CAenB;IAED;;;OAGG;IACH,kBAFW,MAAM,MAAM,QAKtB;IAED,oCAEC;IAED,sCAEC;IAED;;;OAGG;IACH,gBAEC;IAED;;;;OAIG;IACH,uBAsEC;IAED;;;;OAIG;IACH,sBAuCC;IAED;;;OAGG;IACH,mBAFW,MAAM,QAWhB;CACJ;iBA3PgB,6CAA6C;oBAD1C,sCAAsC;8BAG5B,2BAA2B"}

package/src/engine/graphics/particles/particular/engine/ParticularEngine.js

@@ -105,6 +105,14 @@ export class ParticularEngine {
         this.shaderManager.setViewportSize(x, y);
     }
 
+    /**
+     * Hand back the resources held on behalf of the managed emitters. Emitters themselves are owned by
+     * their components and are disposed by {@link ParticleEmitter#dispose} as they are removed.
+     */
+    dispose() {
+        this.shaderManager.dispose();
+    }
+
     /**
      * @private
      * @param {ParticleEmitter} emitter

package/src/engine/graphics/particles/particular/engine/shader/MaterialRecord.d.ts

@@ -4,6 +4,13 @@ export class MaterialRecord {
      * @type {Material}
      */
     material: Material;
+    /**
+     * The reference {@link MaterialManager#obtain} handed out for {@link MaterialRecord#material}. Held so
+     * the material can be given back; the manager decides when to actually dispose it, as the compiled
+     * material is shared by content hash with every other consumer that asked for the same shader.
+     * @type {Reference<Material>|null}
+     */
+    material_reference: Reference<Material> | null;
     /**
      *
      * @type {number}

package/src/engine/graphics/particles/particular/engine/shader/MaterialRecord.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MaterialRecord.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/shader/MaterialRecord.js"],"names":[],"mappings":"AAAA;IAEI;;;OAGG;IACH,mBAAgB;IAEhB;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,gBAFU,eAAe,CAEL;IAEpB;;;OAGG;IACH,UAFU,iBAAiB,CAEb;IAEd;;;OAGG;IACH,YAFU,eAAa,IAAI,CAET;IAElB;;;OAGG;IACH,gBAFU,MAAM,CAEG;CAEtB"}
+{"version":3,"file":"MaterialRecord.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/shader/MaterialRecord.js"],"names":[],"mappings":"AAAA;IAEI;;;OAGG;IACH,mBAAgB;IAEhB;;;;;OAKG;IACH,oBAFU,sBAAoB,IAAI,CAER;IAE1B;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,gBAFU,eAAe,CAEL;IAEpB;;;OAGG;IACH,UAFU,iBAAiB,CAEb;IAEd;;;OAGG;IACH,YAFU,eAAa,IAAI,CAET;IAElB;;;OAGG;IACH,gBAFU,MAAM,CAEG;CAEtB"}

package/src/engine/graphics/particles/particular/engine/shader/MaterialRecord.js

@@ -6,6 +6,14 @@ export class MaterialRecord {
      */
     material = null;
 
+    /**
+     * The reference {@link MaterialManager#obtain} handed out for {@link MaterialRecord#material}. Held so
+     * the material can be given back; the manager decides when to actually dispose it, as the compiled
+     * material is shared by content hash with every other consumer that asked for the same shader.
+     * @type {Reference<Material>|null}
+     */
+    material_reference = null;
+
     /**
      *
      * @type {number}

package/src/engine/graphics/particles/particular/engine/shader/ShaderManager.d.ts

@@ -65,7 +65,7 @@ export class ShaderManager {
     private updateSpriteTexture;
     /**
      * @private
-     * @returns {Material}
+     * @returns {Reference<Material>}
      * @param {ParticleEmitter} emitter
      */
     private buildMaterial;
@@ -101,7 +101,15 @@ export class ShaderManager {
      */
     setViewportSize(x: number, y: number): void;
     /**
-     * Dispose of any used resources
+     * Hand back every resource this manager acquired.
+     *
+     * Materials are given back to the {@link MaterialManager} rather than disposed here: the compiled
+     * material is shared by content hash with every other consumer that asked for the same shader, so the
+     * manager is the only thing that can know when the last user is gone. Releasing is therefore safe
+     * whichever way the teardown ordering falls, even for a material a live mesh still points at.
+     *
+     * The manager is left able to re-acquire, so a system that starts up again gets working materials and
+     * a working sprite sheet without being rebuilt.
      */
     dispose(): void;
     #private;

package/src/engine/graphics/particles/particular/engine/shader/ShaderManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShaderManager.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/shader/ShaderManager.js"],"names":[],"mappings":"AA0FA;IAOI;;;;;OAKG;IACH,4EAuGC;IAnGG;;;;OAIG;IACH,2BAA0C;IAE1C;;;OAGG;IACH,aAFU,YAAY,CAE4B;IAElD;;;OAGG;IACH,eAFU,WAAW,GAAC,IAAI,CAOxB;IAIF;;;OAGG;IACH,cAFU,UAAQ,IAAI,CAEE;IAExB;;;;;OAKG;IACH,6BAGE;IAEF;;;OAGG;IACH,qBAFU,MAAM,CAEa;IAE7B;;;;OAIG;IACH,iCAGE;IAEF;;;OAGG;IACH,cAFU,OAAO,CAEoB;IAKrC;;;OAGG;IACH,0BAwBC;IAKL;;OAEG;IACH,eAEC;IAGD;;OAEG;IACH,4BAuBC;IAED;;;;OAIG;IACH,sBAmBC;IAED;;;OAGG;IACH,yCA+CC;IAED;;OAEG;IACH,gBA2BC;IAED;;;OAGG;IACH,2CA8CC;IAED;;;OAGG;IACH,gCAiBC;IAhBG,eAAoB;IAkBxB;;;OAGG;IACH,wCAKC;IAED;;;;OAIG;IACH,mBAHW,MAAM,KACN,MAAM,QAMhB;IAED;;OAEG;IACH,gBAEC;;CACJ;6BA7b4B,kDAAkD;4BAJxE,OAAO;oBAGM,wCAAwC"}
+{"version":3,"file":"ShaderManager.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/shader/ShaderManager.js"],"names":[],"mappings":"AA0FA;IAOI;;;;;OAKG;IACH,4EAuGC;IAnGG;;;;OAIG;IACH,2BAA0C;IAE1C;;;OAGG;IACH,aAFU,YAAY,CAE4B;IAElD;;;OAGG;IACH,eAFU,WAAW,GAAC,IAAI,CAOxB;IAIF;;;OAGG;IACH,cAFU,UAAQ,IAAI,CAEE;IAExB;;;;;OAKG;IACH,6BAGE;IAEF;;;OAGG;IACH,qBAFU,MAAM,CAEa;IAE7B;;;;OAIG;IACH,iCAGE;IAEF;;;OAGG;IACH,cAFU,OAAO,CAEoB;IAKrC;;;OAGG;IACH,0BAwBC;IAKL;;OAEG;IACH,eAEC;IAGD;;OAEG;IACH,4BAuBC;IAED;;;;OAIG;IACH,sBAeC;IAED;;;OAGG;IACH,yCAkDC;IAED;;OAEG;IACH,gBAiCC;IAED;;;OAGG;IACH,2CAiDC;IAED;;;OAGG;IACH,gCAiBC;IAhBG,eAAoB;IAkBxB;;;OAGG;IACH,wCAKC;IAED;;;;OAIG;IACH,mBAHW,MAAM,KACN,MAAM,QAMhB;IAED;;;;;;;;;;OAUG;IACH,gBAiBC;;CACJ;6BA5d4B,kDAAkD;4BAJxE,OAAO;oBAGM,wCAAwC"}

package/src/engine/graphics/particles/particular/engine/shader/ShaderManager.js

@@ -244,7 +244,7 @@ export class ShaderManager {
 
     /**
      * @private
-     * @returns {Material}
+     * @returns {Reference<Material>}
      * @param {ParticleEmitter} emitter
      */
     buildMaterial(emitter) {
@@ -261,11 +261,7 @@ export class ShaderManager {
         defs.DEPTH_SOFT_ENABLED = !emitter.getFlag(ParticleEmitterFlag.DepthSoftDisabled);
         defs.ALIGN_DIRECTION_ENABLED = emitter.getFlag(ParticleEmitterFlag.AlignOnVelocity);
 
-        const ref = this.__material_manager.obtain(shader);
-
-        // TODO track reference and release it eventually
-
-        return ref.getValue();
+        return this.__material_manager.obtain(shader);
     }
 
     /**
@@ -299,6 +295,9 @@ export class ShaderManager {
         if (this.materialMap.has(emitter)) {
             entry = this.materialMap.get(emitter);
 
+            // the record is in use again, so it is no longer a candidate for the graveyard eviction in
+            // `cleanup`, which releases the material reference the record still hands to live emitters
+            this.recordGraveyard.delete(emitter);
 
             material = entry.material;
         } else {
@@ -338,6 +337,8 @@ export class ShaderManager {
                 }
             });
 
+            const evicted = this.recordGraveyard.get(bestKey);
+
             if (!this.recordGraveyard.delete(bestKey)) {
                 console.error(`Failed to remove record from the graveyard`, bestKey, this.recordGraveyard);
 
@@ -350,6 +351,10 @@ export class ShaderManager {
             }
 
             this.materialMap.delete(bestKey);
+
+            // the record is leaving both maps, so this is the last chance to hand the material back;
+            // only unused records reach the graveyard, `register` takes a resurrected one back out of it
+            evicted.material_reference.release();
         }
     }
 
@@ -381,6 +386,9 @@ export class ShaderManager {
 
             if (ref !== undefined) {
                 ref.release();
+
+                // the reference is spent, and the map is what keeps the layer reachable
+                this.#sprite_references.delete(layer);
             }
 
             layer.setAtlasPatch(null); // clear patch
@@ -451,10 +459,33 @@ export class ShaderManager {
     }
 
     /**
-     * Dispose of any used resources
+     * Hand back every resource this manager acquired.
+     *
+     * Materials are given back to the {@link MaterialManager} rather than disposed here: the compiled
+     * material is shared by content hash with every other consumer that asked for the same shader, so the
+     * manager is the only thing that can know when the last user is gone. Releasing is therefore safe
+     * whichever way the teardown ordering falls, even for a material a live mesh still points at.
+     *
+     * The manager is left able to re-acquire, so a system that starts up again gets working materials and
+     * a working sprite sheet without being rebuilt.
      */
     dispose() {
-        // TODO implement
+        // the graveyard is a subset of `materialMap` - `deregister` adds an unused record to the graveyard
+        // without taking it out of the material map, and `cleanup` is what drops it from both
+        this.materialMap.forEach(record => {
+            record.material_reference.release();
+        });
+
+        this.materialMap.clear();
+        this.recordGraveyard.clear();
+
+        for (const reference of this.#sprite_references.values()) {
+            reference.release();
+        }
+
+        this.#sprite_references.clear();
+
+        this.spriteTexture.dispose();
     }
 }
 
@@ -469,9 +500,10 @@ function createShaderEntry(emitter, shaderManager) {
     entry.count = 0;
     entry.parameters = emitter.parameters;
 
-    const material = shaderManager.buildMaterial(emitter);
+    const material_reference = shaderManager.buildMaterial(emitter);
 
-    entry.material = material;
+    entry.material_reference = material_reference;
+    entry.material = material_reference.getValue();
 
     //link all signal bindings
     entry.signalBindings.forEach(function (b) {

package/src/engine/graphics/render/buffer/FrameBuffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrameBuffer.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/render/buffer/FrameBuffer.js"],"names":[],"mappings":"AAGA;IAyBI;;;;OAIG;IACH,gBAHW,MAAM,EAWhB;IArCD;;;OAGG;IACH,cAFU,iBAAiB,CAEP;IAEpB;;;OAGG;IACH,gBAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,cAFU,MAAM,EAAE,CAEA;IAElB;;;OAGG;IACH,MAFU,OAAO,CAEQ;IAQrB;;;OAGG;IACH,IAFU,MAAM,CAEJ;IAKhB;;;OAGG;IACH,mBAFa,iBAAiB,+BAA6B,CAI1D;IAED;;;OAGG;IACH,0CAEC;IAED;;;OAGG;IACH,wCAEC;IAED;;;;;;OAMG;IACH,4EAFW,WAAW,EAAE,QAYvB;IAED;;;;OAIG;IACH,WAHW,MAAM,KACN,MAAM,QAgBhB;CACJ;kCA1GiC,OAAO;oBACrB,kCAAkC"}
+{"version":3,"file":"FrameBuffer.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/render/buffer/FrameBuffer.js"],"names":[],"mappings":"AAGA;IAyBI;;;;OAIG;IACH,gBAHW,MAAM,EAWhB;IArCD;;;OAGG;IACH,cAFU,iBAAiB,CAEP;IAEpB;;;OAGG;IACH,gBAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,cAFU,MAAM,EAAE,CAEA;IAElB;;;OAGG;IACH,MAFU,OAAO,CAEQ;IAQrB;;;OAGG;IACH,IAFU,MAAM,CAEJ;IAKhB;;;OAGG;IACH,mBAFa,iBAAiB,+BAA6B,CAI1D;IAED;;;OAGG;IACH,0CAEC;IAED;;;OAGG;IACH,wCAEC;IAED;;;;;;OAMG;IACH,4EAFW,WAAW,EAAE,QAYvB;IAED;;;;OAIG;IACH,WAHW,MAAM,KACN,MAAM,QAmBhB;CACJ;kCA7GiC,OAAO;oBACrB,kCAAkC"}

package/src/engine/graphics/render/buffer/FrameBuffer.js

@@ -92,9 +92,12 @@ export class FrameBuffer {
     setSize(x, y) {
         const size = this.size;
 
+        // a render target is a whole number of texels; WebGL truncates fractional dimensions when it
+        // allocates, so round here too, otherwise `renderTarget.width` reports a size the texture does
+        // not have and any texel math built from it is off by up to a texel
         // clamp to 1: a 0-sized attachment trips GL_INVALID_FRAMEBUFFER_OPERATION on clear/draw
-        const w = Math.max(1, x);
-        const h = Math.max(1, y);
+        const w = Math.max(1, Math.floor(x));
+        const h = Math.max(1, Math.floor(y));
 
         if (w === size.x && h === size.y) {
             // nothing changed

package/src/engine/graphics/render/buffer/simple-fx/ao/AmbientOcclusionPostProcessEffect.d.ts

@@ -60,7 +60,12 @@ export class AmbientOcclusionPostProcessEffect extends EnginePlugin {
      * @private
      */
     private __setCamera;
-    __prepare_uniforms(): void;
+    /**
+     *
+     * @param {GraphicsEngine} graphics
+     * @private
+     */
+    private __prepare_uniforms;
     __prepare_draw(): void;
     /**
      *
@@ -84,6 +89,13 @@ export class AmbientOcclusionPostProcessEffect extends EnginePlugin {
      * @private
      */
     private __remove_used_frame_buffer;
+    /**
+     * Give back every frame buffer reference this plugin holds. `__use_normals` is deliberately left
+     * alone, so a subsequent {@link AmbientOcclusionPostProcessEffect#startup} re-acquires the same
+     * buffers through {@link AmbientOcclusionPostProcessEffect#setNormalBufferUsage}.
+     * @private
+     */
+    private __release_used_frame_buffers;
     __update_render_target_size(): void;
 }
 import { EnginePlugin } from "../../../../../plugin/EnginePlugin.js";

package/src/engine/graphics/render/buffer/simple-fx/ao/AmbientOcclusionPostProcessEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AmbientOcclusionPostProcessEffect.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/render/buffer/simple-fx/ao/AmbientOcclusionPostProcessEffect.js"],"names":[],"mappings":"AAoBA;IAQQ,2BAQE;IAyBF;;;;OAIG;IACH,sBAA0B;IAE1B;;;;OAIG;IACH,2BAA6B;IAG7B;;;;OAIG;IACH,yBAA4B;IAE5B;;;;OAIG;IACH,wBAA2B;IAE3B,8CAUE;IAEF;;;;OAIG;IACH,uBAAwB;IAExB;;;;;OAKG;IACH,2BASE;IAKF;;;;OAIG;IACH,0BAAwD;IAK5D;;;OAGG;IACH,2BAEC;IAED;;;OAGG;IACH,wBAEC;IAED;;;;OAIG;IACH,oBAeC;IAMD,2BAoCC;IAED,uBASC;IAED;;;OAGG;IACH,iBAwBC;IAED;;;OAGG;IACH,4BAFW,OAAO,QAiCjB;IAED;;;;OAIG;IACH,gCASC;IAED;;;;OAIG;IACH,mCAUC;IAGD,oCAiBC;CAkEJ;6BApZ4B,uCAAuC;+BAD7D,OAAO;6CAAP,OAAO"}
+{"version":3,"file":"AmbientOcclusionPostProcessEffect.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/render/buffer/simple-fx/ao/AmbientOcclusionPostProcessEffect.js"],"names":[],"mappings":"AAoBA;IAQQ,2BAQE;IAyBF;;;;OAIG;IACH,sBAA0B;IAE1B;;;;OAIG;IACH,2BAA6B;IAG7B;;;;OAIG;IACH,yBAA4B;IAE5B;;;;OAIG;IACH,wBAA2B;IAE3B,8CAUE;IAEF;;;;OAIG;IACH,uBAAwB;IAExB;;;;;OAKG;IACH,2BASE;IAKF;;;;OAIG;IACH,0BAAwD;IAK5D;;;OAGG;IACH,2BAEC;IAED;;;OAGG;IACH,wBAEC;IAED;;;;OAIG;IACH,oBAeC;IAMD;;;;OAIG;IACH,2BA2CC;IAED,uBASC;IAED;;;OAGG;IACH,iBAwBC;IAED;;;OAGG;IACH,4BAFW,OAAO,QAiCjB;IAED;;;;OAIG;IACH,gCASC;IAED;;;;OAIG;IACH,mCAUC;IAED;;;;;OAKG;IACH,qCAQC;IAGD,oCAiBC;CAuEJ;6BArb4B,uCAAuC;+BAD7D,OAAO;6CAAP,OAAO"}

package/src/engine/graphics/render/buffer/simple-fx/ao/AmbientOcclusionPostProcessEffect.js

@@ -179,7 +179,12 @@ export class AmbientOcclusionPostProcessEffect extends EnginePlugin {
         super.finalize();
     }
 
-    __prepare_uniforms() {
+    /**
+     *
+     * @param {GraphicsEngine} graphics
+     * @private
+     */
+    __prepare_uniforms(graphics) {
 
         const material = this.__material;
 
@@ -188,8 +193,14 @@ export class AmbientOcclusionPostProcessEffect extends EnginePlugin {
         const camera = this.__render_camera;
 
         // AO renders at half-res but samples the full-res depth buffer, so `size` is the full (depth)
-        // resolution -- all texel math then lands on depth texel centres rather than texel boundaries
-        uniforms.size.value.set(this.__composit_layer.renderTarget.width, this.__composit_layer.renderTarget.height);
+        // resolution -- all texel math then lands on depth texel centres rather than texel boundaries.
+        // Read it from `output_resolution`, the value the depth frame buffer is itself sized from:
+        // deriving it from any other buffer only holds while that buffer agrees, and a `size` that
+        // disagrees with the depth texture collapses the reconstructed normals (neighbour taps land
+        // inside the centre texel, so every depth delta reads as zero).
+        const output_resolution = graphics.output_resolution;
+
+        uniforms.size.value.copy(output_resolution);
 
         // setup camera
         const near = camera.near;
@@ -205,12 +216,13 @@ export class AmbientOcclusionPostProcessEffect extends EnginePlugin {
         // trigger uniform update
         material.uniformsNeedUpdate = true;
 
-        // upscale runs at full resolution (the composit layer), reading the half-res AO target
+        // upscale runs at full resolution (the composit layer), reading the half-res AO target. `size`
+        // must be the same full-res grid the AO pass used, since the upscale reproduces its depth-texel
+        // snapping to judge each tap
         const upscale = this.__upscale_material;
         const upscaleUniforms = upscale.uniforms;
-        const output = this.__composit_layer.renderTarget;
 
-        upscaleUniforms.size.value.set(output.width, output.height);
+        upscaleUniforms.size.value.copy(output_resolution);
         upscaleUniforms.cameraNear.value = near;
         upscaleUniforms.cameraFar.value = far;
 
@@ -224,7 +236,7 @@ export class AmbientOcclusionPostProcessEffect extends EnginePlugin {
 
         this.__setCamera(camera);
 
-        this.__prepare_uniforms();
+        this.__prepare_uniforms(graphics);
 
     }
 
@@ -328,6 +340,22 @@ export class AmbientOcclusionPostProcessEffect extends EnginePlugin {
         this.__used_buffers.splice(i, 1);
     }
 
+    /**
+     * Give back every frame buffer reference this plugin holds. `__use_normals` is deliberately left
+     * alone, so a subsequent {@link AmbientOcclusionPostProcessEffect#startup} re-acquires the same
+     * buffers through {@link AmbientOcclusionPostProcessEffect#setNormalBufferUsage}.
+     * @private
+     */
+    __release_used_frame_buffers() {
+        const buffers = this.__used_buffers;
+
+        for (const buffer of buffers) {
+            buffer.referenceCount--;
+        }
+
+        buffers.length = 0;
+    }
+
 
     __update_render_target_size() {
         const engine = this.engine;
@@ -404,7 +432,12 @@ export class AmbientOcclusionPostProcessEffect extends EnginePlugin {
         this.__composit_layer.on.preRender.remove(this.__render, this);
         graphics.output_resolution.onChanged.remove(this.__update_render_target_size, this);
 
+        // hand back the frame buffers we pinned, otherwise FrameBufferManager keeps rendering them
+        // for a plugin that is no longer there
+        this.__release_used_frame_buffers();
+
         // release memory
+        this.__material.dispose();
         this.__upscale_material.dispose();
         this.__hilbert_texture.dispose();
         this.__render_target.dispose();

package/src/engine/graphics/render/buffer/simple-fx/taa/TemporalSupersamplingRenderPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TemporalSupersamplingRenderPlugin.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/render/buffer/simple-fx/taa/TemporalSupersamplingRenderPlugin.js"],"names":[],"mappings":"AAIA;IAIQ;;;;OAIG;IACH,sBAAsB;IAEtB,uBAAwB;IACxB,8BAAkE;IAGlE;QACI;;;;WAIG;2BAFQ,MAAM,EAAE,UACR,MAAM,EAAE;MAkBtB;IAGL,2BAIC;IAED,8BAEC;CAyBJ;6BA3E4B,uCAAuC"}
+{"version":3,"file":"TemporalSupersamplingRenderPlugin.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/render/buffer/simple-fx/taa/TemporalSupersamplingRenderPlugin.js"],"names":[],"mappings":"AAIA;IAIQ;;;;OAIG;IACH,sBAAsB;IAEtB,uBAAwB;IACxB,8BAAkE;IAGlE;QACI;;;;WAIG;2BAFQ,MAAM,EAAE,UACR,MAAM,EAAE;MAwBtB;IAGL,2BAIC;IAED,8BAEC;CAyBJ;6BAjF4B,uCAAuC"}