@itwin/hypermodeling-frontend 3.0.0-dev.72

package/lib/SectionMarkerHandler.js

@@ -0,0 +1,113 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module HyperModeling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SectionMarkerHandler = void 0;
+const core_frontend_1 = require("@itwin/core-frontend");
+/** Supplies interactions with [[SectionMarker]]s, including a mini-toolbar displayed when the mouse hovers over a marker and what action occurs when the user clicks a marker.
+ * The base implementation supplies the following interactions:
+ *  * Click: Toggle display of the section graphics and clip volume; apply the section's spatial view if toggling on.
+ *  * Toolbar:
+ *    * Apply Section: Applies the section location's spatial view to the viewport and displays the 2d section graphics.
+ *    * Open Drawing: Navigates to the section drawing view. By default, this applies the section drawing view to the viewport.
+ *    * Open Sheet: Navigates to the [ViewAttachment]($backend) of the section drawing on a [Sheet]($backend). Disabled if no such attachment exists.
+ * @see [[HyperModelingConfig]] to override the default handler by supplying a subclass of `SectionMarkerHandler`.
+ * @see [[HyperModelingDecorator]] for various methods that might be usefully wired up to marker click or toolbar actions.
+ * @public
+ */
+class SectionMarkerHandler {
+    /** Respond to activation of the specified marker. Return true if the marker should become the active marker - i.e., if the marker was successfully activated.
+     * @see [[SectionMarkerHandler.deactivateMarker]].
+     */
+    async activateMarker(marker, decorator) {
+        return decorator.toggleSection(marker, true);
+    }
+    /** Respond to deactivation of the specified marker. Invoked when the user clicks on the marker while it is the active marker.
+     * This should perform the inverse of [[SectionMarkerHandler.activateMarker]]. The marker becomes inactive as a result.
+     */
+    async deactivateMarker(marker, decorator) {
+        await decorator.toggleSection(marker, false);
+    }
+    /** Return toolbar items for the specified marker. If the array of toolbar items is empty, no toolbar will be displayed.
+     * @see [[executeCommand]] to implement each toolbar command.
+     */
+    getToolbarProps(marker, _decorator) {
+        var _a;
+        const i18n = core_frontend_1.IModelApp.i18n;
+        return {
+            items: [
+                {
+                    id: "apply_view",
+                    itemPriority: 10,
+                    label: i18n.translate("HyperModeling:Message.ApplyView"),
+                    icon: "icon-spatial-view-apply",
+                    execute: () => { },
+                    isDisabled: false,
+                },
+                {
+                    id: "open_section",
+                    itemPriority: 20,
+                    label: i18n.translate("HyperModeling:Message.OpenSection"),
+                    icon: "icon-plan-drawing",
+                    execute: () => { },
+                    isDisabled: false,
+                },
+                {
+                    id: "open_sheet",
+                    itemPriority: 30,
+                    label: i18n.translate("HyperModeling:Message.OpenSheet"),
+                    icon: "icon-plan-floor",
+                    execute: () => { },
+                    isDisabled: undefined === ((_a = marker.state.viewAttachment) === null || _a === void 0 ? void 0 : _a.viewId),
+                },
+            ],
+        };
+    }
+    /** Execute the command associated with the specified tool bar item.
+     * @see [[getToolbarProps]] to define the set of commands.
+     */
+    async executeCommand(commandId, marker, decorator) {
+        switch (commandId) {
+            case "apply_view":
+                await decorator.applySpatialView(marker);
+                break;
+            case "open_section":
+                await decorator.openSection(marker);
+                break;
+            case "open_sheet":
+                await decorator.openSheet(marker);
+                break;
+        }
+    }
+    /** Customize which markers are visible. [[HyperModelingDecorator]] determines marker visibility as follows:
+     *  - If a marker is currently active (selected), only that marker is visible.
+     *  - Otherwise, the marker is visible if this method returns `true`.
+     * The default implementation of this method determines visibility based on the [[SectionMarkerConfig]] as follows.
+     *  - If the marker is of a type included in the config's `hiddenSectionTypes`, it is invisible.
+     *  - If the marker belongs to a model not currently displayed in the viewport and the config's `ignoreModelSelector` is false, it is invisible.
+     *  - If the marker belongs to a category not currently displayed in the viewport and the config's `ignoreCategorySelector` is false, it is invisible,
+     *  - Otherwise, the marker is visible, unless this method returns `false`.
+     * The default implementation of this method always returns `true`
+     * @param marker The marker whose visibility is to be determined.
+     * @param decorator The hypermodeling decorator to which the marker belongs.
+     * @param config The configuration controlling marker visibility based on [SectionType]($common), [ModelSelectorState]($frontend), and [CategorySelectorState]($frontend).
+     * @returns true if the marker should be displayed; false to make it invisible.
+     * @see [[HyperModelingDecorator.requestSync]] to force the decorator to reevaluate marker visibility when the criterion used by your implementation of this method changes.
+     */
+    isMarkerVisible(marker, decorator, config) {
+        if (undefined !== config.hiddenSectionTypes && config.hiddenSectionTypes.includes(marker.state.sectionType))
+            return false;
+        if (!config.ignoreCategorySelector && !decorator.viewport.view.viewsCategory(marker.state.category))
+            return false;
+        if (!config.ignoreModelSelector && !decorator.viewport.view.viewsModel(marker.state.model))
+            return false;
+        return true;
+    }
+}
+exports.SectionMarkerHandler = SectionMarkerHandler;
+//# sourceMappingURL=SectionMarkerHandler.js.map

