@itwin/core-frontend 5.12.0-dev.6 → 5.12.0-dev.7

package/lib/cjs/tools/AccuDrawTool.js

@@ -7,7 +7,7 @@
  * @module Tools
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefineACSByPointsTool = exports.DefineACSByElementTool = exports.AccuDrawRotateElementTool = exports.AccuDrawRotateAxesTool = exports.AccuDrawRotate90AboutZTool = exports.AccuDrawRotate90AboutYTool = exports.AccuDrawRotate90AboutXTool = exports.AccuDrawRotateViewTool = exports.AccuDrawRotateSideTool = exports.AccuDrawRotateFrontTool = exports.AccuDrawRotateTopTool = exports.AccuDrawRotateCycleTool = exports.AccuDrawChangeModeTool = exports.AccuDrawSetLockAngleTool = exports.AccuDrawSetLockDistanceTool = exports.AccuDrawSetLockZTool = exports.AccuDrawSetLockYTool = exports.AccuDrawSetLockXTool = exports.AccuDrawSetLockIndexTool = exports.AccuDrawSetLockSmartTool = exports.AccuDrawSetOriginTool = exports.AccuDrawSuspendToggleTool = exports.AccuDrawSessionToggleTool = exports.AccuDrawShortcuts = void 0;
+exports.DefineACSByPointsTool = exports.DefineACSByElementTool = exports.AccuDrawRotatePointsTool = exports.AccuDrawRotateElementTool = exports.AccuDrawRotateAxesTool = exports.AccuDrawRotate90AboutZTool = exports.AccuDrawRotate90AboutYTool = exports.AccuDrawRotate90AboutXTool = exports.AccuDrawRotateViewTool = exports.AccuDrawRotateSideTool = exports.AccuDrawRotateFrontTool = exports.AccuDrawRotateTopTool = exports.AccuDrawRotateCycleTool = exports.AccuDrawChangeModeTool = exports.AccuDrawSetLockAngleTool = exports.AccuDrawSetLockDistanceTool = exports.AccuDrawSetLockZTool = exports.AccuDrawSetLockYTool = exports.AccuDrawSetLockXTool = exports.AccuDrawSetLockIndexTool = exports.AccuDrawSetLockSmartTool = exports.AccuDrawSetOriginTool = exports.AccuDrawSuspendToggleTool = exports.AccuDrawSessionToggleTool = exports.AccuDrawShortcuts = void 0;
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_geometry_1 = require("@itwin/core-geometry");
 const AccuDraw_1 = require("../AccuDraw");
@@ -16,6 +16,7 @@ const AuxCoordSys_1 = require("../AuxCoordSys");
 const IModelApp_1 = require("../IModelApp");
 const Tool_1 = require("./Tool");
 const AccuDrawShortcutTool_1 = require("./AccuDrawShortcutTool");
