@itwin/frontend-devtools 3.0.0-dev.134 → 3.0.0-dev.139

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.
@@ -248,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).
@@ -280,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.

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

@@ -1 +1 @@
-{"version":3,"file":"FrontEndDevTools.d.ts","sourceRoot":"","sources":["../../src/FrontEndDevTools.ts"],"names":[],"mappings":"AAIA;;GAEG;AA8DH;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAS;IAEpC;;;;;;;OAOG;WACiB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAuJhD"}
+{"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,
@@ -153,7 +154,7 @@ class FrontendDevTools {
             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":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,wDAAiD;AACjD,uDAA+I;AAC/I,uDAAyD;AACzD,mDAAsD;AACtD,mDAAuE;AACvE,6DAAsF;AACtF,qDAA0E;AAC1E,yCAA4C;AAC5C,iDAAoE;AACpE,6DAGiC;AACjC,yDAI+B;AAC/B,yEAAsE;AACtE,6DAA0D;AAC1D,iDAA2F;AAC3F,iEAEmC;AACnC,yEAEuC;AACvC,iEAA8H;AAC9H,mEAAgE;AAChE,uDAI8B;AAC9B,qEAAsE;AACtE,uEAGsC;AACtC,qEAAgJ;AAChJ,2DAAkE;AAClE,iEAGmC;AACnC,yEAAsE;AACtE,iEAA8H;AAC9H,iEAGmC;AACnC,uFAAoF;AACpF,mDAAoF;AACpF,2DAAgE;AAChE,yEAAsE;AACtE,qEAA+G;AAC/G,yEAAgF;AAChF,+EAAsF;AACtF,6DAA6D;AAE7D;;GAEG;AACH,MAAa,gBAAgB;IAG3B;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CAAC,UAAU;QAC5B,IAAI,IAAI,CAAC,YAAY;YACnB,OAAO;QAET,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,MAAM,SAAS,GAAG,kBAAkB,CAAC;QACrC,MAAM,gBAAgB,GAAG,yBAAS,CAAC,YAAY,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG;YACZ,iCAAkB;YAClB,mCAAoB;YACpB,4CAA6B;YAC7B,yCAA0B;YAC1B,0CAA2B;YAC3B,6CAA8B;YAC9B,6CAAqB;YACrB,2CAAuB;YACvB,8BAAiB;YACjB,0BAAa;YACb,gCAAgB;YAChB,0CAA0B;YAC1B,uCAAuB;YACvB,wCAAwB;YACxB,sDAAgC;YAChC,iCAAe;YACf,uCAAmB;YACnB,8BAAgB;YAChB,mDAA2B;YAC3B,iDAAyB;YACzB,yBAAa;YACb,sCAAkB;YAClB,2CAA2B;YAC3B,kCAAmB;YACnB,oDAA8B;YAC9B,iCAAmB;YACnB,0BAAY;YACZ,qDAA+B;YAC/B,qDAA6B;YAC7B,oDAA4B;YAC5B,2BAAe;YACf,2BAAW;YACX,2BAAe;YACf,2BAAe;YACf,+BAAe;YACf,gCAAkB;YAClB,uCAAkB;YAClB,mDAA2B;YAC3B,qCAAoB;YACpB,qCAAoB;YACpB,wCAAoB;YACpB,uCAAwB;YACxB,qCAAsB;YACtB,6CAA8B;YAC9B,+BAAgB;YAChB,+BAAgB;YAChB,sCAAuB;YACvB,oCAAqB;YACrB,6CAAuB;YACvB,2CAAuB;YACvB,qDAA+B;YAC/B,2CAAuB;YACvB,6CAAqB;YACrB,+BAAgB;YAChB,2DAA4B;YAC5B,6BAAgB;YAChB,6BAAgB;YAChB,0CAAsB;YACtB,yBAAY;YACZ,uCAAsB;YACtB,oCAAgB;YAChB,sCAAsB;YACtB,2CAAuB;YACvB,6BAAc;YACd,2BAAa;YACb,6BAAe;YACf,mCAAmB;YACnB,+BAAW;YACX,iCAAa;YACb,iBAAU;YACV,qDAA+B;YAC/B,6BAAiB;YACjB,yCAAyB;YACzB,yCAAyB;YACzB,uCAAmB;YACnB,0CAAsB;YACtB,6CAAyB;YACzB,iDAA6B;YAC7B,yCAAwB;YACxB,wCAAoB;YACpB,mDAAmC;YACnC,iDAA6B;YAC7B,2CAAuB;YACvB,oCAAgB;YAChB,uDAA+B;YAC/B,6DAAkC;YAClC,4CAA4B;YAC5B,oCAAkB;YAClB,kDAAkC;YAClC,kDAAkC;YAClC,yCAAyB;YACzB,sCAAkB;YAClB,2CAAuB;YACvB,4CAAwB;YACxB,4CAAwB;YACxB,2CAAuB;YACvB,gCAAoB;YACpB,gCAAiB;YACjB,6BAAe;YACf,uCAAuB;YACvB,4CAA4B;YAC5B,yBAAc;YACd,yBAAc;YACd,0CAAsB;YACtB,0CAAsB;YACtB,wCAAoB;YACpB,6CAAqB;YACrB,6CAAyB;YACzB,iDAA6B;YAC7B,mDAA+B;YAC/B,4CAAwB;YACxB,yCAAkB;YAClB,6CAAsB;YACtB,+CAAwB;YACxB,wCAAiB;YACjB,6CAAsB;YACtB,2CAAoB;YACpB,mDAA4B;YAC5B,wDAAoC;YACpC,oDAA6B;YAC7B,yCAAqB;YACrB,4CAAwB;YACxB,sDAAoC;YACpC,6CAA2B;YAC3B,6CAA2B;YAC3B,mDAAiC;YACjC,+CAA6B;YAC7B,uDAAqC;YACrC,wCAAsB;YACtB,8CAA4B;YAC5B,oDAAkC;YAClC,gDAA8B;YAC9B,wDAAsC;YACtC,+BAAa;YACb,2CAAuB;SACxB,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,KAAK;YACtB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAE3B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;;AAjKH,4CAkKC;AAjKgB,6BAAY,GAAG,KAAK,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 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, ChangeViewFlagsTool, OverrideSubCategoryTool, QueryScheduleScriptTool, SaveRenderingStyleTool, SkyCubeTool, SkySphereTool, 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      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"]}
