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

package/lib/esm/tools/ViewportTools.js

@@ -0,0 +1,429 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Tools
+ */
+import { BeDuration } from "@itwin/core-bentley";
+import { ColorDef, Hilite } from "@itwin/core-common";
+import { DrawingViewState, FlashMode, FlashSettings, IModelApp, TileBoundingBoxes, Tool, } from "@itwin/core-frontend";
+import { parseArgs } from "./parseArgs";
+import { parseToggle } from "./parseToggle";
+/** Base class for a tool that toggles some aspect of a Viewport.
+ * @beta
+ */
+export class ViewportToggleTool extends Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 1; }
+    async run(enable) {
+        const vp = IModelApp.viewManager.selectedView;
+        if (undefined !== vp)
+            await this.toggle(vp, enable);
+        return true;
+    }
+    async parseAndRun(...args) {
+        const enable = parseToggle(args[0]);
+        if (typeof enable !== "string")
+            await this.run(enable);
+        return true;
+    }
+}
+/** Freeze or unfreeze the scene for the selected viewport. While the scene is frozen, no new tiles will be selected for drawing within the viewport.
+ * @beta
+ */
+export class FreezeSceneTool extends ViewportToggleTool {
+    async toggle(vp, enable) {
+        if (undefined === enable || enable !== vp.freezeScene)
+            vp.freezeScene = !vp.freezeScene;
+        return Promise.resolve();
+    }
+}
+FreezeSceneTool.toolId = "FreezeScene";
+const boundingVolumeNames = [
+    "none",
+    "volume",
+    "content",
+    "both",
+    "children",
+    "sphere",
+];
+/** Set the tile bounding volume decorations to display in the selected viewport.
+ * Omitting the argument turns on Volume bounding boxes if bounding boxes are currently off; otherwise, toggles them off.
+ * Allowed inputs are "none", "volume", "content", "both" (volume and content), "children", and "sphere".
+ * @beta
+ */
+export class ShowTileVolumesTool extends Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 1; }
+    async run(boxes) {
+        const vp = IModelApp.viewManager.selectedView;
+        if (undefined === vp)
+            return true;
+        if (undefined === boxes)
+            boxes = TileBoundingBoxes.None === vp.debugBoundingBoxes ? TileBoundingBoxes.Volume : TileBoundingBoxes.None;
+        vp.debugBoundingBoxes = boxes;
+        return true;
+    }
+    async parseAndRun(...args) {
+        let boxes;
+        if (0 !== args.length) {
+            const arg = args[0].toLowerCase();
+            for (let i = 0; i < boundingVolumeNames.length; i++) {
+                if (arg === boundingVolumeNames[i]) {
+                    boxes = i;
+                    break;
+                }
+            }
+            if (undefined === boxes)
+                return true;
+        }
+        return this.run(boxes);
+    }
+}
+ShowTileVolumesTool.toolId = "ShowTileVolumes";
+/** This tool sets the aspect ratio skew for the selected viewport.
+ * @beta
+ */
+export class SetAspectRatioSkewTool extends Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 1; }
+    /** This method runs the tool, setting the aspect ratio skew for the selected viewport.
+     * @param skew the aspect ratio (x/y) skew value; 1.0 or undefined removes any skew
+     */
+    async run(skew) {
+        if (undefined === skew)
+            skew = 1.0;
+        const vp = IModelApp.viewManager.selectedView;
+        if (undefined !== vp) {
+            vp.view.setAspectRatioSkew(skew);
+            vp.synchWithView();
+        }
+        return true;
+    }
+    /** Executes this tool's run method.
+     * @param args the first entry of this array contains the `skew` argument
+     * @see [[run]]
+     */
+    async parseAndRun(...args) {
+        const skew = args.length > 0 ? parseFloat(args[0]) : 1.0;
+        return !Number.isNaN(skew) && this.run(skew);
+    }
+}
+SetAspectRatioSkewTool.toolId = "SetAspectRatioSkew";
+/** Changes the selected viewport's hilite or emphasis settings.
+ * @beta
+ */
+export class ChangeHiliteTool extends Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 6; }
+    async run(settings) {
+        const vp = IModelApp.viewManager.selectedView;
+        if (undefined !== vp)
+            this.apply(vp, settings);
+        return true;
+    }
+    async parseAndRun(...inputArgs) {
+        if (0 === inputArgs.length)
+            return this.run();
+        const vp = IModelApp.viewManager.selectedView;
+        if (undefined === vp)
+            return true;
+        const cur = this.getCurrentSettings(vp);
+        const colors = cur.color.colors;
+        let visible = cur.visibleRatio;
+        let hidden = cur.hiddenRatio;
+        let silhouette = cur.silhouette;
+        const args = parseArgs(inputArgs);
+        const parseColorComponent = (c) => {
+            const num = args.getInteger(c);
+            if (undefined !== num)
+                colors[c] = Math.floor(Math.max(0, Math.min(255, num)));
+        };
+        parseColorComponent("r");
+        parseColorComponent("g");
+        parseColorComponent("b");
+        const silhouetteArg = args.getInteger("s");
+        if (undefined !== silhouetteArg && silhouetteArg >= Hilite.Silhouette.None && silhouetteArg <= Hilite.Silhouette.Thick)
+            silhouette = silhouetteArg;
+        const v = args.getFloat("v");
+        if (undefined !== v && v >= 0 && v <= 1)
+            visible = v;
+        const h = args.getFloat("h");
+        if (undefined !== h && h >= 0 && h <= 1)
+            hidden = h;
+        if (undefined === silhouette)
+            silhouette = cur.silhouette;
+        if (undefined === visible)
+            visible = cur.visibleRatio;
+        if (undefined === hidden)
+            hidden = cur.hiddenRatio;
+        const settings = {
+            color: ColorDef.from(colors.r, colors.g, colors.b),
+            silhouette,
+            visibleRatio: visible,
+            hiddenRatio: hidden,
+        };
+        return this.run(settings);
+    }
+}
+/** Changes the selected viewport's hilite settings, or resets to defaults.
+ * @beta
+ */
+export class ChangeHiliteSettingsTool extends ChangeHiliteTool {
+    getCurrentSettings(vp) { return vp.hilite; }
+    apply(vp, settings) {
+        vp.hilite = undefined !== settings ? settings : new Hilite.Settings();
+    }
+}
+ChangeHiliteSettingsTool.toolId = "ChangeHiliteSettings";
+/** Changes the selected viewport's emphasis settings.
+ * @beta
+ */
+export class ChangeEmphasisSettingsTool extends ChangeHiliteTool {
+    getCurrentSettings(vp) { return vp.emphasisSettings; }
+    apply(vp, settings) {
+        if (undefined !== settings)
+            vp.emphasisSettings = settings;
+    }
+}
+ChangeEmphasisSettingsTool.toolId = "ChangeEmphasisSettings";
+/** Changes the [FlashSettings]($frontend) for the selected [Viewport]($frontend).
+ * @beta
+ */
+export class ChangeFlashSettingsTool extends Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 3; }
+    async run(settings) {
+        const vp = IModelApp.viewManager.selectedView;
+        if (vp)
+            vp.flashSettings = settings !== null && settings !== void 0 ? settings : new FlashSettings();
+        return true;
+    }
+    async parseAndRun(...inputArgs) {
+        const vp = IModelApp.viewManager.selectedView;
+        if (!vp)
+            return true;
+        if (1 === inputArgs.length && "default" === inputArgs[0].toLowerCase())
+            return this.run();
+        const options = {};
+        const args = parseArgs(inputArgs);
+        const intensity = args.getFloat("i");
+        if (undefined !== intensity)
+            options.maxIntensity = intensity;
+        const mode = args.get("m");
+        if (mode) {
+            switch (mode[0].toLowerCase()) {
+                case "b":
+                    options.litMode = FlashMode.Brighten;
+                    break;
+                case "h":
+                    options.litMode = FlashMode.Hilite;
+                    break;
+                default:
+                    return false;
+            }
+        }
+        const duration = args.getFloat("d");
+        if (undefined !== duration)
+            options.duration = BeDuration.fromSeconds(duration);
+        return this.run(vp.flashSettings.clone(options));
+    }
+}
+ChangeFlashSettingsTool.toolId = "ChangeFlashSettings";
+/** Enables or disables fade-out transparency mode for the selected viewport.
+ * @beta
+ */
+export class FadeOutTool extends ViewportToggleTool {
+    async toggle(vp, enable) {
+        if (undefined === enable || enable !== vp.isFadeOutActive)
+            vp.isFadeOutActive = !vp.isFadeOutActive;
+        return Promise.resolve();
+    }
+}
+FadeOutTool.toolId = "FadeOut";
+/** Sets the default tile size modifier used for all viewports that don't explicitly override it.
+ * @beta
+ */
+export class DefaultTileSizeModifierTool extends Tool {
+    static get minArgs() { return 1; }
+    static get maxArgs() { return 1; }
+    /** This method runs the tool, setting the default tile size modifier used for all viewports that don't explicitly override it.
+     * @param modifier the tile size modifier to use; if undefined, do not set modifier
+     */
+    async run(modifier) {
+        if (undefined !== modifier)
+            IModelApp.tileAdmin.defaultTileSizeModifier = modifier;
+        return true;
+    }
+    /** Executes this tool's run method with args[0] containing `modifier`.
+     * @see [[run]]
+     */
+    async parseAndRun(...args) {
+        return this.run(Number.parseFloat(args[0]));
+    }
+}
+DefaultTileSizeModifierTool.toolId = "DefaultTileSizeMod";
+/** Sets or clears the tile size modifier override for the selected viewport.
+ * @beta
+ */
+export class ViewportTileSizeModifierTool extends Tool {
+    static get minArgs() { return 1; }
+    static get maxArgs() { return 1; }
+    /** This method runs the tool, setting the tile size modifier used for the selected viewport.
+     * @param modifier the tile size modifier to use; if undefined, reset the modifier
+     */
+    async run(modifier) {
+        const vp = IModelApp.viewManager.selectedView;
+        if (undefined !== vp)
+            vp.setTileSizeModifier(modifier);
+        return true;
+    }
+    /** Executes this tool's run method with args[0] containing the `modifier` argument or the string "reset" in order to reset the modifier.
+     * @see [[run]]
+     */
+    async parseAndRun(...args) {
+        const arg = args[0].toLowerCase();
+        const modifier = "reset" === arg ? undefined : Number.parseFloat(args[0]);
+        return this.run(modifier);
+    }
+}
+ViewportTileSizeModifierTool.toolId = "ViewportTileSizeMod";
+/** This tool adds a reality model to the viewport.
+ * @beta
+ */
+export class ViewportAddRealityModel extends Tool {
+    static get minArgs() { return 1; }
+    static get maxArgs() { return 1; }
+    /** This method runs the tool, adding a reality model to the viewport
+     * @param url the URL which points to the reality model tileset
+     */
+    async run(url) {
+        const vp = IModelApp.viewManager.selectedView;
+        if (undefined !== vp)
+            vp.displayStyle.attachRealityModel({ tilesetUrl: url });
+        return true;
+    }
+    /** Executes this tool's run method with args[0] containing the `url` argument.
+     * @see [[run]]
+     */
+    async parseAndRun(...args) {
+        return this.run(args[0]);
+    }
+}
+ViewportAddRealityModel.toolId = "ViewportAddRealityModel";
+/** Changes the `allow3dManipulations` flag for the selected viewport if the viewport is displaying a `ViewState3d`.
+ * @beta
+ */
+export class Toggle3dManipulationsTool extends ViewportToggleTool {
+    async toggle(vp, allow) {
+        if (!vp.view.is3d())
+            return Promise.resolve();
+        if (undefined === allow)
+            allow = !vp.view.allow3dManipulations();
+        if (allow !== vp.view.allow3dManipulations()) {
+            vp.view.setAllow3dManipulations(allow);
+            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+            IModelApp.toolAdmin.startDefaultTool();
+        }
+        return Promise.resolve();
+    }
+}
+Toggle3dManipulationsTool.toolId = "Toggle3dManipulations";
+/** Toggles display of view attachments in sheet views.
+ * @beta
+ */
+export class ToggleViewAttachmentsTool extends ViewportToggleTool {
+    async toggle(vp, enable) {
+        if (undefined === enable || enable !== vp.wantViewAttachments)
+            vp.wantViewAttachments = !vp.wantViewAttachments;
+        return Promise.resolve();
+    }
+}
+ToggleViewAttachmentsTool.toolId = "ToggleViewAttachments";
+/** Toggle display of view attachment boundaries in sheet views.
+ * @beta
+ */
+export class ToggleViewAttachmentBoundariesTool extends ViewportToggleTool {
+    async toggle(vp, enable) {
+        if (undefined === enable || enable !== vp.wantViewAttachmentBoundaries)
+            vp.wantViewAttachmentBoundaries = !vp.wantViewAttachmentBoundaries;
+        return Promise.resolve();
+    }
+}
+ToggleViewAttachmentBoundariesTool.toolId = "ToggleViewAttachmentBoundaries";
+/** Toggle display of view attachment clip shapes in sheet views.
+ * @beta
+ */
+export class ToggleViewAttachmentClipShapesTool extends ViewportToggleTool {
+    async toggle(vp, enable) {
+        if (undefined === enable || enable !== vp.wantViewAttachmentClipShapes)
+            vp.wantViewAttachmentClipShapes = !vp.wantViewAttachmentClipShapes;
+        return Promise.resolve();
+    }
+}
+ToggleViewAttachmentClipShapesTool.toolId = "ToggleViewAttachmentClipShapes";
+/** Toggles display of 2d graphics in a [DrawingViewState]($frontend). This setting affects all drawing views until it is reset.
+ * @beta
+ */
+export class ToggleDrawingGraphicsTool extends ViewportToggleTool {
+    async toggle(vp, enable) {
+        if (undefined === enable || enable !== DrawingViewState.hideDrawingGraphics) {
+            DrawingViewState.hideDrawingGraphics = !DrawingViewState.hideDrawingGraphics;
+            vp.invalidateScene();
+        }
+        return Promise.resolve();
+    }
+}
+ToggleDrawingGraphicsTool.toolId = "ToggleDrawingGraphics";
+/** Toggles whether a [SectionDrawing]($backend)'s spatial view is always displayed along with the 2d graphics by a [DrawingViewState]($frontend), even
+ * if it otherwise would not be. This setting affects all section drawing views until it is reset.
+ * @beta
+ */
+export class ToggleSectionDrawingSpatialViewTool extends ViewportToggleTool {
+    async toggle(vp, enable) {
+        if (undefined === enable || enable !== DrawingViewState.alwaysDisplaySpatialView) {
+            DrawingViewState.alwaysDisplaySpatialView = !DrawingViewState.alwaysDisplaySpatialView;
+            if (vp.view instanceof DrawingViewState) {
+                // Force the view to update its section drawing attachment.
+                const view = vp.view.clone();
+                await view.changeViewedModel(view.baseModelId);
+                await view.load();
+                vp.changeView(view);
+            }
+        }
+    }
+}
+ToggleSectionDrawingSpatialViewTool.toolId = "ToggleSectionDrawingSpatialView";
+/** Change the camera settings of the selected viewport.
+ * @beta
+ */
+export class ChangeCameraTool extends Tool {
+    static get minArgs() { return 1; }
+    static get maxArgs() { return 2; }
+    async run(camera) {
+        const vp = IModelApp.viewManager.selectedView;
+        if (camera && vp && vp.view.is3d()) {
+            const view = vp.view.clone();
+            view.camera.setFrom(camera);
+            vp.changeView(view);
+        }
+        return true;
+    }
+    async parseAndRun(...inArgs) {
+        const vp = IModelApp.viewManager.selectedView;
+        if (!vp || !vp.view.is3d())
+            return false;
+        const camera = vp.view.camera.clone();
+        const args = parseArgs(inArgs);
+        const lens = args.getFloat("l");
+        if (undefined !== lens)
+            camera.lens.setDegrees(lens);
+        const focusDist = args.getFloat("d");
+        if (undefined !== focusDist)
+            camera.focusDist = focusDist;
+        return this.run(camera);
+    }
+}
+ChangeCameraTool.toolId = "ChangeCamera";
+//# sourceMappingURL=ViewportTools.js.map

