@itwin/frontend-devtools 3.0.0-dev.78 → 3.0.0-dev.82

package/lib/cjs/widgets/ToolSettingsTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolSettingsTracker.js","sourceRoot":"","sources":["../../../src/widgets/ToolSettingsTracker.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module Widgets\n */\n\nimport { BeDuration } from \"@itwin/core-bentley\";\nimport { IModelApp, ScreenViewport, ToolSettings, Viewport } from \"@itwin/core-frontend\";\nimport { createCheckBox } from \"../ui/CheckBox\";\nimport { createNestedMenu } from \"../ui/NestedMenu\";\nimport { createLabeledNumericInput, createNumericInput } from \"../ui/NumericInput\";\n\n/** Allows the global settings controlling the behavior of viewing tools to be customized.\n * @alpha\n */\nexport class ToolSettingsTracker {\n  private static _expandToolSettings = false;\n\n  public constructor(parent: HTMLElement, _vp: Viewport) {\n    const settingsDiv = document.createElement(\"div\");\n    settingsDiv.style.display = \"block\";\n    settingsDiv.style.textAlign = \"left\";\n\n    createNestedMenu({\n      label: \"Tool Settings\",\n      parent,\n      expand: ToolSettingsTracker._expandToolSettings,\n      handler: (expanded) => ToolSettingsTracker._expandToolSettings = expanded,\n      body: settingsDiv,\n    });\n\n    let div = IModelApp.makeHTMLElement(\"div\", { parent: settingsDiv });\n    createCheckBox({\n      parent: div,\n      name: \"Preserve World Up When Rotating\",\n      id: \"ts_preserveWorldUp\",\n      isChecked: ToolSettings.preserveWorldUp,\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      handler: (_cb) => { ToolSettings.preserveWorldUp = !ToolSettings.preserveWorldUp; IModelApp.toolAdmin.exitViewTool(); },\n    });\n    div.style.textAlign = \"left\";\n\n    // We use a static so the expand/collapse state persists after closing and reopening the drop-down.\n    settingsDiv.style.display = ToolSettingsTracker._expandToolSettings ? \"block\" : \"none\";\n\n    div = IModelApp.makeHTMLElement(\"div\", { parent: settingsDiv });\n    let label = IModelApp.makeHTMLElement(\"label\", { innerText: \"Animation Duration (ms): \", parent: div });\n    label.style.display = \"inline\";\n    label.htmlFor = \"ts_animationTime\";\n    createNumericInput({\n      parent: div,\n      id: \"ts_animationTime\",\n      display: \"inline\",\n      min: 0,\n      step: 1,\n      value: ScreenViewport.animation.time.normal.milliseconds,\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      handler: (value, _input) => { ScreenViewport.animation.time.normal = BeDuration.fromMilliseconds(value); IModelApp.toolAdmin.exitViewTool(); },\n    });\n    div.style.display = \"block\";\n    div.style.textAlign = \"left\";\n\n    div = IModelApp.makeHTMLElement(\"div\", { parent: settingsDiv });\n    label = IModelApp.makeHTMLElement(\"label\", { innerText: \"Pick Radius (inches): \", parent: div });\n    label.style.display = \"inline\";\n    label.htmlFor = \"ts_viewToolPickRadiusInches\";\n    label.innerText = \"Pick Radius (inches): \";\n    createNumericInput({\n      parent: div,\n      id: \"ts_viewToolPickRadiusInches\",\n      display: \"inline\",\n      min: 0,\n      step: 0.01,\n      value: ToolSettings.viewToolPickRadiusInches,\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      handler: (value, _input) => { ToolSettings.viewToolPickRadiusInches = value; IModelApp.toolAdmin.exitViewTool(); },\n      parseAsFloat: true,\n    }, true);\n    div.style.display = \"block\";\n    div.style.textAlign = \"left\";\n\n    div = IModelApp.makeHTMLElement(\"div\", { parent: settingsDiv });\n    createCheckBox({\n      parent: div,\n      name: \"Walk Enforce Z Up\",\n      id: \"ts_walkEnforceZUp\",\n      isChecked: ToolSettings.walkEnforceZUp,\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      handler: (_cb) => { ToolSettings.walkEnforceZUp = !ToolSettings.walkEnforceZUp; IModelApp.toolAdmin.exitViewTool(); },\n    });\n    div.style.display = \"block\";\n    div.style.textAlign = \"left\";\n\n    div = IModelApp.makeHTMLElement(\"div\", { parent: settingsDiv });\n    label = IModelApp.makeHTMLElement(\"label\", { innerText: \"Walk Camera Angle (degrees): \", parent: div });\n    label.style.display = \"inline\";\n    label.htmlFor = \"ts_walkCameraAngle\";\n    createNumericInput({\n      parent: div,\n      id: \"ts_walkCameraAngle\",\n      display: \"inline\",\n      min: 0,\n      step: 0.1,\n      value: ToolSettings.walkCameraAngle.degrees,\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      handler: (value, _input) => { ToolSettings.walkCameraAngle.setDegrees(value); IModelApp.toolAdmin.exitViewTool(); },\n      parseAsFloat: true,\n    }, true);\n    div.style.display = \"block\";\n    div.style.textAlign = \"left\";\n\n    div = IModelApp.makeHTMLElement(\"div\", { parent: settingsDiv });\n    label = IModelApp.makeHTMLElement(\"label\", { innerText: \"Walk Velocity (meters per second): \", parent: div });\n    label.style.display = \"inline\";\n    label.htmlFor = \"ts_walkVelocity\";\n    createNumericInput({\n      parent: div,\n      id: \"ts_walkVelocity\",\n      display: \"inline\",\n      min: 0,\n      step: 0.1,\n      value: ToolSettings.walkVelocity,\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      handler: (value, _input) => { ToolSettings.walkVelocity = value; IModelApp.toolAdmin.exitViewTool(); },\n      parseAsFloat: true,\n    }, true);\n    div.style.display = \"block\";\n    div.style.textAlign = \"left\";\n\n    div = IModelApp.makeHTMLElement(\"div\", { parent: settingsDiv });\n    label = IModelApp.makeHTMLElement(\"label\", { innerText: \"Wheel Zoom Bump Distance (meters): \", parent: div });\n    label.style.display = \"inline\";\n    label.htmlFor = \"ts_wheelZoomBumpDistance\";\n    createNumericInput({\n      parent: div,\n      id: \"ts_wheelZoomBumpDistance\",\n      display: \"inline\",\n      min: 0,\n      step: 0.025,\n      value: ToolSettings.wheelZoomBumpDistance,\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      handler: (value, _input) => { ToolSettings.wheelZoomBumpDistance = value; IModelApp.toolAdmin.exitViewTool(); },\n      parseAsFloat: true,\n    }, true);\n    div.style.display = \"block\";\n    div.style.textAlign = \"left\";\n\n    div = IModelApp.makeHTMLElement(\"div\", { parent: settingsDiv });\n    label = IModelApp.makeHTMLElement(\"label\", { innerText: \"Wheel Zoom Ratio: \", parent: div });\n    label.style.display = \"inline\";\n    label.htmlFor = \"ts_wheelZoomRatio\";\n    createNumericInput({\n      parent: div,\n      id: \"ts_wheelZoomRatio\",\n      display: \"inline\",\n      min: 1.0,\n      step: 0.025,\n      value: ToolSettings.wheelZoomRatio,\n      handler: async (value, _input) => { ToolSettings.wheelZoomRatio = value; return IModelApp.toolAdmin.exitViewTool(); },\n      parseAsFloat: true,\n    }, true);\n    div.style.display = \"block\";\n    div.style.textAlign = \"left\";\n\n    createLabeledNumericInput({\n      id: \"num_inertiaDamping\",\n      parent: settingsDiv,\n      value: ToolSettings.viewingInertia.damping,\n      handler: async (value, _) => { ToolSettings.viewingInertia.damping = value; return IModelApp.toolAdmin.exitViewTool(); },\n      min: 0,\n      max: 1,\n      step: 0.05,\n      parseAsFloat: true,\n      name: \"Inertial damping: \",\n    });\n    createLabeledNumericInput({\n      id: \"num_inertiaDuration\",\n      parent: settingsDiv,\n      value: ToolSettings.viewingInertia.duration.milliseconds / 1000,\n      handler: async (value, _) => { ToolSettings.viewingInertia.duration = BeDuration.fromMilliseconds(value * 1000); return IModelApp.toolAdmin.exitViewTool(); },\n      min: 0,\n      max: 10,\n      step: 0.5,\n      parseAsFloat: true,\n      name: \"Inertial duration (seconds): \",\n    });\n  }\n\n  public dispose(): void { }\n}\n"]}

