@itwin/frontend-devtools 4.0.0-dev.10 → 4.0.0-dev.101

package/lib/esm/effects/EffectTools.js

@@ -1,63 +1,64 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Effects
- */
-import { assert } from "@itwin/core-bentley";
-import { IModelApp, Tool, } from "@itwin/core-frontend";
-/** Adds a screen-space effect to the selected viewport.
- * @beta
- */
-export class AddEffectTool extends Tool {
-    async run() {
-        // Avoid conflicts with the names of other registered screen-space effects.
-        const name = `fdt ${this.effectName}`;
-        if (!AddEffectTool._registeredEffects.has(name)) {
-            // Register the effect.
-            const builder = IModelApp.renderSystem.createScreenSpaceEffectBuilder({
-                name,
-                textureCoordFromPosition: this.textureCoordFromPosition,
-                source: this.source,
-            });
-            assert(undefined !== builder);
-            this.defineEffect(builder);
-            builder.finish();
-            AddEffectTool._registeredEffects.add(name);
-        }
-        const vp = IModelApp.viewManager.selectedView;
-        if (vp)
-            vp.addScreenSpaceEffect(name);
-        return true;
-    }
-}
-AddEffectTool._registeredEffects = new Set();
-/** Removes all screen-space effects from the selected viewport.
- * @beta
- */
-export class ClearEffectsTool extends Tool {
-    static get minArgs() { return 0; }
-    static get maxArgs() { return 0; }
-    async run() {
-        var _a;
-        (_a = IModelApp.viewManager.selectedView) === null || _a === void 0 ? void 0 : _a.removeScreenSpaceEffects();
-        return true;
-    }
-}
-ClearEffectsTool.toolId = "ClearEffects";
-/** Requests that any viewport to which the specified effect has been applied redraw its contents.
- * Used by tools like [[VignetteConfig]] to update the view after the effect parameters are modified.
- * @beta
- */
-export function refreshViewportsForEffect(effectName) {
-    for (const vp of IModelApp.viewManager) {
-        for (const vpEffectName of vp.screenSpaceEffects) {
-            if (vpEffectName === effectName) {
-                vp.requestRedraw();
-                break;
-            }
-        }
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Effects
+ */
+import { assert } from "@itwin/core-bentley";
+import { IModelApp, Tool, } from "@itwin/core-frontend";
+/** Adds a screen-space effect to the selected viewport.
+ * @beta
+ */
+class AddEffectTool extends Tool {
+    async run() {
+        // Avoid conflicts with the names of other registered screen-space effects.
+        const name = `fdt ${this.effectName}`;
+        if (!AddEffectTool._registeredEffects.has(name)) {
+            // Register the effect.
+            const builder = IModelApp.renderSystem.createScreenSpaceEffectBuilder({
+                name,
+                textureCoordFromPosition: this.textureCoordFromPosition,
+                source: this.source,
+            });
+            assert(undefined !== builder);
+            this.defineEffect(builder);
+            builder.finish();
+            AddEffectTool._registeredEffects.add(name);
+        }
+        const vp = IModelApp.viewManager.selectedView;
+        if (vp)
+            vp.addScreenSpaceEffect(name);
+        return true;
+    }
+}
+AddEffectTool._registeredEffects = new Set();
+export { AddEffectTool };
+/** Removes all screen-space effects from the selected viewport.
+ * @beta
+ */
+class ClearEffectsTool extends Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 0; }
+    async run() {
+        IModelApp.viewManager.selectedView?.removeScreenSpaceEffects();
+        return true;
+    }
+}
+ClearEffectsTool.toolId = "ClearEffects";
+export { ClearEffectsTool };
+/** Requests that any viewport to which the specified effect has been applied redraw its contents.
+ * Used by tools like [[VignetteConfig]] to update the view after the effect parameters are modified.
+ * @beta
+ */
+export function refreshViewportsForEffect(effectName) {
+    for (const vp of IModelApp.viewManager) {
+        for (const vpEffectName of vp.screenSpaceEffects) {
+            if (vpEffectName === effectName) {
+                vp.requestRedraw();
+                break;
+            }
+        }
+    }
+}
 //# sourceMappingURL=EffectTools.js.map

package/lib/esm/effects/EffectTools.js.map