package/lib/esm/tools/ViewportTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewportTools.js","sourceRoot":"","sources":["../../../src/tools/ViewportTools.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\r\n/** @packageDocumentation\r\n * @module Tools\r\n */\r\n\r\nimport { BeDuration } from \"@itwin/core-bentley\";\r\nimport { Camera, ColorDef, Hilite } from \"@itwin/core-common\";\r\nimport {\r\n  DrawingViewState, FlashMode, FlashSettings, FlashSettingsOptions, IModelApp, TileBoundingBoxes, Tool, Viewport,\r\n} from \"@itwin/core-frontend\";\r\nimport { parseArgs } from \"./parseArgs\";\r\nimport { parseToggle } from \"./parseToggle\";\r\n\r\n/** Base class for a tool that toggles some aspect of a Viewport.\r\n * @beta\r\n */\r\nexport abstract class ViewportToggleTool extends Tool {\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 1; }\r\n\r\n  protected abstract toggle(vp: Viewport, enable?: boolean): Promise<void>;\r\n\r\n  public override async run(enable?: boolean): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (undefined !== vp)\r\n      await this.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\r\n/** Freeze or unfreeze the scene for the selected viewport. While the scene is frozen, no new tiles will be selected for drawing within the viewport.\r\n * @beta\r\n */\r\nexport class FreezeSceneTool extends ViewportToggleTool {\r\n  public static override toolId = \"FreezeScene\";\r\n\r\n  protected override async toggle(vp: Viewport, enable?: boolean) {\r\n    if (undefined === enable || enable !== vp.freezeScene)\r\n      vp.freezeScene = !vp.freezeScene;\r\n\r\n    return Promise.resolve();\r\n  }\r\n}\r\n\r\nconst boundingVolumeNames = [\r\n  \"none\",\r\n  \"volume\",\r\n  \"content\",\r\n  \"both\",\r\n  \"children\",\r\n  \"sphere\",\r\n];\r\n\r\n/** Set the tile bounding volume decorations to display in the selected viewport.\r\n * Omitting the argument turns on Volume bounding boxes if bounding boxes are currently off; otherwise, toggles them off.\r\n * Allowed inputs are \"none\", \"volume\", \"content\", \"both\" (volume and content), \"children\", and \"sphere\".\r\n * @beta\r\n */\r\nexport class ShowTileVolumesTool extends Tool {\r\n  public static override toolId = \"ShowTileVolumes\";\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 1; }\r\n\r\n  public override async run(boxes?: TileBoundingBoxes): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (undefined === vp)\r\n      return true;\r\n\r\n    if (undefined === boxes)\r\n      boxes = TileBoundingBoxes.None === vp.debugBoundingBoxes ? TileBoundingBoxes.Volume : TileBoundingBoxes.None;\r\n\r\n    vp.debugBoundingBoxes = boxes;\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...args: string[]): Promise<boolean> {\r\n    let boxes: TileBoundingBoxes | undefined;\r\n    if (0 !== args.length) {\r\n      const arg = args[0].toLowerCase();\r\n      for (let i = 0; i < boundingVolumeNames.length; i++) {\r\n        if (arg === boundingVolumeNames[i]) {\r\n          boxes = i;\r\n          break;\r\n        }\r\n      }\r\n\r\n      if (undefined === boxes)\r\n        return true;\r\n    }\r\n\r\n    return this.run(boxes);\r\n  }\r\n}\r\n\r\n/** This tool sets the aspect ratio skew for the selected viewport.\r\n * @beta\r\n */\r\nexport class SetAspectRatioSkewTool extends Tool {\r\n  public static override toolId = \"SetAspectRatioSkew\";\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 1; }\r\n\r\n  /** This method runs the tool, setting the aspect ratio skew for the selected viewport.\r\n   * @param skew the aspect ratio (x/y) skew value; 1.0 or undefined removes any skew\r\n   */\r\n  public override async run(skew?: number): Promise<boolean> {\r\n    if (undefined === skew)\r\n      skew = 1.0;\r\n\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (undefined !== vp) {\r\n      vp.view.setAspectRatioSkew(skew);\r\n      vp.synchWithView();\r\n    }\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Executes this tool's run method.\r\n   * @param args the first entry of this array contains the `skew` argument\r\n   * @see [[run]]\r\n   */\r\n  public override async parseAndRun(...args: string[]): Promise<boolean> {\r\n    const skew = args.length > 0 ? parseFloat(args[0]) : 1.0;\r\n    return !Number.isNaN(skew) && this.run(skew);\r\n  }\r\n}\r\n\r\n/** Changes the selected viewport's hilite or emphasis settings.\r\n * @beta\r\n */\r\nexport abstract class ChangeHiliteTool extends Tool {\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 6; }\r\n\r\n  public override async run(settings?: Hilite.Settings): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (undefined !== vp)\r\n      this.apply(vp, settings);\r\n\r\n    return true;\r\n  }\r\n\r\n  protected abstract apply(vp: Viewport, settings: Hilite.Settings | undefined): void;\r\n  protected abstract getCurrentSettings(vp: Viewport): Hilite.Settings;\r\n\r\n  public override async parseAndRun(...inputArgs: string[]): Promise<boolean> {\r\n    if (0 === inputArgs.length)\r\n      return this.run();\r\n\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (undefined === vp)\r\n      return true;\r\n\r\n    const cur = this.getCurrentSettings(vp);\r\n    const colors = cur.color.colors;\r\n    let visible = cur.visibleRatio;\r\n    let hidden = cur.hiddenRatio;\r\n    let silhouette = cur.silhouette;\r\n\r\n    const args = parseArgs(inputArgs);\r\n    const parseColorComponent = (c: \"r\" | \"g\" | \"b\") => {\r\n      const num = args.getInteger(c);\r\n      if (undefined !== num)\r\n        colors[c] = Math.floor(Math.max(0, Math.min(255, num)));\r\n    };\r\n\r\n    parseColorComponent(\"r\");\r\n    parseColorComponent(\"g\");\r\n    parseColorComponent(\"b\");\r\n\r\n    const silhouetteArg = args.getInteger(\"s\");\r\n    if (undefined !== silhouetteArg && silhouetteArg >= Hilite.Silhouette.None && silhouetteArg <= Hilite.Silhouette.Thick)\r\n      silhouette = silhouetteArg;\r\n\r\n    const v = args.getFloat(\"v\");\r\n    if (undefined !== v && v >= 0 && v <= 1)\r\n      visible = v;\r\n\r\n    const h = args.getFloat(\"h\");\r\n    if (undefined !== h && h >= 0 && h <= 1)\r\n      hidden = h;\r\n\r\n    if (undefined === silhouette)\r\n      silhouette = cur.silhouette;\r\n\r\n    if (undefined === visible)\r\n      visible = cur.visibleRatio;\r\n\r\n    if (undefined === hidden)\r\n      hidden = cur.hiddenRatio;\r\n\r\n    const settings: Hilite.Settings = {\r\n      color: ColorDef.from(colors.r, colors.g, colors.b),\r\n      silhouette,\r\n      visibleRatio: visible,\r\n      hiddenRatio: hidden,\r\n    };\r\n\r\n    return this.run(settings);\r\n  }\r\n}\r\n\r\n/** Changes the selected viewport's hilite settings, or resets to defaults.\r\n * @beta\r\n */\r\nexport class ChangeHiliteSettingsTool extends ChangeHiliteTool {\r\n  public static override toolId = \"ChangeHiliteSettings\";\r\n\r\n  protected getCurrentSettings(vp: Viewport) { return vp.hilite; }\r\n  protected apply(vp: Viewport, settings?: Hilite.Settings): void {\r\n    vp.hilite = undefined !== settings ? settings : new Hilite.Settings();\r\n  }\r\n}\r\n\r\n/** Changes the selected viewport's emphasis settings.\r\n * @beta\r\n */\r\nexport class ChangeEmphasisSettingsTool extends ChangeHiliteTool {\r\n  public static override toolId = \"ChangeEmphasisSettings\";\r\n\r\n  protected getCurrentSettings(vp: Viewport) { return vp.emphasisSettings; }\r\n  protected apply(vp: Viewport, settings?: Hilite.Settings): void {\r\n    if (undefined !== settings)\r\n      vp.emphasisSettings = settings;\r\n  }\r\n}\r\n\r\n/** Changes the [FlashSettings]($frontend) for the selected [Viewport]($frontend).\r\n * @beta\r\n */\r\nexport class ChangeFlashSettingsTool extends Tool {\r\n  public static override toolId = \"ChangeFlashSettings\";\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 3; }\r\n\r\n  public override async run(settings?: FlashSettings): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (vp)\r\n      vp.flashSettings = settings ?? new FlashSettings();\r\n\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...inputArgs: string[]): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (!vp)\r\n      return true;\r\n\r\n    if (1 === inputArgs.length && \"default\" === inputArgs[0].toLowerCase())\r\n      return this.run();\r\n\r\n    const options: FlashSettingsOptions = {};\r\n    const args = parseArgs(inputArgs);\r\n\r\n    const intensity = args.getFloat(\"i\");\r\n    if (undefined !== intensity)\r\n      options.maxIntensity = intensity;\r\n\r\n    const mode = args.get(\"m\");\r\n    if (mode) {\r\n      switch (mode[0].toLowerCase()) {\r\n        case \"b\":\r\n          options.litMode = FlashMode.Brighten;\r\n          break;\r\n        case \"h\":\r\n          options.litMode = FlashMode.Hilite;\r\n          break;\r\n        default:\r\n          return false;\r\n      }\r\n    }\r\n\r\n    const duration = args.getFloat(\"d\");\r\n    if (undefined !== duration)\r\n      options.duration = BeDuration.fromSeconds(duration);\r\n\r\n    return this.run(vp.flashSettings.clone(options));\r\n  }\r\n}\r\n\r\n/** Enables or disables fade-out transparency mode for the selected viewport.\r\n * @beta\r\n */\r\nexport class FadeOutTool extends ViewportToggleTool {\r\n  public static override toolId = \"FadeOut\";\r\n\r\n  protected override async toggle(vp: Viewport, enable?: boolean): Promise<void> {\r\n    if (undefined === enable || enable !== vp.isFadeOutActive)\r\n      vp.isFadeOutActive = !vp.isFadeOutActive;\r\n\r\n    return Promise.resolve();\r\n  }\r\n}\r\n\r\n/** Sets the default tile size modifier used for all viewports that don't explicitly override it.\r\n * @beta\r\n */\r\nexport class DefaultTileSizeModifierTool extends Tool {\r\n  public static override toolId = \"DefaultTileSizeMod\";\r\n  public static override get minArgs() { return 1; }\r\n  public static override get maxArgs() { return 1; }\r\n\r\n  /** This method runs the tool, setting the default tile size modifier used for all viewports that don't explicitly override it.\r\n   * @param modifier the tile size modifier to use; if undefined, do not set modifier\r\n   */\r\n  public override async run(modifier?: number): Promise<boolean> {\r\n    if (undefined !== modifier)\r\n      IModelApp.tileAdmin.defaultTileSizeModifier = modifier;\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Executes this tool's run method with args[0] containing `modifier`.\r\n   * @see [[run]]\r\n   */\r\n  public override async parseAndRun(...args: string[]): Promise<boolean> {\r\n    return this.run(Number.parseFloat(args[0]));\r\n  }\r\n}\r\n\r\n/** Sets or clears the tile size modifier override for the selected viewport.\r\n * @beta\r\n */\r\nexport class ViewportTileSizeModifierTool extends Tool {\r\n  public static override toolId = \"ViewportTileSizeMod\";\r\n  public static override get minArgs() { return 1; }\r\n  public static override get maxArgs() { return 1; }\r\n\r\n  /** This method runs the tool, setting the tile size modifier used for the selected viewport.\r\n   * @param modifier the tile size modifier to use; if undefined, reset the modifier\r\n   */\r\n  public override async run(modifier?: number): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (undefined !== vp)\r\n      vp.setTileSizeModifier(modifier);\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Executes this tool's run method with args[0] containing the `modifier` argument or the string \"reset\" in order to reset the modifier.\r\n   * @see [[run]]\r\n   */\r\n  public override async parseAndRun(...args: string[]): Promise<boolean> {\r\n    const arg = args[0].toLowerCase();\r\n    const modifier = \"reset\" === arg ? undefined : Number.parseFloat(args[0]);\r\n    return this.run(modifier);\r\n  }\r\n}\r\n\r\n/** This tool adds a reality model to the viewport.\r\n * @beta\r\n */\r\nexport class ViewportAddRealityModel extends Tool {\r\n  public static override toolId = \"ViewportAddRealityModel\";\r\n  public static override get minArgs() { return 1; }\r\n  public static override get maxArgs() { return 1; }\r\n\r\n  /** This method runs the tool, adding a reality model to the viewport\r\n   * @param url the URL which points to the reality model tileset\r\n   */\r\n  public override async run(url: string): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (undefined !== vp)\r\n      vp.displayStyle.attachRealityModel({ tilesetUrl: url });\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Executes this tool's run method with args[0] containing the `url` argument.\r\n   * @see [[run]]\r\n   */\r\n  public override async parseAndRun(...args: string[]): Promise<boolean> {\r\n    return this.run(args[0]);\r\n  }\r\n}\r\n\r\n/** Changes the `allow3dManipulations` flag for the selected viewport if the viewport is displaying a `ViewState3d`.\r\n * @beta\r\n */\r\nexport class Toggle3dManipulationsTool extends ViewportToggleTool {\r\n  public static override toolId = \"Toggle3dManipulations\";\r\n\r\n  protected override async toggle(vp: Viewport, allow?: boolean): Promise<void> {\r\n    if (!vp.view.is3d())\r\n      return Promise.resolve();\r\n\r\n    if (undefined === allow)\r\n      allow = !vp.view.allow3dManipulations();\r\n\r\n    if (allow !== vp.view.allow3dManipulations()) {\r\n      vp.view.setAllow3dManipulations(allow);\r\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\r\n      IModelApp.toolAdmin.startDefaultTool();\r\n    }\r\n\r\n    return Promise.resolve();\r\n  }\r\n}\r\n\r\n/** Toggles display of view attachments in sheet views.\r\n * @beta\r\n */\r\nexport class ToggleViewAttachmentsTool extends ViewportToggleTool {\r\n  public static override toolId = \"ToggleViewAttachments\";\r\n\r\n  protected override async toggle(vp: Viewport, enable?: boolean): Promise<void> {\r\n    if (undefined === enable || enable !== vp.wantViewAttachments)\r\n      vp.wantViewAttachments = !vp.wantViewAttachments;\r\n\r\n    return Promise.resolve();\r\n  }\r\n}\r\n\r\n/** Toggle display of view attachment boundaries in sheet views.\r\n * @beta\r\n */\r\nexport class ToggleViewAttachmentBoundariesTool extends ViewportToggleTool {\r\n  public static override toolId = \"ToggleViewAttachmentBoundaries\";\r\n\r\n  protected override async toggle(vp: Viewport, enable?: boolean): Promise<void> {\r\n    if (undefined === enable || enable !== vp.wantViewAttachmentBoundaries)\r\n      vp.wantViewAttachmentBoundaries = !vp.wantViewAttachmentBoundaries;\r\n\r\n    return Promise.resolve();\r\n  }\r\n}\r\n\r\n/** Toggle display of view attachment clip shapes in sheet views.\r\n * @beta\r\n */\r\nexport class ToggleViewAttachmentClipShapesTool extends ViewportToggleTool {\r\n  public static override toolId = \"ToggleViewAttachmentClipShapes\";\r\n\r\n  protected override async toggle(vp: Viewport, enable?: boolean): Promise<void> {\r\n    if (undefined === enable || enable !== vp.wantViewAttachmentClipShapes)\r\n      vp.wantViewAttachmentClipShapes = !vp.wantViewAttachmentClipShapes;\r\n\r\n    return Promise.resolve();\r\n  }\r\n}\r\n\r\n/** Toggles display of 2d graphics in a [DrawingViewState]($frontend). This setting affects all drawing views until it is reset.\r\n * @beta\r\n */\r\nexport class ToggleDrawingGraphicsTool extends ViewportToggleTool {\r\n  public static override toolId = \"ToggleDrawingGraphics\";\r\n\r\n  protected override async toggle(vp: Viewport, enable?: boolean): Promise<void> {\r\n    if (undefined === enable || enable !== DrawingViewState.hideDrawingGraphics) {\r\n      DrawingViewState.hideDrawingGraphics = !DrawingViewState.hideDrawingGraphics;\r\n      vp.invalidateScene();\r\n    }\r\n\r\n    return Promise.resolve();\r\n  }\r\n}\r\n\r\n/** Toggles whether a [SectionDrawing]($backend)'s spatial view is always displayed along with the 2d graphics by a [DrawingViewState]($frontend), even\r\n * if it otherwise would not be. This setting affects all section drawing views until it is reset.\r\n * @beta\r\n */\r\nexport class ToggleSectionDrawingSpatialViewTool extends ViewportToggleTool {\r\n  public static override toolId = \"ToggleSectionDrawingSpatialView\";\r\n\r\n  protected async toggle(vp: Viewport, enable?: boolean): Promise<void> {\r\n    if (undefined === enable || enable !== DrawingViewState.alwaysDisplaySpatialView) {\r\n      DrawingViewState.alwaysDisplaySpatialView = !DrawingViewState.alwaysDisplaySpatialView;\r\n      if (vp.view instanceof DrawingViewState) {\r\n        // Force the view to update its section drawing attachment.\r\n        const view = vp.view.clone();\r\n        await view.changeViewedModel(view.baseModelId);\r\n        await view.load();\r\n        vp.changeView(view);\r\n      }\r\n    }\r\n  }\r\n}\r\n\r\n/** Change the camera settings of the selected viewport.\r\n * @beta\r\n */\r\nexport class ChangeCameraTool extends Tool {\r\n  public static override get minArgs() { return 1; }\r\n  public static override get maxArgs() { return 2; }\r\n  public static override toolId = \"ChangeCamera\";\r\n\r\n  public override async run(camera?: Camera): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (camera && vp && vp.view.is3d()) {\r\n      const view = vp.view.clone();\r\n      view.camera.setFrom(camera);\r\n      vp.changeView(view);\r\n    }\r\n\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...inArgs: string[]): Promise<boolean> {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    if (!vp || !vp.view.is3d())\r\n      return false;\r\n\r\n    const camera = vp.view.camera.clone();\r\n    const args = parseArgs(inArgs);\r\n    const lens = args.getFloat(\"l\");\r\n    if (undefined !== lens)\r\n      camera.lens.setDegrees(lens);\r\n\r\n    const focusDist = args.getFloat(\"d\");\r\n    if (undefined !== focusDist)\r\n      camera.focusDist = focusDist;\r\n\r\n    return this.run(camera);\r\n  }\r\n}\r\n"]}