package/lib/SectionMarkerHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionMarkerHandler.js","sourceRoot":"","sources":["../src/SectionMarkerHandler.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,wDAAiD;AAMjD;;;;;;;;;;GAUG;AACH,MAAa,oBAAoB;IAC/B;;OAEG;IACI,KAAK,CAAC,cAAc,CAAC,MAAqB,EAAE,SAAiC;QAClF,OAAO,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,gBAAgB,CAAC,MAAqB,EAAE,SAAiC;QACpF,MAAM,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,MAAqB,EAAE,UAAkC;;QAC9E,MAAM,IAAI,GAAG,yBAAS,CAAC,IAAI,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE;gBACL;oBACE,EAAE,EAAE,YAAY;oBAChB,YAAY,EAAE,EAAE;oBAChB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,iCAAiC,CAAC;oBACxD,IAAI,EAAE,yBAAyB;oBAC/B,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC;oBAClB,UAAU,EAAE,KAAK;iBAClB;gBACD;oBACE,EAAE,EAAE,cAAc;oBAClB,YAAY,EAAE,EAAE;oBAChB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,mCAAmC,CAAC;oBAC1D,IAAI,EAAE,mBAAmB;oBACzB,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC;oBAClB,UAAU,EAAE,KAAK;iBAClB;gBACD;oBACE,EAAE,EAAE,YAAY;oBAChB,YAAY,EAAE,EAAE;oBAChB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,iCAAiC,CAAC;oBACxD,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC;oBAClB,UAAU,EAAE,SAAS,MAAK,MAAA,MAAM,CAAC,KAAK,CAAC,cAAc,0CAAE,MAAM,CAAA;iBAC9D;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,MAAqB,EAAE,SAAiC;QACrG,QAAQ,SAAS,EAAE;YACjB,KAAK,YAAY;gBACf,MAAM,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,cAAc;gBACjB,MAAM,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBACpC,MAAM;YACR,KAAK,YAAY;gBACf,MAAM,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAClC,MAAM;SACT;IACH,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,eAAe,CAAC,MAAqB,EAAE,SAAiC,EAAE,MAA2B;QAC1G,IAAI,SAAS,KAAK,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;YACzG,OAAO,KAAK,CAAC;QAEf,IAAI,CAAC,MAAM,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YACjG,OAAO,KAAK,CAAC;QAEf,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YACxF,OAAO,KAAK,CAAC;QAEf,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA9FD,oDA8FC","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 HyperModeling\r\n */\r\n\r\nimport { IModelApp } from \"@itwin/core-frontend\";\r\nimport { AbstractToolbarProps } from \"@itwin/appui-abstract\";\r\nimport { SectionMarker } from \"./SectionMarkers\";\r\nimport { SectionMarkerConfig } from \"./HyperModelingConfig\";\r\nimport { HyperModelingDecorator } from \"./HyperModelingDecorator\";\r\n\r\n/** Supplies interactions with [[SectionMarker]]s, including a mini-toolbar displayed when the mouse hovers over a marker and what action occurs when the user clicks a marker.\r\n * The base implementation supplies the following interactions:\r\n *  * Click: Toggle display of the section graphics and clip volume; apply the section's spatial view if toggling on.\r\n *  * Toolbar:\r\n *    * Apply Section: Applies the section location's spatial view to the viewport and displays the 2d section graphics.\r\n *    * Open Drawing: Navigates to the section drawing view. By default, this applies the section drawing view to the viewport.\r\n *    * Open Sheet: Navigates to the [ViewAttachment]($backend) of the section drawing on a [Sheet]($backend). Disabled if no such attachment exists.\r\n * @see [[HyperModelingConfig]] to override the default handler by supplying a subclass of `SectionMarkerHandler`.\r\n * @see [[HyperModelingDecorator]] for various methods that might be usefully wired up to marker click or toolbar actions.\r\n * @public\r\n */\r\nexport class SectionMarkerHandler {\r\n  /** Respond to activation of the specified marker. Return true if the marker should become the active marker - i.e., if the marker was successfully activated.\r\n   * @see [[SectionMarkerHandler.deactivateMarker]].\r\n   */\r\n  public async activateMarker(marker: SectionMarker, decorator: HyperModelingDecorator): Promise<boolean> {\r\n    return decorator.toggleSection(marker, true);\r\n  }\r\n\r\n  /** Respond to deactivation of the specified marker. Invoked when the user clicks on the marker while it is the active marker.\r\n   * This should perform the inverse of [[SectionMarkerHandler.activateMarker]]. The marker becomes inactive as a result.\r\n   */\r\n  public async deactivateMarker(marker: SectionMarker, decorator: HyperModelingDecorator): Promise<void> {\r\n    await decorator.toggleSection(marker, false);\r\n  }\r\n\r\n  /** Return toolbar items for the specified marker. If the array of toolbar items is empty, no toolbar will be displayed.\r\n   * @see [[executeCommand]] to implement each toolbar command.\r\n   */\r\n  public getToolbarProps(marker: SectionMarker, _decorator: HyperModelingDecorator): AbstractToolbarProps {\r\n    const i18n = IModelApp.i18n;\r\n    return {\r\n      items: [\r\n        {\r\n          id: \"apply_view\",\r\n          itemPriority: 10,\r\n          label: i18n.translate(\"HyperModeling:Message.ApplyView\"),\r\n          icon: \"icon-spatial-view-apply\",\r\n          execute: () => { },\r\n          isDisabled: false,\r\n        },\r\n        {\r\n          id: \"open_section\",\r\n          itemPriority: 20,\r\n          label: i18n.translate(\"HyperModeling:Message.OpenSection\"),\r\n          icon: \"icon-plan-drawing\",\r\n          execute: () => { },\r\n          isDisabled: false,\r\n        },\r\n        {\r\n          id: \"open_sheet\",\r\n          itemPriority: 30,\r\n          label: i18n.translate(\"HyperModeling:Message.OpenSheet\"),\r\n          icon: \"icon-plan-floor\",\r\n          execute: () => { },\r\n          isDisabled: undefined === marker.state.viewAttachment?.viewId,\r\n        },\r\n      ],\r\n    };\r\n  }\r\n\r\n  /** Execute the command associated with the specified tool bar item.\r\n   * @see [[getToolbarProps]] to define the set of commands.\r\n   */\r\n  public async executeCommand(commandId: string, marker: SectionMarker, decorator: HyperModelingDecorator): Promise<void> {\r\n    switch (commandId) {\r\n      case \"apply_view\":\r\n        await decorator.applySpatialView(marker);\r\n        break;\r\n      case \"open_section\":\r\n        await decorator.openSection(marker);\r\n        break;\r\n      case \"open_sheet\":\r\n        await decorator.openSheet(marker);\r\n        break;\r\n    }\r\n  }\r\n\r\n  /** Customize which markers are visible. [[HyperModelingDecorator]] determines marker visibility as follows:\r\n   *  - If a marker is currently active (selected), only that marker is visible.\r\n   *  - Otherwise, the marker is visible if this method returns `true`.\r\n   * The default implementation of this method determines visibility based on the [[SectionMarkerConfig]] as follows.\r\n   *  - If the marker is of a type included in the config's `hiddenSectionTypes`, it is invisible.\r\n   *  - If the marker belongs to a model not currently displayed in the viewport and the config's `ignoreModelSelector` is false, it is invisible.\r\n   *  - If the marker belongs to a category not currently displayed in the viewport and the config's `ignoreCategorySelector` is false, it is invisible,\r\n   *  - Otherwise, the marker is visible, unless this method returns `false`.\r\n   * The default implementation of this method always returns `true`\r\n   * @param marker The marker whose visibility is to be determined.\r\n   * @param decorator The hypermodeling decorator to which the marker belongs.\r\n   * @param config The configuration controlling marker visibility based on [SectionType]($common), [ModelSelectorState]($frontend), and [CategorySelectorState]($frontend).\r\n   * @returns true if the marker should be displayed; false to make it invisible.\r\n   * @see [[HyperModelingDecorator.requestSync]] to force the decorator to reevaluate marker visibility when the criterion used by your implementation of this method changes.\r\n   */\r\n  public isMarkerVisible(marker: SectionMarker, decorator: HyperModelingDecorator, config: SectionMarkerConfig): boolean {\r\n    if (undefined !== config.hiddenSectionTypes && config.hiddenSectionTypes.includes(marker.state.sectionType))\r\n      return false;\r\n\r\n    if (!config.ignoreCategorySelector && !decorator.viewport.view.viewsCategory(marker.state.category))\r\n      return false;\r\n\r\n    if (!config.ignoreModelSelector && !decorator.viewport.view.viewsModel(marker.state.model))\r\n      return false;\r\n\r\n    return true;\r\n  }\r\n}\r\n"]}