+const GraphicType_1 = require("../common/render/GraphicType");
 // cSpell:ignore dont unlockedz
 function normalizedDifference(point1, point2, out) {
     return point2.vectorTo(point1).normalizeWithLength(out).mag;
@@ -78,15 +79,13 @@ class AccuDrawShortcuts {
     }
     static updateACSByPoints(acs, vp, points, isDynamics) {
         const accudraw = IModelApp_1.IModelApp.accuDraw;
-        if (!accudraw.isEnabled)
-            return false;
         let accept = false;
         const vec = [new core_geometry_1.Vector3d(), new core_geometry_1.Vector3d(), new core_geometry_1.Vector3d()];
         acs.setOrigin(points[0]);
         switch (points.length) {
             case 1:
                 acs.setRotation(vp.rotation);
-                if (!isDynamics) {
+                if (!isDynamics && accudraw.isEnabled) {
                     accudraw.published.origin.setFrom(points[0]);
                     accudraw.published.flags = AccuDraw_1.AccuDrawFlags.SetOrigin;
                     accudraw.flags.fixedOrg = true;
@@ -98,7 +97,7 @@ class AccuDrawShortcuts {
                     break;
                 }
                 if (vp.view.is3d()) {
-                    if (normalizedCrossProduct(accudraw.axes.y, vec[0], vec[1]) < 0.00001) {
+                    if (accudraw.isEnabled && normalizedCrossProduct(accudraw.axes.y, vec[0], vec[1]) < 0.00001) {
                         vec[2].set(0.0, 0.0, 1.0);
                         if (normalizedCrossProduct(vec[2], vec[0], vec[1]) < 0.00001) {
                             vec[2].set(0.0, 1.0, 0.0);
@@ -107,7 +106,7 @@ class AccuDrawShortcuts {
                     }
                     normalizedCrossProduct(vec[0], vec[1], vec[2]);
                     acs.setRotation(core_geometry_1.Matrix3d.createRows(vec[0], vec[1], vec[2]));
-                    if (!isDynamics) {
+                    if (!isDynamics && accudraw.isEnabled) {
                         accudraw.published.origin.setFrom(points[0]);
                         accudraw.published.flags = AccuDraw_1.AccuDrawFlags.SetOrigin | AccuDraw_1.AccuDrawFlags.SetNormal;
                         accudraw.published.vector.setFrom(vec[0]);
@@ -829,7 +828,11 @@ class AccuDrawShortcuts {
     }
 }
 exports.AccuDrawShortcuts = AccuDrawShortcuts;
-/** @beta */
+/**
+ * Immediate tool to toggle AccuDraw's availability for the current session.
+ * @note AccuDraw is enabled by default
+ * @beta
+ */
 class AccuDrawSessionToggleTool extends Tool_1.Tool {
     static toolId = "AccuDraw.SessionToggle";
     async run() {
@@ -838,7 +841,11 @@ class AccuDrawSessionToggleTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawSessionToggleTool = AccuDrawSessionToggleTool;
-/** @beta */
+/**
+ * Immediate tool to toggle AccuDraw on/off temporarily for the current interactive tool.
+ * @note Typically used to disable AccuDraw for a single data button.
+ * @beta
+ */
 class AccuDrawSuspendToggleTool extends Tool_1.Tool {
     static toolId = "AccuDraw.SuspendToggle";
     async run() {
@@ -847,7 +854,11 @@ class AccuDrawSuspendToggleTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawSuspendToggleTool = AccuDrawSuspendToggleTool;
-/** @beta */
+/**
+ * Immediate tool to enable AccuDraw and position it at the current AccuSnap or Tentative snap location.
+ * @note When not snapped, AccuDraw is activated at the last data button location when inactive, or moved to the current cursor location when active.
+ * @beta
+ */
 class AccuDrawSetOriginTool extends Tool_1.Tool {
     static toolId = "AccuDraw.SetOrigin";
     async run() {
@@ -856,7 +867,11 @@ class AccuDrawSetOriginTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawSetOriginTool = AccuDrawSetOriginTool;
-/** @beta */
+/**
+ * Immediate tool to lock the closer of the x or y axis based on the current cursor location.
+ * @note When an axis is locked, points are projected onto the axis line.
+ * @beta
+ */
 class AccuDrawSetLockSmartTool extends Tool_1.Tool {
     static toolId = "AccuDraw.LockSmart";
     async run() {
@@ -865,7 +880,10 @@ class AccuDrawSetLockSmartTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawSetLockSmartTool = AccuDrawSetLockSmartTool;
-/** @beta */
+/**
+ * Immediate tool to toggle the locked state of an indexed axis of the AccuDraw compass.
+ * @beta
+ */
 class AccuDrawSetLockIndexTool extends Tool_1.Tool {
     static toolId = "AccuDraw.LockIndex";
     async run() {
@@ -874,7 +892,10 @@ class AccuDrawSetLockIndexTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawSetLockIndexTool = AccuDrawSetLockIndexTool;
-/** @beta */
+/**
+ * Immediate tool to toggle the locked state of the X text field.
+ * @beta
+ */
 class AccuDrawSetLockXTool extends Tool_1.Tool {
     static toolId = "AccuDraw.LockX";
     async run() {
@@ -883,7 +904,10 @@ class AccuDrawSetLockXTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawSetLockXTool = AccuDrawSetLockXTool;
-/** @beta */
+/**
+ * Immediate tool to toggle the locked state of the Y text field.
+ * @beta
+ */
 class AccuDrawSetLockYTool extends Tool_1.Tool {
     static toolId = "AccuDraw.LockY";
     async run() {
@@ -892,7 +916,10 @@ class AccuDrawSetLockYTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawSetLockYTool = AccuDrawSetLockYTool;
-/** @beta */
+/**
+ * Immediate tool to toggle the locked state of the Z text field.
+ * @beta
+ */
 class AccuDrawSetLockZTool extends Tool_1.Tool {
     static toolId = "AccuDraw.LockZ";
     async run() {
@@ -901,7 +928,10 @@ class AccuDrawSetLockZTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawSetLockZTool = AccuDrawSetLockZTool;
-/** @beta */
+/**
+ * Immediate tool to toggle the locked state of the Distance text field.
+ * @beta
+ */
 class AccuDrawSetLockDistanceTool extends Tool_1.Tool {
     static toolId = "AccuDraw.LockDistance";
     async run() {
@@ -910,7 +940,10 @@ class AccuDrawSetLockDistanceTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawSetLockDistanceTool = AccuDrawSetLockDistanceTool;
-/** @beta */
+/**
+ * Immediate tool to toggle the locked state of the Angle text field.
+ * @beta
+ */
 class AccuDrawSetLockAngleTool extends Tool_1.Tool {
     static toolId = "AccuDraw.LockAngle";
     async run() {
@@ -919,7 +952,10 @@ class AccuDrawSetLockAngleTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawSetLockAngleTool = AccuDrawSetLockAngleTool;
-/** @beta */
+/**
+ * Immediate tool to toggle between polar and rectangular compass modes.
+ * @beta
+ */
 class AccuDrawChangeModeTool extends Tool_1.Tool {
     static toolId = "AccuDraw.ChangeMode";
     async run() {
@@ -928,7 +964,10 @@ class AccuDrawChangeModeTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawChangeModeTool = AccuDrawChangeModeTool;
-/** @beta */
+/**
+ * Immediate tool to cycle between XY, XZ, and YZ planes for the current AccuDraw rotation.
+ * @beta
+ */
 class AccuDrawRotateCycleTool extends Tool_1.Tool {
     static toolId = "AccuDraw.RotateCycle";
     async run() {
@@ -937,7 +976,11 @@ class AccuDrawRotateCycleTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawRotateCycleTool = AccuDrawRotateCycleTool;
-/** @beta */
+/**
+ * Immediate tool to set the AccuDraw rotation to a standard Top view.
+ * @note When IModelApp.toolAdmin.acsContextLock is true, rotation is set relative to the view's ACS.
+ * @beta
+ */
 class AccuDrawRotateTopTool extends Tool_1.Tool {
     static toolId = "AccuDraw.RotateTop";
     async run() {
@@ -946,7 +989,11 @@ class AccuDrawRotateTopTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawRotateTopTool = AccuDrawRotateTopTool;
-/** @beta */
+/**
+ * Immediate tool to set the AccuDraw rotation to a standard Front view.
+ * @note When IModelApp.toolAdmin.acsContextLock is true, rotation is set relative to the view's ACS.
+ * @beta
+ */
 class AccuDrawRotateFrontTool extends Tool_1.Tool {
     static toolId = "AccuDraw.RotateFront";
     async run() {
@@ -955,7 +1002,11 @@ class AccuDrawRotateFrontTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawRotateFrontTool = AccuDrawRotateFrontTool;
-/** @beta */
+/**
+ * Immediate tool to set the AccuDraw rotation to a standard Side view.
+ * @note When IModelApp.toolAdmin.acsContextLock is true, rotation is set relative to the view's ACS.
+ * @beta
+ */
 class AccuDrawRotateSideTool extends Tool_1.Tool {
     static toolId = "AccuDraw.RotateSide";
     async run() {
@@ -964,7 +1015,10 @@ class AccuDrawRotateSideTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawRotateSideTool = AccuDrawRotateSideTool;
-/** @beta */
+/**
+ * Immediate tool to set the AccuDraw rotation to match the rotation of the current view.
+ * @beta
+ */
 class AccuDrawRotateViewTool extends Tool_1.Tool {
     static toolId = "AccuDraw.RotateView";
     async run() {
@@ -973,7 +1027,10 @@ class AccuDrawRotateViewTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawRotateViewTool = AccuDrawRotateViewTool;
-/** @beta */
+/**
+ * Immediate tool to set the AccuDraw rotation to be a 90 degree rotation about the current x axis.
+ * @beta
+ */
 class AccuDrawRotate90AboutXTool extends Tool_1.Tool {
     static toolId = "AccuDraw.Rotate90AboutX";
     async run() {
@@ -982,7 +1039,10 @@ class AccuDrawRotate90AboutXTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawRotate90AboutXTool = AccuDrawRotate90AboutXTool;
-/** @beta */
+/**
+ * Immediate tool to set the AccuDraw rotation to be a 90 degree rotation about the current y axis.
+ * @beta
+ */
 class AccuDrawRotate90AboutYTool extends Tool_1.Tool {
     static toolId = "AccuDraw.Rotate90AboutY";
     async run() {
@@ -991,7 +1051,10 @@ class AccuDrawRotate90AboutYTool extends Tool_1.Tool {
     }
 }
 exports.AccuDrawRotate90AboutYTool = AccuDrawRotate90AboutYTool;
-/** @beta */
+/**
+ * Immediate tool to set the AccuDraw rotation to be a 90 degree rotation about the current z axis.
+ * @beta
+ */
 class AccuDrawRotate90AboutZTool extends Tool_1.Tool {
     static toolId = "AccuDraw.Rotate90AboutZ";
     async run() {
@@ -1038,7 +1101,11 @@ class RotateAxesImplementation extends AccuDrawShortcutTool_1.AccuDrawShortcutIm
         return true;
     }
 }
-/** @beta */
+/**
+ * Interactive tool to set the AccuDraw rotation by rotating about the current z axis to a point on the x axis.
+ * @note When AccuSnap or Tentative snap is active, the snap point is immediately used to define the x axis and not further input is required.
+ * @beta
+ */
 class AccuDrawRotateAxesTool extends AccuDrawShortcutTool_1.AccuDrawShortcutTool {
     aboutCurrentZ;
     static toolId = "AccuDraw.RotateAxes";
@@ -1104,7 +1171,10 @@ class RotateElementImplementation extends AccuDrawShortcutTool_1.AccuDrawShortcu
         return true;
     }
 }
-/** @beta */
+/**
+ * Interactive tool to set the AccuDraw rotation using the snapped to geometry under the cursor.
+ * @beta
+ */
 class AccuDrawRotateElementTool extends AccuDrawShortcutTool_1.AccuDrawShortcutTool {
     static toolId = "AccuDraw.RotateElement";
     /** @internal */
@@ -1114,6 +1184,125 @@ class AccuDrawRotateElementTool extends AccuDrawShortcutTool_1.AccuDrawShortcutT
 }
 exports.AccuDrawRotateElementTool = AccuDrawRotateElementTool;
 /** @internal */
+class RotatePointsImplementation extends AccuDrawShortcutTool_1.AccuDrawShortcutImplementation {
+    _points = [];
+    _origin = IModelApp_1.IModelApp.tentativePoint.isActive ? IModelApp_1.IModelApp.tentativePoint.getPoint().clone() : undefined;
+    _moveOrigin = !IModelApp_1.IModelApp.accuDraw.isActive || IModelApp_1.IModelApp.tentativePoint.isActive; // Preserve current origin if AccuDraw already active and not tentative snap...
+    _lastPoint;
+    onProvideToolAssistance() {
+        switch (this._points.length) {
+            case 0:
+                Tool_1.CoreTools.outputPromptByKey("AccuDraw.RotatePoints.Prompts.FirstPoint");
+                break;
+            case 1:
+                Tool_1.CoreTools.outputPromptByKey("AccuDraw.RotatePoints.Prompts.SecondPoint");
+                break;
+            default:
+                Tool_1.CoreTools.outputPromptByKey("AccuDraw.RotatePoints.Prompts.NextPoint");
+                break;
+        }
+    }
+    onInitialize() {
+        if (undefined === this._origin)
+            return;
+        this._points.push(this._origin);
+        IModelApp_1.IModelApp.tentativePoint.clear(true); // Necessary when installed as an InputCollector...
+        IModelApp_1.IModelApp.accuDraw.activate();
+        IModelApp_1.IModelApp.accuDraw.setContext(AccuDraw_1.AccuDrawFlags.SetOrigin | AccuDraw_1.AccuDrawFlags.FixedOrigin, this._origin);
+        IModelApp_1.IModelApp.accuDraw.refreshDecorationsAndDynamics();
+    }
+    onComplete() {
+        let ignoreFlags = AccuDraw_1.AccuDrawFlags.SetRMatrix | AccuDraw_1.AccuDrawFlags.Disable; // If AccuDraw wasn't active when the shortcut started, let it remain active for suspended tool when shortcut completes...
+        if (this._moveOrigin)
+            ignoreFlags |= AccuDraw_1.AccuDrawFlags.SetOrigin;
+        return ignoreFlags;
+    }
+    doManipulation(ev, isMotion) {
+        if (!ev || !ev.viewport)
+            return false;
+        IModelApp_1.IModelApp.viewManager.invalidateDecorationsAllViews();
+        if (isMotion) {
+            this._lastPoint = ev.point.clone();
+            return false;
+        }
+        const accuDraw = IModelApp_1.IModelApp.accuDraw;
+        accuDraw.activate();
+        switch (this._points.length) {
+            case 0: {
+                this._points.push(ev.point.clone());
+                accuDraw.setContext(AccuDraw_1.AccuDrawFlags.SetOrigin | AccuDraw_1.AccuDrawFlags.FixedOrigin, this._points[0]);
+                break;
+            }
+            case 1: {
+                const xVec = core_geometry_1.Vector3d.createNormalizedStartEnd(this._points[0], ev.point);
+                if (undefined === xVec)
+                    return false;
+                if (!ev.viewport.view.is3d() || !ev.viewport.view.allow3dManipulations()) {
+                    accuDraw.setContext(AccuDraw_1.AccuDrawFlags.SetOrigin | AccuDraw_1.AccuDrawFlags.SetXAxis, this._points[0], xVec);
+                    return true; // Complete
+                }
+                this._points.push(ev.point.clone());
+                accuDraw.setContext(AccuDraw_1.AccuDrawFlags.SetOrigin | AccuDraw_1.AccuDrawFlags.FixedOrigin | AccuDraw_1.AccuDrawFlags.SetNormal, this._points[0], xVec);
+                break;
+            }
+            case 2: {
+                const xVec = core_geometry_1.Vector3d.createNormalizedStartEnd(this._points[0], this._points[1]);
+                if (undefined === xVec)
+                    return false;
+                const yVec = core_geometry_1.Vector3d.createNormalizedStartEnd(this._points[0], ev.point);
+                if (undefined === yVec)
+                    return false;
+                const matrix = core_geometry_1.Matrix3d.createRigidFromColumns(xVec, yVec, core_geometry_1.AxisOrder.XYZ);
+                if (undefined === matrix)
+                    return false;
+                const invMatrix = matrix.inverse();
+                if (undefined === invMatrix)
+                    return false;
+                accuDraw.setContext(AccuDraw_1.AccuDrawFlags.SetOrigin | AccuDraw_1.AccuDrawFlags.SetRMatrix, this._points[0], invMatrix);
+                return true; // Complete
+            }
+        }
+        this.onProvideToolAssistance();
+        return false;
+    }
+    doDecorate(context) {
+        if (0 === this._points.length)
+            return;
+        const currentPoint = this._lastPoint;
+        if (undefined === currentPoint)
+            return;
+        if (2 === this._points.length) {
+            const xVec = core_geometry_1.Vector3d.createNormalizedStartEnd(this._points[0], this._points[1]);
+            if (undefined === xVec)
+                return;
+            const plane = core_geometry_1.Plane3dByOriginAndUnitNormal.create(this._points[0], xVec);
+            if (undefined === plane)
+                return;
+            plane.projectPointToPlane(currentPoint, currentPoint);
+        }
+        const tmpPoints = this._points.slice(0, 1);
+        tmpPoints.push(currentPoint);
+        const vp = context.viewport;
+        const color = vp.getContrastToBackgroundColor();
+        const builder = context.createGraphicBuilder(GraphicType_1.GraphicType.WorldOverlay);
+        builder.setSymbology(color, color, 2);
+        builder.addLineString(tmpPoints);
+        context.addDecorationFromBuilder(builder);
+    }
+}
+/**
+ * Interactive tool to set the AccuDraw rotation by 3 points: x axis origin, x axis direction, and y axis direction.
+ * @beta
+ */
+class AccuDrawRotatePointsTool extends AccuDrawShortcutTool_1.AccuDrawShortcutTool {
+    static toolId = "AccuDraw.RotatePoints";
+    /** @internal */
+    createImplementation() {
+        return new RotatePointsImplementation();
+    }
+}
+exports.AccuDrawRotatePointsTool = AccuDrawRotatePointsTool;
+/** @internal */
 class DefineACSByElementImplementation extends AccuDrawShortcutTool_1.AccuDrawShortcutImplementation {
     _origin = core_geometry_1.Point3d.create();
     _rMatrix = core_geometry_1.Matrix3d.createIdentity();
@@ -1156,7 +1345,10 @@ class DefineACSByElementImplementation extends AccuDrawShortcutTool_1.AccuDrawSh
         this._acs.display(context, AuxCoordSys_1.ACSDisplayOptions.Active | AuxCoordSys_1.ACSDisplayOptions.Dynamics);
     }
 }
-/** @beta */
+/**
+ * Interactive tool to set the view's ACS rotation by 3 points: x axis origin, x axis direction, and y axis direction/
+ * @beta
+ */
 class DefineACSByElementTool extends AccuDrawShortcutTool_1.AccuDrawShortcutTool {
     static toolId = "AccuDraw.DefineACSByElement";
     /** @internal */
@@ -1170,6 +1362,7 @@ class DefineACSByPointsImplementation extends AccuDrawShortcutTool_1.AccuDrawSho
     _points = [];
     _acs;
     _origin = IModelApp_1.IModelApp.tentativePoint.isActive ? IModelApp_1.IModelApp.tentativePoint.getPoint().clone() : undefined;
+    _lastPoint;
     onProvideToolAssistance() {
         switch (this._points.length) {
             case 0:
@@ -1186,16 +1379,20 @@ class DefineACSByPointsImplementation extends AccuDrawShortcutTool_1.AccuDrawSho
     onInitialize() {
         if (undefined === this._origin)
             return;
-        IModelApp_1.IModelApp.accuDraw.setContext(AccuDraw_1.AccuDrawFlags.SetOrigin | AccuDraw_1.AccuDrawFlags.FixedOrigin, this._origin);
         this._points.push(this._origin);
         IModelApp_1.IModelApp.tentativePoint.clear(true); // Necessary when installed as an InputCollector...
+        IModelApp_1.IModelApp.accuDraw.activate();
+        IModelApp_1.IModelApp.accuDraw.setContext(AccuDraw_1.AccuDrawFlags.SetOrigin | AccuDraw_1.AccuDrawFlags.FixedOrigin, this._origin);
+        IModelApp_1.IModelApp.accuDraw.refreshDecorationsAndDynamics();
     }
     doManipulation(ev, isMotion) {
         if (!ev || !ev.viewport)
             return false;
         IModelApp_1.IModelApp.viewManager.invalidateDecorationsAllViews();
-        if (isMotion)
+        if (isMotion) {
+            this._lastPoint = ev.point.clone();
             return false;
+        }
         IModelApp_1.IModelApp.accuDraw.activate();
         this._points.push(ev.point.clone());
         const vp = ev.viewport;
@@ -1210,11 +1407,11 @@ class DefineACSByPointsImplementation extends AccuDrawShortcutTool_1.AccuDrawSho
         return false;
     }
     doDecorate(context) {
+        if (undefined === this._lastPoint)
+            return;
         const tmpPoints = [];
         this._points.forEach((pt) => tmpPoints.push(pt));
-        const ev = new Tool_1.BeButtonEvent();
-        IModelApp_1.IModelApp.toolAdmin.fillEventFromCursorLocation(ev);
-        tmpPoints.push(ev.point);
+        tmpPoints.push(this._lastPoint);
         const vp = context.viewport;
         if (!this._acs)
             this._acs = vp.view.auxiliaryCoordinateSystem.clone();
@@ -1222,7 +1419,10 @@ class DefineACSByPointsImplementation extends AccuDrawShortcutTool_1.AccuDrawSho
         this._acs.display(context, AuxCoordSys_1.ACSDisplayOptions.Active | AuxCoordSys_1.ACSDisplayOptions.Dynamics);
     }
 }
-/** @beta */
+/**
+ * Interactive tool to set the view's ACS rotation by 3 points: x axis origin, x axis direction, and y axis direction.
+ * @beta
+ */
 class DefineACSByPointsTool extends AccuDrawShortcutTool_1.AccuDrawShortcutTool {
     static toolId = "AccuDraw.DefineACSByPoints";
     /** @internal */