@woosh/meep-engine 3.0.0 → 3.0.1

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

@@ -1,120 +1,49 @@
+/**
+ * The sprite sheet the particle system draws from.
+ *
+ * **Every emitter's layers share one atlas**, so a hundred effects using the same puff of smoke pay
+ * for one image; a layer holds a reference to the patch it was given and hands it back when the
+ * emitter is deregistered, and the atlas repacks when the set of patches changes.
+ *
+ * The class used to carry a second job — a compiled shader per emitter, keyed on the four flags
+ * that change the shader, with a graveyard of unused records to avoid recompiling. That was three's
+ * `ShaderMaterial`, and it is gone: the particles are drawn by a Shade pass that owns its own
+ * pipeline and reads the atlas sampler directly.
+ */
 export class ShaderManager {
     /**
-     *
      * @param {AssetManager} asset_manager
-     * @param {MaterialManager} material_manager
-     * @constructor
-     */
-    constructor(asset_manager: AssetManager, material_manager: MaterialManager);
-    /**
-     *
-     * @type {Texture|null}
-     */
-    depthTexture: Texture | null;
-    /**
-     * Number of unused records to keep, this allows reused of records avoiding shader recompilation
-     * @type {number}
      */
-    recordGraveyardSize: number;
-    /**
-     *
-     * @type {MaterialManager}
-     * @private
-     */
-    private __material_manager;
+    constructor(asset_manager: AssetManager);
     /**
      *
      * @type {ManagedAtlas}
      */
     spriteAtlas: ManagedAtlas;
     /**
-     *
-     * @type {DataTexture|null}
-     */
-    spriteTexture: DataTexture | null;
-    /**
-     * material map is identified by parameter hash
-     * @readonly
-     * @private
-     * @type {HashMap<ParticleEmitter, MaterialRecord>}
-     */
-    private readonly materialMap;
-    /**
-     * @readonly
-     * @private
-     * @type {HashMap<ParticleEmitter, MaterialRecord>}
-     */
-    private readonly recordGraveyard;
-    /**
-     *
-     * @type {Vector2}
-     */
-    viewportSize: Vector2;
-    /**
-     * Common shader uniforms, inherited by every material and updated centrally (here)
-     * @private
-     */
-    private __common_uniforms;
-    /**
-     * Should be called before using shaders managed by this
+     * Should be called before using the sprite sheet.
      */
     update(): void;
     /**
-     * @private
-     */
-    private updateSpriteTexture;
-    /**
-     * @private
-     * @returns {Reference<Material>}
-     * @param {ParticleEmitter} emitter
-     */
-    private buildMaterial;
-    /**
+     * Take out a reference to every sprite the emitter's layers name.
      *
      * @param {ParticleEmitter} emitter
      */
     register(emitter: ParticleEmitter): void;
     /**
-     * Perform intenal cleanup, remove unused material records
-     */
-    cleanup(): void;
-    /**
+     * Hand back every sprite the emitter's layers hold.
      *
      * @param {ParticleEmitter} emitter
      */
     deregister(emitter: ParticleEmitter): void;
     /**
+     * Hand back every sprite this manager acquired.
      *
-     * @param {Camera} camera THREE.js Camera object
-     */
-    setCamera(camera: Camera): void;
-    camera: Camera;
-    /**
-     *
-     * @param {Texture} texture
-     */
-    setDepthTexture(texture: Texture): void;
-    /**
-     *
-     * @param {number} x
-     * @param {number} y
-     */
-    setViewportSize(x: number, y: number): void;
-    /**
-     * 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.
+     * The manager is left able to re-acquire, so a system that starts up again gets a working
+     * sprite sheet without being rebuilt.
      */
     dispose(): void;
     #private;
 }
 import { ManagedAtlas } from "../../../../texture/atlas/ManagedTextureAtlas.js";
-import { DataTexture } from "three";
-import Vector2 from "../../../../../../core/geom/Vector2.js";
 //# sourceMappingURL=ShaderManager.d.ts.map

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;IAmBI;;;;;OAKG;IACH,4EA2FC;IA7GD;;;OAGG;IACH,cAFU,UAAQ,IAAI,CAEF;IAEpB;;;OAGG;IACH,qBAFU,MAAM,CAES;IAYrB;;;;OAIG;IACH,2BAA0C;IAE1C;;;OAGG;IACH,aAFU,YAAY,CAE4B;IAElD;;;OAGG;IACH,eAFU,WAAW,GAAC,IAAI,CAOxB;IAIF;;;;;OAKG;IACH,6BAGE;IAEF;;;;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"}
+{"version":3,"file":"ShaderManager.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/shader/ShaderManager.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH;IAgBI;;OAEG;IACH,yCAUC;IAPG;;;OAGG;IACH,aAFU,YAAY,CAE4B;IAKtD;;OAEG;IACH,eAEC;IAWD;;;;OAIG;IACH,yCAsBC;IAED;;;;OAIG;IACH,2CAqBC;IAED;;;;;OAKG;IACH,gBAOC;;CACJ;6BArI4B,kDAAkD"}