package/lib/SectionMarkers.d.ts

@@ -0,0 +1,83 @@
+/** @packageDocumentation
+ * @module HyperModeling
+ */
+import { BeEvent, Id64String } from "@itwin/core-bentley";
+import { XAndY, XYAndZ } from "@itwin/core-geometry";
+import { BeButtonEvent, Cluster, DecorateContext, Marker, MarkerImage, MarkerSet, ScreenViewport } from "@itwin/core-frontend";
+import { SectionDrawingLocationState } from "./SectionDrawingLocationState";
+/** A [Marker]($frontend) associated with a [[SectionDrawingLocationState]], displayed as a canvas decoration at the location of the section.
+ * Clicking on the marker toggles display of the section graphics. Mousing over the marker produces a toolbar with additional interactions.
+ * @see [[HyperModelingDecorator]] for a [Decorator]($frontend) capable of displaying section markers for each section drawing location.
+ * @see [[SectionMarkerHandler]] to customize the marker interactions.
+ * @public
+ */
+export declare class SectionMarker extends Marker {
+    /** The section drawing location state associated with the marker. */
+    readonly state: SectionDrawingLocationState;
+    /** A description displayed as part of the tooltip when this marker is clustered with other markers. */
+    readonly description: string;
+    /** @internal */
+    readonly onMouseEnterEvent: BeEvent<(marker: SectionMarker) => void>;
+    /** @internal */
+    readonly onMouseButtonEvent: BeEvent<(marker: SectionMarker) => void>;
+    /** @internal */
+    private _isActive;
+    /** Constructor, typically invoked indirectly via [[HyperModelingDecorator]].
+     * @param state The section drawing location state this marker will represent.
+     * @param pos The world coordinates at which to display the marker.
+     * @param description A brief description of this marker, used as part of the tooltip when this marker is part of a cluster.
+     * @param icon The icon displayed by the marker.
+     * @param tooltip Optional detailed tooltip displayed on mouse hover. If undefined, the `description` is used instead.
+     */
+    constructor(state: SectionDrawingLocationState);
+    /** @internal */
+    get isHilited(): boolean;
+    /** Returns true if this is the "active" section marker. At most one marker is active at a given time.
+     * @see [[HyperModelingDecorator.activeMarker]].
+     * @see [[HyperModelingDecorator.setActiveMarker]].
+     * @see [[SectionMarkerHandler.toggleMarker]].
+     */
+    get isActive(): boolean;
+    /** @internal */
+    setActive(active: boolean): void;
+    /** @internal */
+    protected drawActive(ctx: CanvasRenderingContext2D): boolean;
+    /** @internal */
+    drawDecoration(ctx: CanvasRenderingContext2D): void;
+    /** @internal */
+    onMouseEnter(ev: BeButtonEvent): void;
+    /** @internal */
+    onMouseButton(ev: BeButtonEvent): boolean;
+    /** @internal */
+    addMarker(context: DecorateContext): void;
+}
+/** A Marker used to show a cluster of section locations.
+ * @internal
+ */
+export declare class SectionMarkerCluster extends Marker {
+    /** Create a new cluster marker */
+    constructor(location: XYAndZ, size: XAndY, cluster: Cluster<SectionMarker>, image: Promise<MarkerImage>);
+    /** Show the cluster as a white circle with an outline */
+    drawFunc(ctx: CanvasRenderingContext2D): void;
+    onMouseButton(_ev: BeButtonEvent): boolean;
+}
+/** A [MarkerSet]($frontend) containing [[SectionMarker]]s identifying [SectionDrawingLocation]($backend)s within a spatial view.
+ * Typically used indirectly via [[HyperModelingDecorator]].
+ * @public
+ */
+export declare class SectionMarkerSet extends MarkerSet<SectionMarker> {
+    minimumClusterSize: number;
+    /** Constructor
+     * @param viewport The viewport in which the markers are to be displayed.
+     * @param markers The markers to be displayed.
+     * @note Each marker's [[SectionDrawingLocationState]] must be associated with the same [IModelConnection]($frontend) as the viewport; any markers from other iModels will be omitted.
+     */
+    constructor(viewport: ScreenViewport, markers: SectionMarker[]);
+    /** The viewport in which the markers are to be displayed. */
+    get viewport(): ScreenViewport;
+    /** @internal */
+    protected getClusterMarker(cluster: Cluster<SectionMarker>): Marker;
+    /** Find the SectionMarker corresponding to the specified [SectionDrawingLocation]($backend) Id. */
+    findMarkerById(sectionDrawingLocationId: Id64String): SectionMarker | undefined;
+}
+//# sourceMappingURL=SectionMarkers.d.ts.map