package/lib/esm/ClipboardUtilities.d.ts

@@ -0,0 +1,9 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+/** Copy the input string to the system clipboard.
+ * Obtained from https://techoverflow.net/2018/03/30/copying-strings-to-the-clipboard-using-pure-javascript/
+ * @beta
+ */
+export declare function copyStringToClipboard(str: string): void;
+//# sourceMappingURL=ClipboardUtilities.d.ts.map

package/lib/esm/ClipboardUtilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipboardUtilities.d.ts","sourceRoot":"","sources":["../../src/ClipboardUtilities.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAUvD"}

package/lib/esm/ClipboardUtilities.js

@@ -0,0 +1,23 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utilities
+ */
+/** Copy the input string to the system clipboard.
+ * Obtained from https://techoverflow.net/2018/03/30/copying-strings-to-the-clipboard-using-pure-javascript/
+ * @beta
+ */
+export function copyStringToClipboard(str) {
+    const el = document.createElement("textarea");
+    el.value = str;
+    el.setAttribute("readonly", "");
+    el.style.position = "absolute";
+    el.style.left = "-9999px";
+    document.body.appendChild(el);
+    el.select();
+    document.execCommand("copy"); // eslint-disable-line deprecation/deprecation
+    document.body.removeChild(el);
+}
+//# sourceMappingURL=ClipboardUtilities.js.map

