@woosh/meep-engine 3.53.0 → 3.54.0

package/src/engine/graphics3/GPUParticleEmitterSystem.d.ts

@@ -22,11 +22,6 @@
  * @returns {boolean} whether the emitter differs from what it held before
  */
 export function apply_particle_effect(emitter: ParticleEmitter, effect: ParticleEffect): boolean;
-/**
- * @typedef {object} ParticleAtlasTexture
- * @property {number} references Number of entities using this URL.
- * @property {import("../graphics/texture/atlas/AtlasPatch.js").AtlasPatch|null} patch Null while loading or after failure.
- */
 /**
  * @typedef {object} ParticleEmitterEntry
  * @property {number} entity
@@ -38,7 +33,7 @@ export function apply_particle_effect(emitter: ParticleEmitter, effect: Particle
  * registered it, or after a device restart took that context away
  * @property {function():void} on_transform_changed
  * @property {string|null} url last observed {@link ParticleEffect#texture}
- * @property {ParticleAtlasTexture|null} texture shared image record, or null for an untextured effect
+ * @property {import("../graphics/texture/atlas/ManagedTextureAtlas.js").ManagedAtlasReference|null} texture shared image reference, or null for an untextured effect
  */
 /**
  * Draws the game's GPU particle effects: one emitter per entity carrying
@@ -78,8 +73,9 @@ export function apply_particle_effect(emitter: ParticleEmitter, effect: Particle
  * ## It owns the scene's sprite atlas
  *
  * Every {@link ParticleEffect#texture} is loaded through the supplied `AssetManager` and packed into
- * one {@link TextureAtlas} shared by the scene, one patch per distinct URL however many entities
- * name it, reference-counted so the last entity to let go is what unpacks it. A `FrameStart`
+ * one {@link SpriteAtlas} shared by the scene, one patch per distinct URL however many entities
+ * name it, reference-counted through {@link ManagedAtlas} so unreferenced sprites remain in the
+ * atlas graveyard and are only reaped when incoming sprites need the space. A `FrameStart`
  * extension publishes the pixels and every current patch region before the renderer records the
  * particle passes — every repack moves UVs that nothing else changed, so the regions are rewritten
  * whole rather than when a URL changes. Pending and failed images sample a transparent texel;
@@ -107,9 +103,9 @@ export class GPUParticleEmitterSystem extends System<any> {
     dependencies: (typeof Transform64 | typeof ParticleEffect)[];
     /**
      * CPU atlas, exposed for inspection. Owned by this system.
-     * @type {TextureAtlas}
+     * @type {SpriteAtlas}
      */
-    atlas: TextureAtlas;
+    atlas: SpriteAtlas;
     /**
      * The scene the emitters are put in. Received rather than created: meshes and lights come from
      * systems of their own, and all of them have to be writing into one scene for any of it to be
@@ -189,16 +185,6 @@ export class GPUParticleEmitterSystem extends System<any> {
     prepare(frame: import("../../shade/renderer/extension/FrameContext.js").FrameContext): void;
     #private;
 }
-export type ParticleAtlasTexture = {
-    /**
-     * Number of entities using this URL.
-     */
-    references: number;
-    /**
-     * Null while loading or after failure.
-     */
-    patch: import("../graphics/texture/atlas/AtlasPatch.js").AtlasPatch | null;
-};
 export type ParticleEmitterEntry = {
     entity: number;
     /**
@@ -224,12 +210,13 @@ export type ParticleEmitterEntry = {
      */
     url: string | null;
     /**
-     * shared image record, or null for an untextured effect
+     * shared image reference, or null for an untextured effect
      */
-    texture: ParticleAtlasTexture | null;
+    texture: import("../graphics/texture/atlas/ManagedTextureAtlas.js").ManagedAtlasReference | null;
 };
 import { ParticleEmitter } from "../../shade/renderer/particles/runtime/ParticleEmitter.js";
 import { ParticleEffect } from "../graphics/ecs/particles/ParticleEffect.js";
 import { System } from "../ecs/System.js";
 import { Transform64 } from "../ecs/transform/Transform64.js";
+import { SpriteAtlas } from "../graphics/texture/atlas/SpriteAtlas.js";
 //# sourceMappingURL=GPUParticleEmitterSystem.d.ts.map

