@itwin/frontend-devtools 3.0.0-extension.1 → 3.0.2

package/CHANGELOG.md

@@ -1,6 +1,111 @@
 # Change Log - @itwin/frontend-devtools
 
-This log was last generated on Tue, 21 Sep 2021 21:06:40 GMT and should not be manually modified.
+This log was last generated on Thu, 10 Mar 2022 21:18:13 GMT and should not be manually modified.
+
+## 3.0.2
+Thu, 10 Mar 2022 21:18:13 GMT
+
+_Version update only_
+
+## 3.0.1
+Thu, 24 Feb 2022 15:26:55 GMT
+
+_Version update only_
+
+## 3.0.0
+Mon, 24 Jan 2022 14:00:52 GMT
+
+### Updates
+
+- Update release tags
+- Upgrade target to ES2019 and deliver both a CommonJs and ESModule version of package
+- Added keyins for setting images to be used for sky sphere or sky cube.
+- fix ecsql row format
+- Now use 'DisplayStyleState.backgroundMapBase' instead of 'DisplayStyleState.changeBaseMapProps' to update the mapImagery.
+- Support -1 to modify all reality models.  Fix messages
+- rename to @itwin/frontend-devtools
+- Fix typo.
+- Add support for inverting planar clip mask (inside vs outside)
+- Replace usage of I18N with generic Localization interface.
+-  Renamed an iModel's parent container to iTwin
+- tool.run and tool.parseAndRun are now async methods
+- Add `fdt bgcolor` keyin for changing the viewport's background color.
+- Replace `fdt toggle wiremesh` keyin with `fdt wiremesh` that produces real wiremesh.
+
+## 2.19.28
+Wed, 12 Jan 2022 14:52:38 GMT
+
+_Version update only_
+
+## 2.19.27
+Wed, 05 Jan 2022 20:07:20 GMT
+
+_Version update only_
+
+## 2.19.26
+Wed, 08 Dec 2021 20:54:52 GMT
+
+_Version update only_
+
+## 2.19.25
+Fri, 03 Dec 2021 20:05:49 GMT
+
+_Version update only_
+
+## 2.19.24
+Mon, 29 Nov 2021 18:44:31 GMT
+
+_Version update only_
+
+## 2.19.23
+Mon, 22 Nov 2021 20:41:39 GMT
+
+_Version update only_
+
+## 2.19.22
+Wed, 17 Nov 2021 01:23:26 GMT
+
+_Version update only_
+
+## 2.19.21
+Wed, 10 Nov 2021 10:58:24 GMT
+
+_Version update only_
+
+## 2.19.20
+Fri, 29 Oct 2021 16:14:22 GMT
+
+_Version update only_
+
+## 2.19.19
+Mon, 25 Oct 2021 16:16:25 GMT
+
+_Version update only_
+
+## 2.19.18
+Thu, 21 Oct 2021 20:59:44 GMT
+
+_Version update only_
+
+## 2.19.17
+Thu, 14 Oct 2021 21:19:43 GMT
+
+_Version update only_
+
+## 2.19.16
+Mon, 11 Oct 2021 17:37:46 GMT
+
+_Version update only_
+
+## 2.19.15
+Fri, 08 Oct 2021 16:44:23 GMT
+
+_Version update only_
+
+## 2.19.14
+Fri, 01 Oct 2021 13:07:03 GMT
+
+_Version update only_
 
 ## 2.19.13
 Tue, 21 Sep 2021 21:06:40 GMT

package/LICENSE.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright © 2017-2021 Bentley Systems, Incorporated. All rights reserved.
+Copyright © 2017-2022 Bentley Systems, Incorporated. All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/README.md

@@ -55,6 +55,7 @@ The key-ins below enable, disable, or toggle a specific feature. They take at mo
 
 * `fdt project extents` - Toggles display of a decoration illustrating the iModel's project extents.
 * `fdt freeze scene` - Toggles scene freeze for the active viewport. While scene freeze is enabled, the same set of tiles will continue to be displayed until the scene is unfrozen - no new tiles will be loaded. Useful for zooming in or out to inspect geometry inside specific tiles.
+* `fdt wiremesh` - Toggles the display of wiremesh overlay on surfaces in the selected viewport.
 * `fdt section cut` - Specify whether a clip volume applied to the view should produce cut geometry at intersections with the design models. This controls `ViewState.details.clipStyle.produceCutGeometry`.
 * `fdt particle snow` - Toggle a particle effect simulating snowfall for the active viewport.
 * `fdt frustum selected` - Toggles a decoration representing the current frustum of the selected viewport. The decoration is displayed in any *other* open viewports - so if no other viewports are open, this key-in has no effect.
@@ -188,7 +189,7 @@ Reality models can be attached to a display style to provide context when that d
 ### Planar Mask keyins
 
 This package supplies several keyins to control planar masking for background maps and reality models. These masks provide a two and a half dimensional method for masking the regions where the background map, reality models and BIM geometry overlap.
-Planar masks include an optional transparency override.  If a transparency values is specified, a value of 0 will completely mask the reality model  - the masked portion will be omitted completely, higher values will produce less masking and a semit translucent display of the masked geometry. If no transparency is included then the transparency value from the mask elements is used.
+Planar masks include an optional transparency override.  If a transparency values is specified, a value of 0 will completely mask the reality model  - the masked portion will be omitted completely, higher values will produce less masking and a semit translucent display of the masked geometry. If no transparency is included then the transparency value from the mask elements is used.  An additional argument boolean argument will invert the mask and mask the area outside the mask geometry rather than inside.
 
 #### Background map planar masks
 
@@ -196,15 +197,19 @@ These keyins control the planar masking of the background map.
 
 * `fdt set map mask by priority`  Set the background map to be masked based on priority.  Masking by priority will mask by higher priority models.  By default background map have lowest priorty (-2048) Unless their priority is overridden reality models are higher priority and BIM models are always higher priority, therefore if priority masking is selected then the background map will be masked by all reality and BIM models. A value for transparency may optionally be included.
   * `transparency`: (optional) - A value for the mask transparency override. [0...1]
-  * `priority`: (optional) - A bias to be applied to the default reality model priority.  As lower priority models are masked by higher priority ones, specifying a priority of -1 would cause the reality model to be masked by other reality models.
+  * `invert`: (optional) - If `on` or `true` then the mask sense is inverted and the area outside the mask geometry will be masked and the area inside the mask is displayed.
 * `fdt set map mask elements` Set the background map to be masked by one or more elements.  If elements are already selected they are used for the mask, otherwise the mask elements may be selected individually.
   * `transparency`: (optional) - A value for the mask transparency override. [0...1]
+  * `invert`: (optional) - If `on` or `true` then the mask sense is inverted and the area outside the mask geometry will be masked and the area inside the mask is displayed.
 * `fdt set map mask exclude elements` Set the background map to be masked by all elements except the selected (or individually picked) excluded elements.
   * `transparency`: (optional) - A value for the mask transparency override. [0...1]
+  * `invert`: (optional) - If `on` or `true` then the mask sense is inverted and the area outside the mask geometry will be masked and the area inside the mask is displayed.
 * `fdt set map mask models` Set the background map to be masked by the selected models.  The selected models can come from either the current selection set or can be picked individually.
   * `transparency`: (optional) - A value for the mask transparency override. [0...1]
+  * `invert`: (optional) - If `on` or `true` then the mask sense is inverted and the area outside the mask geometry will be masked and the area inside the mask is displayed.
 * `fdt set map mask subcategory` Set the background map to be masked by one or more picked subcategories.
   * `transparency`: (optional) - A value for the mask transparency override. [0...1]
+  * `invert`: (optional) - If `on` or `true` then the mask sense is inverted and the area outside the mask geometry will be masked and the area inside the mask is displayed.
 * `fdt unmask map`  Removes the current background map masks.
 
 #### Reality model planar masks
@@ -214,14 +219,19 @@ These keysins control the planar masking of reality models.
 * `fdt set reality model mask by priority` Set the reality model to masked based on priority.  Masking by priority will cause the masked model to be masked by all higher priority models.  By default global reality models (such as the OpenStreetMap building layer) have a priority of -1024 and standard reality models have a priority of zero.  BIM models have a priority of 1024.  Therefore with default priorities reality models are always masked by BIM model and global reality models are masked by standard reality models.  By specifying a priority bias for the when creating the masks for a reality model the masking of reality models by other reality models can be controlled.
   * `transparency`: (optional) - A value for the mask transparency override. [0...1]
   * `priority`: (optional) - A bias to be applied to the default reality model priority.  As lower priority models are masked by higher priority ones, specifying a priority of -1 would cause the reality model to be masked by other reality models.
+  * `invert`: (optional) - If `on` or `true` then the mask sense is inverted and the area outside the mask geometry will be masked and the area inside the mask is displayed.
 * `fdt set reality model mask models`
   * `transparency`: (optional)- A value for the mask transparency override.  A value of 0 (the default) will completely mask the reality model, higher values will produce less masking and more more map display [0..1]  If no transparency is included then the transparency value from the mask elements is used.
+  * `invert`: (optional) - If `on` or `true` then the mask sense is inverted and the area outside the mask geometry will be masked and the area inside the mask is displayed.
 * `fdt set reality model mask elements` Set the reality model to be masked by one or more elements.  If elements are already selected they are used for the mask, otherwise the mask elements may be selected individually.
   * `transparency`: (optional) - A value for the mask transparency override. [0...1]
+  * `invert`: (optional) - If `on` or `true` then the mask sense is inverted and the area outside the mask geometry will be masked and the area inside the mask is displayed.
 * `fdt set reality model mask exclude elements` Set a reality model to be masked by all elements except the selected (or individually picked) excluded elements.
   * `transparency`: (optional) - A value for the mask transparency override. [0...1]
+  * `invert`: (optional) - If `on` or `true` then the mask sense is inverted and the area outside the mask geometry will be masked and the area inside the mask is displayed.
 * `fdt set reality model mask subcategory` Set a reality mdel to be masked by one or more picked subcategories.
   * `transparency`: (optional) - A value for the mask transparency override. [0...1]
+  * `invert`: (optional) - If `on` or `true` then the mask sense is inverted and the area outside the mask geometry will be masked and the area inside the mask is displayed
 * `fdt unmask reality model` Removes the masks from the selected reality model.
 
 ### Other key-ins