package/lib/esm/ClipboardUtilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipboardUtilities.js","sourceRoot":"","sources":["../../src/ClipboardUtilities.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC9C,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC;IACf,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAChC,EAAE,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC;IAC/B,EAAE,CAAC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,EAAE,CAAC,MAAM,EAAE,CAAC;IACZ,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,8CAA8C;IAC5E,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Utilities\n */\n\n/** Copy the input string to the system clipboard.\n * Obtained from https://techoverflow.net/2018/03/30/copying-strings-to-the-clipboard-using-pure-javascript/\n * @beta\n */\nexport function copyStringToClipboard(str: string): void {\n  const el = document.createElement(\"textarea\");\n  el.value = str;\n  el.setAttribute(\"readonly\", \"\");\n  el.style.position = \"absolute\";\n  el.style.left = \"-9999px\";\n  document.body.appendChild(el);\n  el.select();\n  document.execCommand(\"copy\"); // eslint-disable-line deprecation/deprecation\n  document.body.removeChild(el);\n}\n"]}

package/lib/esm/FrontEndDevTools.d.ts

@@ -0,0 +1,19 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+/** Entry-point for the package. Before using the package you *must* call [[FrontendDevTools.initialize]].
+ * @beta
+ */
+export declare class FrontendDevTools {
+    private static _initialized;
+    /** Call this before using the package (e.g., before instantiating any of its widgets or attempting to use any of its tools.
+     * To initialize when starting up your app:
+     * ```ts
+     *   IModelApp.startup();
+     *   await FrontendDevTools.initialize();
+     * ```
+     * @beta
+     */
+    static initialize(): Promise<void>;
+}
+//# sourceMappingURL=FrontEndDevTools.d.ts.map

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

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

package/lib/esm/FrontEndDevTools.js

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