package/src/engine/graphics3/GPUParticleEmitterSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUParticleEmitterSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/GPUParticleEmitterSystem.js"],"names":[],"mappings":"AAo0BA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,+CAJW,eAAe,UACf,cAAc,GACZ,OAAO,CAiFnB;AA94BD;;;;GAIG;AAEH;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH;IAoDI;;;;;OAKG;IACH,sBALW,OAAO,qBAAqB,EAAE,cAAc,SAC5C,OAAO,qCAAqC,EAAE,KAAK,gEAgB7D;IArED,6DAA6C;IAE7C;;;OAGG;IACH,oBAAsD;IAiEtD;;;;;;OAMG;IACH,iEAEC;IAED;;;;;OAKG;IACH,kCAEC;IAED;;;;;;;;;;OAUG;IACH,mBAJW,MAAM,GACJ,eAAe,GAAC,IAAI,CAWhC;IAED;;;;;;;;;;;OAWG;IACH,cAHW,MAAM,SACN,MAAM,QA4BhB;IA6BD,+BAA+B;IAC/B,YADc,QAAQ,IAAI,CAAC,CAyB1B;IAED;;;;OAIG;IACH,aAJW,cAAc,aACd,WAAW,UACX,MAAM,QAqChB;IAED;;;;OAIG;IACH,eAJW,cAAc,aACd,WAAW,UACX,MAAM,QAIhB;IAED;;;;;;;OAOG;IACH,4BAHW,MAAM,GACJ,IAAI,CAgBhB;IAoCD;;;;;;;;;;;;OAYG;IACH,eAHW,OAAO,gDAAgD,EAAE,YAAY,GACnE,IAAI,CAqChB;;CA6WJ;;;;;gBApyBa,MAAM;;;;WACN,OAAO,yCAAyC,EAAE,UAAU,GAAC,IAAI;;;YAKjE,MAAM;;;;YACN,cAAc;;;;eACd,WAAW;;;;aACX,eAAe,GAAC,IAAI;;;;;aACpB,OAAO,+CAA+C,EAAE,eAAe,GAAC,IAAI;gCAGjE,IAAI;;;;SACf,MAAM,GAAC,IAAI;;;;aACX,oBAAoB,GAAC,IAAI;;gCAzCP,2DAA2D;+BAS5D,6CAA6C;uBAPrD,kBAAkB;4BAEb,iCAAiC"}
+{"version":3,"file":"GPUParticleEmitterSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/GPUParticleEmitterSystem.js"],"names":[],"mappings":"AAywBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,+CAJW,eAAe,UACf,cAAc,GACZ,OAAO,CAiFnB;AAn1BD;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH;IAoDI;;;;;OAKG;IACH,sBALW,OAAO,qBAAqB,EAAE,cAAc,SAC5C,OAAO,qCAAqC,EAAE,KAAK,gEAoB7D;IAzED,6DAA6C;IAE7C;;;OAGG;IACH,OAFU,WAAW,CAEmC;IAqExD;;;;;;OAMG;IACH,iEAEC;IAED;;;;;OAKG;IACH,kCAEC;IAED;;;;;;;;;;OAUG;IACH,mBAJW,MAAM,GACJ,eAAe,GAAC,IAAI,CAWhC;IAED;;;;;;;;;;;OAWG;IACH,cAHW,MAAM,SACN,MAAM,QA4BhB;IA6BD,+BAA+B;IAC/B,YADc,QAAQ,IAAI,CAAC,CAsB1B;IAED;;;;OAIG;IACH,aAJW,cAAc,aACd,WAAW,UACX,MAAM,QAqChB;IAED;;;;OAIG;IACH,eAJW,cAAc,aACd,WAAW,UACX,MAAM,QAIhB;IAED;;;;;;;OAOG;IACH,4BAHW,MAAM,GACJ,IAAI,CAgBhB;IAoCD;;;;;;;;;;;;OAYG;IACH,eAHW,OAAO,gDAAgD,EAAE,YAAY,GACnE,IAAI,CAqChB;;CAsTJ;;YAzuBa,MAAM;;;;YACN,cAAc;;;;eACd,WAAW;;;;aACX,eAAe,GAAC,IAAI;;;;;aACpB,OAAO,+CAA+C,EAAE,eAAe,GAAC,IAAI;gCAGjE,IAAI;;;;SACf,MAAM,GAAC,IAAI;;;;aACX,OAAO,kDAAkD,EAAE,qBAAqB,GAAC,IAAI;;gCAnCnE,2DAA2D;+BAS5D,6CAA6C;uBAPrD,kBAAkB;4BAEb,iCAAiC;4BAOjC,0CAA0C"}