@@ -239,6 +249,7 @@ These keysins control the planar masking of reality models.
   * `copy`: copy result to system clipboard.
   * `quote`: format the result so it can be directly parsed by `fdt apply rendering style` as a single quoted string argument.
 * `fdt apply rendering style` - Given a rendering style as a JSON string (see `fdt save rendering style`), applies it to the active viewport's display style. See `DisplayStyleSettings.applyOverrides`. Takes a single required argument: the JSON string.
+* `fdt bgcolor` - change the background color for the active viewport. It requires a single argument - the string representation of the color. See ColorDef.fromString for supported formats.
 * `fdt change viewflags` - Changes any number of ViewFlags for the active viewport. Each argument is of the format "flag=value". For boolean flags, the value is `0` for `false` or `1` for `true`. Flag names are case-insensitive.
   * Boolean flags: "dimensions", "patterns", "weights", "styles", "transparency", "fill", "textures", "materials", "acsTriad", "grid", "visibleEdges", "hiddenEdges", "lighting", "shadows", "clipVolume", "constructions", "monochrome", "backgroundMap", "ambientOcclusion", "forceSurfaceDiscard"
   * "renderMode": 0 = wireframe, 3 = hidden line, 4 = solid fill, 6 = smooth shade (numeric values of RenderMode enum).
@@ -252,6 +263,14 @@ These keysins control the planar masking of reality models.
   * "copy=0|1" where `1` indicates the output should be copied to the system clipboard.
 * `fdt select elements` - given a list of element Ids separated by whitespace, replace the contents of the selection set with those Ids.
 * `fdt toggle skybox` - If the active viewport is displaying a spatial view, toggles display of the skybox.
+* `fdt sky sphere` - set the image used for the skybox as a Url or texture Id.
+* `fdt sky cube` - set the images used for the skybox, mapping each to one or more faces of the box. Each image is specified as a Url or texture Id. The images are mapped in the following orders based on how many are supplied:
+  * 1: all faces use the same image
+  * 2: top/bottom, sides
+  * 3: top/bottom, left/right, front/back
+  * 4: top, bottom, left/right, front/back
+  * 5: top/bottom, left, right, front, back
+  * 6: top, bottom, left, right, front, back
 * `fdt emphasize selection` - Emphasizes all elements in the selection set, and de-emphasizes all other elements by making them semi-transparent and grey. If the selection set is empty, clear the effects of any previous use of this key-in. Accepts one of the following arguments:
   * "none": Don't override color, don't apply silhouette.
   * "color": Override color to white.
@@ -263,7 +282,6 @@ These keysins control the planar masking of reality models.
 * `fdt clear emphasized` - Undo the effects of `fdt emphasize selection` or `fdt emphasize visible`.
 * `fdt isolate selection` - Causes all elements except those currently in the selection set to stop drawing.
 * `fdt clear isolate` - Reverse the effects of `fdt isolate selection`.
-* `fdt toggle wiremesh` - Toggles "pseudo-wiremesh" display. This causes surfaces to be rendered using `GL_LINES` instead of `GL_TRIANGLES`. Useful for visualizing the triangles of a mesh - but not suitable for "real" wiremesh display.
 * `fdt test clip style ON|OFF` - Toggles a ClipStyle for the active viewport with hard-coded symbology overrides.
 * `fdt tile bounds` - Sets the type of bounding volume decorations that will be displayed for each tile displayed in the view. Accepts at most one argument; if none is specified, it defaults to "volume", unless tile bounds are already displayed, in which it toggles them back off.
   * "none": Don't display bounding volumes.
@@ -289,6 +307,13 @@ These keysins control the planar masking of reality models.
 * `fdt webgl lose context` - Force a webgl context loss.
 * `fdt compile shaders` - Compile all un-compiled registered shader programs and report whether any errors occurred. Useful for testing/debugging platform-specific shader issues.
 * `fdt animation interval` - Changes the `IModelApp.animationInterval` settings. Specify milliseconds in non-negative milliseconds; or anything not parseable as an integer to disable the interval callback entirely.
+* `fdt query schedule script` - Queries the schedule script associated with the RenderTimeline or DisplayStyle element specified by Id. All arguments are optional:
+  - "id=<Id>": The Id of the element hosting the script. If omitted, obtains the Id from the schedule script applied to the active viewport.
+  - "action=<break|copy>": Specifies what to do after obtaining the script. "break" causes execution to pause in the debugger. "copy" (the default) copies the script JSON to the clipboard.
+  - "elementIds=<include|count|expand>": Specifies what to do with the list of element Ids in the script. By default, they are omitted.
+    * "include": Include the Ids as they are stored in the script - possibly in compressed format.
+    * "expand": Include the Ids, decompressing them if they are in compressed format.
+    * "count": Replace each list of Ids with the number of Ids in that list.
 * `fdt visibility` - Controls whether instanced, un-instanced (batched), or all geometry is displayed in the active viewport. Accepts at most one argument; defaults to "all" if none is specified:
   * "instanced": Display only instanced geometry.
   * "batched": Display only un-instanced (batched) geometry.

package/lib/cjs/FrontEndDevTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrontEndDevTools.d.ts","sourceRoot":"","sources":["../../src/FrontEndDevTools.ts"],"names":[],"mappings":"AAIA;;GAEG;AAuDH;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAS;IAEpC;;;;;;;OAOG;WACiB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAmJhD"}
+{"version":3,"file":"FrontEndDevTools.d.ts","sourceRoot":"","sources":["../../src/FrontEndDevTools.ts"],"names":[],"mappings":"AAIA;;GAEG;AA+DH;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAS;IAEpC;;;;;;;OAOG;WACiB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAwJhD"}

package/lib/cjs/FrontEndDevTools.js