package/lib/esm/tools/parseArgs.d.ts

@@ -0,0 +1,24 @@
+/** @packageDocumentation
+ * @module Tools
+ */
+/** Represents parsed arguments as name-value pairs.
+ * @see [[parseArgs]]
+ * @beta
+ */
+export interface ToolArgs {
+    /** Find the value associated with the first argument that begins with the specified prefix, case-insensitively; or undefined if no such argument exists. */
+    get(namePrefix: string): string | undefined;
+    /** Convert the value associated with the first argument beginning with the specified prefix to an integer; return undefined if not found or not an integer. */
+    getInteger(namePrefix: string): number | undefined;
+    /** Convert the value associated with the first argument beginning with the specified prefix to a boolean, where "1" indicates true and "0" indicates false. */
+    getBoolean(namePrefix: string): boolean | undefined;
+    /** Convert the value associated with the first argument beginning with the specified prefix to a float; return undefined if not found or not a float. */
+    getFloat(namePrefix: string): number | undefined;
+}
+/** Given a list of arguments, parse the arguments into name-value pairs.
+ * Each input string is expected to be of the format "name=value".
+ * Argument names are converted to lower-case; values are left untouched.
+ * @beta
+ */
+export declare function parseArgs(args: string[]): ToolArgs;
+//# sourceMappingURL=parseArgs.d.ts.map