@@ -1 +1 @@
-{"version":3,"file":"EffectTools.js","sourceRoot":"","sources":["../../../src/effects/EffectTools.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EACL,SAAS,EAAqD,IAAI,GACnE,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,OAAgB,aAAc,SAAQ,IAAI;IAY9B,KAAK,CAAC,GAAG;QACvB,2EAA2E;QAC3E,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAC/C,uBAAuB;YACvB,MAAM,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,8BAA8B,CAAC;gBACpE,IAAI;gBACJ,wBAAwB,EAAE,IAAI,CAAC,wBAAwB;gBACvD,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YAEH,MAAM,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC;YAC9B,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,MAAM,EAAE,CAAC;YAEjB,aAAa,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAC5C;QAED,MAAM,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC,YAAY,CAAC;QAC9C,IAAI,EAAE;YACJ,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEhC,OAAO,IAAI,CAAC;IACd,CAAC;;AAlCuB,gCAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;AAqCjE;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,IAAI;IAEjC,MAAM,KAAc,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAc,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAElC,KAAK,CAAC,GAAG;;QACvB,MAAA,SAAS,CAAC,WAAW,CAAC,YAAY,0CAAE,wBAAwB,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;;AAPsB,uBAAM,GAAG,cAAc,CAAC;AAUjD;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,WAAW,EAAE;QACtC,KAAK,MAAM,YAAY,IAAI,EAAE,CAAC,kBAAkB,EAAE;YAChD,IAAI,YAAY,KAAK,UAAU,EAAE;gBAC/B,EAAE,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM;aACP;SACF;KACF;AACH,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Effects\r\n */\r\n\r\nimport { assert } from \"@itwin/core-bentley\";\r\nimport {\r\n  IModelApp, ScreenSpaceEffectBuilder, ScreenSpaceEffectSource, Tool,\r\n} from \"@itwin/core-frontend\";\r\n\r\n/** Adds a screen-space effect to the selected viewport.\r\n * @beta\r\n */\r\nexport abstract class AddEffectTool extends Tool {\r\n  private static readonly _registeredEffects = new Set<string>();\r\n\r\n  /** Name of effect as used in keyins like `fdt effect add`. Ideally one word. */\r\n  protected abstract get effectName(): string;\r\n  /** vertex, fragment, and optional sampleSourcePixel GLSL snippets. */\r\n  protected abstract get source(): ScreenSpaceEffectSource;\r\n  /** Whether the fragment shader should include built-in `textureCoordFromPosition` function. */\r\n  protected abstract get textureCoordFromPosition(): boolean;\r\n  /** Add uniforms, varyings, etc. */\r\n  protected abstract defineEffect(builder: ScreenSpaceEffectBuilder): void;\r\n\r\n  public override async run(): Promise<boolean> {\r\n    // Avoid conflicts with the names of other registered screen-space effects.\r\n    const name = `fdt ${this.effectName}`;\r\n    if (!AddEffectTool._registeredEffects.has(name)) {\r\n      // Register the effect.\r\n      const builder = IModelApp.renderSystem.createScreenSpaceEffectBuilder({\r\n        name,\r\n        textureCoordFromPosition: this.textureCoordFromPosition,\r\n        source: this.source,\r\n      });\r\n\r\n      assert(undefined !== builder);\r\n      this.defineEffect(builder);\r\n      builder.finish();\r\n\r\n      AddEffectTool._registeredEffects.add(name);\r\n    }\r\n\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (vp)\r\n      vp.addScreenSpaceEffect(name);\r\n\r\n    return true;\r\n  }\r\n}\r\n\r\n/** Removes all screen-space effects from the selected viewport.\r\n * @beta\r\n */\r\nexport class ClearEffectsTool extends Tool {\r\n  public static override toolId = \"ClearEffects\";\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 0; }\r\n\r\n  public override async run(): Promise<boolean> {\r\n    IModelApp.viewManager.selectedView?.removeScreenSpaceEffects();\r\n    return true;\r\n  }\r\n}\r\n\r\n/** Requests that any viewport to which the specified effect has been applied redraw its contents.\r\n * Used by tools like [[VignetteConfig]] to update the view after the effect parameters are modified.\r\n * @beta\r\n */\r\nexport function refreshViewportsForEffect(effectName: string): void {\r\n  for (const vp of IModelApp.viewManager) {\r\n    for (const vpEffectName of vp.screenSpaceEffects) {\r\n      if (vpEffectName === effectName) {\r\n        vp.requestRedraw();\r\n        break;\r\n      }\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"EffectTools.js","sourceRoot":"","sources":["../../../src/effects/EffectTools.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EACL,SAAS,EAAqD,IAAI,GACnE,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAsB,aAAc,SAAQ,IAAI;IAY9B,KAAK,CAAC,GAAG;QACvB,2EAA2E;QAC3E,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAC/C,uBAAuB;YACvB,MAAM,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,8BAA8B,CAAC;gBACpE,IAAI;gBACJ,wBAAwB,EAAE,IAAI,CAAC,wBAAwB;gBACvD,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YAEH,MAAM,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC;YAC9B,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,MAAM,EAAE,CAAC;YAEjB,aAAa,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAC5C;QAED,MAAM,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC,YAAY,CAAC;QAC9C,IAAI,EAAE;YACJ,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEhC,OAAO,IAAI,CAAC;IACd,CAAC;;AAlCuB,gCAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;SAD3C,aAAa;AAsCnC;;GAEG;AACH,MAAa,gBAAiB,SAAQ,IAAI;IAEjC,MAAM,KAAc,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAc,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAElC,KAAK,CAAC,GAAG;QACvB,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,wBAAwB,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;;AAPsB,uBAAM,GAAG,cAAc,CAAC;SADpC,gBAAgB;AAW7B;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,WAAW,EAAE;QACtC,KAAK,MAAM,YAAY,IAAI,EAAE,CAAC,kBAAkB,EAAE;YAChD,IAAI,YAAY,KAAK,UAAU,EAAE;gBAC/B,EAAE,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM;aACP;SACF;KACF;AACH,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Effects\n */\n\nimport { assert } from \"@itwin/core-bentley\";\nimport {\n  IModelApp, ScreenSpaceEffectBuilder, ScreenSpaceEffectSource, Tool,\n} from \"@itwin/core-frontend\";\n\n/** Adds a screen-space effect to the selected viewport.\n * @beta\n */\nexport abstract class AddEffectTool extends Tool {\n  private static readonly _registeredEffects = new Set<string>();\n\n  /** Name of effect as used in keyins like `fdt effect add`. Ideally one word. */\n  protected abstract get effectName(): string;\n  /** vertex, fragment, and optional sampleSourcePixel GLSL snippets. */\n  protected abstract get source(): ScreenSpaceEffectSource;\n  /** Whether the fragment shader should include built-in `textureCoordFromPosition` function. */\n  protected abstract get textureCoordFromPosition(): boolean;\n  /** Add uniforms, varyings, etc. */\n  protected abstract defineEffect(builder: ScreenSpaceEffectBuilder): void;\n\n  public override async run(): Promise<boolean> {\n    // Avoid conflicts with the names of other registered screen-space effects.\n    const name = `fdt ${this.effectName}`;\n    if (!AddEffectTool._registeredEffects.has(name)) {\n      // Register the effect.\n      const builder = IModelApp.renderSystem.createScreenSpaceEffectBuilder({\n        name,\n        textureCoordFromPosition: this.textureCoordFromPosition,\n        source: this.source,\n      });\n\n      assert(undefined !== builder);\n      this.defineEffect(builder);\n      builder.finish();\n\n      AddEffectTool._registeredEffects.add(name);\n    }\n\n    const vp = IModelApp.viewManager.selectedView;\n    if (vp)\n      vp.addScreenSpaceEffect(name);\n\n    return true;\n  }\n}\n\n/** Removes all screen-space effects from the selected viewport.\n * @beta\n */\nexport class ClearEffectsTool extends Tool {\n  public static override toolId = \"ClearEffects\";\n  public static override get minArgs() { return 0; }\n  public static override get maxArgs() { return 0; }\n\n  public override async run(): Promise<boolean> {\n    IModelApp.viewManager.selectedView?.removeScreenSpaceEffects();\n    return true;\n  }\n}\n\n/** Requests that any viewport to which the specified effect has been applied redraw its contents.\n * Used by tools like [[VignetteConfig]] to update the view after the effect parameters are modified.\n * @beta\n */\nexport function refreshViewportsForEffect(effectName: string): void {\n  for (const vp of IModelApp.viewManager) {\n    for (const vpEffectName of vp.screenSpaceEffects) {\n      if (vpEffectName === effectName) {\n        vp.requestRedraw();\n        break;\n      }\n    }\n  }\n}\n"]}