@@ -72,6 +72,7 @@ class FrontendDevTools {
             DisplayStyleTools_1.ApplyRenderingStyleTool,
             SavedViews_1.ApplyViewByIdTool,
             SavedViews_1.ApplyViewTool,
+            DisplayStyleTools_1.ChangeBackgroundColorTool,
             ViewportTools_1.ChangeCameraTool,
             ViewportTools_1.ChangeEmphasisSettingsTool,
             ViewportTools_1.ChangeFlashSettingsTool,
@@ -113,6 +114,7 @@ class FrontendDevTools {
             MeasureTileLoadTime_1.MeasureTileLoadTimeTool,
             DisplayStyleTools_1.OverrideSubCategoryTool,
             PlanProjectionTools_1.OverrideSubCategoryPriorityTool,
+            DisplayStyleTools_1.QueryScheduleScriptTool,
             RealityTransitionTool_1.RealityTransitionTool,
             MapLayerTool_1.ReorderMapLayers,
             ReportWebGLCompatibilityTool_1.ReportWebGLCompatibilityTool,
@@ -128,6 +130,8 @@ class FrontendDevTools {
             Convolution_1.SharpenEffect,
             Convolution_1.SharpnessEffect,
             ViewportTools_1.ShowTileVolumesTool,
+            DisplayStyleTools_1.SkyCubeTool,
+            DisplayStyleTools_1.SkySphereTool,
             Snow_1.SnowEffect,
             SourceAspectIdTools_1.SourceAspectIdFromElementIdTool,
             ClipTools_1.TestClipStyleTool,
@@ -145,11 +149,12 @@ class FrontendDevTools {
             DisplayStyleTools_1.ToggleSkyboxTool,
             TileRequestDecoration_1.ToggleTileRequestDecorationTool,
             TileTreeBoundsDecoration_1.ToggleTileTreeBoundsDecorationTool,
+            ViewportTools_1.ToggleTileTreeReferencesTool,
             ToolTipProvider_1.ToggleToolTipsTool,
             ViewportTools_1.ToggleViewAttachmentBoundariesTool,
             ViewportTools_1.ToggleViewAttachmentClipShapesTool,
             ViewportTools_1.ToggleViewAttachmentsTool,
-            RenderSystemTools_1.ToggleWiremeshTool,
+            DisplayStyleTools_1.ToggleWiremeshTool,
             RenderTargetTools_1.ToggleRealityTileBounds,
             RenderTargetTools_1.ToggleRealityTilePreload,
             RenderTargetTools_1.ToggleRealityTileLogging,

package/lib/cjs/FrontEndDevTools.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrontEndDevTools.js","sourceRoot":"","sources":["../../src/FrontEndDevTools.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 Utilities\r\n */\r\n\r\nimport { IModelApp } from \"@itwin/core-frontend\";\r\nimport { EdgeDetectionEffect, EmbossEffect, GaussianBlurEffect, SharpenEffect, SharpnessEffect, UnsharpenEffect } from \"./effects/Convolution\";\r\nimport { ClearEffectsTool } from \"./effects/EffectTools\";\r\nimport { ExplosionEffect } from \"./effects/Explosion\";\r\nimport { FlipImageConfig, FlipImageEffect } from \"./effects/FlipImage\";\r\nimport { LensDistortionConfig, LensDistortionEffect } from \"./effects/LensDistortion\";\r\nimport { SaturationConfig, SaturationEffect } from \"./effects/Saturation\";\r\nimport { SnowEffect } from \"./effects/Snow\";\r\nimport { VignetteConfig, VignetteEffect } from \"./effects/Vignette\";\r\nimport { MaskBackgroundMapByElementTool, MaskBackgroundMapByExcludedElementTool, MaskBackgroundMapByModelTool, MaskBackgroundMapBySubCategoryTool, MaskRealityModelByElementTool, MaskRealityModelByExcludedElementTool, MaskRealityModelByModelTool, MaskRealityModelBySubCategoryTool, SetHigherPriorityRealityModelMasking, SetMapHigherPriorityMasking, UnmaskMapTool, UnmaskRealityModelTool } from \"./tools/PlanarMaskTools\";\r\nimport { ChangeCameraTool, ChangeEmphasisSettingsTool, ChangeFlashSettingsTool, ChangeHiliteSettingsTool, DefaultTileSizeModifierTool, FadeOutTool, FreezeSceneTool, SetAspectRatioSkewTool, ShowTileVolumesTool, Toggle3dManipulationsTool, ToggleDrawingGraphicsTool, ToggleSectionDrawingSpatialViewTool, ToggleViewAttachmentBoundariesTool, ToggleViewAttachmentClipShapesTool, ToggleViewAttachmentsTool, ViewportAddRealityModel, ViewportTileSizeModifierTool } from \"./tools/ViewportTools\";\r\nimport { AnimationIntervalTool } from \"./tools/AnimationIntervalTool\";\r\nimport { ChangeUnitsTool } from \"./tools/ChangeUnitsTool\";\r\nimport { ClipColorTool, TestClipStyleTool, ToggleSectionCutTool } from \"./tools/ClipTools\";\r\nimport {\r\n  ApplyRenderingStyleTool, ChangeViewFlagsTool, OverrideSubCategoryTool, SaveRenderingStyleTool, ToggleSkyboxTool, WoWIgnoreBackgroundTool,\r\n} from \"./tools/DisplayStyleTools\";\r\nimport {\r\n  ClearEmphasizedElementsTool, ClearIsolatedElementsTool, EmphasizeSelectedElementsTool, EmphasizeVisibleElementsTool, IsolateSelectedElementsTool,\r\n} from \"./tools/EmphasizeElementsTool\";\r\nimport { ToggleFrustumSnapshotTool, ToggleSelectedViewFrustumTool, ToggleShadowFrustumTool } from \"./tools/FrustumDecoration\";\r\nimport { InspectElementTool } from \"./tools/InspectElementTool\";\r\nimport {\r\n  AttachArcGISMapLayerByUrlTool, AttachMapLayerTool, AttachMapOverlayTool, AttachTileURLMapLayerByUrlTool, AttachWmsMapLayerByUrlTool,\r\n  AttachWmtsMapLayerByUrlTool, DetachMapLayersTool, MapBaseColorTool, MapBaseTransparencyTool, MapBaseVisibilityTool, MapLayerSubLayerVisibilityTool,\r\n  MapLayerTransparencyTool, MapLayerVisibilityTool, MapLayerZoomTool, ReorderMapLayers, SetMapBaseTool, ToggleTerrainTool,\r\n} from \"./tools/MapLayerTool\";\r\nimport { MeasureTileLoadTimeTool } from \"./tools/MeasureTileLoadTime\";\r\nimport {\r\n  ClearModelAppearanceOverrides, SetModelColorTool, SetModelEmphasizedTool, SetModelIgnoresMaterialsTool, SetModelLineCodeTool,\r\n  SetModelLineWeightTool, SetModelLocateTool, SetModelTransparencyTool,\r\n} from \"./tools/ModelAppearanceTools\";\r\nimport { ChangePlanProjectionSettingsTool, DumpPlanProjectionSettingsTool, OverrideSubCategoryPriorityTool } from \"./tools/PlanProjectionTools\";\r\nimport { ToggleProjectExtentsTool } from \"./tools/ProjectExtents\";\r\nimport {\r\n  AttachCesiumAssetTool, AttachRealityModelTool, ClearRealityModelAppearanceOverrides, DetachRealityModelTool, SaveRealityModelTool,\r\n  SetRealityModelColorTool, SetRealityModelEmphasizedTool, SetRealityModelLocateTool, SetRealityModelTransparencyTool, ToggleOSMBuildingDisplay,\r\n} from \"./tools/RealityModelTools\";\r\nimport { RealityTransitionTool } from \"./tools/RealityTransitionTool\";\r\nimport { CompileShadersTool, LoseWebGLContextTool, ToggleDPIForLODTool, ToggleWiremeshTool } from \"./tools/RenderSystemTools\";\r\nimport {\r\n  SetAASamplesTool, ToggleDrapeFrustumTool, TogglePrimitiveVisibilityTool, ToggleReadPixelsTool, ToggleRealityTileBounds, ToggleRealityTileFreeze,\r\n  ToggleRealityTileLogging, ToggleRealityTilePreload, ToggleVolClassIntersect,\r\n} from \"./tools/RenderTargetTools\";\r\nimport { ReportWebGLCompatibilityTool } from \"./tools/ReportWebGLCompatibilityTool\";\r\nimport { ApplyViewByIdTool, ApplyViewTool, SaveViewTool } from \"./tools/SavedViews\";\r\nimport { SelectElementsByIdTool } from \"./tools/SelectionTools\";\r\nimport { SetGpuMemoryLimitTool } from \"./tools/SetGpuMemoryLimitTool\";\r\nimport { ElementIdFromSourceAspectIdTool, SourceAspectIdFromElementIdTool } from \"./tools/SourceAspectIdTools\";\r\nimport { ToggleTileRequestDecorationTool } from \"./tools/TileRequestDecoration\";\r\nimport { ToggleTileTreeBoundsDecorationTool } from \"./tools/TileTreeBoundsDecoration\";\r\nimport { ToggleToolTipsTool } from \"./tools/ToolTipProvider\";\r\n\r\n/** Entry-point for the package. Before using the package you *must* call [[FrontendDevTools.initialize]].\r\n * @beta\r\n */\r\nexport class FrontendDevTools {\r\n  private static _initialized = false;\r\n\r\n  /** Call this before using the package (e.g., before instantiating any of its widgets or attempting to use any of its tools.\r\n   * To initialize when starting up your app:\r\n   * ```ts\r\n   *   IModelApp.startup();\r\n   *   await FrontendDevTools.initialize();\r\n   * ```\r\n   * @beta\r\n   */\r\n  public static async initialize(): Promise<void> {\r\n    if (this._initialized)\r\n      return;\r\n\r\n    this._initialized = true;\r\n\r\n    const namespace = \"FrontendDevTools\";\r\n    const namespacePromise = IModelApp.localization.registerNamespace(namespace);\r\n    const tools = [\r\n      AttachMapLayerTool,\r\n      AttachMapOverlayTool,\r\n      AttachArcGISMapLayerByUrlTool,\r\n      AttachWmsMapLayerByUrlTool,\r\n      AttachWmtsMapLayerByUrlTool,\r\n      AttachTileURLMapLayerByUrlTool,\r\n      AnimationIntervalTool,\r\n      ApplyRenderingStyleTool,\r\n      ApplyViewByIdTool,\r\n      ApplyViewTool,\r\n      ChangeCameraTool,\r\n      ChangeEmphasisSettingsTool,\r\n      ChangeFlashSettingsTool,\r\n      ChangeHiliteSettingsTool,\r\n      ChangePlanProjectionSettingsTool,\r\n      ChangeUnitsTool,\r\n      ChangeViewFlagsTool,\r\n      ClearEffectsTool,\r\n      ClearEmphasizedElementsTool,\r\n      ClearIsolatedElementsTool,\r\n      ClipColorTool,\r\n      CompileShadersTool,\r\n      DefaultTileSizeModifierTool,\r\n      DetachMapLayersTool,\r\n      DumpPlanProjectionSettingsTool,\r\n      EdgeDetectionEffect,\r\n      EmbossEffect,\r\n      ElementIdFromSourceAspectIdTool,\r\n      EmphasizeSelectedElementsTool,\r\n      EmphasizeVisibleElementsTool,\r\n      ExplosionEffect,\r\n      FadeOutTool,\r\n      FlipImageConfig,\r\n      FlipImageEffect,\r\n      FreezeSceneTool,\r\n      GaussianBlurEffect,\r\n      InspectElementTool,\r\n      IsolateSelectedElementsTool,\r\n      LensDistortionConfig,\r\n      LensDistortionEffect,\r\n      LoseWebGLContextTool,\r\n      MapLayerTransparencyTool,\r\n      MapLayerVisibilityTool,\r\n      MapLayerSubLayerVisibilityTool,\r\n      MapLayerZoomTool,\r\n      MapBaseColorTool,\r\n      MapBaseTransparencyTool,\r\n      MapBaseVisibilityTool,\r\n      MeasureTileLoadTimeTool,\r\n      OverrideSubCategoryTool,\r\n      OverrideSubCategoryPriorityTool,\r\n      RealityTransitionTool,\r\n      ReorderMapLayers,\r\n      ReportWebGLCompatibilityTool,\r\n      SaturationConfig,\r\n      SaturationEffect,\r\n      SaveRenderingStyleTool,\r\n      SaveViewTool,\r\n      SelectElementsByIdTool,\r\n      SetAASamplesTool,\r\n      SetAspectRatioSkewTool,\r\n      ToggleVolClassIntersect,\r\n      SetMapBaseTool,\r\n      SharpenEffect,\r\n      SharpnessEffect,\r\n      ShowTileVolumesTool,\r\n      SnowEffect,\r\n      SourceAspectIdFromElementIdTool,\r\n      TestClipStyleTool,\r\n      Toggle3dManipulationsTool,\r\n      ToggleDrawingGraphicsTool,\r\n      ToggleDPIForLODTool,\r\n      ToggleDrapeFrustumTool,\r\n      ToggleFrustumSnapshotTool,\r\n      TogglePrimitiveVisibilityTool,\r\n      ToggleProjectExtentsTool,\r\n      ToggleReadPixelsTool,\r\n      ToggleSectionDrawingSpatialViewTool,\r\n      ToggleSelectedViewFrustumTool,\r\n      ToggleShadowFrustumTool,\r\n      ToggleSkyboxTool,\r\n      ToggleTileRequestDecorationTool,\r\n      ToggleTileTreeBoundsDecorationTool,\r\n      ToggleToolTipsTool,\r\n      ToggleViewAttachmentBoundariesTool,\r\n      ToggleViewAttachmentClipShapesTool,\r\n      ToggleViewAttachmentsTool,\r\n      ToggleWiremeshTool,\r\n      ToggleRealityTileBounds,\r\n      ToggleRealityTilePreload,\r\n      ToggleRealityTileLogging,\r\n      ToggleRealityTileFreeze,\r\n      ToggleSectionCutTool,\r\n      ToggleTerrainTool,\r\n      UnsharpenEffect,\r\n      ViewportAddRealityModel,\r\n      ViewportTileSizeModifierTool,\r\n      VignetteConfig,\r\n      VignetteEffect,\r\n      AttachRealityModelTool,\r\n      DetachRealityModelTool,\r\n      SaveRealityModelTool,\r\n      SetGpuMemoryLimitTool,\r\n      SetRealityModelLocateTool,\r\n      SetRealityModelEmphasizedTool,\r\n      SetRealityModelTransparencyTool,\r\n      SetRealityModelColorTool,\r\n      SetModelLocateTool,\r\n      SetModelEmphasizedTool,\r\n      SetModelTransparencyTool,\r\n      SetModelColorTool,\r\n      SetModelLineWeightTool,\r\n      SetModelLineCodeTool,\r\n      SetModelIgnoresMaterialsTool,\r\n      ClearRealityModelAppearanceOverrides,\r\n      ClearModelAppearanceOverrides,\r\n      AttachCesiumAssetTool,\r\n      ToggleOSMBuildingDisplay,\r\n      SetHigherPriorityRealityModelMasking,\r\n      SetMapHigherPriorityMasking,\r\n      MaskRealityModelByModelTool,\r\n      MaskRealityModelBySubCategoryTool,\r\n      MaskRealityModelByElementTool,\r\n      MaskRealityModelByExcludedElementTool,\r\n      UnmaskRealityModelTool,\r\n      MaskBackgroundMapByModelTool,\r\n      MaskBackgroundMapBySubCategoryTool,\r\n      MaskBackgroundMapByElementTool,\r\n      MaskBackgroundMapByExcludedElementTool,\r\n      UnmaskMapTool,\r\n      WoWIgnoreBackgroundTool,\r\n    ];\r\n\r\n    for (const tool of tools)\r\n      tool.register(namespace);\r\n\r\n    return namespacePromise;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"FrontEndDevTools.js","sourceRoot":"","sources":["../../src/FrontEndDevTools.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 Utilities\r\n */\r\n\r\nimport { IModelApp } from \"@itwin/core-frontend\";\r\nimport { EdgeDetectionEffect, EmbossEffect, GaussianBlurEffect, SharpenEffect, SharpnessEffect, UnsharpenEffect } from \"./effects/Convolution\";\r\nimport { ClearEffectsTool } from \"./effects/EffectTools\";\r\nimport { ExplosionEffect } from \"./effects/Explosion\";\r\nimport { FlipImageConfig, FlipImageEffect } from \"./effects/FlipImage\";\r\nimport { LensDistortionConfig, LensDistortionEffect } from \"./effects/LensDistortion\";\r\nimport { SaturationConfig, SaturationEffect } from \"./effects/Saturation\";\r\nimport { SnowEffect } from \"./effects/Snow\";\r\nimport { VignetteConfig, VignetteEffect } from \"./effects/Vignette\";\r\nimport {\r\n  MaskBackgroundMapByElementTool, MaskBackgroundMapByExcludedElementTool, MaskBackgroundMapByModelTool, MaskBackgroundMapBySubCategoryTool, MaskRealityModelByElementTool, MaskRealityModelByExcludedElementTool,\r\n  MaskRealityModelByModelTool, MaskRealityModelBySubCategoryTool, SetHigherPriorityRealityModelMasking, SetMapHigherPriorityMasking, UnmaskMapTool, UnmaskRealityModelTool,\r\n} from \"./tools/PlanarMaskTools\";\r\nimport {\r\n  ChangeCameraTool, ChangeEmphasisSettingsTool, ChangeFlashSettingsTool, ChangeHiliteSettingsTool, DefaultTileSizeModifierTool, FadeOutTool, FreezeSceneTool, SetAspectRatioSkewTool, ShowTileVolumesTool,\r\n  Toggle3dManipulationsTool, ToggleDrawingGraphicsTool, ToggleSectionDrawingSpatialViewTool, ToggleTileTreeReferencesTool, ToggleViewAttachmentBoundariesTool, ToggleViewAttachmentClipShapesTool,\r\n  ToggleViewAttachmentsTool, ViewportAddRealityModel, ViewportTileSizeModifierTool,\r\n} from \"./tools/ViewportTools\";\r\nimport { AnimationIntervalTool } from \"./tools/AnimationIntervalTool\";\r\nimport { ChangeUnitsTool } from \"./tools/ChangeUnitsTool\";\r\nimport { ClipColorTool, TestClipStyleTool, ToggleSectionCutTool } from \"./tools/ClipTools\";\r\nimport {\r\n  ApplyRenderingStyleTool, ChangeBackgroundColorTool, ChangeViewFlagsTool, OverrideSubCategoryTool, QueryScheduleScriptTool, SaveRenderingStyleTool, SkyCubeTool, SkySphereTool, ToggleSkyboxTool,\r\n  ToggleWiremeshTool, WoWIgnoreBackgroundTool,\r\n} from \"./tools/DisplayStyleTools\";\r\nimport {\r\n  ClearEmphasizedElementsTool, ClearIsolatedElementsTool, EmphasizeSelectedElementsTool, EmphasizeVisibleElementsTool, IsolateSelectedElementsTool,\r\n} from \"./tools/EmphasizeElementsTool\";\r\nimport { ToggleFrustumSnapshotTool, ToggleSelectedViewFrustumTool, ToggleShadowFrustumTool } from \"./tools/FrustumDecoration\";\r\nimport { InspectElementTool } from \"./tools/InspectElementTool\";\r\nimport {\r\n  AttachArcGISMapLayerByUrlTool, AttachMapLayerTool, AttachMapOverlayTool, AttachTileURLMapLayerByUrlTool, AttachWmsMapLayerByUrlTool,\r\n  AttachWmtsMapLayerByUrlTool, DetachMapLayersTool, MapBaseColorTool, MapBaseTransparencyTool, MapBaseVisibilityTool, MapLayerSubLayerVisibilityTool,\r\n  MapLayerTransparencyTool, MapLayerVisibilityTool, MapLayerZoomTool, ReorderMapLayers, SetMapBaseTool, ToggleTerrainTool,\r\n} from \"./tools/MapLayerTool\";\r\nimport { MeasureTileLoadTimeTool } from \"./tools/MeasureTileLoadTime\";\r\nimport {\r\n  ClearModelAppearanceOverrides, SetModelColorTool, SetModelEmphasizedTool, SetModelIgnoresMaterialsTool, SetModelLineCodeTool,\r\n  SetModelLineWeightTool, SetModelLocateTool, SetModelTransparencyTool,\r\n} from \"./tools/ModelAppearanceTools\";\r\nimport { ChangePlanProjectionSettingsTool, DumpPlanProjectionSettingsTool, OverrideSubCategoryPriorityTool } from \"./tools/PlanProjectionTools\";\r\nimport { ToggleProjectExtentsTool } from \"./tools/ProjectExtents\";\r\nimport {\r\n  AttachCesiumAssetTool, AttachRealityModelTool, ClearRealityModelAppearanceOverrides, DetachRealityModelTool, SaveRealityModelTool,\r\n  SetRealityModelColorTool, SetRealityModelEmphasizedTool, SetRealityModelLocateTool, SetRealityModelTransparencyTool, ToggleOSMBuildingDisplay,\r\n} from \"./tools/RealityModelTools\";\r\nimport { RealityTransitionTool } from \"./tools/RealityTransitionTool\";\r\nimport { CompileShadersTool, LoseWebGLContextTool, ToggleDPIForLODTool } from \"./tools/RenderSystemTools\";\r\nimport {\r\n  SetAASamplesTool, ToggleDrapeFrustumTool, TogglePrimitiveVisibilityTool, ToggleReadPixelsTool, ToggleRealityTileBounds, ToggleRealityTileFreeze,\r\n  ToggleRealityTileLogging, ToggleRealityTilePreload, ToggleVolClassIntersect,\r\n} from \"./tools/RenderTargetTools\";\r\nimport { ReportWebGLCompatibilityTool } from \"./tools/ReportWebGLCompatibilityTool\";\r\nimport { ApplyViewByIdTool, ApplyViewTool, SaveViewTool } from \"./tools/SavedViews\";\r\nimport { SelectElementsByIdTool } from \"./tools/SelectionTools\";\r\nimport { SetGpuMemoryLimitTool } from \"./tools/SetGpuMemoryLimitTool\";\r\nimport { ElementIdFromSourceAspectIdTool, SourceAspectIdFromElementIdTool } from \"./tools/SourceAspectIdTools\";\r\nimport { ToggleTileRequestDecorationTool } from \"./tools/TileRequestDecoration\";\r\nimport { ToggleTileTreeBoundsDecorationTool } from \"./tools/TileTreeBoundsDecoration\";\r\nimport { ToggleToolTipsTool } from \"./tools/ToolTipProvider\";\r\n\r\n/** Entry-point for the package. Before using the package you *must* call [[FrontendDevTools.initialize]].\r\n * @beta\r\n */\r\nexport class FrontendDevTools {\r\n  private static _initialized = false;\r\n\r\n  /** Call this before using the package (e.g., before instantiating any of its widgets or attempting to use any of its tools.\r\n   * To initialize when starting up your app:\r\n   * ```ts\r\n   *   IModelApp.startup();\r\n   *   await FrontendDevTools.initialize();\r\n   * ```\r\n   * @beta\r\n   */\r\n  public static async initialize(): Promise<void> {\r\n    if (this._initialized)\r\n      return;\r\n\r\n    this._initialized = true;\r\n\r\n    const namespace = \"FrontendDevTools\";\r\n    const namespacePromise = IModelApp.localization.registerNamespace(namespace);\r\n    const tools = [\r\n      AttachMapLayerTool,\r\n      AttachMapOverlayTool,\r\n      AttachArcGISMapLayerByUrlTool,\r\n      AttachWmsMapLayerByUrlTool,\r\n      AttachWmtsMapLayerByUrlTool,\r\n      AttachTileURLMapLayerByUrlTool,\r\n      AnimationIntervalTool,\r\n      ApplyRenderingStyleTool,\r\n      ApplyViewByIdTool,\r\n      ApplyViewTool,\r\n      ChangeBackgroundColorTool,\r\n      ChangeCameraTool,\r\n      ChangeEmphasisSettingsTool,\r\n      ChangeFlashSettingsTool,\r\n      ChangeHiliteSettingsTool,\r\n      ChangePlanProjectionSettingsTool,\r\n      ChangeUnitsTool,\r\n      ChangeViewFlagsTool,\r\n      ClearEffectsTool,\r\n      ClearEmphasizedElementsTool,\r\n      ClearIsolatedElementsTool,\r\n      ClipColorTool,\r\n      CompileShadersTool,\r\n      DefaultTileSizeModifierTool,\r\n      DetachMapLayersTool,\r\n      DumpPlanProjectionSettingsTool,\r\n      EdgeDetectionEffect,\r\n      EmbossEffect,\r\n      ElementIdFromSourceAspectIdTool,\r\n      EmphasizeSelectedElementsTool,\r\n      EmphasizeVisibleElementsTool,\r\n      ExplosionEffect,\r\n      FadeOutTool,\r\n      FlipImageConfig,\r\n      FlipImageEffect,\r\n      FreezeSceneTool,\r\n      GaussianBlurEffect,\r\n      InspectElementTool,\r\n      IsolateSelectedElementsTool,\r\n      LensDistortionConfig,\r\n      LensDistortionEffect,\r\n      LoseWebGLContextTool,\r\n      MapLayerTransparencyTool,\r\n      MapLayerVisibilityTool,\r\n      MapLayerSubLayerVisibilityTool,\r\n      MapLayerZoomTool,\r\n      MapBaseColorTool,\r\n      MapBaseTransparencyTool,\r\n      MapBaseVisibilityTool,\r\n      MeasureTileLoadTimeTool,\r\n      OverrideSubCategoryTool,\r\n      OverrideSubCategoryPriorityTool,\r\n      QueryScheduleScriptTool,\r\n      RealityTransitionTool,\r\n      ReorderMapLayers,\r\n      ReportWebGLCompatibilityTool,\r\n      SaturationConfig,\r\n      SaturationEffect,\r\n      SaveRenderingStyleTool,\r\n      SaveViewTool,\r\n      SelectElementsByIdTool,\r\n      SetAASamplesTool,\r\n      SetAspectRatioSkewTool,\r\n      ToggleVolClassIntersect,\r\n      SetMapBaseTool,\r\n      SharpenEffect,\r\n      SharpnessEffect,\r\n      ShowTileVolumesTool,\r\n      SkyCubeTool,\r\n      SkySphereTool,\r\n      SnowEffect,\r\n      SourceAspectIdFromElementIdTool,\r\n      TestClipStyleTool,\r\n      Toggle3dManipulationsTool,\r\n      ToggleDrawingGraphicsTool,\r\n      ToggleDPIForLODTool,\r\n      ToggleDrapeFrustumTool,\r\n      ToggleFrustumSnapshotTool,\r\n      TogglePrimitiveVisibilityTool,\r\n      ToggleProjectExtentsTool,\r\n      ToggleReadPixelsTool,\r\n      ToggleSectionDrawingSpatialViewTool,\r\n      ToggleSelectedViewFrustumTool,\r\n      ToggleShadowFrustumTool,\r\n      ToggleSkyboxTool,\r\n      ToggleTileRequestDecorationTool,\r\n      ToggleTileTreeBoundsDecorationTool,\r\n      ToggleTileTreeReferencesTool,\r\n      ToggleToolTipsTool,\r\n      ToggleViewAttachmentBoundariesTool,\r\n      ToggleViewAttachmentClipShapesTool,\r\n      ToggleViewAttachmentsTool,\r\n      ToggleWiremeshTool,\r\n      ToggleRealityTileBounds,\r\n      ToggleRealityTilePreload,\r\n      ToggleRealityTileLogging,\r\n      ToggleRealityTileFreeze,\r\n      ToggleSectionCutTool,\r\n      ToggleTerrainTool,\r\n      UnsharpenEffect,\r\n      ViewportAddRealityModel,\r\n      ViewportTileSizeModifierTool,\r\n      VignetteConfig,\r\n      VignetteEffect,\r\n      AttachRealityModelTool,\r\n      DetachRealityModelTool,\r\n      SaveRealityModelTool,\r\n      SetGpuMemoryLimitTool,\r\n      SetRealityModelLocateTool,\r\n      SetRealityModelEmphasizedTool,\r\n      SetRealityModelTransparencyTool,\r\n      SetRealityModelColorTool,\r\n      SetModelLocateTool,\r\n      SetModelEmphasizedTool,\r\n      SetModelTransparencyTool,\r\n      SetModelColorTool,\r\n      SetModelLineWeightTool,\r\n      SetModelLineCodeTool,\r\n      SetModelIgnoresMaterialsTool,\r\n      ClearRealityModelAppearanceOverrides,\r\n      ClearModelAppearanceOverrides,\r\n      AttachCesiumAssetTool,\r\n      ToggleOSMBuildingDisplay,\r\n      SetHigherPriorityRealityModelMasking,\r\n      SetMapHigherPriorityMasking,\r\n      MaskRealityModelByModelTool,\r\n      MaskRealityModelBySubCategoryTool,\r\n      MaskRealityModelByElementTool,\r\n      MaskRealityModelByExcludedElementTool,\r\n      UnmaskRealityModelTool,\r\n      MaskBackgroundMapByModelTool,\r\n      MaskBackgroundMapBySubCategoryTool,\r\n      MaskBackgroundMapByElementTool,\r\n      MaskBackgroundMapByExcludedElementTool,\r\n      UnmaskMapTool,\r\n      WoWIgnoreBackgroundTool,\r\n    ];\r\n\r\n    for (const tool of tools)\r\n      tool.register(namespace);\r\n\r\n    return namespacePromise;\r\n  }\r\n}\r\n"]}

package/lib/cjs/effects/Explosion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Explosion.d.ts","sourceRoot":"","sources":["../../../src/effects/Explosion.ts"],"names":[],"mappings":"AAIA;;GAEG;AAKH,OAAO,EACqJ,IAAI,EAC/J,MAAM,sBAAsB,CAAC;AAyL9B;;GAEG;AACH,qBAAa,eAAgB,SAAQ,IAAI;IACvC,OAAuB,MAAM,SAAqB;IAElD,wEAAwE;IAClD,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;CAO9C"}
+{"version":3,"file":"Explosion.d.ts","sourceRoot":"","sources":["../../../src/effects/Explosion.ts"],"names":[],"mappings":"AAIA;;GAEG;AAKH,OAAO,EACgI,IAAI,EAC1I,MAAM,sBAAsB,CAAC;AAyL9B;;GAEG;AACH,qBAAa,eAAgB,SAAQ,IAAI;IACvC,OAAuB,MAAM,SAAqB;IAElD,wEAAwE;IAClD,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;CAO9C"}

package/lib/cjs/effects/Explosion.js

@@ -9,6 +9,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExplosionEffect = void 0;
 const core_geometry_1 = require("@itwin/core-geometry");
+const core_common_1 = require("@itwin/core-common");
 const core_frontend_1 = require("@itwin/core-frontend");
 const Random_1 = require("./Random");
 /** Represents one particle in the system. */
@@ -141,10 +142,10 @@ class ParticleSystem {
     }
     static async addDecorator(iModel) {
         // Note: The decorator takes ownership of the texture, and disposes of it when the decorator is disposed.
-        const image = await (0, core_frontend_1.imageElementFromUrl)("./sprites/particle_explosion.png");
+        const image = await (0, core_frontend_1.imageElementFromUrl)(`${core_frontend_1.IModelApp.publicPath}sprites/particle_explosion.png`);
         const texture = core_frontend_1.IModelApp.renderSystem.createTexture({
             ownership: "external",
-            image: { source: image, transparency: core_frontend_1.TextureTransparency.Mixed },
+            image: { source: image, transparency: core_common_1.TextureTransparency.Mixed },
         });
         if (texture)
             core_frontend_1.IModelApp.viewManager.addDecorator(new ParticleSystem(texture, iModel, (0, Random_1.randomIntegerInRange)(this.numEmissionsRange)));

package/lib/cjs/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 } from \"@itwin/core-common\";\r\nimport {\r\n  DecorateContext, GraphicType, HitDetail, imageElementFromUrl, IModelApp, IModelConnection, ParticleCollectionBuilder, ParticleProps, TextureTransparency, 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.next;\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(\"./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":["/*---------------------------------------------------------------------------------------------\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.next;\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"]}

package/lib/cjs/effects/Snow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Snow.d.ts","sourceRoot":"","sources":["../../../src/effects/Snow.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAW,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EACL,eAAe,EAAE,SAAS,EAA0E,aAAa,EAAuB,IAAI,EAAE,QAAQ,EACvJ,MAAM,sBAAsB,CAAC;AAI9B;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,oDAAoD;IACpD,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IAEV,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sKAAsK;IACtK,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kGAAkG;IAClG,aAAa,EAAE,OAAO,CAAC;IACvB,2JAA2J;IAC3J,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,oCAAoC;IACpC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,sDAAsD;IACtD,SAAgB,OAAO,EAAE,YAAY,CAAC;IACtC,oHAAoH;IACpH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,sEAAsE;IACtE,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IAErC,OAAO;IAuCA,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IA0B/C,8DAA8D;IACvD,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAQnD,sDAAsD;IACtD,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,eAAe;IA4CvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAEzE;;;OAGG;WACiB,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBhF;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,IAAI;IAClC,OAAuB,MAAM,SAAgB;IAEvB,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAQvC,WAAW,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAOvE"}
+{"version":3,"file":"Snow.d.ts","sourceRoot":"","sources":["../../../src/effects/Snow.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAW,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EACL,eAAe,EAAE,SAAS,EAA0E,aAAa,EAAE,IAAI,EAAE,QAAQ,EAClI,MAAM,sBAAsB,CAAC;AAI9B;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,oDAAoD;IACpD,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IAEV,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sKAAsK;IACtK,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kGAAkG;IAClG,aAAa,EAAE,OAAO,CAAC;IACvB,2JAA2J;IAC3J,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,oCAAoC;IACpC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,sDAAsD;IACtD,SAAgB,OAAO,EAAE,YAAY,CAAC;IACtC,oHAAoH;IACpH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,sEAAsE;IACtE,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IAErC,OAAO;IAuCA,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IA0B/C,8DAA8D;IACvD,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAQnD,sDAAsD;IACtD,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,eAAe;IA4CvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAEzE;;;OAGG;WACiB,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBhF;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,IAAI;IAClC,OAAuB,MAAM,SAAgB;IAEvB,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAQvC,WAAW,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAOvE"}

package/lib/cjs/effects/Snow.js

@@ -10,6 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SnowEffect = exports.SnowDecorator = void 0;
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_geometry_1 = require("@itwin/core-geometry");
+const core_common_1 = require("@itwin/core-common");
 const core_frontend_1 = require("@itwin/core-frontend");
 const parseToggle_1 = require("../tools/parseToggle");
 const Random_1 = require("./Random");
@@ -153,10 +154,10 @@ class SnowDecorator {
         else if (undefined === decorator && enable) {
             // Create a texture to use for the particles.
             // Note: the decorator takes ownership of the texture, and disposes of it when the decorator is disposed.
-            const image = await (0, core_frontend_1.imageElementFromUrl)("./sprites/particle_snow.png");
+            const image = await (0, core_frontend_1.imageElementFromUrl)(`${core_frontend_1.IModelApp.publicPath}sprites/particle_snow.png`);
             const texture = core_frontend_1.IModelApp.renderSystem.createTexture({
                 ownership: "external",
-                image: { source: image, transparency: core_frontend_1.TextureTransparency.Mixed },
+                image: { source: image, transparency: core_common_1.TextureTransparency.Mixed },
             });
             new SnowDecorator(viewport, texture);
         }

package/lib/cjs/effects/Snow.js.map

@@ -1 +1 @@
-{"version":3,"file":"Snow.js","sourceRoot":"","sources":["../../../src/effects/Snow.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 { dispose } from \"@itwin/core-bentley\";\r\nimport { Point2d, Range1d, Range2d, Vector2d } from \"@itwin/core-geometry\";\r\nimport { RenderTexture } from \"@itwin/core-common\";\r\nimport {\r\n  DecorateContext, Decorator, GraphicType, imageElementFromUrl, IModelApp, ParticleCollectionBuilder, ParticleProps, TextureTransparency, Tool, Viewport,\r\n} from \"@itwin/core-frontend\";\r\nimport { parseToggle } from \"../tools/parseToggle\";\r\nimport { randomFloat, randomInteger } from \"./Random\";\r\n\r\n/** Represents one particle displayed by a [[SnowDecorator]].\r\n * Particle positions are in [CoordSystem.View]($frontend).\r\n * @beta\r\n */\r\nexport interface SnowParticle extends ParticleProps {\r\n  /** Make x, y, and z from ParticleProps writable. */\r\n  x: number;\r\n  y: number;\r\n  z: number;\r\n\r\n  /** Current velocity, in pixels per second. */\r\n  velocity: Vector2d;\r\n}\r\n\r\n/** Parameters controlling how a [[SnowDecorator]] works.\r\n * @beta\r\n */\r\nexport interface SnowParams {\r\n  /** The number of snow particles to produce. This could alternatively be expressed as a density so that small viewports would not be more crowded than larger ones. */\r\n  numParticles: number;\r\n  /** Range from which to randomly select each particle's size, in pixels. */\r\n  sizeRange: Range1d;\r\n  /** Range from which to randomly select each particle's transparency. */\r\n  transparencyRange: Range1d;\r\n  /** Range from which to randomly select each particle's initial velocity, in pixels per second. */\r\n  velocityRange: Range2d;\r\n  /** Range from which to randomly select an acceleration to apply to each particle's velocity each frame, in pixels per second squared, to simulate wind. */\r\n  accelerationRange: Range2d;\r\n  /** Wind velocity in pixels per second in X. */\r\n  windVelocity: number;\r\n}\r\n\r\n/** The default snow effect parameters used by newly-created SnowDecorators. */\r\nconst defaultSnowParams: SnowParams = {\r\n  numParticles: 2000,\r\n  sizeRange: Range1d.createXX(3, 22),\r\n  transparencyRange: Range1d.createXX(0, 50),\r\n  velocityRange: new Range2d(-30, 50, 30, 130),\r\n  accelerationRange: new Range2d(-1, -0.25, 1, 0.25),\r\n  windVelocity: 0,\r\n};\r\n\r\n/** Simulates snowfall in a [Viewport]($frontend) using particle effects.\r\n * @see [[SnowEffect]] for a [Tool]($frontend) that toggles this decorator.\r\n * @see [ParticleCollectionBuilder]($frontend) for defining custom particle effects.\r\n * @beta\r\n */\r\nexport class SnowDecorator implements Decorator {\r\n  /** The viewport being decorated. */\r\n  public readonly viewport: Viewport;\r\n  /** Invoked when this decorator is to be destroyed. */\r\n  public readonly dispose: VoidFunction;\r\n  /** The initial width and height of the viewport, from which we randomly select each particle's initial position. */\r\n  private readonly _dimensions: Point2d;\r\n  /** The list of particles being drawn. */\r\n  private readonly _particles: SnowParticle[] = [];\r\n  /** The image to display for each particle. */\r\n  private _texture?: RenderTexture;\r\n  /** The last time `updateParticles()` was invoked, in milliseconds. */\r\n  private _lastUpdateTime: number;\r\n  private readonly _params: SnowParams;\r\n\r\n  private constructor(viewport: Viewport, texture: RenderTexture | undefined) {\r\n    this._params = { ...defaultSnowParams };\r\n    this.viewport = viewport;\r\n    this._dimensions = new Point2d(viewport.viewRect.width, viewport.viewRect.height);\r\n    this._lastUpdateTime = Date.now();\r\n    this._texture = texture;\r\n\r\n    // Tell the viewport to re-render the decorations every frame so that the snow particles animate smoothly.\r\n    const removeOnRender = viewport.onRender.addListener(() => viewport.invalidateDecorations());\r\n\r\n    // When the viewport is resized, replace this decorator with a new one to match the new dimensions.\r\n    const removeOnResized = viewport.onResized.addListener(() => {\r\n      // Transfer ownership of the texture to the new decorator.\r\n      const tex = this._texture;\r\n      this._texture = undefined;\r\n      this.dispose();\r\n      new SnowDecorator(viewport, tex);\r\n    });\r\n\r\n    // When the viewport is destroyed, dispose of this decorator too.\r\n    const removeOnDispose = viewport.onDisposed.addListener(() => this.dispose());\r\n    const removeDecorator = IModelApp.viewManager.addDecorator(this);\r\n\r\n    this.dispose = () => {\r\n      removeDecorator();\r\n      removeOnRender();\r\n      removeOnDispose();\r\n      removeOnResized();\r\n      this._texture = dispose(this._texture);\r\n      SnowDecorator._decorators.delete(viewport);\r\n    };\r\n\r\n    SnowDecorator._decorators.set(viewport, this);\r\n\r\n    // Initialize the particles.\r\n    for (let i = 0; i < this._params.numParticles; i++)\r\n      this._particles.push(this.emit(true));\r\n  }\r\n\r\n  public decorate(context: DecorateContext): void {\r\n    if (context.viewport !== this.viewport || !this._texture)\r\n      return;\r\n\r\n    // Update the particles.\r\n    const now = Date.now();\r\n    const deltaMillis = now - this._lastUpdateTime;\r\n    this._lastUpdateTime = now;\r\n    this.updateParticles(deltaMillis / 1000);\r\n\r\n    // Create particle graphics.\r\n    const builder = ParticleCollectionBuilder.create({\r\n      viewport: this.viewport,\r\n      isViewCoords: true,\r\n      texture: this._texture,\r\n      size: (this._params.sizeRange.high - this._params.sizeRange.low) / 2,\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.ViewOverlay, graphic);\r\n  }\r\n\r\n  /** Change some of the parameters affecting this decorator. */\r\n  public configure(params: Partial<SnowParams>): void {\r\n    for (const key of Object.keys(params)) {\r\n      const val = (params as any)[key];\r\n      if (undefined !== val)\r\n        (this._params as any)[key] = val;\r\n    }\r\n  }\r\n\r\n  /** Emit a new particle with randomized properties. */\r\n  private emit(randomizeHeight: boolean): SnowParticle {\r\n    return {\r\n      x: randomInteger(0, this._dimensions.x),\r\n      y: randomizeHeight ? randomInteger(0, this._dimensions.y) : 0,\r\n      z: 0,\r\n      size: randomInteger(this._params.sizeRange.low, this._params.sizeRange.high),\r\n      transparency: randomInteger(this._params.transparencyRange.low, this._params.transparencyRange.high),\r\n      velocity: new Vector2d(randomFloat(this._params.velocityRange.low.x, this._params.velocityRange.high.x),\r\n        randomFloat(this._params.velocityRange.low.y, this._params.velocityRange.high.y)),\r\n    };\r\n  }\r\n\r\n  // Update the positions and velocities of all the particles based on the amount of time that has passed since the last update.\r\n  private updateParticles(elapsedSeconds: number): void {\r\n    // Determine if someone changed the desired number of particles.\r\n    const particleDiscrepancy = this._params.numParticles - this._particles.length;\r\n    if (particleDiscrepancy > 0) {\r\n      // Birth new particles up to the new maximum.\r\n      for (let i = 0; i < particleDiscrepancy; i++)\r\n        this._particles.push(this.emit(true));\r\n    } else {\r\n      // Destroy extra particles.\r\n      this._particles.length = this._params.numParticles;\r\n    }\r\n\r\n    const acceleration = new Vector2d();\r\n    const velocity = new Vector2d();\r\n    for (let i = 0; i < this._particles.length; i++) {\r\n      // Apply some acceleration to produce random drift.\r\n      const particle = this._particles[i];\r\n      acceleration.set(randomFloat(this._params.accelerationRange.low.x, this._params.accelerationRange.high.x),\r\n        randomFloat(this._params.accelerationRange.low.y, this._params.accelerationRange.high.y));\r\n\r\n      acceleration.scale(elapsedSeconds, acceleration);\r\n      particle.velocity.plus(acceleration, particle.velocity);\r\n\r\n      // Apply velocity.\r\n      particle.velocity.clone(velocity);\r\n      velocity.scale(elapsedSeconds, velocity);\r\n      particle.x += velocity.x;\r\n      particle.y += velocity.y;\r\n\r\n      // Apply wind\r\n      particle.x += this._params.windVelocity * elapsedSeconds;\r\n\r\n      // Particles that travel beyond the viewport's left or right edges wrap around to the other side.\r\n      if (particle.x < 0)\r\n        particle.x = this._dimensions.x - 1;\r\n      else if (particle.x >= this._dimensions.x)\r\n        particle.x = 0;\r\n\r\n      // Particles that travel beyond the viewport's bottom or top edges are replaced by newborn particles.\r\n      if (particle.y < 0 || particle.y >= this._dimensions.y)\r\n        this._particles[i] = this.emit(false);\r\n    }\r\n  }\r\n\r\n  private static readonly _decorators = new Map<Viewport, SnowDecorator>();\r\n\r\n  /** Toggle this decorator for the specified viewport.\r\n   * @param viewport The viewport to which the effect should be applied or removed.\r\n   * @param enable `true` to enable the effect, `false` to disable it, or `undefined` to toggle the current state.\r\n   */\r\n  public static async toggle(viewport: Viewport, enable?: boolean): Promise<void> {\r\n    const decorator = this._decorators.get(viewport);\r\n    if (undefined === enable)\r\n      enable = undefined === decorator;\r\n\r\n    if (undefined !== decorator && !enable)\r\n      decorator.dispose();\r\n    else if (undefined === decorator && enable) {\r\n      // Create a texture to use for the particles.\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(\"./sprites/particle_snow.png\");\r\n      const texture = IModelApp.renderSystem.createTexture({\r\n        ownership: \"external\",\r\n        image: { source: image, transparency: TextureTransparency.Mixed },\r\n      });\r\n\r\n      new SnowDecorator(viewport, texture);\r\n    }\r\n  }\r\n}\r\n\r\n/** Toggles a decorator that simulates snow using particle effects.\r\n * @see [[SnowDecorator]] for the implementation of the decorator.\r\n * @beta\r\n */\r\nexport class SnowEffect extends Tool {\r\n  public static override toolId = \"SnowEffect\";\r\n\r\n  public override async run(enable?: boolean): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (vp)\r\n      await SnowDecorator.toggle(vp, enable);\r\n\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...args: string[]): Promise<boolean> {\r\n    const enable = parseToggle(args[0]);\r\n    if (typeof enable !== \"string\")\r\n      await this.run(enable);\r\n\r\n    return true;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Snow.js","sourceRoot":"","sources":["../../../src/effects/Snow.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAA8C;AAC9C,wDAA2E;AAC3E,oDAAwE;AACxE,wDAE8B;AAC9B,sDAAmD;AACnD,qCAAsD;AAkCtD,+EAA+E;AAC/E,MAAM,iBAAiB,GAAe;IACpC,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,uBAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC;IAClC,iBAAiB,EAAE,uBAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC;IAC1C,aAAa,EAAE,IAAI,uBAAO,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC;IAC5C,iBAAiB,EAAE,IAAI,uBAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC;IAClD,YAAY,EAAE,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAa,aAAa;IAexB,YAAoB,QAAkB,EAAE,OAAkC;QAR1E,yCAAyC;QACxB,eAAU,GAAmB,EAAE,CAAC;QAQ/C,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,iBAAiB,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,uBAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClF,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAExB,0GAA0G;QAC1G,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,qBAAqB,EAAE,CAAC,CAAC;QAE7F,mGAAmG;QACnG,MAAM,eAAe,GAAG,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE;YAC1D,0DAA0D;YAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC1B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;YAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,iEAAiE;QACjE,MAAM,eAAe,GAAG,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,MAAM,eAAe,GAAG,yBAAS,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAEjE,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE;YAClB,eAAe,EAAE,CAAC;YAClB,cAAc,EAAE,CAAC;YACjB,eAAe,EAAE,CAAC;YAClB,eAAe,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,GAAG,IAAA,sBAAO,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvC,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC,CAAC;QAEF,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAE9C,4BAA4B;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,EAAE;YAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC;IAEM,QAAQ,CAAC,OAAwB;QACtC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ;YACtD,OAAO;QAET,wBAAwB;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC;QAC3B,IAAI,CAAC,eAAe,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;QAEzC,4BAA4B;QAC5B,MAAM,OAAO,GAAG,yCAAyB,CAAC,MAAM,CAAC;YAC/C,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI;YAClB,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;SACrE,CAAC,CAAC;QAEH,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU;YACpC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAEhC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,OAAO;YACT,OAAO,CAAC,aAAa,CAAC,2BAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,8DAA8D;IACvD,SAAS,CAAC,MAA2B;QAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;YACrC,MAAM,GAAG,GAAI,MAAc,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,SAAS,KAAK,GAAG;gBAClB,IAAI,CAAC,OAAe,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;SACpC;IACH,CAAC;IAED,sDAAsD;IAC9C,IAAI,CAAC,eAAwB;QACnC,OAAO;YACL,CAAC,EAAE,IAAA,sBAAa,EAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YACvC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,IAAA,sBAAa,EAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,CAAC,EAAE,CAAC;YACJ,IAAI,EAAE,IAAA,sBAAa,EAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;YAC5E,YAAY,EAAE,IAAA,sBAAa,EAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC;YACpG,QAAQ,EAAE,IAAI,wBAAQ,CAAC,IAAA,oBAAW,EAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EACrG,IAAA,oBAAW,EAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACpF,CAAC;IACJ,CAAC;IAED,8HAA8H;IACtH,eAAe,CAAC,cAAsB;QAC5C,gEAAgE;QAChE,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAC/E,IAAI,mBAAmB,GAAG,CAAC,EAAE;YAC3B,6CAA6C;YAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,mBAAmB,EAAE,CAAC,EAAE;gBAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;SACzC;aAAM;YACL,2BAA2B;YAC3B,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;SACpD;QAED,MAAM,YAAY,GAAG,IAAI,wBAAQ,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,wBAAQ,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC/C,mDAAmD;YACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACpC,YAAY,CAAC,GAAG,CAAC,IAAA,oBAAW,EAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EACvG,IAAA,oBAAW,EAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAE5F,YAAY,CAAC,KAAK,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;YACjD,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAExD,kBAAkB;YAClB,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClC,QAAQ,CAAC,KAAK,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;YACzC,QAAQ,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;YACzB,QAAQ,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;YAEzB,aAAa;YACb,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,cAAc,CAAC;YAEzD,iGAAiG;YACjG,IAAI,QAAQ,CAAC,CAAC,GAAG,CAAC;gBAChB,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC;iBACjC,IAAI,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;gBACvC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;YAEjB,qGAAqG;YACrG,IAAI,QAAQ,CAAC,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;gBACpD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACzC;IACH,CAAC;IAID;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAkB,EAAE,MAAgB;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,SAAS,KAAK,MAAM;YACtB,MAAM,GAAG,SAAS,KAAK,SAAS,CAAC;QAEnC,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,MAAM;YACpC,SAAS,CAAC,OAAO,EAAE,CAAC;aACjB,IAAI,SAAS,KAAK,SAAS,IAAI,MAAM,EAAE;YAC1C,6CAA6C;YAC7C,yGAAyG;YACzG,MAAM,KAAK,GAAG,MAAM,IAAA,mCAAmB,EAAC,GAAG,yBAAS,CAAC,UAAU,2BAA2B,CAAC,CAAC;YAC5F,MAAM,OAAO,GAAG,yBAAS,CAAC,YAAY,CAAC,aAAa,CAAC;gBACnD,SAAS,EAAE,UAAU;gBACrB,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,iCAAmB,CAAC,KAAK,EAAE;aAClE,CAAC,CAAC;YAEH,IAAI,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;SACtC;IACH,CAAC;;AA3KH,sCA4KC;AAzByB,yBAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;AA2B3E;;;GAGG;AACH,MAAa,UAAW,SAAQ,oBAAI;IAGlB,KAAK,CAAC,GAAG,CAAC,MAAgB;QACxC,MAAM,EAAE,GAAG,yBAAS,CAAC,WAAW,CAAC,YAAY,CAAC;QAC9C,IAAI,EAAE;YACJ,MAAM,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAEzC,OAAO,IAAI,CAAC;IACd,CAAC;IAEe,KAAK,CAAC,WAAW,CAAC,GAAG,IAAc;QACjD,MAAM,MAAM,GAAG,IAAA,yBAAW,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,OAAO,MAAM,KAAK,QAAQ;YAC5B,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEzB,OAAO,IAAI,CAAC;IACd,CAAC;;AAjBH,gCAkBC;AAjBwB,iBAAM,GAAG,YAAY,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 { dispose } from \"@itwin/core-bentley\";\r\nimport { Point2d, Range1d, Range2d, Vector2d } from \"@itwin/core-geometry\";\r\nimport { RenderTexture, TextureTransparency } from \"@itwin/core-common\";\r\nimport {\r\n  DecorateContext, Decorator, GraphicType, imageElementFromUrl, IModelApp, ParticleCollectionBuilder, ParticleProps, Tool, Viewport,\r\n} from \"@itwin/core-frontend\";\r\nimport { parseToggle } from \"../tools/parseToggle\";\r\nimport { randomFloat, randomInteger } from \"./Random\";\r\n\r\n/** Represents one particle displayed by a [[SnowDecorator]].\r\n * Particle positions are in [CoordSystem.View]($frontend).\r\n * @beta\r\n */\r\nexport interface SnowParticle extends ParticleProps {\r\n  /** Make x, y, and z from ParticleProps writable. */\r\n  x: number;\r\n  y: number;\r\n  z: number;\r\n\r\n  /** Current velocity, in pixels per second. */\r\n  velocity: Vector2d;\r\n}\r\n\r\n/** Parameters controlling how a [[SnowDecorator]] works.\r\n * @beta\r\n */\r\nexport interface SnowParams {\r\n  /** The number of snow particles to produce. This could alternatively be expressed as a density so that small viewports would not be more crowded than larger ones. */\r\n  numParticles: number;\r\n  /** Range from which to randomly select each particle's size, in pixels. */\r\n  sizeRange: Range1d;\r\n  /** Range from which to randomly select each particle's transparency. */\r\n  transparencyRange: Range1d;\r\n  /** Range from which to randomly select each particle's initial velocity, in pixels per second. */\r\n  velocityRange: Range2d;\r\n  /** Range from which to randomly select an acceleration to apply to each particle's velocity each frame, in pixels per second squared, to simulate wind. */\r\n  accelerationRange: Range2d;\r\n  /** Wind velocity in pixels per second in X. */\r\n  windVelocity: number;\r\n}\r\n\r\n/** The default snow effect parameters used by newly-created SnowDecorators. */\r\nconst defaultSnowParams: SnowParams = {\r\n  numParticles: 2000,\r\n  sizeRange: Range1d.createXX(3, 22),\r\n  transparencyRange: Range1d.createXX(0, 50),\r\n  velocityRange: new Range2d(-30, 50, 30, 130),\r\n  accelerationRange: new Range2d(-1, -0.25, 1, 0.25),\r\n  windVelocity: 0,\r\n};\r\n\r\n/** Simulates snowfall in a [Viewport]($frontend) using particle effects.\r\n * @see [[SnowEffect]] for a [Tool]($frontend) that toggles this decorator.\r\n * @see [ParticleCollectionBuilder]($frontend) for defining custom particle effects.\r\n * @beta\r\n */\r\nexport class SnowDecorator implements Decorator {\r\n  /** The viewport being decorated. */\r\n  public readonly viewport: Viewport;\r\n  /** Invoked when this decorator is to be destroyed. */\r\n  public readonly dispose: VoidFunction;\r\n  /** The initial width and height of the viewport, from which we randomly select each particle's initial position. */\r\n  private readonly _dimensions: Point2d;\r\n  /** The list of particles being drawn. */\r\n  private readonly _particles: SnowParticle[] = [];\r\n  /** The image to display for each particle. */\r\n  private _texture?: RenderTexture;\r\n  /** The last time `updateParticles()` was invoked, in milliseconds. */\r\n  private _lastUpdateTime: number;\r\n  private readonly _params: SnowParams;\r\n\r\n  private constructor(viewport: Viewport, texture: RenderTexture | undefined) {\r\n    this._params = { ...defaultSnowParams };\r\n    this.viewport = viewport;\r\n    this._dimensions = new Point2d(viewport.viewRect.width, viewport.viewRect.height);\r\n    this._lastUpdateTime = Date.now();\r\n    this._texture = texture;\r\n\r\n    // Tell the viewport to re-render the decorations every frame so that the snow particles animate smoothly.\r\n    const removeOnRender = viewport.onRender.addListener(() => viewport.invalidateDecorations());\r\n\r\n    // When the viewport is resized, replace this decorator with a new one to match the new dimensions.\r\n    const removeOnResized = viewport.onResized.addListener(() => {\r\n      // Transfer ownership of the texture to the new decorator.\r\n      const tex = this._texture;\r\n      this._texture = undefined;\r\n      this.dispose();\r\n      new SnowDecorator(viewport, tex);\r\n    });\r\n\r\n    // When the viewport is destroyed, dispose of this decorator too.\r\n    const removeOnDispose = viewport.onDisposed.addListener(() => this.dispose());\r\n    const removeDecorator = IModelApp.viewManager.addDecorator(this);\r\n\r\n    this.dispose = () => {\r\n      removeDecorator();\r\n      removeOnRender();\r\n      removeOnDispose();\r\n      removeOnResized();\r\n      this._texture = dispose(this._texture);\r\n      SnowDecorator._decorators.delete(viewport);\r\n    };\r\n\r\n    SnowDecorator._decorators.set(viewport, this);\r\n\r\n    // Initialize the particles.\r\n    for (let i = 0; i < this._params.numParticles; i++)\r\n      this._particles.push(this.emit(true));\r\n  }\r\n\r\n  public decorate(context: DecorateContext): void {\r\n    if (context.viewport !== this.viewport || !this._texture)\r\n      return;\r\n\r\n    // Update the particles.\r\n    const now = Date.now();\r\n    const deltaMillis = now - this._lastUpdateTime;\r\n    this._lastUpdateTime = now;\r\n    this.updateParticles(deltaMillis / 1000);\r\n\r\n    // Create particle graphics.\r\n    const builder = ParticleCollectionBuilder.create({\r\n      viewport: this.viewport,\r\n      isViewCoords: true,\r\n      texture: this._texture,\r\n      size: (this._params.sizeRange.high - this._params.sizeRange.low) / 2,\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.ViewOverlay, graphic);\r\n  }\r\n\r\n  /** Change some of the parameters affecting this decorator. */\r\n  public configure(params: Partial<SnowParams>): void {\r\n    for (const key of Object.keys(params)) {\r\n      const val = (params as any)[key];\r\n      if (undefined !== val)\r\n        (this._params as any)[key] = val;\r\n    }\r\n  }\r\n\r\n  /** Emit a new particle with randomized properties. */\r\n  private emit(randomizeHeight: boolean): SnowParticle {\r\n    return {\r\n      x: randomInteger(0, this._dimensions.x),\r\n      y: randomizeHeight ? randomInteger(0, this._dimensions.y) : 0,\r\n      z: 0,\r\n      size: randomInteger(this._params.sizeRange.low, this._params.sizeRange.high),\r\n      transparency: randomInteger(this._params.transparencyRange.low, this._params.transparencyRange.high),\r\n      velocity: new Vector2d(randomFloat(this._params.velocityRange.low.x, this._params.velocityRange.high.x),\r\n        randomFloat(this._params.velocityRange.low.y, this._params.velocityRange.high.y)),\r\n    };\r\n  }\r\n\r\n  // Update the positions and velocities of all the particles based on the amount of time that has passed since the last update.\r\n  private updateParticles(elapsedSeconds: number): void {\r\n    // Determine if someone changed the desired number of particles.\r\n    const particleDiscrepancy = this._params.numParticles - this._particles.length;\r\n    if (particleDiscrepancy > 0) {\r\n      // Birth new particles up to the new maximum.\r\n      for (let i = 0; i < particleDiscrepancy; i++)\r\n        this._particles.push(this.emit(true));\r\n    } else {\r\n      // Destroy extra particles.\r\n      this._particles.length = this._params.numParticles;\r\n    }\r\n\r\n    const acceleration = new Vector2d();\r\n    const velocity = new Vector2d();\r\n    for (let i = 0; i < this._particles.length; i++) {\r\n      // Apply some acceleration to produce random drift.\r\n      const particle = this._particles[i];\r\n      acceleration.set(randomFloat(this._params.accelerationRange.low.x, this._params.accelerationRange.high.x),\r\n        randomFloat(this._params.accelerationRange.low.y, this._params.accelerationRange.high.y));\r\n\r\n      acceleration.scale(elapsedSeconds, acceleration);\r\n      particle.velocity.plus(acceleration, particle.velocity);\r\n\r\n      // Apply velocity.\r\n      particle.velocity.clone(velocity);\r\n      velocity.scale(elapsedSeconds, velocity);\r\n      particle.x += velocity.x;\r\n      particle.y += velocity.y;\r\n\r\n      // Apply wind\r\n      particle.x += this._params.windVelocity * elapsedSeconds;\r\n\r\n      // Particles that travel beyond the viewport's left or right edges wrap around to the other side.\r\n      if (particle.x < 0)\r\n        particle.x = this._dimensions.x - 1;\r\n      else if (particle.x >= this._dimensions.x)\r\n        particle.x = 0;\r\n\r\n      // Particles that travel beyond the viewport's bottom or top edges are replaced by newborn particles.\r\n      if (particle.y < 0 || particle.y >= this._dimensions.y)\r\n        this._particles[i] = this.emit(false);\r\n    }\r\n  }\r\n\r\n  private static readonly _decorators = new Map<Viewport, SnowDecorator>();\r\n\r\n  /** Toggle this decorator for the specified viewport.\r\n   * @param viewport The viewport to which the effect should be applied or removed.\r\n   * @param enable `true` to enable the effect, `false` to disable it, or `undefined` to toggle the current state.\r\n   */\r\n  public static async toggle(viewport: Viewport, enable?: boolean): Promise<void> {\r\n    const decorator = this._decorators.get(viewport);\r\n    if (undefined === enable)\r\n      enable = undefined === decorator;\r\n\r\n    if (undefined !== decorator && !enable)\r\n      decorator.dispose();\r\n    else if (undefined === decorator && enable) {\r\n      // Create a texture to use for the particles.\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_snow.png`);\r\n      const texture = IModelApp.renderSystem.createTexture({\r\n        ownership: \"external\",\r\n        image: { source: image, transparency: TextureTransparency.Mixed },\r\n      });\r\n\r\n      new SnowDecorator(viewport, texture);\r\n    }\r\n  }\r\n}\r\n\r\n/** Toggles a decorator that simulates snow using particle effects.\r\n * @see [[SnowDecorator]] for the implementation of the decorator.\r\n * @beta\r\n */\r\nexport class SnowEffect extends Tool {\r\n  public static override toolId = \"SnowEffect\";\r\n\r\n  public override async run(enable?: boolean): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (vp)\r\n      await SnowDecorator.toggle(vp, enable);\r\n\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...args: string[]): Promise<boolean> {\r\n    const enable = parseToggle(args[0]);\r\n    if (typeof enable !== \"string\")\r\n      await this.run(enable);\r\n\r\n    return true;\r\n  }\r\n}\r\n"]}

package/lib/cjs/frontend-devtools.d.ts

@@ -57,7 +57,7 @@ export * from "./widgets/TileMemoryBreakdown";
 export * from "./widgets/TileStatisticsTracker";
 export * from "./widgets/ToolSettingsTracker";
 /** @docs-package-description
- * The frontend-devtools package contains various tools and widgets for monitoring and debugging the front-end state of an iModel.js application.
+ * The frontend-devtools package contains various tools and widgets for monitoring and debugging the front-end state of an iTwin.js application.
  */
 /**
  * @docs-group-description Widgets

package/lib/cjs/frontend-devtools.js

@@ -73,7 +73,7 @@ __exportStar(require("./widgets/TileMemoryBreakdown"), exports);
 __exportStar(require("./widgets/TileStatisticsTracker"), exports);
 __exportStar(require("./widgets/ToolSettingsTracker"), exports);
 /** @docs-package-description
- * The frontend-devtools package contains various tools and widgets for monitoring and debugging the front-end state of an iModel.js application.
+ * The frontend-devtools package contains various tools and widgets for monitoring and debugging the front-end state of an iTwin.js application.
  */
 /**
  * @docs-group-description Widgets