package/lib/esm/tools/parseArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArgs.d.ts","sourceRoot":"","sources":["../../../src/tools/parseArgs.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,4JAA4J;IAC5J,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5C,+JAA+J;IAC/J,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,+JAA+J;IAC/J,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACpD,yJAAyJ;IACzJ,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CA8ClD"}

package/lib/esm/tools/parseArgs.js

@@ -0,0 +1,48 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** Given a list of arguments, parse the arguments into name-value pairs.
+ * Each input string is expected to be of the format "name=value".
+ * Argument names are converted to lower-case; values are left untouched.
+ * @beta
+ */
+export function parseArgs(args) {
+    const map = new Map();
+    for (const arg of args) {
+        const parts = arg.split("=");
+        if (2 === parts.length)
+            map.set(parts[0].toLowerCase(), parts[1]);
+    }
+    const findArgValue = (name) => {
+        name = name.toLowerCase();
+        for (const key of map.keys())
+            if (key.startsWith(name))
+                return map.get(key);
+        return undefined;
+    };
+    return {
+        get: (name) => findArgValue(name),
+        getBoolean: (name) => {
+            const val = findArgValue(name);
+            if (undefined !== val && (val === "0" || val === "1"))
+                return val === "1";
+            return undefined;
+        },
+        getInteger: (name) => {
+            const val = findArgValue(name);
+            if (undefined === val)
+                return undefined;
+            const num = Number.parseInt(val, 10);
+            return Number.isNaN(num) ? undefined : num;
+        },
+        getFloat: (name) => {
+            const val = findArgValue(name);
+            if (undefined === val)
+                return undefined;
+            const num = Number.parseFloat(val);
+            return Number.isNaN(num) ? undefined : num;
+        },
+    };
+}
+//# sourceMappingURL=parseArgs.js.map