package/lib/SectionMarkers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionMarkers.d.ts","sourceRoot":"","sources":["../src/SectionMarkers.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAU,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAoB,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EACK,aAAa,EAAE,OAAO,EAAE,eAAe,EAA0B,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAC1H,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAK5E;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,MAAM;IACvC,qEAAqE;IACrE,SAAgB,KAAK,EAAE,2BAA2B,CAAC;IACnD,uGAAuG;IACvG,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,gBAAgB;IAChB,SAAgB,iBAAiB,mBAAwB,aAAa,KAAK,IAAI,EAAI;IACnF,gBAAgB;IAChB,SAAgB,kBAAkB,mBAAwB,aAAa,KAAK,IAAI,EAAI;IACpF,gBAAgB;IAChB,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;;OAMG;gBACgB,KAAK,EAAE,2BAA2B;IAYrD,gBAAgB;IAChB,IAAW,SAAS,IAAI,OAAO,CAA4B;IAE3D;;;;OAIG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,gBAAgB;IACT,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIvC,gBAAgB;IAChB,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,wBAAwB;IAMlD,gBAAgB;IACA,cAAc,CAAC,GAAG,EAAE,wBAAwB,GAAG,IAAI;IAKnE,gBAAgB;IACA,YAAY,CAAC,EAAE,EAAE,aAAa;IAc9C,gBAAgB;IACA,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO;IAOzD,gBAAgB;IACA,SAAS,CAAC,OAAO,EAAE,eAAe;CAKnD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,MAAM;IAC9C,kCAAkC;gBACtB,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC;IA2BvG,yDAAyD;IACzC,QAAQ,CAAC,GAAG,EAAE,wBAAwB,GAAG,IAAI;IAU7C,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;CAC3D;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,SAAS,CAAC,aAAa,CAAC;IAC5C,kBAAkB,SAAK;IAEvC;;;;OAIG;gBACgB,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE;IAQrE,6DAA6D;IAC7D,IAAoB,QAAQ,IAAI,cAAc,CAG7C;IAED,gBAAgB;IAChB,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,MAAM;IAInE,mGAAmG;IAC5F,cAAc,CAAC,wBAAwB,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS;CAOvF"}

package/lib/SectionMarkers.js

@@ -0,0 +1,174 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module HyperModeling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SectionMarkerSet = exports.SectionMarkerCluster = exports.SectionMarker = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_geometry_1 = require("@itwin/core-geometry");
+const core_common_1 = require("@itwin/core-common");
+const core_frontend_1 = require("@itwin/core-frontend");
+const HyperModeling_1 = require("./HyperModeling");
+const markerSize = core_geometry_1.Point2d.create(40, 40);
+/** A [Marker]($frontend) associated with a [[SectionDrawingLocationState]], displayed as a canvas decoration at the location of the section.
+ * Clicking on the marker toggles display of the section graphics. Mousing over the marker produces a toolbar with additional interactions.
+ * @see [[HyperModelingDecorator]] for a [Decorator]($frontend) capable of displaying section markers for each section drawing location.
+ * @see [[SectionMarkerHandler]] to customize the marker interactions.
+ * @public
+ */
+class SectionMarker extends core_frontend_1.Marker {
+    /** Constructor, typically invoked indirectly via [[HyperModelingDecorator]].
+     * @param state The section drawing location state this marker will represent.
+     * @param pos The world coordinates at which to display the marker.
+     * @param description A brief description of this marker, used as part of the tooltip when this marker is part of a cluster.
+     * @param icon The icon displayed by the marker.
+     * @param tooltip Optional detailed tooltip displayed on mouse hover. If undefined, the `description` is used instead.
+     */
+    constructor(state) {
+        super(state.placement.origin.clone(), markerSize);
+        /** @internal */
+        this.onMouseEnterEvent = new core_bentley_1.BeEvent();
+        /** @internal */
+        this.onMouseButtonEvent = new core_bentley_1.BeEvent();
+        /** @internal */
+        this._isActive = false;
+        this.state = state;
+        const data = HyperModeling_1.HyperModeling.getMarkerData(state.sectionType);
+        this.description = data.label;
+        if (data.image)
+            this.setImage(data.image);
+        this.setScaleFactor({ low: .2, high: 1.4 }); // make size 20% at back of frustum and 140% at front of frustum (if camera is on)
+    }
+    /** @internal */
+    get isHilited() { return this._isHilited; }
+    /** Returns true if this is the "active" section marker. At most one marker is active at a given time.
+     * @see [[HyperModelingDecorator.activeMarker]].
+     * @see [[HyperModelingDecorator.setActiveMarker]].
+     * @see [[SectionMarkerHandler.toggleMarker]].
+     */
+    get isActive() {
+        return this._isActive;
+    }
+    /** @internal */
+    setActive(active) {
+        this._isActive = active;
+    }
+    /** @internal */
+    drawActive(ctx) {
+        ctx.shadowBlur = 30;
+        ctx.shadowColor = "gold";
+        return false;
+    }
+    /** @internal */
+    drawDecoration(ctx) {
+        if (!this.isActive || !this.drawActive(ctx))
+            super.drawDecoration(ctx);
+    }
+    /** @internal */
+    onMouseEnter(ev) {
+        // Lazily load the tooltip.
+        if (undefined === this.title) {
+            core_common_1.IModelReadRpcInterface.getClientForRouting(this.state.iModel.routingContext.token).getToolTipMessage(this.state.iModel.getRpcProps(), this.state.id).then((tooltipMsg) => {
+                this.title = core_frontend_1.IModelApp.formatElementToolTip(tooltipMsg);
+            }).catch((_) => {
+                this.title = this.description;
+            });
+        }
+        super.onMouseEnter(ev);
+        this.onMouseEnterEvent.raiseEvent(this);
+    }
+    /** @internal */
+    onMouseButton(ev) {
+        if (core_frontend_1.InputSource.Mouse === ev.inputSource && core_frontend_1.BeButton.Data === ev.button && ev.isDown && ev.viewport)
+            this.onMouseButtonEvent.raiseEvent(this);
+        return true; // Don't allow clicks to be sent to active tool...
+    }
+    /** @internal */
+    addMarker(context) {
+        super.addMarker(context);
+        if (this.isHilited)
+            core_frontend_1.ViewClipTool.drawClip(context, this.state.clip, undefined, { fillClipPlanes: true, hasPrimaryPlane: true });
+    }
+}
+exports.SectionMarker = SectionMarker;
+/** A Marker used to show a cluster of section locations.
+ * @internal
+ */
+class SectionMarkerCluster extends core_frontend_1.Marker {
+    /** Create a new cluster marker */
+    constructor(location, size, cluster, image) {
+        super(location, size);
+        this.imageOffset = new core_geometry_1.Point3d(0, 30);
+        this.label = cluster.markers.length.toLocaleString();
+        this.labelColor = "black";
+        this.labelFont = "bold 14px sans-serif";
+        const maxLen = 10;
+        let title = "";
+        cluster.markers.forEach((marker, index) => {
+            if (index < maxLen) {
+                if (title !== "")
+                    title += "<br>";
+                title += marker.description;
+            }
+        });
+        if (cluster.markers.length > maxLen)
+            title += "<br>...";
+        const div = document.createElement("div");
+        div.innerHTML = title;
+        this.title = div;
+        this.setImage(image);
+    }
+    /** Show the cluster as a white circle with an outline */
+    drawFunc(ctx) {
+        ctx.beginPath();
+        ctx.strokeStyle = "#372528";
+        ctx.fillStyle = "white";
+        ctx.lineWidth = 5;
+        ctx.arc(0, 0, 13, 0, Math.PI * 2);
+        ctx.fill();
+        ctx.stroke();
+    }
+    onMouseButton(_ev) { return true; } // Don't allow clicks to be sent to active tool...
+}
+exports.SectionMarkerCluster = SectionMarkerCluster;
+/** A [MarkerSet]($frontend) containing [[SectionMarker]]s identifying [SectionDrawingLocation]($backend)s within a spatial view.
+ * Typically used indirectly via [[HyperModelingDecorator]].
+ * @public
+ */
+class SectionMarkerSet extends core_frontend_1.MarkerSet {
+    /** Constructor
+     * @param viewport The viewport in which the markers are to be displayed.
+     * @param markers The markers to be displayed.
+     * @note Each marker's [[SectionDrawingLocationState]] must be associated with the same [IModelConnection]($frontend) as the viewport; any markers from other iModels will be omitted.
+     */
+    constructor(viewport, markers) {
+        super(viewport);
+        this.minimumClusterSize = 5;
+        for (const marker of markers) {
+            if (marker.state.iModel === viewport.iModel)
+                this.markers.add(marker);
+        }
+    }
+    /** The viewport in which the markers are to be displayed. */
+    get viewport() {
+        (0, core_bentley_1.assert)(undefined !== super.viewport);
+        return super.viewport;
+    }
+    /** @internal */
+    getClusterMarker(cluster) {
+        return SectionMarkerCluster.makeFrom(cluster.markers[0], cluster, cluster.markers[0].image);
+    }
+    /** Find the SectionMarker corresponding to the specified [SectionDrawingLocation]($backend) Id. */
+    findMarkerById(sectionDrawingLocationId) {
+        for (const marker of this.markers)
+            if (marker.state.id === sectionDrawingLocationId)
+                return marker;
+        return undefined;
+    }
+}
+exports.SectionMarkerSet = SectionMarkerSet;
+//# sourceMappingURL=SectionMarkers.js.map

