@itwin/editor-frontend 3.4.0-dev.44 → 3.4.0-dev.47

package/lib/esm/ProjectLocation/ProjectExtentsDecoration.js

@@ -1,814 +1,814 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Editing
- */
-import { BeDuration, BeEvent, BentleyError } from "@itwin/core-bentley";
-import { ColorDef, EcefLocation } from "@itwin/core-common";
-import { BeButton, CoreTools, EditManipulator, EventHandled, GraphicType, IModelApp, MessageBoxIconType, MessageBoxType, MessageBoxValue, NotifyMessageDetails, OutputMessagePriority, QuantityType, Tool, ViewClipControlArrow, ViewClipDecorationProvider, ViewClipShapeModifyTool, ViewClipTool, } from "@itwin/core-frontend";
-import { Angle, Arc3d, AxisIndex, AxisOrder, Constant, Matrix3d, Point3d, PolygonOps, Range1d, Range3d, Ray3d, Transform, Vector3d, } from "@itwin/core-geometry";
-import { editorBuiltInCmdIds } from "@itwin/editor-common";
-import { EditTools } from "../EditTool";
-import { ProjectGeolocationNorthTool, ProjectGeolocationPointTool } from "./ProjectGeolocation";
-function translateMessage(key) { return EditTools.translate(`ProjectLocation:Message.${key}`); }
-function translateMessageBold(key) { return `<b>${translateMessage(key)}:</b> `; }
-function translateCoreMeasureBold(key) { return `<b>${CoreTools.translate(`Measure.Labels.${key}`)}:</b> `; }
-function clearViewClip(vp) {
-    if (!ViewClipTool.doClipClear(vp))
-        return false;
-    ViewClipDecorationProvider.create().onClearClip(vp); // Send clear event...
-    ViewClipDecorationProvider.clear();
-    return true;
-}
-function clipToProjectExtents(vp) {
-    clearViewClip(vp); // Clear any existing view clip and send clear event...
-    ViewClipTool.enableClipVolume(vp);
-    return ViewClipTool.doClipToRange(vp, vp.iModel.projectExtents, Transform.createIdentity());
-}
-function enableBackgroundMap(viewport, onOff) {
-    if (onOff === viewport.viewFlags.backgroundMap)
-        return false;
-    viewport.viewFlags = viewport.viewFlags.with("backgroundMap", onOff);
-    return true;
-}
-function updateMapDisplay(vp, turnOnMap) {
-    if (!turnOnMap || !enableBackgroundMap(vp, true))
-        vp.invalidateRenderPlan();
-}
-class ProjectExtentsControlArrow extends ViewClipControlArrow {
-    constructor() {
-        super(...arguments);
-        this.extentValid = true;
-    }
-}
-/** Values for [[ProjectExtentsClipDecoration.onChanged] event.
- * @beta
- */
-export var ProjectLocationChanged;
-(function (ProjectLocationChanged) {
-    /** Extents has been modified (unsaved changes) */
-    ProjectLocationChanged[ProjectLocationChanged["Extents"] = 0] = "Extents";
-    /** Geolocation has been modified (unsaved changes) */
-    ProjectLocationChanged[ProjectLocationChanged["Geolocation"] = 1] = "Geolocation";
-    /** Abandon unsaved changes to extents */
-    ProjectLocationChanged[ProjectLocationChanged["ResetExtents"] = 2] = "ResetExtents";
-    /** Abandon unsaved changes to geolocation */
-    ProjectLocationChanged[ProjectLocationChanged["ResetGeolocation"] = 3] = "ResetGeolocation";
-    /** Decoration hidden (unsaved changes preserved) */
-    ProjectLocationChanged[ProjectLocationChanged["Hide"] = 4] = "Hide";
-    /** Decoration shown (unsaved changes restored) */
-    ProjectLocationChanged[ProjectLocationChanged["Show"] = 5] = "Show";
-    /** Save changes to extents and geolocation */
-    ProjectLocationChanged[ProjectLocationChanged["Save"] = 6] = "Save";
-})(ProjectLocationChanged || (ProjectLocationChanged = {}));
-/** Controls to modify project extents shown using view clip
- * @beta
- */
-export class ProjectExtentsClipDecoration extends EditManipulator.HandleProvider {
-    constructor(viewport) {
-        super(viewport.iModel);
-        this.viewport = viewport;
-        this._extentsLengthValid = true;
-        this._extentsWidthValid = true;
-        this._extentsHeightValid = true;
-        this._allowEcefLocationChange = false;
-        this._controlIds = [];
-        this._controls = [];
-        this._suspendDecorator = false;
-        this.suspendGeolocationDecorations = false;
-        /** Called when project extents or geolocation is modified */
-        this.onChanged = new BeEvent();
-        if (!this.init())
-            return;
-        this._monumentId = this.iModel.transientIds.next;
-        this._northId = this.iModel.transientIds.next;
-        this._clipId = this.iModel.transientIds.next;
-        this.start();
-    }
-    start() {
-        this.updateDecorationListener(true);
-        this._removeViewCloseListener = IModelApp.viewManager.onViewClose.addListener((vp) => this.onViewClose(vp));
-        this.iModel.selectionSet.replace(this._clipId); // Always select decoration on create...
-    }
-    stop() {
-        const selectedId = (undefined !== this._clipId && this.iModel.selectionSet.has(this._clipId)) ? this._clipId : undefined;
-        this._clipId = undefined; // Invalidate id so that decorator will be dropped...
-        super.stop();
-        if (undefined !== selectedId)
-            this.iModel.selectionSet.remove(selectedId); // Don't leave decorator id in selection set...
-        if (undefined !== this._removeViewCloseListener) {
-            this._removeViewCloseListener();
-            this._removeViewCloseListener = undefined;
-        }
-    }
-    init() {
-        if (!this.getClipData())
-            return false;
-        this._ecefLocation = this.iModel.ecefLocation;
-        this._monumentPoint = this.getMonumentPoint();
-        this._northDirection = this.getNorthDirection();
-        return true;
-    }
-    onViewClose(vp) {
-        if (this.viewport === vp)
-            ProjectExtentsClipDecoration.clear();
-    }
-    getClipData() {
-        this._clip = this._clipShape = this._clipShapeExtents = this._clipRange = undefined;
-        const clip = this.viewport.view.getViewClip();
-        if (undefined === clip)
-            return false;
-        const clipShape = ViewClipTool.isSingleClipShape(clip);
-        if (undefined === clipShape)
-            return false;
-        if (5 !== clipShape.polygon.length || undefined === clipShape.zLow || undefined === clipShape.zHigh)
-            return false; // Not a box, can't be project extents clip...
-        if (undefined !== clipShape.transformFromClip && !clipShape.transformFromClip.isIdentity)
-            return false; // Not axis aligned, can't be project extents clip...
-        this._clipShapeExtents = Range1d.createXX(clipShape.zLow, clipShape.zHigh);
-        this._clipShape = clipShape;
-        this._clip = clip;
-        this._clipRange = Range3d.create();
-        const shapePtsLo = ViewClipTool.getClipShapePoints(this._clipShape, this._clipShapeExtents.low);
-        const shapePtsHi = ViewClipTool.getClipShapePoints(this._clipShape, this._clipShapeExtents.high);
-        this._clipRange.extendArray(shapePtsLo);
-        this._clipRange.extendArray(shapePtsHi);
-        return true;
-    }
-    ensureNumControls(numReqControls) {
-        const numCurrent = this._controlIds.length;
-        if (numCurrent < numReqControls) {
-            const transientIds = this.iModel.transientIds;
-            for (let i = numCurrent; i < numReqControls; i++)
-                this._controlIds[i] = transientIds.next;
-        }
-        else if (numCurrent > numReqControls) {
-            this._controlIds.length = numReqControls;
-        }
-    }
-    createClipShapeControls() {
-        if (undefined === this._clipShape)
-            return false;
-        const shapePtsLo = ViewClipTool.getClipShapePoints(this._clipShape, this._clipShapeExtents.low);
-        const shapePtsHi = ViewClipTool.getClipShapePoints(this._clipShape, this._clipShapeExtents.high);
-        const shapeArea = PolygonOps.centroidAreaNormal(shapePtsLo);
-        if (undefined === shapeArea)
-            return false;
-        const numControls = shapePtsLo.length + 1; // Number of edge midpoints plus zLow and zHigh...
-        this.ensureNumControls(numControls);
-        for (let i = 0; i < numControls - 2; i++) {
-            const midPtLo = shapePtsLo[i].interpolate(0.5, shapePtsLo[i + 1]);
-            const midPtHi = shapePtsHi[i].interpolate(0.5, shapePtsHi[i + 1]);
-            const faceCenter = midPtLo.interpolate(0.5, midPtHi);
-            const edgeTangent = Vector3d.createStartEnd(shapePtsLo[i], shapePtsLo[i + 1]);
-            const faceNormal = edgeTangent.crossProduct(shapeArea.direction);
-            faceNormal.normalizeInPlace();
-            this._controls[i] = new ProjectExtentsControlArrow(faceCenter, faceNormal, 0.75);
-            this._controls[i].extentValid = (faceNormal.isParallelTo(Vector3d.unitX(), true) ? this._extentsLengthValid : this._extentsWidthValid);
-        }
-        const zFillColor = ColorDef.from(150, 150, 250);
-        this._controls[numControls - 2] = new ProjectExtentsControlArrow(shapeArea.origin, Vector3d.unitZ(-1.0), 0.75, zFillColor, undefined, "zLow");
-        this._controls[numControls - 1] = new ProjectExtentsControlArrow(shapeArea.origin.plusScaled(Vector3d.unitZ(), shapePtsLo[0].distance(shapePtsHi[0])), Vector3d.unitZ(), 0.75, zFillColor, undefined, "zHigh");
-        this._controls[numControls - 2].extentValid = this._extentsHeightValid;
-        this._controls[numControls - 1].extentValid = this._extentsHeightValid;
-        return true;
-    }
-    /** Allow project extents for map projections to be larger since curvature of the earth is accounted for. */
-    get maxExtentLength() { return ((this._allowEcefLocationChange ? 20 : 350) * Constant.oneKilometer); }
-    /** Impose some reasonable height limit for project extents. */
-    get maxExtentHeight() { return (2 * Constant.oneKilometer); }
-    hasValidGCS() {
-        if (!this.iModel.isGeoLocated || this.iModel.noGcsDefined)
-            return false;
-        const gcs = this.iModel.geographicCoordinateSystem;
-        if (undefined === gcs || undefined === gcs.horizontalCRS)
-            return false; // A valid GCS ought to have horizontalCR defined...
-        // Check for approximate GCS (such as from MicroStation's "From Placemark" tool) and allow it to be replaced...
-        const hasValidId = (undefined !== gcs.horizontalCRS.id && 0 !== gcs.horizontalCRS.id.length);
-        const hasValidDescr = (undefined !== gcs.horizontalCRS.description && 0 !== gcs.horizontalCRS.description.length);
-        const hasValidProjection = (undefined !== gcs.horizontalCRS.projection && "AzimuthalEqualArea" !== gcs.horizontalCRS.projection.method);
-        return hasValidId || hasValidDescr || hasValidProjection;
-    }
-    async createControls() {
-        // Always update to current view clip to handle post-modify, etc.
-        if (undefined === this._clipId || !this.getClipData())
-            return false;
-        this._allowEcefLocationChange = !this.hasValidGCS();
-        if (undefined !== this._clipRange) {
-            this._extentsLengthValid = (this._clipRange.xLength() < this.maxExtentLength);
-            this._extentsWidthValid = (this._clipRange.yLength() < this.maxExtentLength);
-            this._extentsHeightValid = (this._clipRange.zLength() < this.maxExtentHeight);
-        }
-        // Show controls if only range box and it's controls are selected, selection set doesn't include any other elements...
-        let showControls = false;
-        if (this.iModel.selectionSet.size <= this._controlIds.length + 1 && this.iModel.selectionSet.has(this._clipId)) {
-            showControls = true;
-            if (this.iModel.selectionSet.size > 1) {
-                this.iModel.selectionSet.elements.forEach((val) => {
-                    if (this._clipId !== val && !this._controlIds.includes(val))
-                        showControls = false;
-                });
-            }
-        }
-        if (!showControls)
-            return false; // Don't clear decoration on de-select...
-        return this.createClipShapeControls();
-    }
-    clearControls() {
-        this.iModel.selectionSet.remove(this._controlIds); // Remove any selected controls as they won't continue to be displayed...
-        super.clearControls();
-    }
-    async modifyControls(hit, _ev) {
-        if (undefined === this._clip || hit.sourceId === this._clipId)
-            return false;
-        const saveQualifiers = IModelApp.toolAdmin.currentInputState.qualifiers;
-        if (undefined !== this._clipShape) {
-            const clipShapeModifyTool = new ViewClipShapeModifyTool(this, this._clip, this.viewport, hit.sourceId, this._controlIds, this._controls);
-            this._suspendDecorator = await clipShapeModifyTool.run();
-        }
-        if (this._suspendDecorator)
-            IModelApp.toolAdmin.currentInputState.qualifiers = saveQualifiers; // onInstallTool cleared qualifiers, preserve for "modify all" behavior when shift was held and drag started...
-        return this._suspendDecorator;
-    }
-    async onRightClick(_hit, _ev) { return EventHandled.No; }
-    async onTouchTap(hit, ev) { return (hit.sourceId === this._clipId ? EventHandled.No : super.onTouchTap(hit, ev)); }
-    async onDecorationButtonEvent(hit, ev) {
-        if (hit.sourceId === this._monumentId) {
-            if (BeButton.Data === ev.button && !ev.isDown && !ev.isDragging)
-                await ProjectGeolocationPointTool.startTool();
-            return EventHandled.Yes; // Only pickable for tooltip, don't allow selection...
-        }
-        if (hit.sourceId === this._northId) {
-            if (BeButton.Data === ev.button && !ev.isDown && !ev.isDragging)
-                await ProjectGeolocationNorthTool.startTool();
-            return EventHandled.Yes; // Only pickable for tooltip, don't allow selection...
-        }
-        return super.onDecorationButtonEvent(hit, ev);
-    }
-    onManipulatorEvent(eventType) {
-        if (EditManipulator.EventType.Accept === eventType)
-            this.onChanged.raiseEvent(this.iModel, ProjectLocationChanged.Extents);
-        this._suspendDecorator = false;
-        super.onManipulatorEvent(eventType);
-    }
-    async getDecorationToolTip(hit) {
-        const quantityFormatter = IModelApp.quantityFormatter;
-        const toolTip = document.createElement("div");
-        let toolTipHtml = "";
-        if (hit.sourceId === this._monumentId) {
-            toolTipHtml += `${translateMessage("ModifyGeolocation")}<br>`;
-            const coordFormatterSpec = quantityFormatter.findFormatterSpecByQuantityType(QuantityType.Coordinate);
-            if (undefined !== coordFormatterSpec) {
-                const pointAdjusted = this._monumentPoint.minus(this.iModel.globalOrigin);
-                const formattedPointX = quantityFormatter.formatQuantity(pointAdjusted.x, coordFormatterSpec);
-                const formattedPointY = quantityFormatter.formatQuantity(pointAdjusted.y, coordFormatterSpec);
-                const formattedPointZ = quantityFormatter.formatQuantity(pointAdjusted.z, coordFormatterSpec);
-                toolTipHtml += `${translateCoreMeasureBold("Coordinate") + formattedPointX}, ${formattedPointY}, ${formattedPointZ}<br>`;
-            }
-            const latLongFormatterSpec = quantityFormatter.findFormatterSpecByQuantityType(QuantityType.LatLong);
-            if (undefined !== latLongFormatterSpec && undefined !== coordFormatterSpec && this.iModel.isGeoLocated) {
-                const cartographic = this.iModel.spatialToCartographicFromEcef(this._monumentPoint);
-                const formattedLat = quantityFormatter.formatQuantity(Math.abs(cartographic.latitude), latLongFormatterSpec);
-                const formattedLong = quantityFormatter.formatQuantity(Math.abs(cartographic.longitude), latLongFormatterSpec);
-                const formattedHeight = quantityFormatter.formatQuantity(cartographic.height, coordFormatterSpec);
-                const latDir = CoreTools.translate(cartographic.latitude < 0 ? "Measure.Labels.S" : "Measure.Labels.N");
-                const longDir = CoreTools.translate(cartographic.longitude < 0 ? "Measure.Labels.W" : "Measure.Labels.E");
-                toolTipHtml += `${translateCoreMeasureBold("LatLong") + formattedLat + latDir}, ${formattedLong}${longDir}<br>`;
-                toolTipHtml += `${translateCoreMeasureBold("Altitude") + formattedHeight}<br>`;
-            }
-        }
-        else if (hit.sourceId === this._northId) {
-            toolTipHtml += `${translateMessage("ModifyNorthDirection")}<br>`;
-            const angleFormatterSpec = quantityFormatter.findFormatterSpecByQuantityType(QuantityType.Angle);
-            if (undefined !== angleFormatterSpec) {
-                const formattedAngle = quantityFormatter.formatQuantity(this.getClockwiseAngleToNorth().radians, angleFormatterSpec);
-                toolTipHtml += `${translateMessageBold("Angle") + formattedAngle}<br>`;
-            }
-        }
-        else if (hit.sourceId === this._clipId) {
-            const extentsValid = (this._extentsLengthValid && this._extentsWidthValid && this._extentsHeightValid);
-            toolTipHtml += `${translateMessage(extentsValid ? "ProjectExtents" : "LargeProjectExtents")}<br>`;
-            const distanceFormatterSpec = quantityFormatter.findFormatterSpecByQuantityType(QuantityType.Length);
-            if (undefined !== distanceFormatterSpec && undefined !== this._clipRange) {
-                const formattedLength = quantityFormatter.formatQuantity(this._clipRange.xLength(), distanceFormatterSpec);
-                const formattedWidth = quantityFormatter.formatQuantity(this._clipRange.yLength(), distanceFormatterSpec);
-                const formattedHeight = quantityFormatter.formatQuantity(this._clipRange.zLength(), distanceFormatterSpec);
-                toolTipHtml += `${translateMessageBold("Length") + formattedLength}<br>`;
-                toolTipHtml += `${translateMessageBold("Width") + formattedWidth}<br>`;
-                toolTipHtml += `${translateMessageBold("Height") + formattedHeight}<br>`;
-            }
-        }
-        else {
-            const arrowIndex = this._controlIds.indexOf(hit.sourceId);
-            if (-1 !== arrowIndex) {
-                toolTipHtml += `${translateMessage("ModifyProjectExtents")}<br>`;
-                const distanceFormatterSpec = quantityFormatter.findFormatterSpecByQuantityType(QuantityType.Length);
-                if (undefined !== distanceFormatterSpec && undefined !== this._clipRange) {
-                    const arrowControl = this._controls[arrowIndex];
-                    let arrowLabel = "";
-                    let arrowLength = 0.0;
-                    let arrowLengthMax = 0.0;
-                    if (arrowControl.direction.isParallelTo(Vector3d.unitX(), true)) {
-                        arrowLabel = "Length";
-                        arrowLength = this._clipRange.xLength();
-                        if (!this._extentsLengthValid)
-                            arrowLengthMax = this.maxExtentLength;
-                    }
-                    else if (arrowControl.direction.isParallelTo(Vector3d.unitY(), true)) {
-                        arrowLabel = "Width";
-                        arrowLength = this._clipRange.yLength();
-                        if (!this._extentsWidthValid)
-                            arrowLengthMax = this.maxExtentLength;
-                    }
-                    else {
-                        arrowLabel = "Height";
-                        arrowLength = this._clipRange.zLength();
-                        if (!this._extentsHeightValid)
-                            arrowLengthMax = this.maxExtentHeight;
-                        const coordFormatterSpec = (this.iModel.isGeoLocated ? quantityFormatter.findFormatterSpecByQuantityType(QuantityType.Coordinate) : undefined);
-                        if (undefined !== coordFormatterSpec) {
-                            const heightPt = ("zLow" === arrowControl.name ? this._clipRange.low : this._clipRange.high);
-                            const cartographic = this.iModel.spatialToCartographicFromEcef(heightPt);
-                            const formattedAltitude = quantityFormatter.formatQuantity(cartographic.height, coordFormatterSpec);
-                            toolTipHtml += `${translateCoreMeasureBold("Altitude") + formattedAltitude}<br>`;
-                        }
-                    }
-                    const formattedLength = quantityFormatter.formatQuantity(arrowLength, distanceFormatterSpec);
-                    toolTipHtml += `${translateMessageBold(arrowLabel) + formattedLength}<br>`;
-                    if (0.0 !== arrowLengthMax) {
-                        const formattedMaxLength = quantityFormatter.formatQuantity(arrowLengthMax, distanceFormatterSpec);
-                        toolTipHtml += `${translateMessageBold("MaxExtent") + formattedMaxLength}<br>`;
-                    }
-                }
-            }
-        }
-        toolTip.innerHTML = toolTipHtml;
-        return toolTip;
-    }
-    testDecorationHit(id) { return (id === this._monumentId || id === this._northId || id === this._clipId || this._controlIds.includes(id)); }
-    updateDecorationListener(_add) { super.updateDecorationListener(undefined !== this._clipId); } // Decorator isn't just for resize controls...
-    getMonumentPoint() {
-        const origin = Point3d.createZero();
-        if (this.iModel.ecefLocation && this.iModel.ecefLocation.cartographicOrigin)
-            return this.iModel.cartographicToSpatialFromEcef(this.iModel.ecefLocation.cartographicOrigin, origin);
-        origin.setFrom(this.iModel.projectExtents.low);
-        if (0.0 > this.iModel.projectExtents.low.z && 0.0 < this.iModel.projectExtents.high.z)
-            origin.z = 0.0;
-        return origin;
-    }
-    getClockwiseAngleToNorth() {
-        const angle = this.getNorthAngle();
-        angle.setRadians(Angle.adjustRadians0To2Pi(angle.radians));
-        return angle;
-    }
-    getNorthAngle() {
-        const northDirection = (undefined !== this._northDirection ? this._northDirection : this.getNorthDirection());
-        return northDirection.direction.angleToXY(Vector3d.unitY());
-    }
-    getNorthDirection(refOrigin) {
-        const origin = (undefined !== refOrigin ? refOrigin : this.iModel.projectExtents.center);
-        if (!this.iModel.isGeoLocated)
-            return Ray3d.create(origin, Vector3d.unitY());
-        const cartographic = this.iModel.spatialToCartographicFromEcef(origin);
-        cartographic.latitude += Angle.createDegrees(0.01).radians;
-        const pt2 = this.iModel.cartographicToSpatialFromEcef(cartographic);
-        const northVec = Vector3d.createStartEnd(origin, pt2);
-        northVec.z = 0.0;
-        northVec.normalizeInPlace();
-        return Ray3d.create(origin, northVec);
-    }
-    drawNorthArrow(context, northDir, id) {
-        const vp = context.viewport;
-        const pixelSize = vp.pixelsFromInches(0.55);
-        const scale = vp.viewingSpace.getPixelSizeAtPoint(northDir.origin) * pixelSize;
-        const matrix = Matrix3d.createRigidFromColumns(northDir.direction, Vector3d.unitZ(), AxisOrder.YZX);
-        if (undefined === matrix)
-            return;
-        matrix.scaleColumnsInPlace(scale, scale, scale);
-        const arrowTrans = Transform.createRefs(northDir.origin, matrix);
-        const northArrowBuilder = context.createGraphicBuilder(GraphicType.WorldOverlay, arrowTrans, id);
-        const color = ColorDef.white;
-        const arrowOutline = [];
-        arrowOutline[0] = Point3d.create(0.0, 0.65);
-        arrowOutline[1] = Point3d.create(-0.45, -0.5);
-        arrowOutline[2] = Point3d.create(0.0, -0.2);
-        arrowOutline[3] = Point3d.create(0.45, -0.5);
-        arrowOutline[4] = arrowOutline[0].clone();
-        const arrowLeftFill = [];
-        arrowLeftFill[0] = arrowOutline[0].clone();
-        arrowLeftFill[1] = arrowOutline[1].clone();
-        arrowLeftFill[2] = arrowOutline[2].clone();
-        arrowLeftFill[3] = arrowLeftFill[0].clone();
-        const arrowRightFill = [];
-        arrowRightFill[0] = arrowOutline[0].clone();
-        arrowRightFill[1] = arrowOutline[3].clone();
-        arrowRightFill[2] = arrowOutline[2].clone();
-        arrowRightFill[3] = arrowRightFill[0].clone();
-        northArrowBuilder.setSymbology(color, ColorDef.from(0, 0, 0, 200), 1);
-        northArrowBuilder.addArc(Arc3d.createXY(Point3d.createZero(), 0.6), true, true);
-        northArrowBuilder.addArc(Arc3d.createXY(Point3d.create(0.0, 0.85), 0.2), true, true);
-        northArrowBuilder.setSymbology(color, color, 2);
-        northArrowBuilder.addArc(Arc3d.createXY(Point3d.createZero(), 0.5), false, false);
-        northArrowBuilder.addLineString([Point3d.create(0.6, 0.0), Point3d.create(-0.6, 0.0)]);
-        northArrowBuilder.addLineString([Point3d.create(0.0, 0.6), Point3d.create(0.0, -0.6)]);
-        northArrowBuilder.setSymbology(color, ColorDef.from(150, 150, 150), 1);
-        northArrowBuilder.addShape(arrowLeftFill);
-        northArrowBuilder.setSymbology(color, ColorDef.black, 1);
-        northArrowBuilder.addShape(arrowRightFill);
-        northArrowBuilder.setSymbology(color, color, 1);
-        northArrowBuilder.addLineString(arrowOutline);
-        northArrowBuilder.setSymbology(color, color, 3);
-        northArrowBuilder.addLineString([Point3d.create(-0.1, 0.75), Point3d.create(-0.1, 0.95), Point3d.create(0.1, 0.75), Point3d.create(0.1, 0.95)]);
-        context.addDecorationFromBuilder(northArrowBuilder);
-    }
-    drawMonumentPoint(context, point, scaleFactor, id) {
-        const vp = context.viewport;
-        const pixelSize = vp.pixelsFromInches(0.25) * scaleFactor;
-        const scale = vp.viewingSpace.getPixelSizeAtPoint(point) * pixelSize;
-        const matrix = Matrix3d.createRotationAroundAxisIndex(AxisIndex.Z, Angle.createDegrees(45.0));
-        matrix.scaleColumnsInPlace(scale, scale, scale);
-        const monumentTrans = Transform.createRefs(point, matrix);
-        const monumentPointBuilder = context.createGraphicBuilder(GraphicType.WorldOverlay, monumentTrans, id);
-        const color = ColorDef.white;
-        monumentPointBuilder.setSymbology(color, ColorDef.from(0, 0, 0, 150), 1);
-        monumentPointBuilder.addArc(Arc3d.createXY(Point3d.createZero(), 0.7), true, true);
-        monumentPointBuilder.setSymbology(color, color, 2);
-        monumentPointBuilder.addArc(Arc3d.createXY(Point3d.createZero(), 0.5), false, false);
-        monumentPointBuilder.addLineString([Point3d.create(0.5, 0.0), Point3d.create(-0.5, 0.0)]);
-        monumentPointBuilder.addLineString([Point3d.create(0.0, 0.5), Point3d.create(0.0, -0.5)]);
-        context.addDecorationFromBuilder(monumentPointBuilder);
-    }
-    drawAreaTooLargeIndicator(context) {
-        if ((this._extentsLengthValid && this._extentsWidthValid) || undefined === this._clipRange)
-            return;
-        const corners = this._clipRange.corners();
-        const indices = Range3d.faceCornerIndices(5);
-        const points = [];
-        for (const index of indices)
-            points.push(corners[index]);
-        const areaWarnColor = ColorDef.red.withAlpha(50);
-        const areaWarnBuilder = context.createGraphicBuilder(GraphicType.WorldDecoration);
-        areaWarnBuilder.setSymbology(areaWarnColor, areaWarnColor, 1);
-        areaWarnBuilder.addShape(points);
-        context.addDecorationFromBuilder(areaWarnBuilder);
-    }
-    drawExtentTooLargeIndicator(context, worldPoint, sizePixels) {
-        const position = context.viewport.worldToView(worldPoint);
-        position.x = Math.floor(position.x) + 0.5;
-        position.y = Math.floor(position.y) + 0.5;
-        const drawDecoration = (ctx) => {
-            ctx.lineWidth = 4;
-            ctx.lineCap = "round";
-            ctx.strokeStyle = "rgba(255,0,0,.75)";
-            ctx.fillStyle = "rgba(255,255,255,.75)";
-            ctx.shadowColor = "black";
-            ctx.shadowBlur = 5;
-            ctx.beginPath();
-            ctx.moveTo(0, -sizePixels);
-            ctx.lineTo(-sizePixels, sizePixels);
-            ctx.lineTo(sizePixels, sizePixels);
-            ctx.lineTo(0, -sizePixels);
-            ctx.fill();
-            ctx.shadowBlur = 0;
-            ctx.beginPath();
-            ctx.moveTo(0, -sizePixels);
-            ctx.lineTo(-sizePixels, sizePixels);
-            ctx.lineTo(sizePixels, sizePixels);
-            ctx.lineTo(0, -sizePixels);
-            ctx.stroke();
-            ctx.strokeStyle = "black";
-            ctx.lineWidth = 3;
-            ctx.beginPath();
-            ctx.moveTo(0, -sizePixels * 0.2);
-            ctx.lineTo(0, sizePixels * 0.3);
-            ctx.moveTo(0, (sizePixels * 0.3) + 4);
-            ctx.lineTo(0, (sizePixels * 0.3) + 4.5);
-            ctx.stroke();
-        };
-        context.addCanvasDecoration({ position, drawDecoration });
-    }
-    decorate(context) {
-        if (this._suspendDecorator)
-            return;
-        if (undefined === this._clipId || undefined === this._clipShape || undefined === this._clipRange)
-            return;
-        const vp = context.viewport;
-        if (this.viewport !== vp)
-            return;
-        if (!this.suspendGeolocationDecorations && undefined !== this._northDirection && this.iModel.isGeoLocated)
-            this.drawNorthArrow(context, this._northDirection, this._allowEcefLocationChange ? this._northId : undefined); // Show north, but don't make pickable if it shouldn't be modified...
-        const maxSizeInches = ((this._clipRange.maxLength() / vp.viewingSpace.getPixelSizeAtPoint(this._clipRange.center)) / vp.pixelsPerInch) * 0.5; // Display size limit when zooming out...
-        if (maxSizeInches < 0.5)
-            return;
-        if (!this.suspendGeolocationDecorations && undefined !== this._monumentPoint && this._allowEcefLocationChange)
-            this.drawMonumentPoint(context, this._monumentPoint, 1.0, this._monumentId);
-        ViewClipTool.drawClipShape(context, this._clipShape, this._clipShapeExtents, ColorDef.white.adjustedForContrast(context.viewport.view.backgroundColor), 3, this._clipId);
-        this.drawAreaTooLargeIndicator(context);
-        if (!this._isActive)
-            return;
-        const outlineColor = ColorDef.from(0, 0, 0, 50).adjustedForContrast(vp.view.backgroundColor);
-        const fillVisColor = ColorDef.from(150, 250, 200, 225).adjustedForContrast(vp.view.backgroundColor);
-        const fillHidColor = fillVisColor.withAlpha(200);
-        const fillSelColor = fillVisColor.inverse().withAlpha(75);
-        const shapePts = EditManipulator.HandleUtils.getArrowShape(0.0, 0.15, 0.55, 1.0, 0.3, 0.5, 0.1);
-        for (let iFace = 0; iFace < this._controlIds.length; iFace++) {
-            const sizeInches = Math.min(this._controls[iFace].sizeInches, maxSizeInches);
-            if (0.0 === sizeInches)
-                continue;
-            const anchorRay = ViewClipTool.getClipRayTransformed(this._controls[iFace].origin, this._controls[iFace].direction, undefined !== this._clipShape ? this._clipShape.transformFromClip : undefined);
-            const transform = EditManipulator.HandleUtils.getArrowTransform(vp, anchorRay.origin, anchorRay.direction, sizeInches);
-            if (undefined === transform)
-                continue;
-            const visPts = [];
-            for (const pt of shapePts)
-                visPts.push(pt.clone()); // deep copy because we're using a builder transform w/addLineString...
-            const hidPts = [];
-            for (const pt of shapePts)
-                hidPts.push(pt.clone());
-            const arrowVisBuilder = context.createGraphicBuilder(GraphicType.WorldOverlay, transform, this._controlIds[iFace]);
-            const arrowHidBuilder = context.createGraphicBuilder(GraphicType.WorldDecoration, transform);
-            const isSelected = this.iModel.selectionSet.has(this._controlIds[iFace]);
-            let outlineColorOvr = this._controls[iFace].outline;
-            if (undefined !== outlineColorOvr) {
-                outlineColorOvr = outlineColorOvr.adjustedForContrast(vp.view.backgroundColor);
-                outlineColorOvr = outlineColorOvr.withAlpha(outlineColor.getAlpha());
-            }
-            else {
-                outlineColorOvr = outlineColor;
-            }
-            let fillVisColorOvr = this._controls[iFace].fill;
-            let fillHidColorOvr = fillHidColor;
-            let fillSelColorOvr = fillSelColor;
-            if (undefined !== fillVisColorOvr) {
-                fillVisColorOvr = fillVisColorOvr.adjustedForContrast(vp.view.backgroundColor);
-                fillVisColorOvr = fillVisColorOvr.withAlpha(fillVisColor.getAlpha());
-                fillHidColorOvr = fillVisColorOvr.withAlpha(fillHidColor.getAlpha());
-                fillSelColorOvr = fillVisColorOvr.inverse().withAlpha(fillSelColor.getAlpha());
-            }
-            else {
-                fillVisColorOvr = fillVisColor;
-            }
-            arrowVisBuilder.setSymbology(outlineColorOvr, outlineColorOvr, isSelected ? 4 : 2);
-            arrowVisBuilder.addLineString(visPts);
-            arrowVisBuilder.setBlankingFill(isSelected ? fillSelColorOvr : fillVisColorOvr);
-            arrowVisBuilder.addShape(visPts);
-            context.addDecorationFromBuilder(arrowVisBuilder);
-            arrowHidBuilder.setSymbology(fillHidColorOvr, fillHidColorOvr, 1);
-            arrowHidBuilder.addShape(hidPts);
-            context.addDecorationFromBuilder(arrowHidBuilder);
-            if (this._controls[iFace].extentValid)
-                continue;
-            const warnPixels = 15.0;
-            const warnOffset = vp.viewingSpace.getPixelSizeAtPoint(anchorRay.origin) * warnPixels * 1.5;
-            const warnOrigin = anchorRay.origin.plusScaled(anchorRay.direction, -warnOffset);
-            this.drawExtentTooLargeIndicator(context, warnOrigin, warnPixels);
-        }
-    }
-    resetViewClip() {
-        if (!clearViewClip(this.viewport))
-            return false;
-        if (undefined !== this.getModifiedExtents())
-            this.onChanged.raiseEvent(this.iModel, ProjectLocationChanged.ResetExtents);
-        return true;
-    }
-    resetGeolocation() {
-        if (!this._allowEcefLocationChange)
-            return false;
-        if (undefined === this.getModifiedEcefLocation())
-            return false; // Wasn't changed...
-        this.iModel.disableGCS(false);
-        this.iModel.ecefLocation = this._ecefLocation;
-        this._monumentPoint = this.getMonumentPoint();
-        this._northDirection = this.getNorthDirection();
-        updateMapDisplay(this.viewport, false);
-        this.onChanged.raiseEvent(this.iModel, ProjectLocationChanged.ResetGeolocation);
-        return true;
-    }
-    updateEcefLocation(origin, point, angle) {
-        if (!this._allowEcefLocationChange)
-            return false;
-        const newEcefLocation = EcefLocation.createFromCartographicOrigin(origin, point, (undefined !== angle ? angle : this.getNorthAngle())); // Preserve modified north direction...
-        const ecefLocation = this.iModel.ecefLocation;
-        if (undefined !== ecefLocation && ecefLocation.isAlmostEqual(newEcefLocation))
-            return false;
-        this.iModel.disableGCS(true); // Map display will ignore change to ecef location when GCS is present...
-        this.iModel.setEcefLocation(newEcefLocation);
-        this._monumentPoint = this.getMonumentPoint();
-        this._northDirection = this.getNorthDirection(undefined !== this._northDirection ? this._northDirection.origin : undefined); // Preserve modified north reference point...
-        updateMapDisplay(this.viewport, true);
-        this.onChanged.raiseEvent(this.iModel, ProjectLocationChanged.Geolocation);
-        return true;
-    }
-    updateNorthDirection(northDir) {
-        if (!this._allowEcefLocationChange || !this.iModel.isGeoLocated)
-            return false;
-        const point = (undefined !== this._monumentPoint ? this._monumentPoint : this.getMonumentPoint()); // Preserve modified monument point...
-        const origin = this.iModel.spatialToCartographicFromEcef(point);
-        const saveDirection = this._northDirection;
-        this._northDirection = northDir; // Change reference point to input location...
-        const angle = this.getNorthAngle();
-        if (!this.updateEcefLocation(origin, point, angle)) {
-            this._northDirection = saveDirection;
-            return false;
-        }
-        return true;
-    }
-    getModifiedEcefLocation() {
-        const ecefLocation = this.iModel.ecefLocation;
-        if (undefined === ecefLocation)
-            return undefined; // geolocation wasn't added...
-        if (undefined === this._ecefLocation)
-            return ecefLocation; // geolocation didn't exist previously...
-        if (this._ecefLocation.isAlmostEqual(ecefLocation))
-            return undefined;
-        return ecefLocation;
-    }
-    getModifiedExtents() {
-        if (undefined === this._clipRange)
-            return undefined;
-        return this._clipRange.isAlmostEqual(this.iModel.projectExtents) ? undefined : this._clipRange;
-    }
-    static allowEcefLocationChange(requireExisting, outputError = true) {
-        if (undefined === ProjectExtentsClipDecoration._decorator) {
-            if (outputError)
-                IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("NotActive")));
-            return false;
-        }
-        else if (!ProjectExtentsClipDecoration._decorator._allowEcefLocationChange) {
-            if (outputError)
-                IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("NotAllowed")));
-            return false;
-        }
-        else if (requireExisting && !ProjectExtentsClipDecoration._decorator.iModel.isGeoLocated) {
-            if (outputError)
-                IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("NotGeolocated")));
-            return false;
-        }
-        return true;
-    }
-    fitExtents() {
-        if (undefined === this._clipRange)
-            return undefined;
-        const options = { animateFrustumChange: true, animationTime: BeDuration.fromSeconds(2).milliseconds };
-        const aspect = this.viewport.viewRect.aspect;
-        this.viewport.view.lookAtVolume(this._clipRange, aspect);
-        this.viewport.synchWithView(options);
-        this.viewport.viewCmdTargetCenter = undefined;
-    }
-    static get() {
-        if (undefined === ProjectExtentsClipDecoration._decorator)
-            return undefined;
-        return ProjectExtentsClipDecoration._decorator;
-    }
-    static show(vp, fitExtents = true) {
-        if (!vp.view.isSpatialView())
-            return false;
-        if (undefined !== ProjectExtentsClipDecoration._decorator) {
-            const deco = ProjectExtentsClipDecoration._decorator;
-            if (vp === deco.viewport && undefined !== deco._clipId && undefined !== deco._clip) {
-                if (deco._clip !== vp.view.getViewClip()) {
-                    clearViewClip(vp);
-                    ViewClipTool.enableClipVolume(vp);
-                    ViewClipTool.setViewClip(vp, deco._clip);
-                }
-                if (undefined === deco._removeManipulatorToolListener) {
-                    deco._removeManipulatorToolListener = IModelApp.toolAdmin.manipulatorToolEvent.addListener((tool, event) => deco.onManipulatorToolEvent(tool, event));
-                    deco.start();
-                    deco.onChanged.raiseEvent(deco.iModel, ProjectLocationChanged.Show);
-                }
-                return true;
-            }
-            ProjectExtentsClipDecoration.clear();
-        }
-        if (!clipToProjectExtents(vp))
-            return false;
-        ProjectExtentsClipDecoration._decorator = new ProjectExtentsClipDecoration(vp);
-        if (fitExtents)
-            ProjectExtentsClipDecoration._decorator.fitExtents();
-        vp.onChangeView.addOnce(() => this.clear(false, true));
-        return (undefined !== ProjectExtentsClipDecoration._decorator._clipId);
-    }
-    static hide() {
-        if (undefined === ProjectExtentsClipDecoration._decorator)
-            return;
-        const saveClipId = ProjectExtentsClipDecoration._decorator._clipId; // cleared by stop to trigger decorator removal...
-        ProjectExtentsClipDecoration._decorator.stop();
-        ProjectExtentsClipDecoration._decorator._clipId = saveClipId;
-        ProjectExtentsClipDecoration._decorator.onChanged.raiseEvent(ProjectExtentsClipDecoration._decorator.iModel, ProjectLocationChanged.Hide);
-    }
-    static clear(clearClip = true, resetGeolocation = true) {
-        if (undefined === ProjectExtentsClipDecoration._decorator)
-            return;
-        if (clearClip)
-            ProjectExtentsClipDecoration._decorator.resetViewClip(); // Clear project extents view clip...
-        if (resetGeolocation)
-            ProjectExtentsClipDecoration._decorator.resetGeolocation(); // Restore modified geolocation back to create state...
-        ProjectExtentsClipDecoration._decorator.stop();
-        ProjectExtentsClipDecoration._decorator = undefined;
-    }
-    static async update() {
-        const deco = ProjectExtentsClipDecoration._decorator;
-        if (undefined === deco)
-            return;
-        clipToProjectExtents(deco.viewport);
-        deco.init();
-        return deco.updateControls();
-    }
-}
-/** Show project location decoration. Project extents represented by view clip.
- * @beta
- */
-export class ProjectLocationShowTool extends Tool {
-    async run() {
-        const vp = IModelApp.viewManager.selectedView;
-        if (undefined === vp || !ProjectExtentsClipDecoration.show(vp))
-            return false;
-        await IModelApp.toolAdmin.startDefaultTool();
-        return true;
-    }
-}
-ProjectLocationShowTool.toolId = "ProjectLocation.Show";
-/** Hide project location decoration. Preserves changes to project extents view clip and geolocation.
- * @beta
- */
-export class ProjectLocationHideTool extends Tool {
-    async run() {
-        ProjectExtentsClipDecoration.hide();
-        await IModelApp.toolAdmin.startDefaultTool();
-        return true;
-    }
-}
-ProjectLocationHideTool.toolId = "ProjectLocation.Hide";
-/** Clear project location decoration. Restore modified geolocation and remove view clip.
- * @beta
- */
-export class ProjectLocationCancelTool extends Tool {
-    async run() {
-        ProjectExtentsClipDecoration.clear();
-        await IModelApp.toolAdmin.startDefaultTool();
-        return true;
-    }
-}
-ProjectLocationCancelTool.toolId = "ProjectLocation.Cancel";
-/** Save modified project extents and geolocation. Updates decoration to reflect saved state.
- * @note Allowing this change to be undone is both problematic and undesirable.
- * Warns the user if called with previous changes to cancel restarting the TxnManager session.
- * @beta
- */
-export class ProjectLocationSaveTool extends Tool {
-    static callCommand(method, ...args) {
-        return EditTools.callCommand(method, ...args);
-    }
-    async allowRestartTxnSession(iModel) {
-        if (!await iModel.txns.isUndoPossible())
-            return true;
-        // NOTE: Default if openMessageBox isn't implemented is MessageBoxValue.Ok, so we'll check No instead of Yes...
-        if (MessageBoxValue.No === await IModelApp.notifications.openMessageBox(MessageBoxType.YesNo, translateMessage("RestartTxn"), MessageBoxIconType.Question))
-            return false;
-        return true;
-    }
-    async saveChanges(deco, extents, ecefLocation) {
-        if (!deco.iModel.isBriefcaseConnection())
-            return;
-        if (!await this.allowRestartTxnSession(deco.iModel))
-            return;
-        try {
-            await EditTools.startCommand(editorBuiltInCmdIds.cmdBasicManipulation, deco.iModel.key);
-            if (undefined !== extents)
-                await ProjectLocationSaveTool.callCommand("updateProjectExtents", extents);
-            if (undefined !== ecefLocation)
-                await ProjectLocationSaveTool.callCommand("updateEcefLocation", ecefLocation);
-            await deco.iModel.saveChanges(this.toolId);
-            await deco.iModel.txns.restartTxnSession();
-        }
-        catch (err) {
-            IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Error, BentleyError.getErrorMessage(err) || "An unknown error occurred."));
-        }
-        deco.onChanged.raiseEvent(deco.iModel, ProjectLocationChanged.Save);
-        await ProjectExtentsClipDecoration.update();
-        return IModelApp.toolAdmin.startDefaultTool();
-    }
-    async run() {
-        const deco = ProjectExtentsClipDecoration.get();
-        if (undefined === deco) {
-            IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("NotActive")));
-            return false;
-        }
-        if (deco.iModel.isReadonly) {
-            IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("Readonly")));
-            return true;
-        }
-        const extents = deco.getModifiedExtents();
-        const ecefLocation = deco.getModifiedEcefLocation();
-        if (undefined === extents && undefined === ecefLocation) {
-            IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("NoChanges")));
-            return true;
-        }
-        await this.saveChanges(deco, extents, ecefLocation);
-        return true;
-    }
-}
-ProjectLocationSaveTool.toolId = "ProjectLocation.Save";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Editing
+ */
+import { BeDuration, BeEvent, BentleyError } from "@itwin/core-bentley";
+import { ColorDef, EcefLocation } from "@itwin/core-common";
+import { BeButton, CoreTools, EditManipulator, EventHandled, GraphicType, IModelApp, MessageBoxIconType, MessageBoxType, MessageBoxValue, NotifyMessageDetails, OutputMessagePriority, QuantityType, Tool, ViewClipControlArrow, ViewClipDecorationProvider, ViewClipShapeModifyTool, ViewClipTool, } from "@itwin/core-frontend";
+import { Angle, Arc3d, AxisIndex, AxisOrder, Constant, Matrix3d, Point3d, PolygonOps, Range1d, Range3d, Ray3d, Transform, Vector3d, } from "@itwin/core-geometry";
+import { editorBuiltInCmdIds } from "@itwin/editor-common";
+import { EditTools } from "../EditTool";
+import { ProjectGeolocationNorthTool, ProjectGeolocationPointTool } from "./ProjectGeolocation";
+function translateMessage(key) { return EditTools.translate(`ProjectLocation:Message.${key}`); }
+function translateMessageBold(key) { return `<b>${translateMessage(key)}:</b> `; }
+function translateCoreMeasureBold(key) { return `<b>${CoreTools.translate(`Measure.Labels.${key}`)}:</b> `; }
+function clearViewClip(vp) {
+    if (!ViewClipTool.doClipClear(vp))
+        return false;
+    ViewClipDecorationProvider.create().onClearClip(vp); // Send clear event...
+    ViewClipDecorationProvider.clear();
+    return true;
+}
+function clipToProjectExtents(vp) {
+    clearViewClip(vp); // Clear any existing view clip and send clear event...
+    ViewClipTool.enableClipVolume(vp);
+    return ViewClipTool.doClipToRange(vp, vp.iModel.projectExtents, Transform.createIdentity());
+}
+function enableBackgroundMap(viewport, onOff) {
+    if (onOff === viewport.viewFlags.backgroundMap)
+        return false;
+    viewport.viewFlags = viewport.viewFlags.with("backgroundMap", onOff);
+    return true;
+}
+function updateMapDisplay(vp, turnOnMap) {
+    if (!turnOnMap || !enableBackgroundMap(vp, true))
+        vp.invalidateRenderPlan();
+}
+class ProjectExtentsControlArrow extends ViewClipControlArrow {
+    constructor() {
+        super(...arguments);
+        this.extentValid = true;
+    }
+}
+/** Values for [[ProjectExtentsClipDecoration.onChanged] event.
+ * @beta
+ */
+export var ProjectLocationChanged;
+(function (ProjectLocationChanged) {
+    /** Extents has been modified (unsaved changes) */
+    ProjectLocationChanged[ProjectLocationChanged["Extents"] = 0] = "Extents";
+    /** Geolocation has been modified (unsaved changes) */
+    ProjectLocationChanged[ProjectLocationChanged["Geolocation"] = 1] = "Geolocation";
+    /** Abandon unsaved changes to extents */
+    ProjectLocationChanged[ProjectLocationChanged["ResetExtents"] = 2] = "ResetExtents";
+    /** Abandon unsaved changes to geolocation */
+    ProjectLocationChanged[ProjectLocationChanged["ResetGeolocation"] = 3] = "ResetGeolocation";
+    /** Decoration hidden (unsaved changes preserved) */
+    ProjectLocationChanged[ProjectLocationChanged["Hide"] = 4] = "Hide";
+    /** Decoration shown (unsaved changes restored) */
+    ProjectLocationChanged[ProjectLocationChanged["Show"] = 5] = "Show";
+    /** Save changes to extents and geolocation */
+    ProjectLocationChanged[ProjectLocationChanged["Save"] = 6] = "Save";
+})(ProjectLocationChanged || (ProjectLocationChanged = {}));
+/** Controls to modify project extents shown using view clip
+ * @beta
+ */
+export class ProjectExtentsClipDecoration extends EditManipulator.HandleProvider {
+    constructor(viewport) {
+        super(viewport.iModel);
+        this.viewport = viewport;
+        this._extentsLengthValid = true;
+        this._extentsWidthValid = true;
+        this._extentsHeightValid = true;
+        this._allowEcefLocationChange = false;
+        this._controlIds = [];
+        this._controls = [];
+        this._suspendDecorator = false;
+        this.suspendGeolocationDecorations = false;
+        /** Called when project extents or geolocation is modified */
+        this.onChanged = new BeEvent();
+        if (!this.init())
+            return;
+        this._monumentId = this.iModel.transientIds.next;
+        this._northId = this.iModel.transientIds.next;
+        this._clipId = this.iModel.transientIds.next;
+        this.start();
+    }
+    start() {
+        this.updateDecorationListener(true);
+        this._removeViewCloseListener = IModelApp.viewManager.onViewClose.addListener((vp) => this.onViewClose(vp));
+        this.iModel.selectionSet.replace(this._clipId); // Always select decoration on create...
+    }
+    stop() {
+        const selectedId = (undefined !== this._clipId && this.iModel.selectionSet.has(this._clipId)) ? this._clipId : undefined;
+        this._clipId = undefined; // Invalidate id so that decorator will be dropped...
+        super.stop();
+        if (undefined !== selectedId)
+            this.iModel.selectionSet.remove(selectedId); // Don't leave decorator id in selection set...
+        if (undefined !== this._removeViewCloseListener) {
+            this._removeViewCloseListener();
+            this._removeViewCloseListener = undefined;
+        }
+    }
+    init() {
+        if (!this.getClipData())
+            return false;
+        this._ecefLocation = this.iModel.ecefLocation;
+        this._monumentPoint = this.getMonumentPoint();
+        this._northDirection = this.getNorthDirection();
+        return true;
+    }
+    onViewClose(vp) {
+        if (this.viewport === vp)
+            ProjectExtentsClipDecoration.clear();
+    }
+    getClipData() {
+        this._clip = this._clipShape = this._clipShapeExtents = this._clipRange = undefined;
+        const clip = this.viewport.view.getViewClip();
+        if (undefined === clip)
+            return false;
+        const clipShape = ViewClipTool.isSingleClipShape(clip);
+        if (undefined === clipShape)
+            return false;
+        if (5 !== clipShape.polygon.length || undefined === clipShape.zLow || undefined === clipShape.zHigh)
+            return false; // Not a box, can't be project extents clip...
+        if (undefined !== clipShape.transformFromClip && !clipShape.transformFromClip.isIdentity)
+            return false; // Not axis aligned, can't be project extents clip...
+        this._clipShapeExtents = Range1d.createXX(clipShape.zLow, clipShape.zHigh);
+        this._clipShape = clipShape;
+        this._clip = clip;
+        this._clipRange = Range3d.create();
+        const shapePtsLo = ViewClipTool.getClipShapePoints(this._clipShape, this._clipShapeExtents.low);
+        const shapePtsHi = ViewClipTool.getClipShapePoints(this._clipShape, this._clipShapeExtents.high);
+        this._clipRange.extendArray(shapePtsLo);
+        this._clipRange.extendArray(shapePtsHi);
+        return true;
+    }
+    ensureNumControls(numReqControls) {
+        const numCurrent = this._controlIds.length;
+        if (numCurrent < numReqControls) {
+            const transientIds = this.iModel.transientIds;
+            for (let i = numCurrent; i < numReqControls; i++)
+                this._controlIds[i] = transientIds.next;
+        }
+        else if (numCurrent > numReqControls) {
+            this._controlIds.length = numReqControls;
+        }
+    }
+    createClipShapeControls() {
+        if (undefined === this._clipShape)
+            return false;
+        const shapePtsLo = ViewClipTool.getClipShapePoints(this._clipShape, this._clipShapeExtents.low);
+        const shapePtsHi = ViewClipTool.getClipShapePoints(this._clipShape, this._clipShapeExtents.high);
+        const shapeArea = PolygonOps.centroidAreaNormal(shapePtsLo);
+        if (undefined === shapeArea)
+            return false;
+        const numControls = shapePtsLo.length + 1; // Number of edge midpoints plus zLow and zHigh...
+        this.ensureNumControls(numControls);
+        for (let i = 0; i < numControls - 2; i++) {
+            const midPtLo = shapePtsLo[i].interpolate(0.5, shapePtsLo[i + 1]);
+            const midPtHi = shapePtsHi[i].interpolate(0.5, shapePtsHi[i + 1]);
+            const faceCenter = midPtLo.interpolate(0.5, midPtHi);
+            const edgeTangent = Vector3d.createStartEnd(shapePtsLo[i], shapePtsLo[i + 1]);
+            const faceNormal = edgeTangent.crossProduct(shapeArea.direction);
+            faceNormal.normalizeInPlace();
+            this._controls[i] = new ProjectExtentsControlArrow(faceCenter, faceNormal, 0.75);
+            this._controls[i].extentValid = (faceNormal.isParallelTo(Vector3d.unitX(), true) ? this._extentsLengthValid : this._extentsWidthValid);
+        }
+        const zFillColor = ColorDef.from(150, 150, 250);
+        this._controls[numControls - 2] = new ProjectExtentsControlArrow(shapeArea.origin, Vector3d.unitZ(-1.0), 0.75, zFillColor, undefined, "zLow");
+        this._controls[numControls - 1] = new ProjectExtentsControlArrow(shapeArea.origin.plusScaled(Vector3d.unitZ(), shapePtsLo[0].distance(shapePtsHi[0])), Vector3d.unitZ(), 0.75, zFillColor, undefined, "zHigh");
+        this._controls[numControls - 2].extentValid = this._extentsHeightValid;
+        this._controls[numControls - 1].extentValid = this._extentsHeightValid;
+        return true;
+    }
+    /** Allow project extents for map projections to be larger since curvature of the earth is accounted for. */
+    get maxExtentLength() { return ((this._allowEcefLocationChange ? 20 : 350) * Constant.oneKilometer); }
+    /** Impose some reasonable height limit for project extents. */
+    get maxExtentHeight() { return (2 * Constant.oneKilometer); }
+    hasValidGCS() {
+        if (!this.iModel.isGeoLocated || this.iModel.noGcsDefined)
+            return false;
+        const gcs = this.iModel.geographicCoordinateSystem;
+        if (undefined === gcs || undefined === gcs.horizontalCRS)
+            return false; // A valid GCS ought to have horizontalCR defined...
+        // Check for approximate GCS (such as from MicroStation's "From Placemark" tool) and allow it to be replaced...
+        const hasValidId = (undefined !== gcs.horizontalCRS.id && 0 !== gcs.horizontalCRS.id.length);
+        const hasValidDescr = (undefined !== gcs.horizontalCRS.description && 0 !== gcs.horizontalCRS.description.length);
+        const hasValidProjection = (undefined !== gcs.horizontalCRS.projection && "AzimuthalEqualArea" !== gcs.horizontalCRS.projection.method);
+        return hasValidId || hasValidDescr || hasValidProjection;
+    }
+    async createControls() {
+        // Always update to current view clip to handle post-modify, etc.
+        if (undefined === this._clipId || !this.getClipData())
+            return false;
+        this._allowEcefLocationChange = !this.hasValidGCS();
+        if (undefined !== this._clipRange) {
+            this._extentsLengthValid = (this._clipRange.xLength() < this.maxExtentLength);
+            this._extentsWidthValid = (this._clipRange.yLength() < this.maxExtentLength);
+            this._extentsHeightValid = (this._clipRange.zLength() < this.maxExtentHeight);
+        }
+        // Show controls if only range box and it's controls are selected, selection set doesn't include any other elements...
+        let showControls = false;
+        if (this.iModel.selectionSet.size <= this._controlIds.length + 1 && this.iModel.selectionSet.has(this._clipId)) {
+            showControls = true;
+            if (this.iModel.selectionSet.size > 1) {
+                this.iModel.selectionSet.elements.forEach((val) => {
+                    if (this._clipId !== val && !this._controlIds.includes(val))
+                        showControls = false;
+                });
+            }
+        }
+        if (!showControls)
+            return false; // Don't clear decoration on de-select...
+        return this.createClipShapeControls();
+    }
+    clearControls() {
+        this.iModel.selectionSet.remove(this._controlIds); // Remove any selected controls as they won't continue to be displayed...
+        super.clearControls();
+    }
+    async modifyControls(hit, _ev) {
+        if (undefined === this._clip || hit.sourceId === this._clipId)
+            return false;
+        const saveQualifiers = IModelApp.toolAdmin.currentInputState.qualifiers;
+        if (undefined !== this._clipShape) {
+            const clipShapeModifyTool = new ViewClipShapeModifyTool(this, this._clip, this.viewport, hit.sourceId, this._controlIds, this._controls);
+            this._suspendDecorator = await clipShapeModifyTool.run();
+        }
+        if (this._suspendDecorator)
+            IModelApp.toolAdmin.currentInputState.qualifiers = saveQualifiers; // onInstallTool cleared qualifiers, preserve for "modify all" behavior when shift was held and drag started...
+        return this._suspendDecorator;
+    }
+    async onRightClick(_hit, _ev) { return EventHandled.No; }
+    async onTouchTap(hit, ev) { return (hit.sourceId === this._clipId ? EventHandled.No : super.onTouchTap(hit, ev)); }
+    async onDecorationButtonEvent(hit, ev) {
+        if (hit.sourceId === this._monumentId) {
+            if (BeButton.Data === ev.button && !ev.isDown && !ev.isDragging)
+                await ProjectGeolocationPointTool.startTool();
+            return EventHandled.Yes; // Only pickable for tooltip, don't allow selection...
+        }
+        if (hit.sourceId === this._northId) {
+            if (BeButton.Data === ev.button && !ev.isDown && !ev.isDragging)
+                await ProjectGeolocationNorthTool.startTool();
+            return EventHandled.Yes; // Only pickable for tooltip, don't allow selection...
+        }
+        return super.onDecorationButtonEvent(hit, ev);
+    }
+    onManipulatorEvent(eventType) {
+        if (EditManipulator.EventType.Accept === eventType)
+            this.onChanged.raiseEvent(this.iModel, ProjectLocationChanged.Extents);
+        this._suspendDecorator = false;
+        super.onManipulatorEvent(eventType);
+    }
+    async getDecorationToolTip(hit) {
+        const quantityFormatter = IModelApp.quantityFormatter;
+        const toolTip = document.createElement("div");
+        let toolTipHtml = "";
+        if (hit.sourceId === this._monumentId) {
+            toolTipHtml += `${translateMessage("ModifyGeolocation")}<br>`;
+            const coordFormatterSpec = quantityFormatter.findFormatterSpecByQuantityType(QuantityType.Coordinate);
+            if (undefined !== coordFormatterSpec) {
+                const pointAdjusted = this._monumentPoint.minus(this.iModel.globalOrigin);
+                const formattedPointX = quantityFormatter.formatQuantity(pointAdjusted.x, coordFormatterSpec);
+                const formattedPointY = quantityFormatter.formatQuantity(pointAdjusted.y, coordFormatterSpec);
+                const formattedPointZ = quantityFormatter.formatQuantity(pointAdjusted.z, coordFormatterSpec);
+                toolTipHtml += `${translateCoreMeasureBold("Coordinate") + formattedPointX}, ${formattedPointY}, ${formattedPointZ}<br>`;
+            }
+            const latLongFormatterSpec = quantityFormatter.findFormatterSpecByQuantityType(QuantityType.LatLong);
+            if (undefined !== latLongFormatterSpec && undefined !== coordFormatterSpec && this.iModel.isGeoLocated) {
+                const cartographic = this.iModel.spatialToCartographicFromEcef(this._monumentPoint);
+                const formattedLat = quantityFormatter.formatQuantity(Math.abs(cartographic.latitude), latLongFormatterSpec);
+                const formattedLong = quantityFormatter.formatQuantity(Math.abs(cartographic.longitude), latLongFormatterSpec);
+                const formattedHeight = quantityFormatter.formatQuantity(cartographic.height, coordFormatterSpec);
+                const latDir = CoreTools.translate(cartographic.latitude < 0 ? "Measure.Labels.S" : "Measure.Labels.N");
+                const longDir = CoreTools.translate(cartographic.longitude < 0 ? "Measure.Labels.W" : "Measure.Labels.E");
+                toolTipHtml += `${translateCoreMeasureBold("LatLong") + formattedLat + latDir}, ${formattedLong}${longDir}<br>`;
+                toolTipHtml += `${translateCoreMeasureBold("Altitude") + formattedHeight}<br>`;
+            }
+        }
+        else if (hit.sourceId === this._northId) {
+            toolTipHtml += `${translateMessage("ModifyNorthDirection")}<br>`;
+            const angleFormatterSpec = quantityFormatter.findFormatterSpecByQuantityType(QuantityType.Angle);
+            if (undefined !== angleFormatterSpec) {
+                const formattedAngle = quantityFormatter.formatQuantity(this.getClockwiseAngleToNorth().radians, angleFormatterSpec);
+                toolTipHtml += `${translateMessageBold("Angle") + formattedAngle}<br>`;
+            }
+        }
+        else if (hit.sourceId === this._clipId) {
+            const extentsValid = (this._extentsLengthValid && this._extentsWidthValid && this._extentsHeightValid);
+            toolTipHtml += `${translateMessage(extentsValid ? "ProjectExtents" : "LargeProjectExtents")}<br>`;
+            const distanceFormatterSpec = quantityFormatter.findFormatterSpecByQuantityType(QuantityType.Length);
+            if (undefined !== distanceFormatterSpec && undefined !== this._clipRange) {
+                const formattedLength = quantityFormatter.formatQuantity(this._clipRange.xLength(), distanceFormatterSpec);
+                const formattedWidth = quantityFormatter.formatQuantity(this._clipRange.yLength(), distanceFormatterSpec);
+                const formattedHeight = quantityFormatter.formatQuantity(this._clipRange.zLength(), distanceFormatterSpec);
+                toolTipHtml += `${translateMessageBold("Length") + formattedLength}<br>`;
+                toolTipHtml += `${translateMessageBold("Width") + formattedWidth}<br>`;
+                toolTipHtml += `${translateMessageBold("Height") + formattedHeight}<br>`;
+            }
+        }
+        else {
+            const arrowIndex = this._controlIds.indexOf(hit.sourceId);
+            if (-1 !== arrowIndex) {
+                toolTipHtml += `${translateMessage("ModifyProjectExtents")}<br>`;
+                const distanceFormatterSpec = quantityFormatter.findFormatterSpecByQuantityType(QuantityType.Length);
+                if (undefined !== distanceFormatterSpec && undefined !== this._clipRange) {
+                    const arrowControl = this._controls[arrowIndex];
+                    let arrowLabel = "";
+                    let arrowLength = 0.0;
+                    let arrowLengthMax = 0.0;
+                    if (arrowControl.direction.isParallelTo(Vector3d.unitX(), true)) {
+                        arrowLabel = "Length";
+                        arrowLength = this._clipRange.xLength();
+                        if (!this._extentsLengthValid)
+                            arrowLengthMax = this.maxExtentLength;
+                    }
+                    else if (arrowControl.direction.isParallelTo(Vector3d.unitY(), true)) {
+                        arrowLabel = "Width";
+                        arrowLength = this._clipRange.yLength();
+                        if (!this._extentsWidthValid)
+                            arrowLengthMax = this.maxExtentLength;
+                    }
+                    else {
+                        arrowLabel = "Height";
+                        arrowLength = this._clipRange.zLength();
+                        if (!this._extentsHeightValid)
+                            arrowLengthMax = this.maxExtentHeight;
+                        const coordFormatterSpec = (this.iModel.isGeoLocated ? quantityFormatter.findFormatterSpecByQuantityType(QuantityType.Coordinate) : undefined);
+                        if (undefined !== coordFormatterSpec) {
+                            const heightPt = ("zLow" === arrowControl.name ? this._clipRange.low : this._clipRange.high);
+                            const cartographic = this.iModel.spatialToCartographicFromEcef(heightPt);
+                            const formattedAltitude = quantityFormatter.formatQuantity(cartographic.height, coordFormatterSpec);
+                            toolTipHtml += `${translateCoreMeasureBold("Altitude") + formattedAltitude}<br>`;
+                        }
+                    }
+                    const formattedLength = quantityFormatter.formatQuantity(arrowLength, distanceFormatterSpec);
+                    toolTipHtml += `${translateMessageBold(arrowLabel) + formattedLength}<br>`;
+                    if (0.0 !== arrowLengthMax) {
+                        const formattedMaxLength = quantityFormatter.formatQuantity(arrowLengthMax, distanceFormatterSpec);
+                        toolTipHtml += `${translateMessageBold("MaxExtent") + formattedMaxLength}<br>`;
+                    }
+                }
+            }
+        }
+        toolTip.innerHTML = toolTipHtml;
+        return toolTip;
+    }
+    testDecorationHit(id) { return (id === this._monumentId || id === this._northId || id === this._clipId || this._controlIds.includes(id)); }
+    updateDecorationListener(_add) { super.updateDecorationListener(undefined !== this._clipId); } // Decorator isn't just for resize controls...
+    getMonumentPoint() {
+        const origin = Point3d.createZero();
+        if (this.iModel.ecefLocation && this.iModel.ecefLocation.cartographicOrigin)
+            return this.iModel.cartographicToSpatialFromEcef(this.iModel.ecefLocation.cartographicOrigin, origin);
+        origin.setFrom(this.iModel.projectExtents.low);
+        if (0.0 > this.iModel.projectExtents.low.z && 0.0 < this.iModel.projectExtents.high.z)
+            origin.z = 0.0;
+        return origin;
+    }
+    getClockwiseAngleToNorth() {
+        const angle = this.getNorthAngle();
+        angle.setRadians(Angle.adjustRadians0To2Pi(angle.radians));
+        return angle;
+    }
+    getNorthAngle() {
+        const northDirection = (undefined !== this._northDirection ? this._northDirection : this.getNorthDirection());
+        return northDirection.direction.angleToXY(Vector3d.unitY());
+    }
+    getNorthDirection(refOrigin) {
+        const origin = (undefined !== refOrigin ? refOrigin : this.iModel.projectExtents.center);
+        if (!this.iModel.isGeoLocated)
+            return Ray3d.create(origin, Vector3d.unitY());
+        const cartographic = this.iModel.spatialToCartographicFromEcef(origin);
+        cartographic.latitude += Angle.createDegrees(0.01).radians;
+        const pt2 = this.iModel.cartographicToSpatialFromEcef(cartographic);
+        const northVec = Vector3d.createStartEnd(origin, pt2);
+        northVec.z = 0.0;
+        northVec.normalizeInPlace();
+        return Ray3d.create(origin, northVec);
+    }
+    drawNorthArrow(context, northDir, id) {
+        const vp = context.viewport;
+        const pixelSize = vp.pixelsFromInches(0.55);
+        const scale = vp.viewingSpace.getPixelSizeAtPoint(northDir.origin) * pixelSize;
+        const matrix = Matrix3d.createRigidFromColumns(northDir.direction, Vector3d.unitZ(), AxisOrder.YZX);
+        if (undefined === matrix)
+            return;
+        matrix.scaleColumnsInPlace(scale, scale, scale);
+        const arrowTrans = Transform.createRefs(northDir.origin, matrix);
+        const northArrowBuilder = context.createGraphicBuilder(GraphicType.WorldOverlay, arrowTrans, id);
+        const color = ColorDef.white;
+        const arrowOutline = [];
+        arrowOutline[0] = Point3d.create(0.0, 0.65);
+        arrowOutline[1] = Point3d.create(-0.45, -0.5);
+        arrowOutline[2] = Point3d.create(0.0, -0.2);
+        arrowOutline[3] = Point3d.create(0.45, -0.5);
+        arrowOutline[4] = arrowOutline[0].clone();
+        const arrowLeftFill = [];
+        arrowLeftFill[0] = arrowOutline[0].clone();
+        arrowLeftFill[1] = arrowOutline[1].clone();
+        arrowLeftFill[2] = arrowOutline[2].clone();
+        arrowLeftFill[3] = arrowLeftFill[0].clone();
+        const arrowRightFill = [];
+        arrowRightFill[0] = arrowOutline[0].clone();
+        arrowRightFill[1] = arrowOutline[3].clone();
+        arrowRightFill[2] = arrowOutline[2].clone();
+        arrowRightFill[3] = arrowRightFill[0].clone();
+        northArrowBuilder.setSymbology(color, ColorDef.from(0, 0, 0, 200), 1);
+        northArrowBuilder.addArc(Arc3d.createXY(Point3d.createZero(), 0.6), true, true);
+        northArrowBuilder.addArc(Arc3d.createXY(Point3d.create(0.0, 0.85), 0.2), true, true);
+        northArrowBuilder.setSymbology(color, color, 2);
+        northArrowBuilder.addArc(Arc3d.createXY(Point3d.createZero(), 0.5), false, false);
+        northArrowBuilder.addLineString([Point3d.create(0.6, 0.0), Point3d.create(-0.6, 0.0)]);
+        northArrowBuilder.addLineString([Point3d.create(0.0, 0.6), Point3d.create(0.0, -0.6)]);
+        northArrowBuilder.setSymbology(color, ColorDef.from(150, 150, 150), 1);
+        northArrowBuilder.addShape(arrowLeftFill);
+        northArrowBuilder.setSymbology(color, ColorDef.black, 1);
+        northArrowBuilder.addShape(arrowRightFill);
+        northArrowBuilder.setSymbology(color, color, 1);
+        northArrowBuilder.addLineString(arrowOutline);
+        northArrowBuilder.setSymbology(color, color, 3);
+        northArrowBuilder.addLineString([Point3d.create(-0.1, 0.75), Point3d.create(-0.1, 0.95), Point3d.create(0.1, 0.75), Point3d.create(0.1, 0.95)]);
+        context.addDecorationFromBuilder(northArrowBuilder);
+    }
+    drawMonumentPoint(context, point, scaleFactor, id) {
+        const vp = context.viewport;
+        const pixelSize = vp.pixelsFromInches(0.25) * scaleFactor;
+        const scale = vp.viewingSpace.getPixelSizeAtPoint(point) * pixelSize;
+        const matrix = Matrix3d.createRotationAroundAxisIndex(AxisIndex.Z, Angle.createDegrees(45.0));
+        matrix.scaleColumnsInPlace(scale, scale, scale);
+        const monumentTrans = Transform.createRefs(point, matrix);
+        const monumentPointBuilder = context.createGraphicBuilder(GraphicType.WorldOverlay, monumentTrans, id);
+        const color = ColorDef.white;
+        monumentPointBuilder.setSymbology(color, ColorDef.from(0, 0, 0, 150), 1);
+        monumentPointBuilder.addArc(Arc3d.createXY(Point3d.createZero(), 0.7), true, true);
+        monumentPointBuilder.setSymbology(color, color, 2);
+        monumentPointBuilder.addArc(Arc3d.createXY(Point3d.createZero(), 0.5), false, false);
+        monumentPointBuilder.addLineString([Point3d.create(0.5, 0.0), Point3d.create(-0.5, 0.0)]);
+        monumentPointBuilder.addLineString([Point3d.create(0.0, 0.5), Point3d.create(0.0, -0.5)]);
+        context.addDecorationFromBuilder(monumentPointBuilder);
+    }
+    drawAreaTooLargeIndicator(context) {
+        if ((this._extentsLengthValid && this._extentsWidthValid) || undefined === this._clipRange)
+            return;
+        const corners = this._clipRange.corners();
+        const indices = Range3d.faceCornerIndices(5);
+        const points = [];
+        for (const index of indices)
+            points.push(corners[index]);
+        const areaWarnColor = ColorDef.red.withAlpha(50);
+        const areaWarnBuilder = context.createGraphicBuilder(GraphicType.WorldDecoration);
+        areaWarnBuilder.setSymbology(areaWarnColor, areaWarnColor, 1);
+        areaWarnBuilder.addShape(points);
+        context.addDecorationFromBuilder(areaWarnBuilder);
+    }
+    drawExtentTooLargeIndicator(context, worldPoint, sizePixels) {
+        const position = context.viewport.worldToView(worldPoint);
+        position.x = Math.floor(position.x) + 0.5;
+        position.y = Math.floor(position.y) + 0.5;
+        const drawDecoration = (ctx) => {
+            ctx.lineWidth = 4;
+            ctx.lineCap = "round";
+            ctx.strokeStyle = "rgba(255,0,0,.75)";
+            ctx.fillStyle = "rgba(255,255,255,.75)";
+            ctx.shadowColor = "black";
+            ctx.shadowBlur = 5;
+            ctx.beginPath();
+            ctx.moveTo(0, -sizePixels);
+            ctx.lineTo(-sizePixels, sizePixels);
+            ctx.lineTo(sizePixels, sizePixels);
+            ctx.lineTo(0, -sizePixels);
+            ctx.fill();
+            ctx.shadowBlur = 0;
+            ctx.beginPath();
+            ctx.moveTo(0, -sizePixels);
+            ctx.lineTo(-sizePixels, sizePixels);
+            ctx.lineTo(sizePixels, sizePixels);
+            ctx.lineTo(0, -sizePixels);
+            ctx.stroke();
+            ctx.strokeStyle = "black";
+            ctx.lineWidth = 3;
+            ctx.beginPath();
+            ctx.moveTo(0, -sizePixels * 0.2);
+            ctx.lineTo(0, sizePixels * 0.3);
+            ctx.moveTo(0, (sizePixels * 0.3) + 4);
+            ctx.lineTo(0, (sizePixels * 0.3) + 4.5);
+            ctx.stroke();
+        };
+        context.addCanvasDecoration({ position, drawDecoration });
+    }
+    decorate(context) {
+        if (this._suspendDecorator)
+            return;
+        if (undefined === this._clipId || undefined === this._clipShape || undefined === this._clipRange)
+            return;
+        const vp = context.viewport;
+        if (this.viewport !== vp)
+            return;
+        if (!this.suspendGeolocationDecorations && undefined !== this._northDirection && this.iModel.isGeoLocated)
+            this.drawNorthArrow(context, this._northDirection, this._allowEcefLocationChange ? this._northId : undefined); // Show north, but don't make pickable if it shouldn't be modified...
+        const maxSizeInches = ((this._clipRange.maxLength() / vp.viewingSpace.getPixelSizeAtPoint(this._clipRange.center)) / vp.pixelsPerInch) * 0.5; // Display size limit when zooming out...
+        if (maxSizeInches < 0.5)
+            return;
+        if (!this.suspendGeolocationDecorations && undefined !== this._monumentPoint && this._allowEcefLocationChange)
+            this.drawMonumentPoint(context, this._monumentPoint, 1.0, this._monumentId);
+        ViewClipTool.drawClipShape(context, this._clipShape, this._clipShapeExtents, ColorDef.white.adjustedForContrast(context.viewport.view.backgroundColor), 3, this._clipId);
+        this.drawAreaTooLargeIndicator(context);
+        if (!this._isActive)
+            return;
+        const outlineColor = ColorDef.from(0, 0, 0, 50).adjustedForContrast(vp.view.backgroundColor);
+        const fillVisColor = ColorDef.from(150, 250, 200, 225).adjustedForContrast(vp.view.backgroundColor);
+        const fillHidColor = fillVisColor.withAlpha(200);
+        const fillSelColor = fillVisColor.inverse().withAlpha(75);
+        const shapePts = EditManipulator.HandleUtils.getArrowShape(0.0, 0.15, 0.55, 1.0, 0.3, 0.5, 0.1);
+        for (let iFace = 0; iFace < this._controlIds.length; iFace++) {
+            const sizeInches = Math.min(this._controls[iFace].sizeInches, maxSizeInches);
+            if (0.0 === sizeInches)
+                continue;
+            const anchorRay = ViewClipTool.getClipRayTransformed(this._controls[iFace].origin, this._controls[iFace].direction, undefined !== this._clipShape ? this._clipShape.transformFromClip : undefined);
+            const transform = EditManipulator.HandleUtils.getArrowTransform(vp, anchorRay.origin, anchorRay.direction, sizeInches);
+            if (undefined === transform)
+                continue;
+            const visPts = [];
+            for (const pt of shapePts)
+                visPts.push(pt.clone()); // deep copy because we're using a builder transform w/addLineString...
+            const hidPts = [];
+            for (const pt of shapePts)
+                hidPts.push(pt.clone());
+            const arrowVisBuilder = context.createGraphicBuilder(GraphicType.WorldOverlay, transform, this._controlIds[iFace]);
+            const arrowHidBuilder = context.createGraphicBuilder(GraphicType.WorldDecoration, transform);
+            const isSelected = this.iModel.selectionSet.has(this._controlIds[iFace]);
+            let outlineColorOvr = this._controls[iFace].outline;
+            if (undefined !== outlineColorOvr) {
+                outlineColorOvr = outlineColorOvr.adjustedForContrast(vp.view.backgroundColor);
+                outlineColorOvr = outlineColorOvr.withAlpha(outlineColor.getAlpha());
+            }
+            else {
+                outlineColorOvr = outlineColor;
+            }
+            let fillVisColorOvr = this._controls[iFace].fill;
+            let fillHidColorOvr = fillHidColor;
+            let fillSelColorOvr = fillSelColor;
+            if (undefined !== fillVisColorOvr) {
+                fillVisColorOvr = fillVisColorOvr.adjustedForContrast(vp.view.backgroundColor);
+                fillVisColorOvr = fillVisColorOvr.withAlpha(fillVisColor.getAlpha());
+                fillHidColorOvr = fillVisColorOvr.withAlpha(fillHidColor.getAlpha());
+                fillSelColorOvr = fillVisColorOvr.inverse().withAlpha(fillSelColor.getAlpha());
+            }
+            else {
+                fillVisColorOvr = fillVisColor;
+            }
+            arrowVisBuilder.setSymbology(outlineColorOvr, outlineColorOvr, isSelected ? 4 : 2);
+            arrowVisBuilder.addLineString(visPts);
+            arrowVisBuilder.setBlankingFill(isSelected ? fillSelColorOvr : fillVisColorOvr);
+            arrowVisBuilder.addShape(visPts);
+            context.addDecorationFromBuilder(arrowVisBuilder);
+            arrowHidBuilder.setSymbology(fillHidColorOvr, fillHidColorOvr, 1);
+            arrowHidBuilder.addShape(hidPts);
+            context.addDecorationFromBuilder(arrowHidBuilder);
+            if (this._controls[iFace].extentValid)
+                continue;
+            const warnPixels = 15.0;
+            const warnOffset = vp.viewingSpace.getPixelSizeAtPoint(anchorRay.origin) * warnPixels * 1.5;
+            const warnOrigin = anchorRay.origin.plusScaled(anchorRay.direction, -warnOffset);
+            this.drawExtentTooLargeIndicator(context, warnOrigin, warnPixels);
+        }
+    }
+    resetViewClip() {
+        if (!clearViewClip(this.viewport))
+            return false;
+        if (undefined !== this.getModifiedExtents())
+            this.onChanged.raiseEvent(this.iModel, ProjectLocationChanged.ResetExtents);
+        return true;
+    }
+    resetGeolocation() {
+        if (!this._allowEcefLocationChange)
+            return false;
+        if (undefined === this.getModifiedEcefLocation())
+            return false; // Wasn't changed...
+        this.iModel.disableGCS(false);
+        this.iModel.ecefLocation = this._ecefLocation;
+        this._monumentPoint = this.getMonumentPoint();
+        this._northDirection = this.getNorthDirection();
+        updateMapDisplay(this.viewport, false);
+        this.onChanged.raiseEvent(this.iModel, ProjectLocationChanged.ResetGeolocation);
+        return true;
+    }
+    updateEcefLocation(origin, point, angle) {
+        if (!this._allowEcefLocationChange)
+            return false;
+        const newEcefLocation = EcefLocation.createFromCartographicOrigin(origin, point, (undefined !== angle ? angle : this.getNorthAngle())); // Preserve modified north direction...
+        const ecefLocation = this.iModel.ecefLocation;
+        if (undefined !== ecefLocation && ecefLocation.isAlmostEqual(newEcefLocation))
+            return false;
+        this.iModel.disableGCS(true); // Map display will ignore change to ecef location when GCS is present...
+        this.iModel.setEcefLocation(newEcefLocation);
+        this._monumentPoint = this.getMonumentPoint();
+        this._northDirection = this.getNorthDirection(undefined !== this._northDirection ? this._northDirection.origin : undefined); // Preserve modified north reference point...
+        updateMapDisplay(this.viewport, true);
+        this.onChanged.raiseEvent(this.iModel, ProjectLocationChanged.Geolocation);
+        return true;
+    }
+    updateNorthDirection(northDir) {
+        if (!this._allowEcefLocationChange || !this.iModel.isGeoLocated)
+            return false;
+        const point = (undefined !== this._monumentPoint ? this._monumentPoint : this.getMonumentPoint()); // Preserve modified monument point...
+        const origin = this.iModel.spatialToCartographicFromEcef(point);
+        const saveDirection = this._northDirection;
+        this._northDirection = northDir; // Change reference point to input location...
+        const angle = this.getNorthAngle();
+        if (!this.updateEcefLocation(origin, point, angle)) {
+            this._northDirection = saveDirection;
+            return false;
+        }
+        return true;
+    }
+    getModifiedEcefLocation() {
+        const ecefLocation = this.iModel.ecefLocation;
+        if (undefined === ecefLocation)
+            return undefined; // geolocation wasn't added...
+        if (undefined === this._ecefLocation)
+            return ecefLocation; // geolocation didn't exist previously...
+        if (this._ecefLocation.isAlmostEqual(ecefLocation))
+            return undefined;
+        return ecefLocation;
+    }
+    getModifiedExtents() {
+        if (undefined === this._clipRange)
+            return undefined;
+        return this._clipRange.isAlmostEqual(this.iModel.projectExtents) ? undefined : this._clipRange;
+    }
+    static allowEcefLocationChange(requireExisting, outputError = true) {
+        if (undefined === ProjectExtentsClipDecoration._decorator) {
+            if (outputError)
+                IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("NotActive")));
+            return false;
+        }
+        else if (!ProjectExtentsClipDecoration._decorator._allowEcefLocationChange) {
+            if (outputError)
+                IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("NotAllowed")));
+            return false;
+        }
+        else if (requireExisting && !ProjectExtentsClipDecoration._decorator.iModel.isGeoLocated) {
+            if (outputError)
+                IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("NotGeolocated")));
+            return false;
+        }
+        return true;
+    }
+    fitExtents() {
+        if (undefined === this._clipRange)
+            return undefined;
+        const options = { animateFrustumChange: true, animationTime: BeDuration.fromSeconds(2).milliseconds };
+        const aspect = this.viewport.viewRect.aspect;
+        this.viewport.view.lookAtVolume(this._clipRange, aspect);
+        this.viewport.synchWithView(options);
+        this.viewport.viewCmdTargetCenter = undefined;
+    }
+    static get() {
+        if (undefined === ProjectExtentsClipDecoration._decorator)
+            return undefined;
+        return ProjectExtentsClipDecoration._decorator;
+    }
+    static show(vp, fitExtents = true) {
+        if (!vp.view.isSpatialView())
+            return false;
+        if (undefined !== ProjectExtentsClipDecoration._decorator) {
+            const deco = ProjectExtentsClipDecoration._decorator;
+            if (vp === deco.viewport && undefined !== deco._clipId && undefined !== deco._clip) {
+                if (deco._clip !== vp.view.getViewClip()) {
+                    clearViewClip(vp);
+                    ViewClipTool.enableClipVolume(vp);
+                    ViewClipTool.setViewClip(vp, deco._clip);
+                }
+                if (undefined === deco._removeManipulatorToolListener) {
+                    deco._removeManipulatorToolListener = IModelApp.toolAdmin.manipulatorToolEvent.addListener((tool, event) => deco.onManipulatorToolEvent(tool, event));
+                    deco.start();
+                    deco.onChanged.raiseEvent(deco.iModel, ProjectLocationChanged.Show);
+                }
+                return true;
+            }
+            ProjectExtentsClipDecoration.clear();
+        }
+        if (!clipToProjectExtents(vp))
+            return false;
+        ProjectExtentsClipDecoration._decorator = new ProjectExtentsClipDecoration(vp);
+        if (fitExtents)
+            ProjectExtentsClipDecoration._decorator.fitExtents();
+        vp.onChangeView.addOnce(() => this.clear(false, true));
+        return (undefined !== ProjectExtentsClipDecoration._decorator._clipId);
+    }
+    static hide() {
+        if (undefined === ProjectExtentsClipDecoration._decorator)
+            return;
+        const saveClipId = ProjectExtentsClipDecoration._decorator._clipId; // cleared by stop to trigger decorator removal...
+        ProjectExtentsClipDecoration._decorator.stop();
+        ProjectExtentsClipDecoration._decorator._clipId = saveClipId;
+        ProjectExtentsClipDecoration._decorator.onChanged.raiseEvent(ProjectExtentsClipDecoration._decorator.iModel, ProjectLocationChanged.Hide);
+    }
+    static clear(clearClip = true, resetGeolocation = true) {
+        if (undefined === ProjectExtentsClipDecoration._decorator)
+            return;
+        if (clearClip)
+            ProjectExtentsClipDecoration._decorator.resetViewClip(); // Clear project extents view clip...
+        if (resetGeolocation)
+            ProjectExtentsClipDecoration._decorator.resetGeolocation(); // Restore modified geolocation back to create state...
+        ProjectExtentsClipDecoration._decorator.stop();
+        ProjectExtentsClipDecoration._decorator = undefined;
+    }
+    static async update() {
+        const deco = ProjectExtentsClipDecoration._decorator;
+        if (undefined === deco)
+            return;
+        clipToProjectExtents(deco.viewport);
+        deco.init();
+        return deco.updateControls();
+    }
+}
+/** Show project location decoration. Project extents represented by view clip.
+ * @beta
+ */
+export class ProjectLocationShowTool extends Tool {
+    async run() {
+        const vp = IModelApp.viewManager.selectedView;
+        if (undefined === vp || !ProjectExtentsClipDecoration.show(vp))
+            return false;
+        await IModelApp.toolAdmin.startDefaultTool();
+        return true;
+    }
+}
+ProjectLocationShowTool.toolId = "ProjectLocation.Show";
+/** Hide project location decoration. Preserves changes to project extents view clip and geolocation.
+ * @beta
+ */
+export class ProjectLocationHideTool extends Tool {
+    async run() {
+        ProjectExtentsClipDecoration.hide();
+        await IModelApp.toolAdmin.startDefaultTool();
+        return true;
+    }
+}
+ProjectLocationHideTool.toolId = "ProjectLocation.Hide";
+/** Clear project location decoration. Restore modified geolocation and remove view clip.
+ * @beta
+ */
+export class ProjectLocationCancelTool extends Tool {
+    async run() {
+        ProjectExtentsClipDecoration.clear();
+        await IModelApp.toolAdmin.startDefaultTool();
+        return true;
+    }
+}
+ProjectLocationCancelTool.toolId = "ProjectLocation.Cancel";
+/** Save modified project extents and geolocation. Updates decoration to reflect saved state.
+ * @note Allowing this change to be undone is both problematic and undesirable.
+ * Warns the user if called with previous changes to cancel restarting the TxnManager session.
+ * @beta
+ */
+export class ProjectLocationSaveTool extends Tool {
+    static callCommand(method, ...args) {
+        return EditTools.callCommand(method, ...args);
+    }
+    async allowRestartTxnSession(iModel) {
+        if (!await iModel.txns.isUndoPossible())
+            return true;
+        // NOTE: Default if openMessageBox isn't implemented is MessageBoxValue.Ok, so we'll check No instead of Yes...
+        if (MessageBoxValue.No === await IModelApp.notifications.openMessageBox(MessageBoxType.YesNo, translateMessage("RestartTxn"), MessageBoxIconType.Question))
+            return false;
+        return true;
+    }
+    async saveChanges(deco, extents, ecefLocation) {
+        if (!deco.iModel.isBriefcaseConnection())
+            return;
+        if (!await this.allowRestartTxnSession(deco.iModel))
+            return;
+        try {
+            await EditTools.startCommand(editorBuiltInCmdIds.cmdBasicManipulation, deco.iModel.key);
+            if (undefined !== extents)
+                await ProjectLocationSaveTool.callCommand("updateProjectExtents", extents);
+            if (undefined !== ecefLocation)
+                await ProjectLocationSaveTool.callCommand("updateEcefLocation", ecefLocation);
+            await deco.iModel.saveChanges(this.toolId);
+            await deco.iModel.txns.restartTxnSession();
+        }
+        catch (err) {
+            IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Error, BentleyError.getErrorMessage(err) || "An unknown error occurred."));
+        }
+        deco.onChanged.raiseEvent(deco.iModel, ProjectLocationChanged.Save);
+        await ProjectExtentsClipDecoration.update();
+        return IModelApp.toolAdmin.startDefaultTool();
+    }
+    async run() {
+        const deco = ProjectExtentsClipDecoration.get();
+        if (undefined === deco) {
+            IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("NotActive")));
+            return false;
+        }
+        if (deco.iModel.isReadonly) {
+            IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("Readonly")));
+            return true;
+        }
+        const extents = deco.getModifiedExtents();
+        const ecefLocation = deco.getModifiedEcefLocation();
+        if (undefined === extents && undefined === ecefLocation) {
+            IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Info, translateMessage("NoChanges")));
+            return true;
+        }
+        await this.saveChanges(deco, extents, ecefLocation);
+        return true;
+    }
+}
+ProjectLocationSaveTool.toolId = "ProjectLocation.Save";
 //# sourceMappingURL=ProjectExtentsDecoration.js.map