+{"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.js

@@ -141,7 +141,7 @@ 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 },

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 } 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(`${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.js

@@ -153,7 +153,7 @@ 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 },

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":"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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(`${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

package/lib/cjs/frontend-devtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-devtools.js","sourceRoot":"","sources":["../../src/frontend-devtools.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;AAE/F,uDAAqC;AACrC,qDAAmC;AAEnC,wDAAsC;AACtC,wDAAsC;AACtC,sDAAoC;AACpC,sDAAoC;AACpC,2DAAyC;AACzC,mDAAiC;AACjC,uDAAqC;AACrC,iDAA+B;AAC/B,qDAAmC;AAEnC,gEAA8C;AAC9C,0DAAwC;AACxC,oDAAkC;AAClC,4DAA0C;AAC1C,gEAA8C;AAC9C,4DAA0C;AAC1C,6DAA2C;AAC3C,uDAAqC;AACrC,8DAA4C;AAC5C,+DAA6C;AAC7C,oDAAkC;AAClC,uDAAqC;AACrC,sDAAoC;AACpC,0DAAwC;AACxC,8DAA4C;AAC5C,yDAAuC;AACvC,4DAA0C;AAC1C,gEAA8C;AAC9C,4DAA0C;AAC1C,4DAA0C;AAC1C,uEAAqD;AACrD,qDAAmC;AACnC,yDAAuC;AACvC,gEAA8C;AAC9C,8DAA4C;AAC5C,gEAA8C;AAC9C,mEAAiD;AACjD,0DAAwC;AACxC,wDAAsC;AAEtC,8CAA4B;AAC5B,gDAA8B;AAC9B,kDAAgC;AAChC,gDAA8B;AAC9B,gDAA8B;AAC9B,kDAAgC;AAChC,oDAAkC;AAClC,gDAA8B;AAC9B,8CAA4B;AAC5B,+CAA6B;AAE7B,6DAA2C;AAC3C,uDAAqC;AACrC,wDAAsC;AACtC,uDAAqC;AACrC,0DAAwC;AACxC,gEAA8C;AAC9C,kEAAgD;AAChD,gEAA8C;AAE9C;;GAEG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG","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\r\nexport * from \"./ClipboardUtilities\";\r\nexport * from \"./FrontEndDevTools\";\r\n\r\nexport * from \"./effects/Convolution\";\r\nexport * from \"./effects/EffectTools\";\r\nexport * from \"./effects/Explosion\";\r\nexport * from \"./effects/FlipImage\";\r\nexport * from \"./effects/LensDistortion\";\r\nexport * from \"./effects/Random\";\r\nexport * from \"./effects/Saturation\";\r\nexport * from \"./effects/Snow\";\r\nexport * from \"./effects/Vignette\";\r\n\r\nexport * from \"./tools/AnimationIntervalTool\";\r\nexport * from \"./tools/ChangeUnitsTool\";\r\nexport * from \"./tools/ClipTools\";\r\nexport * from \"./tools/DisplayStyleTools\";\r\nexport * from \"./tools/EmphasizeElementsTool\";\r\nexport * from \"./tools/FrustumDecoration\";\r\nexport * from \"./tools/InspectElementTool\";\r\nexport * from \"./tools/MapLayerTool\";\r\nexport * from \"./tools/MeasureTileLoadTime\";\r\nexport * from \"./tools/ModelAppearanceTools\";\r\nexport * from \"./tools/parseArgs\";\r\nexport * from \"./tools/parseBoolean\";\r\nexport * from \"./tools/parseToggle\";\r\nexport * from \"./tools/PlanarMaskTools\";\r\nexport * from \"./tools/PlanProjectionTools\";\r\nexport * from \"./tools/ProjectExtents\";\r\nexport * from \"./tools/RealityModelTools\";\r\nexport * from \"./tools/RealityTransitionTool\";\r\nexport * from \"./tools/RenderSystemTools\";\r\nexport * from \"./tools/RenderTargetTools\";\r\nexport * from \"./tools/ReportWebGLCompatibilityTool\";\r\nexport * from \"./tools/SavedViews\";\r\nexport * from \"./tools/SelectionTools\";\r\nexport * from \"./tools/SetGpuMemoryLimitTool\";\r\nexport * from \"./tools/SourceAspectIdTools\";\r\nexport * from \"./tools/TileRequestDecoration\";\r\nexport * from \"./tools/TileTreeBoundsDecoration\";\r\nexport * from \"./tools/ToolTipProvider\";\r\nexport * from \"./tools/ViewportTools\";\r\n\r\nexport * from \"./ui/Button\";\r\nexport * from \"./ui/CheckBox\";\r\nexport * from \"./ui/ColorInput\";\r\nexport * from \"./ui/ComboBox\";\r\nexport * from \"./ui/DataList\";\r\nexport * from \"./ui/NestedMenu\";\r\nexport * from \"./ui/NumericInput\";\r\nexport * from \"./ui/RadioBox\";\r\nexport * from \"./ui/Slider\";\r\nexport * from \"./ui/TextBox\";\r\n\r\nexport * from \"./widgets/DiagnosticsPanel\";\r\nexport * from \"./widgets/FpsTracker\";\r\nexport * from \"./widgets/GpuProfiler\";\r\nexport * from \"./widgets/KeyinField\";\r\nexport * from \"./widgets/MemoryTracker\";\r\nexport * from \"./widgets/TileMemoryBreakdown\";\r\nexport * from \"./widgets/TileStatisticsTracker\";\r\nexport * from \"./widgets/ToolSettingsTracker\";\r\n\r\n/** @docs-package-description\r\n * The frontend-devtools package contains various tools and widgets for monitoring and debugging the front-end state of an iModel.js application.\r\n */\r\n\r\n/**\r\n * @docs-group-description Widgets\r\n * Widgets that wrap some of the package's functionality into embeddable HTML controls.\r\n */\r\n\r\n/**\r\n * @docs-group-description Tools\r\n * Interactive- and immediate-mode [tools]($docs/learning/frontend/Tools.md), most of which can be executed via key-in. All key-ins are documented in the package's README.\r\n */\r\n\r\n/**\r\n * @docs-group-description Controls\r\n * Rudimentary HTML components used to build the widgets.\r\n */\r\n\r\n/**\r\n * @docs-group-description Effects\r\n * Examples of screen-space effects produced by [RenderSystem.createScreenSpaceEffectBuilder]($frontend).\r\n */\r\n\r\n/**\r\n * @docs-group-description Utilities\r\n * Utility functions used throughout the package.\r\n */\r\n"]}
+{"version":3,"file":"frontend-devtools.js","sourceRoot":"","sources":["../../src/frontend-devtools.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;AAE/F,uDAAqC;AACrC,qDAAmC;AAEnC,wDAAsC;AACtC,wDAAsC;AACtC,sDAAoC;AACpC,sDAAoC;AACpC,2DAAyC;AACzC,mDAAiC;AACjC,uDAAqC;AACrC,iDAA+B;AAC/B,qDAAmC;AAEnC,gEAA8C;AAC9C,0DAAwC;AACxC,oDAAkC;AAClC,4DAA0C;AAC1C,gEAA8C;AAC9C,4DAA0C;AAC1C,6DAA2C;AAC3C,uDAAqC;AACrC,8DAA4C;AAC5C,+DAA6C;AAC7C,oDAAkC;AAClC,uDAAqC;AACrC,sDAAoC;AACpC,0DAAwC;AACxC,8DAA4C;AAC5C,yDAAuC;AACvC,4DAA0C;AAC1C,gEAA8C;AAC9C,4DAA0C;AAC1C,4DAA0C;AAC1C,uEAAqD;AACrD,qDAAmC;AACnC,yDAAuC;AACvC,gEAA8C;AAC9C,8DAA4C;AAC5C,gEAA8C;AAC9C,mEAAiD;AACjD,0DAAwC;AACxC,wDAAsC;AAEtC,8CAA4B;AAC5B,gDAA8B;AAC9B,kDAAgC;AAChC,gDAA8B;AAC9B,gDAA8B;AAC9B,kDAAgC;AAChC,oDAAkC;AAClC,gDAA8B;AAC9B,8CAA4B;AAC5B,+CAA6B;AAE7B,6DAA2C;AAC3C,uDAAqC;AACrC,wDAAsC;AACtC,uDAAqC;AACrC,0DAAwC;AACxC,gEAA8C;AAC9C,kEAAgD;AAChD,gEAA8C;AAE9C;;GAEG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG","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\r\nexport * from \"./ClipboardUtilities\";\r\nexport * from \"./FrontEndDevTools\";\r\n\r\nexport * from \"./effects/Convolution\";\r\nexport * from \"./effects/EffectTools\";\r\nexport * from \"./effects/Explosion\";\r\nexport * from \"./effects/FlipImage\";\r\nexport * from \"./effects/LensDistortion\";\r\nexport * from \"./effects/Random\";\r\nexport * from \"./effects/Saturation\";\r\nexport * from \"./effects/Snow\";\r\nexport * from \"./effects/Vignette\";\r\n\r\nexport * from \"./tools/AnimationIntervalTool\";\r\nexport * from \"./tools/ChangeUnitsTool\";\r\nexport * from \"./tools/ClipTools\";\r\nexport * from \"./tools/DisplayStyleTools\";\r\nexport * from \"./tools/EmphasizeElementsTool\";\r\nexport * from \"./tools/FrustumDecoration\";\r\nexport * from \"./tools/InspectElementTool\";\r\nexport * from \"./tools/MapLayerTool\";\r\nexport * from \"./tools/MeasureTileLoadTime\";\r\nexport * from \"./tools/ModelAppearanceTools\";\r\nexport * from \"./tools/parseArgs\";\r\nexport * from \"./tools/parseBoolean\";\r\nexport * from \"./tools/parseToggle\";\r\nexport * from \"./tools/PlanarMaskTools\";\r\nexport * from \"./tools/PlanProjectionTools\";\r\nexport * from \"./tools/ProjectExtents\";\r\nexport * from \"./tools/RealityModelTools\";\r\nexport * from \"./tools/RealityTransitionTool\";\r\nexport * from \"./tools/RenderSystemTools\";\r\nexport * from \"./tools/RenderTargetTools\";\r\nexport * from \"./tools/ReportWebGLCompatibilityTool\";\r\nexport * from \"./tools/SavedViews\";\r\nexport * from \"./tools/SelectionTools\";\r\nexport * from \"./tools/SetGpuMemoryLimitTool\";\r\nexport * from \"./tools/SourceAspectIdTools\";\r\nexport * from \"./tools/TileRequestDecoration\";\r\nexport * from \"./tools/TileTreeBoundsDecoration\";\r\nexport * from \"./tools/ToolTipProvider\";\r\nexport * from \"./tools/ViewportTools\";\r\n\r\nexport * from \"./ui/Button\";\r\nexport * from \"./ui/CheckBox\";\r\nexport * from \"./ui/ColorInput\";\r\nexport * from \"./ui/ComboBox\";\r\nexport * from \"./ui/DataList\";\r\nexport * from \"./ui/NestedMenu\";\r\nexport * from \"./ui/NumericInput\";\r\nexport * from \"./ui/RadioBox\";\r\nexport * from \"./ui/Slider\";\r\nexport * from \"./ui/TextBox\";\r\n\r\nexport * from \"./widgets/DiagnosticsPanel\";\r\nexport * from \"./widgets/FpsTracker\";\r\nexport * from \"./widgets/GpuProfiler\";\r\nexport * from \"./widgets/KeyinField\";\r\nexport * from \"./widgets/MemoryTracker\";\r\nexport * from \"./widgets/TileMemoryBreakdown\";\r\nexport * from \"./widgets/TileStatisticsTracker\";\r\nexport * from \"./widgets/ToolSettingsTracker\";\r\n\r\n/** @docs-package-description\r\n * The frontend-devtools package contains various tools and widgets for monitoring and debugging the front-end state of an iTwin.js application.\r\n */\r\n\r\n/**\r\n * @docs-group-description Widgets\r\n * Widgets that wrap some of the package's functionality into embeddable HTML controls.\r\n */\r\n\r\n/**\r\n * @docs-group-description Tools\r\n * Interactive- and immediate-mode [tools]($docs/learning/frontend/Tools.md), most of which can be executed via key-in. All key-ins are documented in the package's README.\r\n */\r\n\r\n/**\r\n * @docs-group-description Controls\r\n * Rudimentary HTML components used to build the widgets.\r\n */\r\n\r\n/**\r\n * @docs-group-description Effects\r\n * Examples of screen-space effects produced by [RenderSystem.createScreenSpaceEffectBuilder]($frontend).\r\n */\r\n\r\n/**\r\n * @docs-group-description Utilities\r\n * Utility functions used throughout the package.\r\n */\r\n"]}