package/lib/SectionMarkers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionMarkers.js","sourceRoot":"","sources":["../src/SectionMarkers.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module HyperModeling\r\n */\r\n\r\nimport { assert, BeEvent, Id64String } from \"@itwin/core-bentley\";\r\nimport { Point2d, Point3d, XAndY, XYAndZ } from \"@itwin/core-geometry\";\r\nimport { IModelReadRpcInterface } from \"@itwin/core-common\";\r\nimport {\r\n  BeButton, BeButtonEvent, Cluster, DecorateContext, IModelApp, InputSource, Marker, MarkerImage, MarkerSet, ScreenViewport, ViewClipTool,\r\n} from \"@itwin/core-frontend\";\r\nimport { SectionDrawingLocationState } from \"./SectionDrawingLocationState\";\r\nimport { HyperModeling } from \"./HyperModeling\";\r\n\r\nconst markerSize = Point2d.create(40, 40);\r\n\r\n/** A [Marker]($frontend) associated with a [[SectionDrawingLocationState]], displayed as a canvas decoration at the location of the section.\r\n * Clicking on the marker toggles display of the section graphics. Mousing over the marker produces a toolbar with additional interactions.\r\n * @see [[HyperModelingDecorator]] for a [Decorator]($frontend) capable of displaying section markers for each section drawing location.\r\n * @see [[SectionMarkerHandler]] to customize the marker interactions.\r\n * @public\r\n */\r\nexport class SectionMarker extends Marker {\r\n  /** The section drawing location state associated with the marker. */\r\n  public readonly state: SectionDrawingLocationState;\r\n  /** A description displayed as part of the tooltip when this marker is clustered with other markers. */\r\n  public readonly description: string;\r\n  /** @internal */\r\n  public readonly onMouseEnterEvent = new BeEvent<(marker: SectionMarker) => void>();\r\n  /** @internal */\r\n  public readonly onMouseButtonEvent = new BeEvent<(marker: SectionMarker) => void>();\r\n  /** @internal */\r\n  private _isActive = false;\r\n\r\n  /** Constructor, typically invoked indirectly via [[HyperModelingDecorator]].\r\n   * @param state The section drawing location state this marker will represent.\r\n   * @param pos The world coordinates at which to display the marker.\r\n   * @param description A brief description of this marker, used as part of the tooltip when this marker is part of a cluster.\r\n   * @param icon The icon displayed by the marker.\r\n   * @param tooltip Optional detailed tooltip displayed on mouse hover. If undefined, the `description` is used instead.\r\n   */\r\n  public constructor(state: SectionDrawingLocationState) {\r\n    super(state.placement.origin.clone(), markerSize);\r\n    this.state = state;\r\n\r\n    const data = HyperModeling.getMarkerData(state.sectionType);\r\n    this.description = data.label;\r\n    if (data.image)\r\n      this.setImage(data.image);\r\n\r\n    this.setScaleFactor({ low: .2, high: 1.4 }); // make size 20% at back of frustum and 140% at front of frustum (if camera is on)\r\n  }\r\n\r\n  /** @internal */\r\n  public get isHilited(): boolean { return this._isHilited; }\r\n\r\n  /** Returns true if this is the \"active\" section marker. At most one marker is active at a given time.\r\n   * @see [[HyperModelingDecorator.activeMarker]].\r\n   * @see [[HyperModelingDecorator.setActiveMarker]].\r\n   * @see [[SectionMarkerHandler.toggleMarker]].\r\n   */\r\n  public get isActive(): boolean {\r\n    return this._isActive;\r\n  }\r\n\r\n  /** @internal */\r\n  public setActive(active: boolean): void {\r\n    this._isActive = active;\r\n  }\r\n\r\n  /** @internal */\r\n  protected drawActive(ctx: CanvasRenderingContext2D) {\r\n    ctx.shadowBlur = 30;\r\n    ctx.shadowColor = \"gold\";\r\n    return false;\r\n  }\r\n\r\n  /** @internal */\r\n  public override drawDecoration(ctx: CanvasRenderingContext2D): void {\r\n    if (!this.isActive || !this.drawActive(ctx))\r\n      super.drawDecoration(ctx);\r\n  }\r\n\r\n  /** @internal */\r\n  public override onMouseEnter(ev: BeButtonEvent) {\r\n    // Lazily load the tooltip.\r\n    if (undefined === this.title) {\r\n      IModelReadRpcInterface.getClientForRouting(this.state.iModel.routingContext.token).getToolTipMessage(this.state.iModel.getRpcProps(), this.state.id).then((tooltipMsg) => {\r\n        this.title = IModelApp.formatElementToolTip(tooltipMsg);\r\n      }).catch((_) => {\r\n        this.title = this.description;\r\n      });\r\n    }\r\n\r\n    super.onMouseEnter(ev);\r\n    this.onMouseEnterEvent.raiseEvent(this);\r\n  }\r\n\r\n  /** @internal */\r\n  public override onMouseButton(ev: BeButtonEvent): boolean {\r\n    if (InputSource.Mouse === ev.inputSource && BeButton.Data === ev.button && ev.isDown && ev.viewport)\r\n      this.onMouseButtonEvent.raiseEvent(this);\r\n\r\n    return true; // Don't allow clicks to be sent to active tool...\r\n  }\r\n\r\n  /** @internal */\r\n  public override addMarker(context: DecorateContext) {\r\n    super.addMarker(context);\r\n    if (this.isHilited)\r\n      ViewClipTool.drawClip(context, this.state.clip, undefined, { fillClipPlanes: true, hasPrimaryPlane: true });\r\n  }\r\n}\r\n\r\n/** A Marker used to show a cluster of section locations.\r\n * @internal\r\n */\r\nexport class SectionMarkerCluster extends Marker {\r\n  /** Create a new cluster marker */\r\n  constructor(location: XYAndZ, size: XAndY, cluster: Cluster<SectionMarker>, image: Promise<MarkerImage>) {\r\n    super(location, size);\r\n\r\n    this.imageOffset = new Point3d(0, 30);\r\n    this.label = cluster.markers.length.toLocaleString();\r\n    this.labelColor = \"black\";\r\n    this.labelFont = \"bold 14px sans-serif\";\r\n\r\n    const maxLen = 10;\r\n    let title = \"\";\r\n    cluster.markers.forEach((marker, index: number) => {\r\n      if (index < maxLen) {\r\n        if (title !== \"\")\r\n          title += \"<br>\";\r\n        title += marker.description;\r\n      }\r\n    });\r\n\r\n    if (cluster.markers.length > maxLen)\r\n      title += \"<br>...\";\r\n\r\n    const div = document.createElement(\"div\");\r\n    div.innerHTML = title;\r\n    this.title = div;\r\n    this.setImage(image);\r\n  }\r\n\r\n  /** Show the cluster as a white circle with an outline */\r\n  public override drawFunc(ctx: CanvasRenderingContext2D): void {\r\n    ctx.beginPath();\r\n    ctx.strokeStyle = \"#372528\";\r\n    ctx.fillStyle = \"white\";\r\n    ctx.lineWidth = 5;\r\n    ctx.arc(0, 0, 13, 0, Math.PI * 2);\r\n    ctx.fill();\r\n    ctx.stroke();\r\n  }\r\n\r\n  public override onMouseButton(_ev: BeButtonEvent): boolean { return true; } // Don't allow clicks to be sent to active tool...\r\n}\r\n\r\n/** A [MarkerSet]($frontend) containing [[SectionMarker]]s identifying [SectionDrawingLocation]($backend)s within a spatial view.\r\n * Typically used indirectly via [[HyperModelingDecorator]].\r\n * @public\r\n */\r\nexport class SectionMarkerSet extends MarkerSet<SectionMarker> {\r\n  public override minimumClusterSize = 5;\r\n\r\n  /** Constructor\r\n   * @param viewport The viewport in which the markers are to be displayed.\r\n   * @param markers The markers to be displayed.\r\n   * @note Each marker's [[SectionDrawingLocationState]] must be associated with the same [IModelConnection]($frontend) as the viewport; any markers from other iModels will be omitted.\r\n   */\r\n  public constructor(viewport: ScreenViewport, markers: SectionMarker[]) {\r\n    super(viewport);\r\n    for (const marker of markers) {\r\n      if (marker.state.iModel === viewport.iModel)\r\n        this.markers.add(marker);\r\n    }\r\n  }\r\n\r\n  /** The viewport in which the markers are to be displayed. */\r\n  public override get viewport(): ScreenViewport {\r\n    assert(undefined !== super.viewport);\r\n    return super.viewport;\r\n  }\r\n\r\n  /** @internal */\r\n  protected getClusterMarker(cluster: Cluster<SectionMarker>): Marker {\r\n    return SectionMarkerCluster.makeFrom(cluster.markers[0], cluster, cluster.markers[0].image);\r\n  }\r\n\r\n  /** Find the SectionMarker corresponding to the specified [SectionDrawingLocation]($backend) Id. */\r\n  public findMarkerById(sectionDrawingLocationId: Id64String): SectionMarker | undefined {\r\n    for (const marker of this.markers)\r\n      if (marker.state.id === sectionDrawingLocationId)\r\n        return marker;\r\n\r\n    return undefined;\r\n  }\r\n}\r\n"]}