package/lib/esm/tools/parseArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArgs.js","sourceRoot":"","sources":["../../../src/tools/parseArgs.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAqB/F;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;QACtB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM;YACpB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KAC7C;IAED,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE;QACpC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE;YAC1B,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;gBACtB,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAExB,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;QAEzC,UAAU,EAAE,CAAC,IAAY,EAAE,EAAE;YAC3B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,SAAS,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC;gBACnD,OAAO,GAAG,KAAK,GAAG,CAAC;YAErB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,UAAU,EAAE,CAAC,IAAY,EAAE,EAAE;YAC3B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,SAAS,KAAK,GAAG;gBACnB,OAAO,SAAS,CAAC;YAEnB,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7C,CAAC;QAED,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE;YACzB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,SAAS,KAAK,GAAG;gBACnB,OAAO,SAAS,CAAC;YAEnB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,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\r\n/** @packageDocumentation\r\n * @module Tools\r\n */\r\n\r\n/** Represents parsed arguments as name-value pairs.\r\n * @see [[parseArgs]]\r\n * @beta\r\n */\r\nexport interface ToolArgs {\r\n  /** Find the value associated with the first argument that begins with the specified prefix, case-insensitively; or undefined if no such argument exists. */\r\n  get(namePrefix: string): string | undefined;\r\n  /** Convert the value associated with the first argument beginning with the specified prefix to an integer; return undefined if not found or not an integer. */\r\n  getInteger(namePrefix: string): number | undefined;\r\n  /** Convert the value associated with the first argument beginning with the specified prefix to a boolean, where \"1\" indicates true and \"0\" indicates false. */\r\n  getBoolean(namePrefix: string): boolean | undefined;\r\n  /** Convert the value associated with the first argument beginning with the specified prefix to a float; return undefined if not found or not a float. */\r\n  getFloat(namePrefix: string): number | undefined;\r\n}\r\n\r\n/** Given a list of arguments, parse the arguments into name-value pairs.\r\n * Each input string is expected to be of the format \"name=value\".\r\n * Argument names are converted to lower-case; values are left untouched.\r\n * @beta\r\n */\r\nexport function parseArgs(args: string[]): ToolArgs {\r\n  const map = new Map<string, string>();\r\n  for (const arg of args) {\r\n    const parts = arg.split(\"=\");\r\n    if (2 === parts.length)\r\n      map.set(parts[0].toLowerCase(), parts[1]);\r\n  }\r\n\r\n  const findArgValue = (name: string) => {\r\n    name = name.toLowerCase();\r\n    for (const key of map.keys())\r\n      if (key.startsWith(name))\r\n        return map.get(key);\r\n\r\n    return undefined;\r\n  };\r\n\r\n  return {\r\n    get: (name: string) => findArgValue(name),\r\n\r\n    getBoolean: (name: string) => {\r\n      const val = findArgValue(name);\r\n      if (undefined !== val && (val === \"0\" || val === \"1\"))\r\n        return val === \"1\";\r\n\r\n      return undefined;\r\n    },\r\n\r\n    getInteger: (name: string) => {\r\n      const val = findArgValue(name);\r\n      if (undefined === val)\r\n        return undefined;\r\n\r\n      const num = Number.parseInt(val, 10);\r\n      return Number.isNaN(num) ? undefined : num;\r\n    },\r\n\r\n    getFloat: (name: string) => {\r\n      const val = findArgValue(name);\r\n      if (undefined === val)\r\n        return undefined;\r\n\r\n      const num = Number.parseFloat(val);\r\n      return Number.isNaN(num) ? undefined : num;\r\n    },\r\n  };\r\n}\r\n"]}

package/lib/esm/tools/parseBoolean.d.ts

@@ -0,0 +1,9 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+/** Parses a string case-insensitively returning true for "ON" or "TRUE", false for "OFF" or "FALSE" and undefined otherwise.
+ * Used by various tools which take such arguments.
+ * @beta
+ */
+export declare function parseBoolean(arg: string | undefined): boolean | undefined;
+//# sourceMappingURL=parseBoolean.d.ts.map

package/lib/esm/tools/parseBoolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBoolean.d.ts","sourceRoot":"","sources":["../../../src/tools/parseBoolean.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAWzE"}

package/lib/esm/tools/parseBoolean.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
+ */
+/** Parses a string case-insensitively returning true for "ON" or "TRUE", false for "OFF" or "FALSE" and undefined otherwise.
+ * Used by various tools which take such arguments.
+ * @beta
+ */
+export function parseBoolean(arg) {
+    if (undefined === arg)
+        return undefined;
+    switch (arg.toLowerCase()) {
+        case "on": return true;
+        case "true": return true;
+        case "off": return false;
+        case "false": return false;
+        default: return undefined;
+    }
+}
+//# sourceMappingURL=parseBoolean.js.map

package/lib/esm/tools/parseBoolean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBoolean.js","sourceRoot":"","sources":["../../../src/tools/parseBoolean.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAuB;IAClD,IAAI,SAAS,KAAK,GAAG;QACnB,OAAO,SAAS,CAAC;IAEnB,QAAQ,GAAG,CAAC,WAAW,EAAE,EAAE;QACzB,KAAK,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC;QACvB,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC;QACzB,KAAK,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC;QACzB,KAAK,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC;QAC3B,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC;KAC3B;AACH,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Utilities\r\n */\r\n\r\n/** Parses a string case-insensitively returning true for \"ON\" or \"TRUE\", false for \"OFF\" or \"FALSE\" and undefined otherwise.\r\n * Used by various tools which take such arguments.\r\n * @beta\r\n */\r\nexport function parseBoolean(arg: string | undefined): boolean | undefined {\r\n  if (undefined === arg)\r\n    return undefined;\r\n\r\n  switch (arg.toLowerCase()) {\r\n    case \"on\": return true;\r\n    case \"true\": return true;\r\n    case \"off\": return false;\r\n    case \"false\": return false;\r\n    default: return undefined;\r\n  }\r\n}\r\n"]}

package/lib/esm/tools/parseToggle.d.ts

@@ -0,0 +1,9 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+/** Parses a string case-insensitively returning true for "ON", false for "OFF" undefined for "TOGGLE" or undefined, and the input string for anything else
+ * Used by various tools which take such arguments.
+ * @beta
+ */
+export declare function parseToggle(arg: string | undefined): string | boolean | undefined;
+//# sourceMappingURL=parseToggle.d.ts.map

package/lib/esm/tools/parseToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseToggle.d.ts","sourceRoot":"","sources":["../../../src/tools/parseToggle.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAUjF"}