package/lib/esm/FrontEndDevTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrontEndDevTools.js","sourceRoot":"","sources":["../../src/FrontEndDevTools.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/I,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,8BAA8B,EAAE,sCAAsC,EAAE,4BAA4B,EAAE,kCAAkC,EAAE,6BAA6B,EAAE,qCAAqC,EAAE,2BAA2B,EAAE,iCAAiC,EAAE,oCAAoC,EAAE,2BAA2B,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACna,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,WAAW,EAAE,eAAe,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,mCAAmC,EAAE,kCAAkC,EAAE,kCAAkC,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACre,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EACL,uBAAuB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,uBAAuB,GACzI,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,2BAA2B,GACjJ,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC9H,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,6BAA6B,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,0BAA0B,EACnI,2BAA2B,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,8BAA8B,EAClJ,wBAAwB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,GACxH,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EACL,6BAA6B,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,oBAAoB,EAC5H,sBAAsB,EAAE,kBAAkB,EAAE,wBAAwB,GACrE,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gCAAgC,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAChJ,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EACL,qBAAqB,EAAE,sBAAsB,EAAE,oCAAoC,EAAE,sBAAsB,EAAE,oBAAoB,EACjI,wBAAwB,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,wBAAwB,GAC9I,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC9H,OAAO,EACL,gBAAgB,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,uBAAuB,EAC/I,wBAAwB,EAAE,wBAAwB,EAAE,uBAAuB,GAC5E,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,+BAA+B,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC/G,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;GAEG;AACH,MAAM,OAAO,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,SAAS,CAAC,YAAY,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG;YACZ,kBAAkB;YAClB,oBAAoB;YACpB,6BAA6B;YAC7B,0BAA0B;YAC1B,2BAA2B;YAC3B,8BAA8B;YAC9B,qBAAqB;YACrB,uBAAuB;YACvB,iBAAiB;YACjB,aAAa;YACb,gBAAgB;YAChB,0BAA0B;YAC1B,uBAAuB;YACvB,wBAAwB;YACxB,gCAAgC;YAChC,eAAe;YACf,mBAAmB;YACnB,gBAAgB;YAChB,2BAA2B;YAC3B,yBAAyB;YACzB,aAAa;YACb,kBAAkB;YAClB,2BAA2B;YAC3B,mBAAmB;YACnB,8BAA8B;YAC9B,mBAAmB;YACnB,YAAY;YACZ,+BAA+B;YAC/B,6BAA6B;YAC7B,4BAA4B;YAC5B,eAAe;YACf,WAAW;YACX,eAAe;YACf,eAAe;YACf,eAAe;YACf,kBAAkB;YAClB,kBAAkB;YAClB,2BAA2B;YAC3B,oBAAoB;YACpB,oBAAoB;YACpB,oBAAoB;YACpB,wBAAwB;YACxB,sBAAsB;YACtB,8BAA8B;YAC9B,gBAAgB;YAChB,gBAAgB;YAChB,uBAAuB;YACvB,qBAAqB;YACrB,uBAAuB;YACvB,uBAAuB;YACvB,+BAA+B;YAC/B,qBAAqB;YACrB,gBAAgB;YAChB,4BAA4B;YAC5B,gBAAgB;YAChB,gBAAgB;YAChB,sBAAsB;YACtB,YAAY;YACZ,sBAAsB;YACtB,gBAAgB;YAChB,sBAAsB;YACtB,uBAAuB;YACvB,cAAc;YACd,aAAa;YACb,eAAe;YACf,mBAAmB;YACnB,UAAU;YACV,+BAA+B;YAC/B,iBAAiB;YACjB,yBAAyB;YACzB,yBAAyB;YACzB,mBAAmB;YACnB,sBAAsB;YACtB,yBAAyB;YACzB,6BAA6B;YAC7B,wBAAwB;YACxB,oBAAoB;YACpB,mCAAmC;YACnC,6BAA6B;YAC7B,uBAAuB;YACvB,gBAAgB;YAChB,+BAA+B;YAC/B,kCAAkC;YAClC,kBAAkB;YAClB,kCAAkC;YAClC,kCAAkC;YAClC,yBAAyB;YACzB,kBAAkB;YAClB,uBAAuB;YACvB,wBAAwB;YACxB,wBAAwB;YACxB,uBAAuB;YACvB,oBAAoB;YACpB,iBAAiB;YACjB,eAAe;YACf,uBAAuB;YACvB,4BAA4B;YAC5B,cAAc;YACd,cAAc;YACd,sBAAsB;YACtB,sBAAsB;YACtB,oBAAoB;YACpB,qBAAqB;YACrB,yBAAyB;YACzB,6BAA6B;YAC7B,+BAA+B;YAC/B,wBAAwB;YACxB,kBAAkB;YAClB,sBAAsB;YACtB,wBAAwB;YACxB,iBAAiB;YACjB,sBAAsB;YACtB,oBAAoB;YACpB,4BAA4B;YAC5B,oCAAoC;YACpC,6BAA6B;YAC7B,qBAAqB;YACrB,wBAAwB;YACxB,oCAAoC;YACpC,2BAA2B;YAC3B,2BAA2B;YAC3B,iCAAiC;YACjC,6BAA6B;YAC7B,qCAAqC;YACrC,sBAAsB;YACtB,4BAA4B;YAC5B,kCAAkC;YAClC,8BAA8B;YAC9B,sCAAsC;YACtC,aAAa;YACb,uBAAuB;SACxB,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,KAAK;YACtB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAE3B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;;AA5Jc,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 { 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"]}

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

@@ -0,0 +1,69 @@
+/** @packageDocumentation
+ * @module Effects
+ */
+import { ScreenSpaceEffectBuilder } from "@itwin/core-frontend";
+import { AddEffectTool } from "./EffectTools";
+/** Adds one of a collection of "convolution kernels" that alter a [Viewport]($frontend)'s image by blending neighboring pixels.
+ * Based on https://webglfundamentals.org/webgl/lessons/webgl-image-processing-continued.html
+ * @beta
+ */
+export declare abstract class ConvolutionEffect extends AddEffectTool {
+    static get minArgs(): number;
+    static get maxArgs(): number;
+    protected abstract get matrix(): number[];
+    protected get textureCoordFromPosition(): boolean;
+    protected get source(): {
+        vertex: string;
+        fragment: string;
+    };
+    protected defineEffect(builder: ScreenSpaceEffectBuilder): void;
+}
+/** Adds a gaussian blur screen-space effect to the selected Viewport.
+ * @beta
+ */
+export declare class GaussianBlurEffect extends ConvolutionEffect {
+    static toolId: string;
+    protected get effectName(): string;
+    protected get matrix(): number[];
+}
+/** Adds a screen-space unsharpen effect to the selected Viewport.
+ * @beta
+ */
+export declare class UnsharpenEffect extends ConvolutionEffect {
+    static toolId: string;
+    protected get effectName(): string;
+    protected get matrix(): number[];
+}
+/** Adds a screen-space emboss effect to the selected Viewport.
+ * @beta
+ */
+export declare class EmbossEffect extends ConvolutionEffect {
+    static toolId: string;
+    protected get effectName(): string;
+    protected get matrix(): number[];
+}
+/** Adds a screen-space sharpen effect to the selected Viewport.
+ * @beta
+ */
+export declare class SharpenEffect extends ConvolutionEffect {
+    static toolId: string;
+    protected get effectName(): string;
+    protected get matrix(): number[];
+}
+/** Adds a screen-space sharpness effect to the selected Viewport.
+ * @beta
+ */
+export declare class SharpnessEffect extends ConvolutionEffect {
+    static toolId: string;
+    protected get effectName(): string;
+    protected get matrix(): number[];
+}
+/** Adds a screen-space edge-detection effect to the selected Viewport.
+ * @beta
+ */
+export declare class EdgeDetectionEffect extends ConvolutionEffect {
+    static toolId: string;
+    protected get effectName(): string;
+    protected get matrix(): number[];
+}
+//# sourceMappingURL=Convolution.d.ts.map

package/lib/esm/effects/Convolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Convolution.d.ts","sourceRoot":"","sources":["../../../src/effects/Convolution.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,wBAAwB,EAA4B,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,8BAAsB,iBAAkB,SAAQ,aAAa;IAC3D,WAA2B,OAAO,WAAgB;IAClD,WAA2B,OAAO,WAAgB;IAElD,SAAS,CAAC,QAAQ,KAAK,MAAM,IAAI,MAAM,EAAE,CAAC;IAE1C,SAAS,KAAK,wBAAwB,YAAmB;IAEzD,SAAS,KAAK,MAAM;;;MAwBnB;IAED,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;CA+BhE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD,OAAuB,MAAM,SAAwB;IACrD,SAAS,KAAK,UAAU,WAAqB;IAC7C,SAAS,KAAK,MAAM,aAMnB;CACF;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,iBAAiB;IACpD,OAAuB,MAAM,SAAqB;IAClD,SAAS,KAAK,UAAU,WAA0B;IAClD,SAAS,KAAK,MAAM,aAMnB;CACF;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,OAAuB,MAAM,SAAkB;IAC/C,SAAS,KAAK,UAAU,WAAuB;IAC/C,SAAS,KAAK,MAAM,aAMnB;CACF;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,iBAAiB;IAClD,OAAuB,MAAM,SAAmB;IAChD,SAAS,KAAK,UAAU,WAAwB;IAChD,SAAS,KAAK,MAAM,aAMnB;CACF;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,iBAAiB;IACpD,OAAuB,MAAM,SAAqB;IAClD,SAAS,KAAK,UAAU,WAA0B;IAClD,SAAS,KAAK,MAAM,aAMnB;CACF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,OAAuB,MAAM,SAAyB;IACtD,SAAS,KAAK,UAAU,WAA2B;IACnD,SAAS,KAAK,MAAM,aAMnB;CACF"}

package/lib/esm/effects/Convolution.js

@@ -0,0 +1,156 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Effects
+ */
+import { UniformType, VaryingType } from "@itwin/core-frontend";
+import { AddEffectTool } from "./EffectTools";
+/** Adds one of a collection of "convolution kernels" that alter a [Viewport]($frontend)'s image by blending neighboring pixels.
+ * Based on https://webglfundamentals.org/webgl/lessons/webgl-image-processing-continued.html
+ * @beta
+ */
+export class ConvolutionEffect extends AddEffectTool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 0; }
+    get textureCoordFromPosition() { return true; }
+    get source() {
+        return {
+            // The vertex shader simply computes the texture coordinate for use in the fragment shader.
+            vertex: `
+        void effectMain(vec4 pos) {
+          v_texCoord = textureCoordFromPosition(pos);
+        }`,
+            // The fragment shader samples the pixel and its neighbors and applies the kernel.
+            fragment: `
+        vec4 effectMain() {
+          vec2 onePixel = vec2(1.0, 1.0) / u_textureSize;
+          vec4 colorSum =
+            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2(-1, -1)) * u_kernel[0] +
+            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 0, -1)) * u_kernel[1] +
+            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 1, -1)) * u_kernel[2] +
+            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2(-1,  0)) * u_kernel[3] +
+            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 0,  0)) * u_kernel[4] +
+            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 1,  0)) * u_kernel[5] +
+            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2(-1,  1)) * u_kernel[6] +
+            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 0,  1)) * u_kernel[7] +
+            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 1,  1)) * u_kernel[8] ;
+          return vec4((colorSum / u_kernelWeight).rgb, 1);
+        }`,
+        };
+    }
+    defineEffect(builder) {
+        // Define the varying for the texture coordinate.
+        builder.addVarying("v_texCoord", VaryingType.Vec2);
+        // Hook up the uniforms.
+        const matrix = this.matrix;
+        builder.addUniform({
+            name: "u_textureSize",
+            type: UniformType.Vec2,
+            bind: (uniform, context) => {
+                const rect = context.viewport.viewRect;
+                uniform.setUniform2fv([rect.width, rect.height]);
+            },
+        });
+        builder.addUniformArray({
+            name: "u_kernel",
+            type: UniformType.Float,
+            length: matrix.length,
+            bind: (uniform) => uniform.setUniform1fv(matrix),
+        });
+        let weight = matrix.reduce((prev, curr) => prev + curr);
+        if (weight <= 0)
+            weight = 1;
+        builder.addUniform({
+            name: "u_kernelWeight",
+            type: UniformType.Float,
+            bind: (uniform) => uniform.setUniform1f(weight),
+        });
+    }
+}
+/** Adds a gaussian blur screen-space effect to the selected Viewport.
+ * @beta
+ */
+export class GaussianBlurEffect extends ConvolutionEffect {
+    get effectName() { return "blur"; }
+    get matrix() {
+        return [
+            0.045, 0.122, 0.045,
+            0.122, 0.332, 0.122,
+            0.045, 0.122, 0.045,
+        ];
+    }
+}
+GaussianBlurEffect.toolId = "GaussianBlurEffect";
+/** Adds a screen-space unsharpen effect to the selected Viewport.
+ * @beta
+ */
+export class UnsharpenEffect extends ConvolutionEffect {
+    get effectName() { return "unsharpen"; }
+    get matrix() {
+        return [
+            -1, -1, -1,
+            -1, 9, -1,
+            -1, -1, -1,
+        ];
+    }
+}
+UnsharpenEffect.toolId = "UnsharpenEffect";
+/** Adds a screen-space emboss effect to the selected Viewport.
+ * @beta
+ */
+export class EmbossEffect extends ConvolutionEffect {
+    get effectName() { return "emboss"; }
+    get matrix() {
+        return [
+            -2, -1, 0,
+            -1, 1, 1,
+            0, 1, 2,
+        ];
+    }
+}
+EmbossEffect.toolId = "EmbossEffect";
+/** Adds a screen-space sharpen effect to the selected Viewport.
+ * @beta
+ */
+export class SharpenEffect extends ConvolutionEffect {
+    get effectName() { return "sharpen"; }
+    get matrix() {
+        return [
+            0, -1, 0,
+            -1, 5, -1,
+            0, -1, 0,
+        ];
+    }
+}
+SharpenEffect.toolId = "SharpenEffect";
+/** Adds a screen-space sharpness effect to the selected Viewport.
+ * @beta
+ */
+export class SharpnessEffect extends ConvolutionEffect {
+    get effectName() { return "sharpness"; }
+    get matrix() {
+        return [
+            0, -1, 0,
+            -1, 5, -1,
+            0, -1, 0,
+        ];
+    }
+}
+SharpnessEffect.toolId = "SharpnessEffect";
+/** Adds a screen-space edge-detection effect to the selected Viewport.
+ * @beta
+ */
+export class EdgeDetectionEffect extends ConvolutionEffect {
+    get effectName() { return "edgedetect"; }
+    get matrix() {
+        return [
+            -5, 0, 0,
+            0, 0, 0,
+            0, 0, 5,
+        ];
+    }
+}
+EdgeDetectionEffect.toolId = "EdgeDetectionEffect";
+//# sourceMappingURL=Convolution.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Convolution.js","sourceRoot":"","sources":["../../../src/effects/Convolution.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Effects\n */\n\nimport { ScreenSpaceEffectBuilder, UniformType, VaryingType } from \"@itwin/core-frontend\";\nimport { AddEffectTool } from \"./EffectTools\";\n\n/** Adds one of a collection of \"convolution kernels\" that alter a [Viewport]($frontend)'s image by blending neighboring pixels.\n * Based on https://webglfundamentals.org/webgl/lessons/webgl-image-processing-continued.html\n * @beta\n */\nexport abstract class ConvolutionEffect extends AddEffectTool {\n  public static override get minArgs() { return 0; }\n  public static override get maxArgs() { return 0; }\n\n  protected abstract get matrix(): number[];\n\n  protected get textureCoordFromPosition() { return true; }\n\n  protected get source() {\n    return {\n      // The vertex shader simply computes the texture coordinate for use in the fragment shader.\n      vertex: `\n        void effectMain(vec4 pos) {\n          v_texCoord = textureCoordFromPosition(pos);\n        }`,\n      // The fragment shader samples the pixel and its neighbors and applies the kernel.\n      fragment: `\n        vec4 effectMain() {\n          vec2 onePixel = vec2(1.0, 1.0) / u_textureSize;\n          vec4 colorSum =\n            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2(-1, -1)) * u_kernel[0] +\n            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 0, -1)) * u_kernel[1] +\n            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 1, -1)) * u_kernel[2] +\n            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2(-1,  0)) * u_kernel[3] +\n            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 0,  0)) * u_kernel[4] +\n            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 1,  0)) * u_kernel[5] +\n            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2(-1,  1)) * u_kernel[6] +\n            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 0,  1)) * u_kernel[7] +\n            TEXTURE(u_diffuse, v_texCoord + onePixel * vec2( 1,  1)) * u_kernel[8] ;\n          return vec4((colorSum / u_kernelWeight).rgb, 1);\n        }`,\n    };\n  }\n\n  protected defineEffect(builder: ScreenSpaceEffectBuilder): void {\n    // Define the varying for the texture coordinate.\n    builder.addVarying(\"v_texCoord\", VaryingType.Vec2);\n\n    // Hook up the uniforms.\n    const matrix = this.matrix;\n    builder.addUniform({\n      name: \"u_textureSize\",\n      type: UniformType.Vec2,\n      bind: (uniform, context) => {\n        const rect = context.viewport.viewRect;\n        uniform.setUniform2fv([rect.width, rect.height]);\n      },\n    });\n    builder.addUniformArray({\n      name: \"u_kernel\",\n      type: UniformType.Float,\n      length: matrix.length,\n      bind: (uniform) => uniform.setUniform1fv(matrix),\n    });\n\n    let weight = matrix.reduce((prev, curr) => prev + curr);\n    if (weight <= 0)\n      weight = 1;\n\n    builder.addUniform({\n      name: \"u_kernelWeight\",\n      type: UniformType.Float,\n      bind: (uniform) => uniform.setUniform1f(weight),\n    });\n  }\n}\n\n/** Adds a gaussian blur screen-space effect to the selected Viewport.\n * @beta\n */\nexport class GaussianBlurEffect extends ConvolutionEffect {\n  public static override toolId = \"GaussianBlurEffect\";\n  protected get effectName() { return \"blur\"; }\n  protected get matrix() {\n    return [\n      0.045, 0.122, 0.045,\n      0.122, 0.332, 0.122,\n      0.045, 0.122, 0.045,\n    ];\n  }\n}\n\n/** Adds a screen-space unsharpen effect to the selected Viewport.\n * @beta\n */\nexport class UnsharpenEffect extends ConvolutionEffect {\n  public static override toolId = \"UnsharpenEffect\";\n  protected get effectName() { return \"unsharpen\"; }\n  protected get matrix() {\n    return [\n      -1, -1, -1,\n      -1, 9, -1,\n      -1, -1, -1,\n    ];\n  }\n}\n\n/** Adds a screen-space emboss effect to the selected Viewport.\n * @beta\n */\nexport class EmbossEffect extends ConvolutionEffect {\n  public static override toolId = \"EmbossEffect\";\n  protected get effectName() { return \"emboss\"; }\n  protected get matrix() {\n    return [\n      -2, -1, 0,\n      -1, 1, 1,\n      0, 1, 2,\n    ];\n  }\n}\n\n/** Adds a screen-space sharpen effect to the selected Viewport.\n * @beta\n */\nexport class SharpenEffect extends ConvolutionEffect {\n  public static override toolId = \"SharpenEffect\";\n  protected get effectName() { return \"sharpen\"; }\n  protected get matrix() {\n    return [\n      0, -1, 0,\n      -1, 5, -1,\n      0, -1, 0,\n    ];\n  }\n}\n\n/** Adds a screen-space sharpness effect to the selected Viewport.\n * @beta\n */\nexport class SharpnessEffect extends ConvolutionEffect {\n  public static override toolId = \"SharpnessEffect\";\n  protected get effectName() { return \"sharpness\"; }\n  protected get matrix() {\n    return [\n      0, -1, 0,\n      -1, 5, -1,\n      0, -1, 0,\n    ];\n  }\n}\n\n/** Adds a screen-space edge-detection effect to the selected Viewport.\n * @beta\n */\nexport class EdgeDetectionEffect extends ConvolutionEffect {\n  public static override toolId = \"EdgeDetectionEffect\";\n  protected get effectName() { return \"edgedetect\"; }\n  protected get matrix() {\n    return [\n      -5, 0, 0,\n      0, 0, 0,\n      0, 0, 5,\n    ];\n  }\n}\n"]}

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