package/lib/Tools.d.ts

@@ -0,0 +1,7 @@
+/** @packageDocumentation
+ * @module HyperModeling
+ */
+import { I18N, I18NNamespace } from "@itwin/core-i18n";
+/** @internal */
+export declare function registerTools(namespace: I18NNamespace | undefined, i18n: I18N): void;
+//# sourceMappingURL=Tools.d.ts.map

package/lib/Tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tools.d.ts","sourceRoot":"","sources":["../src/Tools.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EACL,IAAI,EACJ,aAAa,EACd,MAAM,kBAAkB,CAAC;AA2L1B,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAMpF"}

package/lib/Tools.js

@@ -0,0 +1,171 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module HyperModeling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTools = void 0;
+const core_common_1 = require("@itwin/core-common");
+const core_frontend_1 = require("@itwin/core-frontend");
+const HyperModeling_1 = require("./HyperModeling");
+const HyperModelingDecorator_1 = require("./HyperModelingDecorator");
+/** Parses a string case-insensitively returning true for "ON", false for "OFF", undefined for "TOGGLE" or undefined, and the input string for anything else. */
+function parseToggle(arg) {
+    if (undefined === arg)
+        return undefined;
+    switch (arg.toLowerCase()) {
+        case "on": return true;
+        case "off": return false;
+        case "toggle": return undefined;
+        default: return arg;
+    }
+}
+class HyperModelingTool extends core_frontend_1.Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 1; }
+    async run(enable, vp) {
+        vp = vp !== null && vp !== void 0 ? vp : core_frontend_1.IModelApp.viewManager.selectedView;
+        if (vp)
+            await HyperModeling_1.HyperModeling.startOrStop(vp, enable);
+        return true;
+    }
+    async parseAndRun(...args) {
+        const enable = parseToggle(args[0]);
+        return typeof enable !== "string" && this.run(enable);
+    }
+}
+HyperModelingTool.toolId = "HyperModeling";
+/** Configures how section graphics are displayed. These are global settings. If no arguments are supplied, the defaults are restored.
+ * Otherwise, each argument is of the form "name=value" where value is 0 (disable) or 1 (enable). Only the first letter of each argument matters.
+ *  - drawings: Whether to display the section drawing graphics. Default: 1.
+ *  - sheets: Whether to display the sheet annotation graphics. Default: 1.
+ *  - clip: Whether to apply clip volumes to the 2d graphics. Default: 1.
+ *  - boundaries: Whether to display clip volumes as boundary shapes for debugging purposes. Default: 0.
+ */
+class SectionGraphicsConfigTool extends core_frontend_1.Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 4; }
+    async run(config) {
+        if (!config) {
+            config = {
+                ignoreClip: false,
+                debugClipVolumes: false,
+                hideSectionGraphics: false,
+                hideSheetAnnotations: false,
+            };
+        }
+        HyperModeling_1.HyperModeling.updateConfiguration({ graphics: config });
+        return true;
+    }
+    async parseAndRun(...args) {
+        if (0 === args.length)
+            return this.run(); // restore defaults...
+        const config = {};
+        for (const arg of args) {
+            const parts = arg.toLowerCase().split("=");
+            if (2 !== parts.length)
+                continue;
+            const value = Number.parseInt(parts[1], 10);
+            if (Number.isNaN(value) || (0 !== value && 1 !== value))
+                continue;
+            const enable = 1 === value;
+            switch (parts[0][0]) {
+                case "d":
+                    config.hideSectionGraphics = !enable;
+                    break;
+                case "s":
+                    config.hideSheetAnnotations = !enable;
+                    break;
+                case "c":
+                    config.ignoreClip = !enable;
+                    break;
+                case "b":
+                    config.debugClipVolumes = enable;
+                    break;
+            }
+        }
+        return this.run(config);
+    }
+}
+SectionGraphicsConfigTool.toolId = "HyperModeling.Graphics.Config";
+class SectionMarkerConfigTool extends core_frontend_1.Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 3; }
+    async run(config) {
+        config = config !== null && config !== void 0 ? config : { ignoreModelSelector: false, ignoreCategorySelector: false, hiddenSectionTypes: [] };
+        this.update(config);
+        return true;
+    }
+    async parseAndRun(...args) {
+        if (0 === args.length)
+            return this.run(); // restore defaults...
+        const config = {};
+        for (const arg of args) {
+            const parts = arg.toLowerCase().split("=");
+            if (2 !== parts.length)
+                continue;
+            const setting = parts[0][0];
+            switch (setting) {
+                case "h": {
+                    config.hiddenSectionTypes = [];
+                    for (const c of parts[1]) {
+                        switch (c) {
+                            case "s":
+                                config.hiddenSectionTypes.push(core_common_1.SectionType.Section);
+                                break;
+                            case "d":
+                                config.hiddenSectionTypes.push(core_common_1.SectionType.Detail);
+                                break;
+                            case "e":
+                                config.hiddenSectionTypes.push(core_common_1.SectionType.Elevation);
+                                break;
+                            case "p":
+                                config.hiddenSectionTypes.push(core_common_1.SectionType.Plan);
+                                break;
+                        }
+                    }
+                    break;
+                }
+                default: {
+                    const intVal = Number.parseInt(parts[1], 10);
+                    if (!Number.isNaN(intVal) && (0 === intVal || 1 === intVal)) {
+                        if ("c" === setting)
+                            config.ignoreCategorySelector = 0 === intVal;
+                        else if ("m" === setting)
+                            config.ignoreModelSelector = 0 === intVal;
+                    }
+                    break;
+                }
+            }
+        }
+        return this.run(config);
+    }
+}
+class SectionMarkerDefaultConfigTool extends SectionMarkerConfigTool {
+    update(config) {
+        HyperModeling_1.HyperModeling.updateConfiguration({ markers: config });
+    }
+}
+SectionMarkerDefaultConfigTool.toolId = "HyperModeling.Marker.Default.Config";
+class SectionMarkerDecoratorConfigTool extends SectionMarkerConfigTool {
+    update(config) {
+        const vp = core_frontend_1.IModelApp.viewManager.selectedView;
+        const decorator = vp ? HyperModelingDecorator_1.HyperModelingDecorator.getForViewport(vp) : undefined;
+        if (decorator)
+            decorator.updateConfiguration(config);
+    }
+}
+SectionMarkerDecoratorConfigTool.toolId = "HyperModeling.Marker.Config";
+/** @internal */
+function registerTools(namespace, i18n) {
+    const register = (tool) => core_frontend_1.IModelApp.tools.register(tool, namespace, i18n);
+    register(HyperModelingTool);
+    register(SectionGraphicsConfigTool);
+    register(SectionMarkerDecoratorConfigTool);
+    register(SectionMarkerDefaultConfigTool);
+}
+exports.registerTools = registerTools;
+//# sourceMappingURL=Tools.js.map