package/lib/esm/effects/Explosion.d.ts

@@ -1,13 +1,13 @@
-/** @packageDocumentation
- * @module Effects
- */
-import { Tool } from "@itwin/core-frontend";
-/** This tool applies an explosion particle effect used for testing [ParticleCollectionBuilder]($frontend).
- * @beta
- */
-export declare class ExplosionEffect extends Tool {
-    static toolId: string;
-    /** This method runs the tool, applying an explosion particle effect. */
-    run(): Promise<boolean>;
-}
+/** @packageDocumentation
+ * @module Effects
+ */
+import { Tool } from "@itwin/core-frontend";
+/** This tool applies an explosion particle effect used for testing [ParticleCollectionBuilder]($frontend).
+ * @beta
+ */
+export declare class ExplosionEffect extends Tool {
+    static toolId: string;
+    /** This method runs the tool, applying an explosion particle effect. */
+    run(): Promise<boolean>;
+}
 //# sourceMappingURL=Explosion.d.ts.map

package/lib/esm/effects/Explosion.js

@@ -1,165 +1,166 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Effects
- */
-import { Point3d, Range1d, Vector3d } from "@itwin/core-geometry";
-import { TextureTransparency } from "@itwin/core-common";
-import { GraphicType, imageElementFromUrl, IModelApp, ParticleCollectionBuilder, Tool, } from "@itwin/core-frontend";
-import { randomFloat, randomFloatInRange, randomIntegerInRange, randomPositionInRange } from "./Random";
-/** Represents one particle in the system. */
-class Particle {
-    constructor(position, velocity, lifetime, size) {
-        /** Current age in seconds, incremented each frame. */
-        this.age = 0;
-        /** Particle transparency in [0..255]. */
-        this.transparency = 0;
-        this.position = position;
-        this.velocity = velocity;
-        this.lifetime = lifetime;
-        this.size = size;
-    }
-    get x() { return this.position.x; }
-    get y() { return this.position.y; }
-    get z() { return this.position.z; }
-    get isExpired() { return this.age >= this.lifetime; }
-}
-/** Emits particles in a sphere with its center at the origin.
- * Each particle is emitted from the center of the sphere with random velocity toward the surface of the sphere.
- */
-class ParticleEmitter {
-    constructor() {
-        /** Range from which each particle's initial speed in meters per second will be selected. */
-        this.speedRange = Range1d.createXX(1, 2);
-        /** Range from which each particle's lifetime in seconds will be selected. */
-        this.lifetimeRange = Range1d.createXX(5, 10);
-        /** Range from which each particle's size in meters will be selected. */
-        this.sizeRange = Range1d.createXX(0.2, 1.0);
-        /** Range from which the number of particles emitted will be selected. */
-        this.numParticlesRange = Range1d.createXX(1600, 2200);
-    }
-    /** Emit an explosion of particles from the center of the sphere. */
-    emit() {
-        const particles = [];
-        const numParticles = randomIntegerInRange(this.numParticlesRange);
-        for (let i = 0; i < numParticles; i++) {
-            const velocity = new Vector3d(randomFloat(-1.0, 1.0), randomFloat(-1.0, 1.0), randomFloat(-1.0, 1.0));
-            velocity.normalizeInPlace();
-            velocity.scaleInPlace(randomFloatInRange(this.speedRange));
-            const lifetime = randomFloatInRange(this.lifetimeRange);
-            const size = randomFloatInRange(this.sizeRange);
-            particles.push(new Particle(new Point3d(0, 0, 0), velocity, lifetime, size));
-        }
-        return particles;
-    }
-}
-class ParticleSystem {
-    constructor(texture, iModel, numEmissions) {
-        this._emitter = new ParticleEmitter();
-        this._particles = [];
-        this._scratchVector3d = new Vector3d();
-        /** Acceleration in Z applied to particles, in meters per second squared. */
-        this.gravity = -3;
-        this._texture = texture;
-        this._pickableId = iModel.transientIds.getNext();
-        this._numEmissions = numEmissions;
-        this._lastUpdateTime = Date.now();
-        this._origin = randomPositionInRange(iModel.projectExtents);
-        this._dispose = iModel.onClose.addListener(() => this.dispose());
-    }
-    dispose() {
-        if (this._dispose) {
-            this._dispose();
-            this._dispose = undefined;
-        }
-        IModelApp.viewManager.dropDecorator(this);
-        this._texture.dispose();
-    }
-    update() {
-        const now = Date.now();
-        let deltaMillis = now - this._lastUpdateTime;
-        deltaMillis = Math.min(100, deltaMillis);
-        this._lastUpdateTime = now;
-        let numParticles = this._particles.length;
-        if (numParticles === 0) {
-            this._numEmissions--;
-            if (this._numEmissions < 0)
-                this.dispose();
-            else
-                this._particles = this._emitter.emit();
-            return;
-        }
-        const elapsedSeconds = deltaMillis / 1000;
-        for (let i = 0; i < numParticles; i++) {
-            const particle = this._particles[i];
-            this.updateParticle(particle, elapsedSeconds);
-            if (particle.isExpired) {
-                this._particles[i] = this._particles[numParticles - 1];
-                --i;
-                --numParticles;
-            }
-        }
-        this._particles.length = numParticles;
-    }
-    updateParticle(particle, elapsedSeconds) {
-        const velocity = particle.velocity.clone(this._scratchVector3d);
-        velocity.scale(elapsedSeconds, velocity);
-        velocity.z += elapsedSeconds * this.gravity;
-        particle.position.addInPlace(velocity);
-        particle.transparency = 255 * (particle.age / particle.lifetime);
-        particle.age += elapsedSeconds;
-    }
-    decorate(context) {
-        if (!context.viewport.view.isSpatialView())
-            return;
-        this.update();
-        const builder = ParticleCollectionBuilder.create({
-            viewport: context.viewport,
-            texture: this._texture,
-            size: (this._emitter.sizeRange.high - this._emitter.sizeRange.low) / 2,
-            transparency: 0,
-            origin: this._origin,
-            pickableId: this._pickableId,
-        });
-        for (const particle of this._particles)
-            builder.addParticle(particle);
-        const graphic = builder.finish();
-        if (graphic) {
-            context.addDecoration(GraphicType.WorldDecoration, graphic);
-            context.viewport.onRender.addOnce((vp) => vp.invalidateDecorations());
-        }
-    }
-    testDecorationHit(id) {
-        return id === this._pickableId;
-    }
-    async getDecorationToolTip(_hit) {
-        return "Explosion effect";
-    }
-    static async addDecorator(iModel) {
-        // Note: The decorator takes ownership of the texture, and disposes of it when the decorator is disposed.
-        const image = await imageElementFromUrl(`${IModelApp.publicPath}sprites/particle_explosion.png`);
-        const texture = IModelApp.renderSystem.createTexture({
-            ownership: "external",
-            image: { source: image, transparency: TextureTransparency.Mixed },
-        });
-        if (texture)
-            IModelApp.viewManager.addDecorator(new ParticleSystem(texture, iModel, randomIntegerInRange(this.numEmissionsRange)));
-    }
-}
-ParticleSystem.numEmissionsRange = Range1d.createXX(1, 5);
-/** This tool applies an explosion particle effect used for testing [ParticleCollectionBuilder]($frontend).
- * @beta
- */
-export class ExplosionEffect extends Tool {
-    /** This method runs the tool, applying an explosion particle effect. */
-    async run() {
-        const vp = IModelApp.viewManager.selectedView;
-        if (vp)
-            await ParticleSystem.addDecorator(vp.iModel);
-        return true;
-    }
-}
-ExplosionEffect.toolId = "ExplosionEffect";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Effects
+ */
+import { Point3d, Range1d, Vector3d } from "@itwin/core-geometry";
+import { TextureTransparency } from "@itwin/core-common";
+import { GraphicType, imageElementFromUrl, IModelApp, ParticleCollectionBuilder, Tool, } from "@itwin/core-frontend";
+import { randomFloat, randomFloatInRange, randomIntegerInRange, randomPositionInRange } from "./Random";
+/** Represents one particle in the system. */
+class Particle {
+    get x() { return this.position.x; }
+    get y() { return this.position.y; }
+    get z() { return this.position.z; }
+    constructor(position, velocity, lifetime, size) {
+        /** Current age in seconds, incremented each frame. */
+        this.age = 0;
+        /** Particle transparency in [0..255]. */
+        this.transparency = 0;
+        this.position = position;
+        this.velocity = velocity;
+        this.lifetime = lifetime;
+        this.size = size;
+    }
+    get isExpired() { return this.age >= this.lifetime; }
+}
+/** Emits particles in a sphere with its center at the origin.
+ * Each particle is emitted from the center of the sphere with random velocity toward the surface of the sphere.
+ */
+class ParticleEmitter {
+    constructor() {
+        /** Range from which each particle's initial speed in meters per second will be selected. */
+        this.speedRange = Range1d.createXX(1, 2);
+        /** Range from which each particle's lifetime in seconds will be selected. */
+        this.lifetimeRange = Range1d.createXX(5, 10);
+        /** Range from which each particle's size in meters will be selected. */
+        this.sizeRange = Range1d.createXX(0.2, 1.0);
+        /** Range from which the number of particles emitted will be selected. */
+        this.numParticlesRange = Range1d.createXX(1600, 2200);
+    }
+    /** Emit an explosion of particles from the center of the sphere. */
+    emit() {
+        const particles = [];
+        const numParticles = randomIntegerInRange(this.numParticlesRange);
+        for (let i = 0; i < numParticles; i++) {
+            const velocity = new Vector3d(randomFloat(-1.0, 1.0), randomFloat(-1.0, 1.0), randomFloat(-1.0, 1.0));
+            velocity.normalizeInPlace();
+            velocity.scaleInPlace(randomFloatInRange(this.speedRange));
+            const lifetime = randomFloatInRange(this.lifetimeRange);
+            const size = randomFloatInRange(this.sizeRange);
+            particles.push(new Particle(new Point3d(0, 0, 0), velocity, lifetime, size));
+        }
+        return particles;
+    }
+}
+class ParticleSystem {
+    constructor(texture, iModel, numEmissions) {
+        this._emitter = new ParticleEmitter();
+        this._particles = [];
+        this._scratchVector3d = new Vector3d();
+        /** Acceleration in Z applied to particles, in meters per second squared. */
+        this.gravity = -3;
+        this._texture = texture;
+        this._pickableId = iModel.transientIds.getNext();
+        this._numEmissions = numEmissions;
+        this._lastUpdateTime = Date.now();
+        this._origin = randomPositionInRange(iModel.projectExtents);
+        this._dispose = iModel.onClose.addListener(() => this.dispose());
+    }
+    dispose() {
+        if (this._dispose) {
+            this._dispose();
+            this._dispose = undefined;
+        }
+        IModelApp.viewManager.dropDecorator(this);
+        this._texture.dispose();
+    }
+    update() {
+        const now = Date.now();
+        let deltaMillis = now - this._lastUpdateTime;
+        deltaMillis = Math.min(100, deltaMillis);
+        this._lastUpdateTime = now;
+        let numParticles = this._particles.length;
+        if (numParticles === 0) {
+            this._numEmissions--;
+            if (this._numEmissions < 0)
+                this.dispose();
+            else
+                this._particles = this._emitter.emit();
+            return;
+        }
+        const elapsedSeconds = deltaMillis / 1000;
+        for (let i = 0; i < numParticles; i++) {
+            const particle = this._particles[i];
+            this.updateParticle(particle, elapsedSeconds);
+            if (particle.isExpired) {
+                this._particles[i] = this._particles[numParticles - 1];
+                --i;
+                --numParticles;
+            }
+        }
+        this._particles.length = numParticles;
+    }
+    updateParticle(particle, elapsedSeconds) {
+        const velocity = particle.velocity.clone(this._scratchVector3d);
+        velocity.scale(elapsedSeconds, velocity);
+        velocity.z += elapsedSeconds * this.gravity;
+        particle.position.addInPlace(velocity);
+        particle.transparency = 255 * (particle.age / particle.lifetime);
+        particle.age += elapsedSeconds;
+    }
+    decorate(context) {
+        if (!context.viewport.view.isSpatialView())
+            return;
+        this.update();
+        const builder = ParticleCollectionBuilder.create({
+            viewport: context.viewport,
+            texture: this._texture,
+            size: (this._emitter.sizeRange.high - this._emitter.sizeRange.low) / 2,
+            transparency: 0,
+            origin: this._origin,
+            pickableId: this._pickableId,
+        });
+        for (const particle of this._particles)
+            builder.addParticle(particle);
+        const graphic = builder.finish();
+        if (graphic) {
+            context.addDecoration(GraphicType.WorldDecoration, graphic);
+            context.viewport.onRender.addOnce((vp) => vp.invalidateDecorations());
+        }
+    }
+    testDecorationHit(id) {
+        return id === this._pickableId;
+    }
+    async getDecorationToolTip(_hit) {
+        return "Explosion effect";
+    }
+    static async addDecorator(iModel) {
+        // Note: The decorator takes ownership of the texture, and disposes of it when the decorator is disposed.
+        const image = await imageElementFromUrl(`${IModelApp.publicPath}sprites/particle_explosion.png`);
+        const texture = IModelApp.renderSystem.createTexture({
+            ownership: "external",
+            image: { source: image, transparency: TextureTransparency.Mixed },
+        });
+        if (texture)
+            IModelApp.viewManager.addDecorator(new ParticleSystem(texture, iModel, randomIntegerInRange(this.numEmissionsRange)));
+    }
+}
+ParticleSystem.numEmissionsRange = Range1d.createXX(1, 5);
+/** This tool applies an explosion particle effect used for testing [ParticleCollectionBuilder]($frontend).
+ * @beta
+ */
+class ExplosionEffect extends Tool {
+    /** This method runs the tool, applying an explosion particle effect. */
+    async run() {
+        const vp = IModelApp.viewManager.selectedView;
+        if (vp)
+            await ParticleSystem.addDecorator(vp.iModel);
+        return true;
+    }
+}
+ExplosionEffect.toolId = "ExplosionEffect";
+export { ExplosionEffect };
 //# sourceMappingURL=Explosion.js.map