@@ -0,0 +1,34 @@
+/** @packageDocumentation
+ * @module Effects
+ */
+import { ScreenSpaceEffectBuilder, ScreenSpaceEffectSource, Tool } from "@itwin/core-frontend";
+/** Adds a screen-space effect to the selected viewport.
+ * @beta
+ */
+export declare abstract class AddEffectTool extends Tool {
+    private static readonly _registeredEffects;
+    /** Name of effect as used in keyins like `fdt effect add`. Ideally one word. */
+    protected abstract get effectName(): string;
+    /** vertex, fragment, and optional sampleSourcePixel GLSL snippets. */
+    protected abstract get source(): ScreenSpaceEffectSource;
+    /** Whether the fragment shader should include built-in `textureCoordFromPosition` function. */
+    protected abstract get textureCoordFromPosition(): boolean;
+    /** Add uniforms, varyings, etc. */
+    protected abstract defineEffect(builder: ScreenSpaceEffectBuilder): void;
+    run(): Promise<boolean>;
+}
+/** Removes all screen-space effects from the selected viewport.
+ * @beta
+ */
+export declare class ClearEffectsTool extends Tool {
+    static toolId: string;
+    static get minArgs(): number;
+    static get maxArgs(): number;
+    run(): Promise<boolean>;
+}
+/** Requests that any viewport to which the specified effect has been applied redraw its contents.
+ * Used by tools like [[VignetteConfig]] to update the view after the effect parameters are modified.
+ * @beta
+ */
+export declare function refreshViewportsForEffect(effectName: string): void;
+//# sourceMappingURL=EffectTools.d.ts.map

package/lib/esm/effects/EffectTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectTools.d.ts","sourceRoot":"","sources":["../../../src/effects/EffectTools.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EACM,wBAAwB,EAAE,uBAAuB,EAAE,IAAI,EACnE,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,8BAAsB,aAAc,SAAQ,IAAI;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IAE/D,gFAAgF;IAChF,SAAS,CAAC,QAAQ,KAAK,UAAU,IAAI,MAAM,CAAC;IAC5C,sEAAsE;IACtE,SAAS,CAAC,QAAQ,KAAK,MAAM,IAAI,uBAAuB,CAAC;IACzD,+FAA+F;IAC/F,SAAS,CAAC,QAAQ,KAAK,wBAAwB,IAAI,OAAO,CAAC;IAC3D,mCAAmC;IACnC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAElD,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;CAwB9C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,IAAI;IACxC,OAAuB,MAAM,SAAkB;IAC/C,WAA2B,OAAO,WAAgB;IAClD,WAA2B,OAAO,WAAgB;IAE5B,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;CAI9C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CASlE"}