update README.md

README.md

@@ -150,6 +150,17 @@ loader.load(jsonURL, (obj) => {
 scene.add(batchSystem);
 ```
 
+#### Play multiple instances of loaded effect
+
+```javascript
+const effect = obj.clone(true);
+scene.add(effect);
+QuarksUtil.setAutoDestroy(effect, true);
+QuarksUtil.addToBatchRenderer(effect, batchSystem);
+QuarksUtil.play(effect);
+
+```
+
 Note: the texture url reference is defined by the texture's name field.
 you may need to modify the texture url in json as needed.
 

packages/quarks.core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quarks.core",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "description": "Core library for Quarks VFX / Particle System Library",
   "type": "module",
   "types": "./dist/types/index.d.ts",

packages/quarks.core/src/IParticleSystem.ts

@@ -92,6 +92,12 @@ export interface IEmitter {
 
 
 export interface IParticleSystem {
+
+    /**
+     * Whether the ParticleSystem should be automatically disposed when it finishes emitting particles.
+     * @type {string}
+     */
+    autoDestroy: boolean;
     /**
      * Whether the system is in world space.
      * @type {boolean}

packages/quarks.nodes/package.json

@@ -1,10 +1,10 @@
 {
   "name": "quarks.nodes",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "description": "node based behavior and render system for quarks engine",
   "type": "module",
   "dependencies": {
-    "three.quarks": "^0.15.0"
+    "three.quarks": "^0.15.2"
   },
   "devDependencies": {
     "@types/three": "^0.165.0",

packages/three.quarks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "three.quarks",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "description": "A General-Purpose Particle System for three.js",
   "type": "module",
   "types": "./dist/types/index.d.ts",
@@ -60,7 +60,7 @@
     "three": ">=0.165.0"
   },
   "dependencies": {
-    "quarks.core": "^0.15.0"
+    "quarks.core": "^0.15.2"
   },
   "devDependencies": {
     "@types/jest": "^29.5.12",

packages/three.quarks/src/ParticleSystem.ts

@@ -279,7 +279,7 @@ const DEFAULT_GEOMETRY = new PlaneGeometry(1, 1, 1, 1);
  */
 export class ParticleSystem implements IParticleSystem {
     /**
-     * Determines whether the ParticleSystem should be automatically disposed when it finishes emitting particles.
+     * whether the ParticleSystem should be automatically disposed when it finishes emitting particles.
      *
      * @type {boolean}
      */

packages/three.quarks/src/QuarksUtil.ts

@@ -1,6 +1,7 @@
 import {Object3D} from 'three';
 import {ParticleEmitter} from './ParticleEmitter';
 import {BatchedRenderer} from './BatchedRenderer';
+import {ParticleSystem} from './ParticleSystem';
 
 
 export class QuarksUtil {
@@ -52,6 +53,12 @@ export class QuarksUtil {
         });
     }
 
+    static setAutoDestroy(obj: Object3D, value: boolean) {
+        QuarksUtil.runOnAllParticleEmitters(obj, (ps) => {
+            ps.system.autoDestroy = value;
+        });
+    }
+
     /**
      * Stop emit new particles from all particle systems and
      * keep simulating the existing particles in the object and the object's children.