package/lib/Tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tools.js","sourceRoot":"","sources":["../src/Tools.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module HyperModeling\r\n */\r\n\r\nimport { SectionType } from \"@itwin/core-common\";\r\nimport {\r\n  I18N,\r\n  I18NNamespace,\r\n} from \"@itwin/core-i18n\";\r\nimport {\r\n  IModelApp,\r\n  ScreenViewport,\r\n  Tool,\r\n} from \"@itwin/core-frontend\";\r\nimport { HyperModeling } from \"./HyperModeling\";\r\nimport { SectionGraphicsConfig, SectionMarkerConfig } from \"./HyperModelingConfig\";\r\nimport { HyperModelingDecorator } from \"./HyperModelingDecorator\";\r\n\r\n/** Parses a string case-insensitively returning true for \"ON\", false for \"OFF\", undefined for \"TOGGLE\" or undefined, and the input string for anything else. */\r\nfunction parseToggle(arg: string | undefined): string | 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 \"off\": return false;\r\n    case \"toggle\": return undefined;\r\n    default: return arg;\r\n  }\r\n}\r\n\r\nclass HyperModelingTool extends Tool {\r\n  public static override toolId = \"HyperModeling\";\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(enable?: boolean, vp?: ScreenViewport): Promise<boolean> {\r\n    vp = vp ?? IModelApp.viewManager.selectedView;\r\n    if (vp)\r\n      await HyperModeling.startOrStop(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    return typeof enable !== \"string\" && this.run(enable);\r\n  }\r\n}\r\n\r\ntype Writeable<T> = { -readonly [P in keyof T]: T[P] };\r\n\r\n/** Configures how section graphics are displayed. These are global settings. If no arguments are supplied, the defaults are restored.\r\n * Otherwise, each argument is of the form \"name=value\" where value is 0 (disable) or 1 (enable). Only the first letter of each argument matters.\r\n *  - drawings: Whether to display the section drawing graphics. Default: 1.\r\n *  - sheets: Whether to display the sheet annotation graphics. Default: 1.\r\n *  - clip: Whether to apply clip volumes to the 2d graphics. Default: 1.\r\n *  - boundaries: Whether to display clip volumes as boundary shapes for debugging purposes. Default: 0.\r\n */\r\nclass SectionGraphicsConfigTool extends Tool {\r\n  public static override toolId = \"HyperModeling.Graphics.Config\";\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 4; }\r\n\r\n  public override async run(config?: SectionGraphicsConfig): Promise<boolean> {\r\n    if (!config) {\r\n      config = {\r\n        ignoreClip: false,\r\n        debugClipVolumes: false,\r\n        hideSectionGraphics: false,\r\n        hideSheetAnnotations: false,\r\n      };\r\n    }\r\n\r\n    HyperModeling.updateConfiguration({ graphics: config });\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...args: string[]): Promise<boolean> {\r\n    if (0 === args.length)\r\n      return this.run(); // restore defaults...\r\n\r\n    const config: Writeable<SectionGraphicsConfig> = {};\r\n    for (const arg of args) {\r\n      const parts = arg.toLowerCase().split(\"=\");\r\n      if (2 !== parts.length)\r\n        continue;\r\n\r\n      const value = Number.parseInt(parts[1], 10);\r\n      if (Number.isNaN(value) || (0 !== value && 1 !== value))\r\n        continue;\r\n\r\n      const enable = 1 === value;\r\n      switch (parts[0][0]) {\r\n        case \"d\":\r\n          config.hideSectionGraphics = !enable;\r\n          break;\r\n        case \"s\":\r\n          config.hideSheetAnnotations = !enable;\r\n          break;\r\n        case \"c\":\r\n          config.ignoreClip = !enable;\r\n          break;\r\n        case \"b\":\r\n          config.debugClipVolumes = enable;\r\n          break;\r\n      }\r\n    }\r\n\r\n    return this.run(config);\r\n  }\r\n}\r\n\r\nabstract class SectionMarkerConfigTool extends Tool {\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 3; }\r\n\r\n  protected abstract update(config: SectionMarkerConfig): void;\r\n\r\n  public override async run(config?: SectionMarkerConfig): Promise<boolean> {\r\n    config = config ?? { ignoreModelSelector: false, ignoreCategorySelector: false, hiddenSectionTypes: [] };\r\n    this.update(config);\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...args: string[]): Promise<boolean> {\r\n    if (0 === args.length)\r\n      return this.run(); // restore defaults...\r\n\r\n    const config: Writeable<SectionMarkerConfig> = {};\r\n    for (const arg of args) {\r\n      const parts = arg.toLowerCase().split(\"=\");\r\n      if (2 !== parts.length)\r\n        continue;\r\n\r\n      const setting = parts[0][0];\r\n      switch (setting) {\r\n        case \"h\": {\r\n          config.hiddenSectionTypes = [];\r\n          for (const c of parts[1]) {\r\n            switch (c) {\r\n              case \"s\":\r\n                config.hiddenSectionTypes.push(SectionType.Section);\r\n                break;\r\n              case \"d\":\r\n                config.hiddenSectionTypes.push(SectionType.Detail);\r\n                break;\r\n              case \"e\":\r\n                config.hiddenSectionTypes.push(SectionType.Elevation);\r\n                break;\r\n              case \"p\":\r\n                config.hiddenSectionTypes.push(SectionType.Plan);\r\n                break;\r\n            }\r\n          }\r\n\r\n          break;\r\n        }\r\n        default: {\r\n          const intVal = Number.parseInt(parts[1], 10);\r\n          if (!Number.isNaN(intVal) && (0 === intVal || 1 === intVal)) {\r\n            if (\"c\" === setting)\r\n              config.ignoreCategorySelector = 0 === intVal;\r\n            else if (\"m\" === setting)\r\n              config.ignoreModelSelector = 0 === intVal;\r\n          }\r\n\r\n          break;\r\n        }\r\n      }\r\n    }\r\n\r\n    return this.run(config);\r\n  }\r\n}\r\n\r\nclass SectionMarkerDefaultConfigTool extends SectionMarkerConfigTool {\r\n  public static override toolId = \"HyperModeling.Marker.Default.Config\";\r\n\r\n  protected update(config: SectionMarkerConfig): void {\r\n    HyperModeling.updateConfiguration({ markers: config });\r\n  }\r\n}\r\n\r\nclass SectionMarkerDecoratorConfigTool extends SectionMarkerConfigTool {\r\n  public static override toolId = \"HyperModeling.Marker.Config\";\r\n\r\n  protected update(config: SectionMarkerConfig): void {\r\n    const vp = IModelApp.viewManager.selectedView;\r\n    const decorator = vp ? HyperModelingDecorator.getForViewport(vp) : undefined;\r\n    if (decorator)\r\n      decorator.updateConfiguration(config);\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport function registerTools(namespace: I18NNamespace | undefined, i18n: I18N): void {\r\n  const register = (tool: typeof Tool) => IModelApp.tools.register(tool, namespace, i18n);\r\n  register(HyperModelingTool);\r\n  register(SectionGraphicsConfigTool);\r\n  register(SectionMarkerDecoratorConfigTool);\r\n  register(SectionMarkerDefaultConfigTool);\r\n}\r\n"]}