@codexo/exojs-particles 0.15.3 → 0.16.0

package/dist/esm/renderers/WebGl2ParticleRenderer.d.ts

@@ -1,6 +1,26 @@
 import type { WebGl2Backend } from '@codexo/exojs/renderer-sdk';
 import { AbstractWebGl2Renderer } from '@codexo/exojs/renderer-sdk';
 import type { ParticleSystem } from '#ParticleSystem';
+/**
+ * Particle renderer for WebGL2.
+ *
+ * One ParticleSystem = one batch. The system's {@link ParticleRenderMode} owns
+ * the *how* - vertex layout, shader pair, draw model and the loop that fills
+ * the buffer - and this renderer is the executor: each `render(system)` flushes
+ * any pending batch, sets the system-level uniforms (transform, local bounds,
+ * texture) and asks the mode to build its vertex data. The next `flush()`
+ * uploads that data and issues the single draw the mode declares.
+ *
+ * Everything mode-specific is read off the mode's `dataLayout`/`Material`, so a
+ * new primitive is a new mode rather than a change here: the vertex array
+ * object is wired from the layout's named attributes, the draw is instanced or
+ * plain per `ParticleRenderMode.instanced`, and its primitive comes from the
+ * topology.
+ *
+ * A mode declaring a `vertexGeometry` adds a second buffer to that vertex array
+ * object, stepping per vertex (divisor 0) beside the per-instance one, and its
+ * geometry supplies the topology and indices instead.
+ */
 export declare class WebGl2ParticleRenderer extends AbstractWebGl2Renderer<ParticleSystem> {
     /**
      * The particle system's transform is bound as a `u_systemTransform` uniform and
@@ -10,36 +30,44 @@ export declare class WebGl2ParticleRenderer extends AbstractWebGl2Renderer<Parti
      * @internal
      */
     readonly _consumesSharedTransform = false;
-    private readonly _shader;
+    /** Particles the GL-side vertex store is pre-sized for. A hint, not a limit. */
     private readonly _batchSize;
-    private readonly _instanceData;
-    private readonly _instanceFloat32;
-    private readonly _instanceUint32;
-    private _instanceCount;
+    private readonly _resources;
+    /**
+     * Materials this renderer already registered a dispose listener on.
+     *
+     * `Material` has no unsubscribe, and a disconnect clears {@link _resources}
+     * without clearing the material's callback set - so registering on every
+     * resource creation would leave one dead closure per material behind on
+     * every device-loss/reconnect cycle. The listener stays valid across those
+     * cycles (it resolves the entry through the map when it fires), so it is
+     * registered once and this set remembers that. Weak, so a material dropped
+     * without `destroy()` stays collectable.
+     */
+    private readonly _disposeListenerRegistered;
+    private _drawCount;
+    private _pendingMode;
+    private _pendingResources;
     private _currentTexture;
     private _currentBlendMode;
-    private _currentView;
-    private _currentViewId;
-    private _instanceBuffer;
-    private _indexBuffer;
-    private _vao;
     private _connection;
     constructor(batchSize: number);
     render(system: ParticleSystem): this;
-    /**
-     * Compute (uvMin, uvMax) pairs for every declared frame on the system.
-     * Pulled lazily and cached per (system, texture-version) to avoid the
-     * arithmetic in the hot pack loop. Falls back to a single entry from
-     * `system.textureFrame` when no atlas is declared.
-     */
-    private _computeFrameUvs;
-    private _uvMinsScratch;
-    private _uvMaxsScratch;
     flush(): void;
     protected onConnect(backend: WebGl2Backend): void;
     protected onDisconnect(): void;
     destroy(): void;
-    private _createConnection;
+    /**
+     * The mode's scratch buffer as bytes. The view is cached and only rebuilt
+     * when the mode swaps in a larger backing buffer; how much of it this draw
+     * uploads is expressed as an element count at the upload call, so a steady
+     * frame allocates nothing at all.
+     */
+    private _resolveUploadSource;
+    private _getOrCreateResources;
+    private _createResources;
+    private _destroyResources;
     private _createBufferRuntime;
     private _createVaoRuntime;
 }
+//# sourceMappingURL=WebGl2ParticleRenderer.d.ts.map

package/dist/esm/renderers/WebGl2ParticleRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGl2ParticleRenderer.d.ts","sourceRoot":"","sources":["../../../src/renderers/WebGl2ParticleRenderer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAKpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAyEtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,sBAAuB,SAAQ,sBAAsB,CAAC,cAAc,CAAC;IAChF;;;;;;OAMG;IACH,SAAgB,wBAAwB,SAAS;IAEjD,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8C;IACzE;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAA2B;IAEtE,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,WAAW,CAA2C;gBAE3C,SAAS,EAAE,MAAM;IAM7B,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IA6CpC,KAAK,IAAI,IAAI;IA0DpB,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIjD,SAAS,CAAC,YAAY,IAAI,IAAI;IAcvB,OAAO,IAAI,IAAI;IAItB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,qBAAqB;IAgD7B,OAAO,CAAC,gBAAgB;IAgHxB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,oBAAoB;IAiC5B,OAAO,CAAC,iBAAiB;CA8D1B"}