package/lib/esm/effects/Explosion.js.map

@@ -1 +1 @@
-{"version":3,"file":"Explosion.js","sourceRoot":"","sources":["../../../src/effects/Explosion.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Effects\r\n */\r\n\r\nimport { Id64String } from \"@itwin/core-bentley\";\r\nimport { Point3d, Range1d, Vector3d } from \"@itwin/core-geometry\";\r\nimport { RenderTexture, TextureTransparency } from \"@itwin/core-common\";\r\nimport {\r\n  DecorateContext, GraphicType, HitDetail, imageElementFromUrl, IModelApp, IModelConnection, ParticleCollectionBuilder, ParticleProps, Tool,\r\n} from \"@itwin/core-frontend\";\r\nimport { randomFloat, randomFloatInRange, randomIntegerInRange, randomPositionInRange } from \"./Random\";\r\n\r\n/** Represents one particle in the system. */\r\nclass Particle implements ParticleProps {\r\n  /** Current position in the particle system's local coordinate space. */\r\n  public readonly position: Point3d;\r\n  /** Current velocity in meters per second. */\r\n  public readonly velocity: Vector3d;\r\n  /** Current age in seconds, incremented each frame. */\r\n  public age = 0;\r\n  /** Maximum age in seconds. When `this.age` exceeds `this.lifetime`, the particle expires. */\r\n  public readonly lifetime: number;\r\n  /** Particle size in meters. */\r\n  public size: number;\r\n  /** Particle transparency in [0..255]. */\r\n  public transparency = 0;\r\n\r\n  public get x() { return this.position.x; }\r\n  public get y() { return this.position.y; }\r\n  public get z() { return this.position.z; }\r\n\r\n  public constructor(position: Point3d, velocity: Vector3d, lifetime: number, size: number) {\r\n    this.position = position;\r\n    this.velocity = velocity;\r\n    this.lifetime = lifetime;\r\n    this.size = size;\r\n  }\r\n\r\n  public get isExpired() { return this.age >= this.lifetime; }\r\n}\r\n\r\n/** Emits particles in a sphere with its center at the origin.\r\n * Each particle is emitted from the center of the sphere with random velocity toward the surface of the sphere.\r\n */\r\nclass ParticleEmitter {\r\n  /** Range from which each particle's initial speed in meters per second will be selected. */\r\n  public readonly speedRange = Range1d.createXX(1, 2);\r\n  /** Range from which each particle's lifetime in seconds will be selected. */\r\n  public readonly lifetimeRange = Range1d.createXX(5, 10);\r\n  /** Range from which each particle's size in meters will be selected. */\r\n  public readonly sizeRange = Range1d.createXX(0.2, 1.0);\r\n  /** Range from which the number of particles emitted will be selected. */\r\n  public numParticlesRange = Range1d.createXX(1600, 2200);\r\n\r\n  /** Emit an explosion of particles from the center of the sphere. */\r\n  public emit(): Particle[] {\r\n    const particles = [];\r\n    const numParticles = randomIntegerInRange(this.numParticlesRange);\r\n    for (let i = 0; i < numParticles; i++) {\r\n      const velocity = new Vector3d(randomFloat(-1.0, 1.0), randomFloat(-1.0, 1.0), randomFloat(-1.0, 1.0));\r\n      velocity.normalizeInPlace();\r\n      velocity.scaleInPlace(randomFloatInRange(this.speedRange));\r\n\r\n      const lifetime = randomFloatInRange(this.lifetimeRange);\r\n      const size = randomFloatInRange(this.sizeRange);\r\n      particles.push(new Particle(new Point3d(0, 0, 0), velocity, lifetime, size));\r\n    }\r\n\r\n    return particles;\r\n  }\r\n}\r\n\r\nclass ParticleSystem {\r\n  private readonly _origin: Point3d;\r\n  private readonly _pickableId: Id64String;\r\n  private readonly _emitter = new ParticleEmitter();\r\n  private _numEmissions: number;\r\n  private readonly _texture: RenderTexture;\r\n  private _lastUpdateTime: number;\r\n  private _particles: Particle[] = [];\r\n  private readonly _scratchVector3d = new Vector3d();\r\n  private _dispose?: VoidFunction;\r\n  /** Acceleration in Z applied to particles, in meters per second squared. */\r\n  public gravity = -3;\r\n\r\n  public static numEmissionsRange = Range1d.createXX(1, 5);\r\n\r\n  public constructor(texture: RenderTexture, iModel: IModelConnection, numEmissions: number) {\r\n    this._texture = texture;\r\n    this._pickableId = iModel.transientIds.getNext();\r\n    this._numEmissions = numEmissions;\r\n    this._lastUpdateTime = Date.now();\r\n\r\n    this._origin = randomPositionInRange(iModel.projectExtents);\r\n\r\n    this._dispose = iModel.onClose.addListener(() => this.dispose());\r\n  }\r\n\r\n  public dispose(): void {\r\n    if (this._dispose) {\r\n      this._dispose();\r\n      this._dispose = undefined;\r\n    }\r\n\r\n    IModelApp.viewManager.dropDecorator(this);\r\n    this._texture.dispose();\r\n  }\r\n\r\n  public update(): void {\r\n    const now = Date.now();\r\n    let deltaMillis = now - this._lastUpdateTime;\r\n    deltaMillis = Math.min(100, deltaMillis);\r\n    this._lastUpdateTime = now;\r\n\r\n    let numParticles = this._particles.length;\r\n    if (numParticles === 0) {\r\n      this._numEmissions--;\r\n      if (this._numEmissions < 0)\r\n        this.dispose();\r\n      else\r\n        this._particles = this._emitter.emit();\r\n\r\n      return;\r\n    }\r\n\r\n    const elapsedSeconds = deltaMillis / 1000;\r\n    for (let i = 0; i < numParticles; i++) {\r\n      const particle = this._particles[i];\r\n      this.updateParticle(particle, elapsedSeconds);\r\n      if (particle.isExpired) {\r\n        this._particles[i] = this._particles[numParticles - 1];\r\n        --i;\r\n        --numParticles;\r\n      }\r\n    }\r\n\r\n    this._particles.length = numParticles;\r\n  }\r\n\r\n  private updateParticle(particle: Particle, elapsedSeconds: number): void {\r\n    const velocity = particle.velocity.clone(this._scratchVector3d);\r\n    velocity.scale(elapsedSeconds, velocity);\r\n    velocity.z += elapsedSeconds * this.gravity;\r\n    particle.position.addInPlace(velocity);\r\n    particle.transparency = 255 * (particle.age / particle.lifetime);\r\n\r\n    particle.age += elapsedSeconds;\r\n  }\r\n\r\n  public decorate(context: DecorateContext): void {\r\n    if (!context.viewport.view.isSpatialView())\r\n      return;\r\n\r\n    this.update();\r\n\r\n    const builder = ParticleCollectionBuilder.create({\r\n      viewport: context.viewport,\r\n      texture: this._texture,\r\n      size: (this._emitter.sizeRange.high - this._emitter.sizeRange.low) / 2,\r\n      transparency: 0,\r\n      origin: this._origin,\r\n      pickableId: this._pickableId,\r\n    });\r\n\r\n    for (const particle of this._particles)\r\n      builder.addParticle(particle);\r\n\r\n    const graphic = builder.finish();\r\n    if (graphic) {\r\n      context.addDecoration(GraphicType.WorldDecoration, graphic);\r\n      context.viewport.onRender.addOnce((vp) => vp.invalidateDecorations());\r\n    }\r\n  }\r\n\r\n  public testDecorationHit(id: Id64String): boolean {\r\n    return id === this._pickableId;\r\n  }\r\n\r\n  public async getDecorationToolTip(_hit: HitDetail): Promise<HTMLElement | string> {\r\n    return \"Explosion effect\";\r\n  }\r\n\r\n  public static async addDecorator(iModel: IModelConnection): Promise<void> {\r\n    // Note: The decorator takes ownership of the texture, and disposes of it when the decorator is disposed.\r\n    const image = await imageElementFromUrl(`${IModelApp.publicPath}sprites/particle_explosion.png`);\r\n    const texture = IModelApp.renderSystem.createTexture({\r\n      ownership: \"external\",\r\n      image: { source: image, transparency: TextureTransparency.Mixed },\r\n    });\r\n    if (texture)\r\n      IModelApp.viewManager.addDecorator(new ParticleSystem(texture, iModel, randomIntegerInRange(this.numEmissionsRange)));\r\n  }\r\n}\r\n\r\n/** This tool applies an explosion particle effect used for testing [ParticleCollectionBuilder]($frontend).\r\n * @beta\r\n */\r\nexport class ExplosionEffect extends Tool {\r\n  public static override toolId = \"ExplosionEffect\";\r\n\r\n  /** This method runs the tool, applying an explosion particle effect. */\r\n  public override async run(): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (vp)\r\n      await ParticleSystem.addDecorator(vp.iModel);\r\n\r\n    return true;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Explosion.js","sourceRoot":"","sources":["../../../src/effects/Explosion.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Effects\n */\n\nimport { Id64String } from \"@itwin/core-bentley\";\nimport { Point3d, Range1d, Vector3d } from \"@itwin/core-geometry\";\nimport { RenderTexture, TextureTransparency } from \"@itwin/core-common\";\nimport {\n  DecorateContext, GraphicType, HitDetail, imageElementFromUrl, IModelApp, IModelConnection, ParticleCollectionBuilder, ParticleProps, Tool,\n} from \"@itwin/core-frontend\";\nimport { randomFloat, randomFloatInRange, randomIntegerInRange, randomPositionInRange } from \"./Random\";\n\n/** Represents one particle in the system. */\nclass Particle implements ParticleProps {\n  /** Current position in the particle system's local coordinate space. */\n  public readonly position: Point3d;\n  /** Current velocity in meters per second. */\n  public readonly velocity: Vector3d;\n  /** Current age in seconds, incremented each frame. */\n  public age = 0;\n  /** Maximum age in seconds. When `this.age` exceeds `this.lifetime`, the particle expires. */\n  public readonly lifetime: number;\n  /** Particle size in meters. */\n  public size: number;\n  /** Particle transparency in [0..255]. */\n  public transparency = 0;\n\n  public get x() { return this.position.x; }\n  public get y() { return this.position.y; }\n  public get z() { return this.position.z; }\n\n  public constructor(position: Point3d, velocity: Vector3d, lifetime: number, size: number) {\n    this.position = position;\n    this.velocity = velocity;\n    this.lifetime = lifetime;\n    this.size = size;\n  }\n\n  public get isExpired() { return this.age >= this.lifetime; }\n}\n\n/** Emits particles in a sphere with its center at the origin.\n * Each particle is emitted from the center of the sphere with random velocity toward the surface of the sphere.\n */\nclass ParticleEmitter {\n  /** Range from which each particle's initial speed in meters per second will be selected. */\n  public readonly speedRange = Range1d.createXX(1, 2);\n  /** Range from which each particle's lifetime in seconds will be selected. */\n  public readonly lifetimeRange = Range1d.createXX(5, 10);\n  /** Range from which each particle's size in meters will be selected. */\n  public readonly sizeRange = Range1d.createXX(0.2, 1.0);\n  /** Range from which the number of particles emitted will be selected. */\n  public numParticlesRange = Range1d.createXX(1600, 2200);\n\n  /** Emit an explosion of particles from the center of the sphere. */\n  public emit(): Particle[] {\n    const particles = [];\n    const numParticles = randomIntegerInRange(this.numParticlesRange);\n    for (let i = 0; i < numParticles; i++) {\n      const velocity = new Vector3d(randomFloat(-1.0, 1.0), randomFloat(-1.0, 1.0), randomFloat(-1.0, 1.0));\n      velocity.normalizeInPlace();\n      velocity.scaleInPlace(randomFloatInRange(this.speedRange));\n\n      const lifetime = randomFloatInRange(this.lifetimeRange);\n      const size = randomFloatInRange(this.sizeRange);\n      particles.push(new Particle(new Point3d(0, 0, 0), velocity, lifetime, size));\n    }\n\n    return particles;\n  }\n}\n\nclass ParticleSystem {\n  private readonly _origin: Point3d;\n  private readonly _pickableId: Id64String;\n  private readonly _emitter = new ParticleEmitter();\n  private _numEmissions: number;\n  private readonly _texture: RenderTexture;\n  private _lastUpdateTime: number;\n  private _particles: Particle[] = [];\n  private readonly _scratchVector3d = new Vector3d();\n  private _dispose?: VoidFunction;\n  /** Acceleration in Z applied to particles, in meters per second squared. */\n  public gravity = -3;\n\n  public static numEmissionsRange = Range1d.createXX(1, 5);\n\n  public constructor(texture: RenderTexture, iModel: IModelConnection, numEmissions: number) {\n    this._texture = texture;\n    this._pickableId = iModel.transientIds.getNext();\n    this._numEmissions = numEmissions;\n    this._lastUpdateTime = Date.now();\n\n    this._origin = randomPositionInRange(iModel.projectExtents);\n\n    this._dispose = iModel.onClose.addListener(() => this.dispose());\n  }\n\n  public dispose(): void {\n    if (this._dispose) {\n      this._dispose();\n      this._dispose = undefined;\n    }\n\n    IModelApp.viewManager.dropDecorator(this);\n    this._texture.dispose();\n  }\n\n  public update(): void {\n    const now = Date.now();\n    let deltaMillis = now - this._lastUpdateTime;\n    deltaMillis = Math.min(100, deltaMillis);\n    this._lastUpdateTime = now;\n\n    let numParticles = this._particles.length;\n    if (numParticles === 0) {\n      this._numEmissions--;\n      if (this._numEmissions < 0)\n        this.dispose();\n      else\n        this._particles = this._emitter.emit();\n\n      return;\n    }\n\n    const elapsedSeconds = deltaMillis / 1000;\n    for (let i = 0; i < numParticles; i++) {\n      const particle = this._particles[i];\n      this.updateParticle(particle, elapsedSeconds);\n      if (particle.isExpired) {\n        this._particles[i] = this._particles[numParticles - 1];\n        --i;\n        --numParticles;\n      }\n    }\n\n    this._particles.length = numParticles;\n  }\n\n  private updateParticle(particle: Particle, elapsedSeconds: number): void {\n    const velocity = particle.velocity.clone(this._scratchVector3d);\n    velocity.scale(elapsedSeconds, velocity);\n    velocity.z += elapsedSeconds * this.gravity;\n    particle.position.addInPlace(velocity);\n    particle.transparency = 255 * (particle.age / particle.lifetime);\n\n    particle.age += elapsedSeconds;\n  }\n\n  public decorate(context: DecorateContext): void {\n    if (!context.viewport.view.isSpatialView())\n      return;\n\n    this.update();\n\n    const builder = ParticleCollectionBuilder.create({\n      viewport: context.viewport,\n      texture: this._texture,\n      size: (this._emitter.sizeRange.high - this._emitter.sizeRange.low) / 2,\n      transparency: 0,\n      origin: this._origin,\n      pickableId: this._pickableId,\n    });\n\n    for (const particle of this._particles)\n      builder.addParticle(particle);\n\n    const graphic = builder.finish();\n    if (graphic) {\n      context.addDecoration(GraphicType.WorldDecoration, graphic);\n      context.viewport.onRender.addOnce((vp) => vp.invalidateDecorations());\n    }\n  }\n\n  public testDecorationHit(id: Id64String): boolean {\n    return id === this._pickableId;\n  }\n\n  public async getDecorationToolTip(_hit: HitDetail): Promise<HTMLElement | string> {\n    return \"Explosion effect\";\n  }\n\n  public static async addDecorator(iModel: IModelConnection): Promise<void> {\n    // Note: The decorator takes ownership of the texture, and disposes of it when the decorator is disposed.\n    const image = await imageElementFromUrl(`${IModelApp.publicPath}sprites/particle_explosion.png`);\n    const texture = IModelApp.renderSystem.createTexture({\n      ownership: \"external\",\n      image: { source: image, transparency: TextureTransparency.Mixed },\n    });\n    if (texture)\n      IModelApp.viewManager.addDecorator(new ParticleSystem(texture, iModel, randomIntegerInRange(this.numEmissionsRange)));\n  }\n}\n\n/** This tool applies an explosion particle effect used for testing [ParticleCollectionBuilder]($frontend).\n * @beta\n */\nexport class ExplosionEffect extends Tool {\n  public static override toolId = \"ExplosionEffect\";\n\n  /** This method runs the tool, applying an explosion particle effect. */\n  public override async run(): Promise<boolean> {\n    const vp = IModelApp.viewManager.selectedView;\n    if (vp)\n      await ParticleSystem.addDecorator(vp.iModel);\n\n    return true;\n  }\n}\n"]}