package/lib/cjs/tools/DisplayStyleTools.d.ts

@@ -68,7 +68,7 @@ export declare class SkyCubeTool extends DisplayStyleTool {
  *  * `project`: include iTwin-specific (formerly known as project) settings.
  *  * `map`: include background map settings.
  *  * `drawingaids`: include drawing aid decoration settings.
- *  * `copy`: copy result to system clipboarad.
+ *  * `copy`: copy result to system clipboard.
  *  * `quote`: format the JSON so it can be parsed directly by [ApplyRenderingStyleTool].
  * @beta
  */
@@ -132,4 +132,27 @@ export declare class WoWIgnoreBackgroundTool extends DisplayStyleTool {
     parse(args: string[]): Promise<boolean>;
     execute(vp: Viewport): Promise<boolean>;
 }
+/** Toggle whether surfaces display with overlaid wiremesh in the active viewport.
+ * @see [ViewFlags.wiremesh]($common).
+ * @beta
+ */
+export declare class ToggleWiremeshTool extends DisplayStyleTool {
+    private _enable?;
+    static toolId: string;
+    static get minArgs(): number;
+    static get maxArgs(): number;
+    parse(args: string[]): Promise<boolean>;
+    execute(vp: Viewport): Promise<boolean>;
+}
+/** Change the background color of the active viewport and optionally its transparency.
+ * @beta
+ */
+export declare class ChangeBackgroundColorTool extends DisplayStyleTool {
+    private _color?;
+    static toolId: string;
+    static get minArgs(): number;
+    static get maxArgs(): number;
+    parse(args: string[]): Promise<boolean>;
+    execute(vp: Viewport): Promise<boolean>;
+}
 //# sourceMappingURL=DisplayStyleTools.d.ts.map

package/lib/cjs/tools/DisplayStyleTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayStyleTools.d.ts","sourceRoot":"","sources":["../../../src/tools/DisplayStyleTools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DisplayStyleTools.d.ts","sourceRoot":"","sources":["../../../src/tools/DisplayStyleTools.ts"],"names":[],"mappings":"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"}

package/lib/cjs/tools/DisplayStyleTools.js

@@ -4,7 +4,7 @@
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WoWIgnoreBackgroundTool = exports.QueryScheduleScriptTool = exports.OverrideSubCategoryTool = exports.ApplyRenderingStyleTool = exports.SaveRenderingStyleTool = exports.SkyCubeTool = exports.SkySphereTool = exports.ToggleSkyboxTool = exports.ChangeViewFlagsTool = exports.DisplayStyleTool = void 0;
+exports.ChangeBackgroundColorTool = exports.ToggleWiremeshTool = exports.WoWIgnoreBackgroundTool = exports.QueryScheduleScriptTool = exports.OverrideSubCategoryTool = exports.ApplyRenderingStyleTool = exports.SaveRenderingStyleTool = exports.SkyCubeTool = exports.SkySphereTool = exports.ToggleSkyboxTool = exports.ChangeViewFlagsTool = exports.DisplayStyleTool = void 0;
 /** @packageDocumentation
  * @module Tools
  */
@@ -18,6 +18,7 @@ const parseToggle_1 = require("./parseToggle");
 const booleanFlagNames = [
     "dimensions", "patterns", "weights", "styles", "transparency", "fill", "textures", "materials", "acsTriad", "grid", "visibleEdges",
     "hiddenEdges", "lighting", "shadows", "clipVolume", "constructions", "monochrome", "backgroundMap", "ambientOcclusion", "forceSurfaceDiscard",
+    "wiremesh",
 ];
 const lowercaseBooleanFlagNames = booleanFlagNames.map((name) => name.toLowerCase());
 /** Modifies the selected viewport's DisplayStyleState.
@@ -206,7 +207,7 @@ SkyCubeTool.toolId = "SetSkyCube";
  *  * `project`: include iTwin-specific (formerly known as project) settings.
  *  * `map`: include background map settings.
  *  * `drawingaids`: include drawing aid decoration settings.
- *  * `copy`: copy result to system clipboarad.
+ *  * `copy`: copy result to system clipboard.
  *  * `quote`: format the JSON so it can be parsed directly by [ApplyRenderingStyleTool].
  * @beta
  */
@@ -401,4 +402,45 @@ class WoWIgnoreBackgroundTool extends DisplayStyleTool {
 }
 exports.WoWIgnoreBackgroundTool = WoWIgnoreBackgroundTool;
 WoWIgnoreBackgroundTool.toolId = "WoWIgnoreBackground";
+/** Toggle whether surfaces display with overlaid wiremesh in the active viewport.
+ * @see [ViewFlags.wiremesh]($common).
+ * @beta
+ */
+class ToggleWiremeshTool extends DisplayStyleTool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 1; }
+    async parse(args) {
+        const enable = (0, parseToggle_1.parseToggle)(args[0]);
+        if (typeof enable === "string")
+            return false;
+        this._enable = enable;
+        return true;
+    }
+    async execute(vp) {
+        var _a;
+        vp.viewFlags = vp.viewFlags.with("wiremesh", (_a = this._enable) !== null && _a !== void 0 ? _a : !vp.viewFlags.wiremesh);
+        return true;
+    }
+}
+exports.ToggleWiremeshTool = ToggleWiremeshTool;
+ToggleWiremeshTool.toolId = "ToggleWiremesh";
+/** Change the background color of the active viewport and optionally its transparency.
+ * @beta
+ */
+class ChangeBackgroundColorTool extends DisplayStyleTool {
+    static get minArgs() { return 1; }
+    static get maxArgs() { return 1; }
+    async parse(args) {
+        this._color = core_common_1.ColorDef.fromString(args[0]);
+        return true;
+    }
+    async execute(vp) {
+        if (!this._color)
+            return false;
+        vp.displayStyle.backgroundColor = this._color;
+        return true;
+    }
+}
+exports.ChangeBackgroundColorTool = ChangeBackgroundColorTool;
+ChangeBackgroundColorTool.toolId = "ChangeBackgroundColor";
 //# sourceMappingURL=DisplayStyleTools.js.map