@itwin/core-frontend 4.1.0-dev.6 → 4.1.0-dev.62

package/lib/esm/ElementLocateManager.js

@@ -7,11 +7,11 @@
  */
 import { Id64 } from "@itwin/core-bentley";
 import { Point2d, Point3d } from "@itwin/core-geometry";
-import { HitDetail, HitList, HitPriority, HitSource } from "./HitDetail";
+import { HitDetail, HitList, HitSource } from "./HitDetail";
 import { IModelApp } from "./IModelApp";
 import { Pixel } from "./render/Pixel";
 import { InputSource, InteractiveTool } from "./tools/Tool";
-import { ViewRect } from "./ViewRect";
+import { ViewRect } from "./common/ViewRect";
 /** The possible actions for which a locate filter can be called.
  * @public
  * @extensions
@@ -149,23 +149,9 @@ export class ElementPicker {
         if (this.hitList)
             this.hitList.resetCurrentHit();
     }
-    getPixelPriority(pixel) {
-        switch (pixel.type) {
-            case Pixel.GeometryType.Surface:
-                return Pixel.Planarity.Planar === pixel.planarity ? HitPriority.PlanarSurface : HitPriority.NonPlanarSurface;
-            case Pixel.GeometryType.Linear:
-                return HitPriority.WireEdge;
-            case Pixel.GeometryType.Edge:
-                return Pixel.Planarity.Planar === pixel.planarity ? HitPriority.PlanarEdge : HitPriority.NonPlanarEdge;
-            case Pixel.GeometryType.Silhouette:
-                return HitPriority.SilhouetteEdge;
-            default:
-                return HitPriority.Unknown;
-        }
-    }
     comparePixel(pixel1, pixel2, distXY1, distXY2) {
-        const priority1 = this.getPixelPriority(pixel1);
-        const priority2 = this.getPixelPriority(pixel2);
+        const priority1 = pixel1.computeHitPriority();
+        const priority2 = pixel2.computeHitPriority();
         if (priority1 < priority2)
             return -1;
         if (priority1 > priority2)
@@ -238,8 +224,14 @@ export class ElementPicker {
                 });
                 if (!hitPointWorld)
                     continue;
-                const modelId = pixel.modelId;
-                const hit = new HitDetail(pickPointWorld, vp, options.hitSource, hitPointWorld, pixel.elementId, this.getPixelPriority(pixel), testPointView.distance(elmPoint), pixel.distanceFraction, pixel.subCategoryId, pixel.geometryClass, modelId, pixel.iModel, pixel.tileId, pixel.isClassifier);
+                const hit = new HitDetail({
+                    ...pixel.toHitProps(vp),
+                    testPoint: pickPointWorld,
+                    viewport: vp,
+                    hitSource: options.hitSource,
+                    hitPoint: hitPointWorld,
+                    distXY: testPointView.distance(elmPoint),
+                });
                 this.hitList.addHit(hit);
                 if (this.hitList.hits.length > options.maxHits)
                     this.hitList.hits.length = options.maxHits; // truncate array...

package/lib/esm/ElementLocateManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElementLocateManager.js","sourceRoot":"","sources":["../../src/ElementLocateManager.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module LocatingElements\r\n */\r\n\r\nimport { Id64 } from \"@itwin/core-bentley\";\r\nimport { Point2d, Point3d } from \"@itwin/core-geometry\";\r\nimport { HitDetail, HitList, HitPriority, HitSource } from \"./HitDetail\";\r\nimport { IModelApp } from \"./IModelApp\";\r\nimport { Pixel } from \"./render/Pixel\";\r\nimport { InputSource, InteractiveTool } from \"./tools/Tool\";\r\nimport { ScreenViewport, Viewport } from \"./Viewport\";\r\nimport { ViewRect } from \"./ViewRect\";\r\n\r\n/** The possible actions for which a locate filter can be called.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum LocateAction {\r\n  Identify = 0,\r\n  AutoLocate = 1,\r\n}\r\n\r\n/** Values to return from a locate filter.\r\n * Return `Reject` to indicate the element is unacceptable.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum LocateFilterStatus {\r\n  Accept = 0,\r\n  Reject = 1,\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SnapStatus {\r\n  Success = 0,\r\n  Aborted = 1,\r\n  NoElements = 2,\r\n  Disabled = 100,\r\n  NoSnapPossible = 200,\r\n  NotSnappable = 300,\r\n  FilteredByApp = 600,\r\n  FilteredByAppQuietly = 700,\r\n}\r\n\r\n/** Options that customize the way element location (i.e. *picking*) works.\r\n * @public\r\n * @extensions\r\n */\r\nexport class LocateOptions {\r\n  /** If true, also test graphics from view decorations. */\r\n  public allowDecorations = false;\r\n  /** If true, also test graphics with non-locatable flag set. */\r\n  public allowNonLocatable = false;\r\n  /** Maximum number of hits to return. */\r\n  public maxHits = 20;\r\n  /** The [[HitSource]] identifying the caller. */\r\n  public hitSource = HitSource.DataPoint;\r\n  /** If true, also test graphics from an IModelConnection other than the one associated with the Viewport. This can occur if, e.g., a\r\n   * [[TiledGraphicsProvider]] is used to display graphics from a different iModel into the [[Viewport]].\r\n   * @note If you override this, you must be prepared to properly handle [[HitDetail]]s originating from other IModelConnections.\r\n   * @see [[HitDetail.iModel]] and [[HitDetail.isExternalIModelHit]]\r\n   */\r\n  public allowExternalIModels = false;\r\n  /** If true, then the world point of a hit on a model will preserve any transforms applied to the model at display time,\r\n   * such as those supplied by a [[ModelDisplayTransformProvider]] or [PlanProjectionSettings.elevation]($common).\r\n   * Otherwise, the world point will be multiplied by the inverse of any such transforms to correlate it with the model's true coordinate space.\r\n   */\r\n  public preserveModelDisplayTransforms = false;\r\n\r\n  /** Make a copy of this LocateOptions. */\r\n  public clone(): LocateOptions {\r\n    const other = new LocateOptions();\r\n    other.allowDecorations = this.allowDecorations;\r\n    other.allowNonLocatable = this.allowNonLocatable;\r\n    other.maxHits = this.maxHits;\r\n    other.hitSource = this.hitSource;\r\n    other.allowExternalIModels = this.allowExternalIModels;\r\n    return other;\r\n  }\r\n  public setFrom(other: LocateOptions): void {\r\n    this.allowDecorations = other.allowDecorations;\r\n    this.allowNonLocatable = other.allowNonLocatable;\r\n    this.maxHits = other.maxHits;\r\n    this.hitSource = other.hitSource;\r\n    this.allowExternalIModels = other.allowExternalIModels;\r\n  }\r\n  public init() {\r\n    this.allowDecorations = this.allowNonLocatable = this.allowExternalIModels = false;\r\n    this.maxHits = 20;\r\n    this.hitSource = HitSource.DataPoint;\r\n  }\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport class LocateResponse {\r\n  public snapStatus = SnapStatus.Success;\r\n  public reason?: string;\r\n  public explanation = \"\";\r\n\r\n  /** @internal */\r\n  public clone(): LocateResponse {\r\n    const other = new LocateResponse();\r\n    other.snapStatus = this.snapStatus;\r\n    other.reason = this.reason;\r\n    other.explanation = this.explanation;\r\n    return other;\r\n  }\r\n\r\n  /** @internal */\r\n  public setFrom(other: LocateResponse): void {\r\n    this.snapStatus = other.snapStatus;\r\n    this.reason = other.reason;\r\n    this.explanation = other.explanation;\r\n  }\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport interface HitListHolder {\r\n  setHitList(list: HitList<HitDetail> | undefined): void;\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport class ElementPicker {\r\n  public viewport?: Viewport;\r\n  public readonly pickPointWorld = new Point3d();\r\n  public hitList?: HitList<HitDetail>;\r\n\r\n  public empty() {\r\n    this.pickPointWorld.setZero();\r\n    this.viewport = undefined;\r\n    if (this.hitList)\r\n      this.hitList.empty();\r\n    else\r\n      this.hitList = new HitList<HitDetail>();\r\n  }\r\n\r\n  /** return the HitList for the last Pick performed. Optionally allows the caller to take ownership of the list. */\r\n  public getHitList(takeOwnership: boolean): HitList<HitDetail> {\r\n    const list = this.hitList!;\r\n    if (takeOwnership)\r\n      this.hitList = undefined;\r\n    return list;\r\n  }\r\n\r\n  public getNextHit(): HitDetail | undefined { return this.hitList ? this.hitList.getNextHit() : undefined; }\r\n\r\n  /** Return a hit from the list of hits created the last time pickElements was called. */\r\n  public getHit(i: number): HitDetail | undefined { return this.hitList ? this.hitList.getHit(i) : undefined; }\r\n\r\n  public resetCurrentHit(): void {\r\n    if (this.hitList)\r\n      this.hitList.resetCurrentHit();\r\n  }\r\n\r\n  private getPixelPriority(pixel: Pixel.Data) {\r\n    switch (pixel.type) {\r\n      case Pixel.GeometryType.Surface:\r\n        return Pixel.Planarity.Planar === pixel.planarity ? HitPriority.PlanarSurface : HitPriority.NonPlanarSurface;\r\n      case Pixel.GeometryType.Linear:\r\n        return HitPriority.WireEdge;\r\n      case Pixel.GeometryType.Edge:\r\n        return Pixel.Planarity.Planar === pixel.planarity ? HitPriority.PlanarEdge : HitPriority.NonPlanarEdge;\r\n      case Pixel.GeometryType.Silhouette:\r\n        return HitPriority.SilhouetteEdge;\r\n      default:\r\n        return HitPriority.Unknown;\r\n    }\r\n  }\r\n\r\n  private comparePixel(pixel1: Pixel.Data, pixel2: Pixel.Data, distXY1: number, distXY2: number) {\r\n    const priority1 = this.getPixelPriority(pixel1);\r\n    const priority2 = this.getPixelPriority(pixel2);\r\n    if (priority1 < priority2)\r\n      return -1;\r\n    if (priority1 > priority2)\r\n      return 1;\r\n    if (distXY1 < distXY2)\r\n      return -1;\r\n    if (distXY1 > distXY2)\r\n      return 1;\r\n    if (pixel1.distanceFraction > pixel2.distanceFraction)\r\n      return -1;\r\n    if (pixel1.distanceFraction < pixel2.distanceFraction)\r\n      return 1;\r\n\r\n    return 0;\r\n  }\r\n\r\n  /** Generate a list of elements that are close to a given point.\r\n   * @returns The number of hits in the hitList of this object.\r\n   */\r\n  public doPick(vp: ScreenViewport, pickPointWorld: Point3d, pickRadiusView: number, options: LocateOptions): number {\r\n    if (this.hitList && this.hitList.length > 0 && vp === this.viewport && pickPointWorld.isAlmostEqual(this.pickPointWorld)) {\r\n      this.hitList.resetCurrentHit();\r\n      return this.hitList.length;\r\n    }\r\n\r\n    this.empty(); // empty the hit list\r\n    this.viewport = vp;\r\n    this.pickPointWorld.setFrom(pickPointWorld);\r\n\r\n    const pickPointView = vp.worldToView(pickPointWorld);\r\n    const testPointView = new Point2d(Math.floor(pickPointView.x + 0.5), Math.floor(pickPointView.y + 0.5));\r\n    let pixelRadius = Math.floor(pickRadiusView + 0.5);\r\n    const rect = new ViewRect(testPointView.x - pixelRadius, testPointView.y - pixelRadius, testPointView.x + pixelRadius, testPointView.y + pixelRadius);\r\n    if (rect.isNull)\r\n      return 0;\r\n    let result: number = 0;\r\n    vp.readPixels(rect, Pixel.Selector.All, (pixels) => {\r\n      if (undefined === pixels)\r\n        return;\r\n\r\n      testPointView.x = vp.cssPixelsToDevicePixels(testPointView.x);\r\n      testPointView.y = vp.cssPixelsToDevicePixels(testPointView.y);\r\n      pixelRadius = vp.cssPixelsToDevicePixels(pixelRadius);\r\n\r\n      const elmHits = new Map<string, Point2d>();\r\n      const testPoint = Point2d.createZero();\r\n      for (testPoint.x = testPointView.x - pixelRadius; testPoint.x <= testPointView.x + pixelRadius; ++testPoint.x) {\r\n        for (testPoint.y = testPointView.y - pixelRadius; testPoint.y <= testPointView.y + pixelRadius; ++testPoint.y) {\r\n          const pixel = pixels.getPixel(testPoint.x, testPoint.y);\r\n          if (undefined === pixel || undefined === pixel.elementId || Id64.isInvalid(pixel.elementId))\r\n            continue; // no geometry at this location...\r\n\r\n          const distXY = testPointView.distance(testPoint);\r\n          if (distXY > pixelRadius)\r\n            continue; // ignore corners. it's a locate circle not square...\r\n\r\n          const oldPoint = elmHits.get(pixel.elementId);\r\n          if (undefined !== oldPoint) {\r\n            if (this.comparePixel(pixel, pixels.getPixel(oldPoint.x, oldPoint.y), distXY, testPointView.distance(oldPoint)) < 0)\r\n              oldPoint.setFrom(testPoint); // new hit is better, update location...\r\n          } else {\r\n            elmHits.set(pixel.elementId, testPoint.clone());\r\n          }\r\n        }\r\n      }\r\n      if (0 === elmHits.size)\r\n        return;\r\n\r\n      for (const elmPoint of elmHits.values()) {\r\n        const pixel = pixels.getPixel(elmPoint.x, elmPoint.y);\r\n        if (undefined === pixel || undefined === pixel.elementId)\r\n          continue;\r\n\r\n        const hitPointWorld = vp.getPixelDataWorldPoint({\r\n          pixels,\r\n          x: elmPoint.x,\r\n          y: elmPoint.y,\r\n          preserveModelDisplayTransforms: options.preserveModelDisplayTransforms,\r\n        });\r\n\r\n        if (!hitPointWorld)\r\n          continue;\r\n\r\n        const modelId = pixel.modelId;\r\n        const hit = new HitDetail(pickPointWorld, vp, options.hitSource, hitPointWorld, pixel.elementId, this.getPixelPriority(pixel), testPointView.distance(elmPoint), pixel.distanceFraction, pixel.subCategoryId, pixel.geometryClass, modelId, pixel.iModel, pixel.tileId, pixel.isClassifier);\r\n        this.hitList!.addHit(hit);\r\n\r\n        if (this.hitList!.hits.length > options.maxHits)\r\n          this.hitList!.hits.length = options.maxHits; // truncate array...\r\n      }\r\n\r\n      result = this.hitList!.length;\r\n    }, !options.allowNonLocatable);\r\n\r\n    return result;\r\n  }\r\n\r\n  public testHit(hit: HitDetail, vp: ScreenViewport, pickPointWorld: Point3d, pickRadiusView: number, options: LocateOptions): boolean {\r\n    if (0 === this.doPick(vp, pickPointWorld, pickRadiusView, options))\r\n      return false;\r\n\r\n    return this.hitList!.hits.some((thisHit) => hit.isSameHit(thisHit));\r\n  }\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport class ElementLocateManager {\r\n  public hitList?: HitList<HitDetail>;\r\n  public currHit?: HitDetail;\r\n  public readonly options = new LocateOptions();\r\n  public readonly picker = new ElementPicker();\r\n\r\n  /** get the full message key for a locate failure  */\r\n  public static getFailureMessageKey(key: string) { return `LocateFailure.${key}`; }\r\n  public onInitialized() { }\r\n  public get apertureInches() { return 0.11; }\r\n  public get touchApertureInches() { return 0.22; }\r\n\r\n  public clear(): void { this.setCurrHit(undefined); }\r\n  public setHitList(list?: HitList<HitDetail>) { this.hitList = list; }\r\n  public setCurrHit(hit?: HitDetail): void { this.currHit = hit; }\r\n  public getNextHit(): HitDetail | undefined { return this.hitList ? this.hitList.getNextHit() : undefined; }\r\n\r\n  /** return the current path from either the snapping logic or the pre-locating systems. */\r\n  public getPreLocatedHit(): HitDetail | undefined {\r\n    // NOTE: Check AccuSnap first as Tentative is used to build intersect snap. For normal snaps when a Tentative is active there should be no AccuSnap.\r\n    let preLocated = IModelApp.accuSnap.getHitAndList(this);\r\n\r\n    if (!preLocated && !!(preLocated = IModelApp.tentativePoint.getHitAndList(this))) {\r\n      const vp = preLocated.viewport;\r\n      this.picker.empty(); // Get new hit list at hit point; want reset to cycle hits using adjusted point location...\r\n      this.picker.doPick(vp, preLocated.getPoint(), (vp.pixelsFromInches(this.apertureInches) / 2.0) + 1.5, this.options);\r\n      this.setHitList(this.picker.getHitList(true));\r\n    }\r\n\r\n    if (this.hitList)\r\n      this.hitList.resetCurrentHit();\r\n\r\n    return preLocated;\r\n  }\r\n\r\n  public async filterHit(hit: HitDetail, _action: LocateAction, out: LocateResponse): Promise<LocateFilterStatus> {\r\n    // Tools must opt-in to locate of transient geometry as it requires special treatment.\r\n    if (!this.options.allowDecorations && !hit.isElementHit) {\r\n      if (hit.isModelHit)\r\n        out.reason = ElementLocateManager.getFailureMessageKey(\"RealityModel\");\r\n      else if (hit.isMapHit)\r\n        out.reason = ElementLocateManager.getFailureMessageKey(\"Map\");\r\n      else\r\n        out.reason = ElementLocateManager.getFailureMessageKey(\"Transient\");\r\n      return LocateFilterStatus.Reject;\r\n    }\r\n\r\n    // Tools must opt-in to locate geometry from external iModels.\r\n    if (!this.options.allowExternalIModels && hit.isExternalIModelHit) {\r\n      out.reason = ElementLocateManager.getFailureMessageKey(\"ExternalIModel\");\r\n      return LocateFilterStatus.Reject;\r\n    }\r\n\r\n    if (undefined !== hit.subCategoryId && !hit.isExternalIModelHit) {\r\n      const appearance = hit.viewport.getSubCategoryAppearance(hit.subCategoryId);\r\n      if (appearance.dontLocate) {\r\n        out.reason = ElementLocateManager.getFailureMessageKey(\"NotLocatableSubCategory\");\r\n        return LocateFilterStatus.Reject;\r\n      }\r\n    }\r\n\r\n    const tool = IModelApp.toolAdmin.activeTool;\r\n    if (!(tool && tool instanceof InteractiveTool))\r\n      return LocateFilterStatus.Accept;\r\n\r\n    const status = await tool.filterHit(hit, out);\r\n    if (LocateFilterStatus.Reject === status)\r\n      out.reason = ElementLocateManager.getFailureMessageKey(\"ByApp\");\r\n\r\n    return status;\r\n  }\r\n\r\n  public initLocateOptions() { this.options.init(); }\r\n  public initToolLocate() {\r\n    this.initLocateOptions();\r\n    this.clear();\r\n    this.picker.empty();\r\n    IModelApp.tentativePoint.clear(true);\r\n  }\r\n\r\n  private async _doLocate(response: LocateResponse, newSearch: boolean, testPoint: Point3d, vp: ScreenViewport | undefined, source: InputSource, filterHits: boolean): Promise<HitDetail | undefined> {\r\n    if (!vp)\r\n      return;\r\n\r\n    // the \"newSearch\" flag indicates whether the caller wants us to conduct a new search at the testPoint, or just continue returning paths from the previous search.\r\n    if (newSearch) {\r\n      const hit = this.getPreLocatedHit();\r\n\r\n      // if we're snapped to something, that path has the highest priority and becomes the active hit.\r\n      if (hit) {\r\n        if (!filterHits || LocateFilterStatus.Accept === await this.filterHit(hit, LocateAction.Identify, response))\r\n          return hit;\r\n\r\n        response = new LocateResponse(); // we have the reason and explanation we want.\r\n      }\r\n\r\n      this.picker.empty();\r\n      this.picker.doPick(vp, testPoint, (vp.pixelsFromInches(InputSource.Touch === source ? this.touchApertureInches : this.apertureInches) / 2.0) + 1.5, this.options);\r\n\r\n      const hitList = this.picker.getHitList(true);\r\n      this.setHitList(hitList);\r\n    }\r\n\r\n    let newHit: HitDetail | undefined;\r\n    while (undefined !== (newHit = this.getNextHit())) {\r\n      if (!filterHits || LocateFilterStatus.Accept === await this.filterHit(newHit, LocateAction.Identify, response))\r\n        return newHit;\r\n      response = new LocateResponse(); // we have the reason and explanation we want.\r\n    }\r\n\r\n    return undefined;\r\n  }\r\n\r\n  public async doLocate(response: LocateResponse, newSearch: boolean, testPoint: Point3d, view: ScreenViewport | undefined, source: InputSource, filterHits = true): Promise<HitDetail | undefined> {\r\n    response.reason = ElementLocateManager.getFailureMessageKey(\"NoElements\");\r\n    response.explanation = \"\";\r\n\r\n    const hit = await this._doLocate(response, newSearch, testPoint, view, source, filterHits);\r\n    this.setCurrHit(hit);\r\n\r\n    // if we found a hit, remove it from the list of remaining hits near the current search point.\r\n    if (hit && this.hitList)\r\n      this.hitList.removeHitsFrom(hit.sourceId);\r\n    return hit;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ElementLocateManager.js","sourceRoot":"","sources":["../../src/ElementLocateManager.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module LocatingElements\r\n */\r\n\r\nimport { Id64 } from \"@itwin/core-bentley\";\r\nimport { Point2d, Point3d } from \"@itwin/core-geometry\";\r\nimport { HitDetail, HitList, HitSource } from \"./HitDetail\";\r\nimport { IModelApp } from \"./IModelApp\";\r\nimport { Pixel } from \"./render/Pixel\";\r\nimport { InputSource, InteractiveTool } from \"./tools/Tool\";\r\nimport { ScreenViewport, Viewport } from \"./Viewport\";\r\nimport { ViewRect } from \"./common/ViewRect\";\r\n\r\n/** The possible actions for which a locate filter can be called.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum LocateAction {\r\n  Identify = 0,\r\n  AutoLocate = 1,\r\n}\r\n\r\n/** Values to return from a locate filter.\r\n * Return `Reject` to indicate the element is unacceptable.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum LocateFilterStatus {\r\n  Accept = 0,\r\n  Reject = 1,\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SnapStatus {\r\n  Success = 0,\r\n  Aborted = 1,\r\n  NoElements = 2,\r\n  Disabled = 100,\r\n  NoSnapPossible = 200,\r\n  NotSnappable = 300,\r\n  FilteredByApp = 600,\r\n  FilteredByAppQuietly = 700,\r\n}\r\n\r\n/** Options that customize the way element location (i.e. *picking*) works.\r\n * @public\r\n * @extensions\r\n */\r\nexport class LocateOptions {\r\n  /** If true, also test graphics from view decorations. */\r\n  public allowDecorations = false;\r\n  /** If true, also test graphics with non-locatable flag set. */\r\n  public allowNonLocatable = false;\r\n  /** Maximum number of hits to return. */\r\n  public maxHits = 20;\r\n  /** The [[HitSource]] identifying the caller. */\r\n  public hitSource = HitSource.DataPoint;\r\n  /** If true, also test graphics from an IModelConnection other than the one associated with the Viewport. This can occur if, e.g., a\r\n   * [[TiledGraphicsProvider]] is used to display graphics from a different iModel into the [[Viewport]].\r\n   * @note If you override this, you must be prepared to properly handle [[HitDetail]]s originating from other IModelConnections.\r\n   * @see [[HitDetail.iModel]] and [[HitDetail.isExternalIModelHit]]\r\n   */\r\n  public allowExternalIModels = false;\r\n  /** If true, then the world point of a hit on a model will preserve any transforms applied to the model at display time,\r\n   * such as those supplied by a [[ModelDisplayTransformProvider]] or [PlanProjectionSettings.elevation]($common).\r\n   * Otherwise, the world point will be multiplied by the inverse of any such transforms to correlate it with the model's true coordinate space.\r\n   */\r\n  public preserveModelDisplayTransforms = false;\r\n\r\n  /** Make a copy of this LocateOptions. */\r\n  public clone(): LocateOptions {\r\n    const other = new LocateOptions();\r\n    other.allowDecorations = this.allowDecorations;\r\n    other.allowNonLocatable = this.allowNonLocatable;\r\n    other.maxHits = this.maxHits;\r\n    other.hitSource = this.hitSource;\r\n    other.allowExternalIModels = this.allowExternalIModels;\r\n    return other;\r\n  }\r\n  public setFrom(other: LocateOptions): void {\r\n    this.allowDecorations = other.allowDecorations;\r\n    this.allowNonLocatable = other.allowNonLocatable;\r\n    this.maxHits = other.maxHits;\r\n    this.hitSource = other.hitSource;\r\n    this.allowExternalIModels = other.allowExternalIModels;\r\n  }\r\n  public init() {\r\n    this.allowDecorations = this.allowNonLocatable = this.allowExternalIModels = false;\r\n    this.maxHits = 20;\r\n    this.hitSource = HitSource.DataPoint;\r\n  }\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport class LocateResponse {\r\n  public snapStatus = SnapStatus.Success;\r\n  public reason?: string;\r\n  public explanation = \"\";\r\n\r\n  /** @internal */\r\n  public clone(): LocateResponse {\r\n    const other = new LocateResponse();\r\n    other.snapStatus = this.snapStatus;\r\n    other.reason = this.reason;\r\n    other.explanation = this.explanation;\r\n    return other;\r\n  }\r\n\r\n  /** @internal */\r\n  public setFrom(other: LocateResponse): void {\r\n    this.snapStatus = other.snapStatus;\r\n    this.reason = other.reason;\r\n    this.explanation = other.explanation;\r\n  }\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport interface HitListHolder {\r\n  setHitList(list: HitList<HitDetail> | undefined): void;\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport class ElementPicker {\r\n  public viewport?: Viewport;\r\n  public readonly pickPointWorld = new Point3d();\r\n  public hitList?: HitList<HitDetail>;\r\n\r\n  public empty() {\r\n    this.pickPointWorld.setZero();\r\n    this.viewport = undefined;\r\n    if (this.hitList)\r\n      this.hitList.empty();\r\n    else\r\n      this.hitList = new HitList<HitDetail>();\r\n  }\r\n\r\n  /** return the HitList for the last Pick performed. Optionally allows the caller to take ownership of the list. */\r\n  public getHitList(takeOwnership: boolean): HitList<HitDetail> {\r\n    const list = this.hitList!;\r\n    if (takeOwnership)\r\n      this.hitList = undefined;\r\n    return list;\r\n  }\r\n\r\n  public getNextHit(): HitDetail | undefined { return this.hitList ? this.hitList.getNextHit() : undefined; }\r\n\r\n  /** Return a hit from the list of hits created the last time pickElements was called. */\r\n  public getHit(i: number): HitDetail | undefined { return this.hitList ? this.hitList.getHit(i) : undefined; }\r\n\r\n  public resetCurrentHit(): void {\r\n    if (this.hitList)\r\n      this.hitList.resetCurrentHit();\r\n  }\r\n\r\n  private comparePixel(pixel1: Pixel.Data, pixel2: Pixel.Data, distXY1: number, distXY2: number) {\r\n    const priority1 = pixel1.computeHitPriority();\r\n    const priority2 = pixel2.computeHitPriority();\r\n    if (priority1 < priority2)\r\n      return -1;\r\n    if (priority1 > priority2)\r\n      return 1;\r\n    if (distXY1 < distXY2)\r\n      return -1;\r\n    if (distXY1 > distXY2)\r\n      return 1;\r\n    if (pixel1.distanceFraction > pixel2.distanceFraction)\r\n      return -1;\r\n    if (pixel1.distanceFraction < pixel2.distanceFraction)\r\n      return 1;\r\n\r\n    return 0;\r\n  }\r\n\r\n  /** Generate a list of elements that are close to a given point.\r\n   * @returns The number of hits in the hitList of this object.\r\n   */\r\n  public doPick(vp: ScreenViewport, pickPointWorld: Point3d, pickRadiusView: number, options: LocateOptions): number {\r\n    if (this.hitList && this.hitList.length > 0 && vp === this.viewport && pickPointWorld.isAlmostEqual(this.pickPointWorld)) {\r\n      this.hitList.resetCurrentHit();\r\n      return this.hitList.length;\r\n    }\r\n\r\n    this.empty(); // empty the hit list\r\n    this.viewport = vp;\r\n    this.pickPointWorld.setFrom(pickPointWorld);\r\n\r\n    const pickPointView = vp.worldToView(pickPointWorld);\r\n    const testPointView = new Point2d(Math.floor(pickPointView.x + 0.5), Math.floor(pickPointView.y + 0.5));\r\n    let pixelRadius = Math.floor(pickRadiusView + 0.5);\r\n    const rect = new ViewRect(testPointView.x - pixelRadius, testPointView.y - pixelRadius, testPointView.x + pixelRadius, testPointView.y + pixelRadius);\r\n    if (rect.isNull)\r\n      return 0;\r\n    let result: number = 0;\r\n    vp.readPixels(rect, Pixel.Selector.All, (pixels) => {\r\n      if (undefined === pixels)\r\n        return;\r\n\r\n      testPointView.x = vp.cssPixelsToDevicePixels(testPointView.x);\r\n      testPointView.y = vp.cssPixelsToDevicePixels(testPointView.y);\r\n      pixelRadius = vp.cssPixelsToDevicePixels(pixelRadius);\r\n\r\n      const elmHits = new Map<string, Point2d>();\r\n      const testPoint = Point2d.createZero();\r\n      for (testPoint.x = testPointView.x - pixelRadius; testPoint.x <= testPointView.x + pixelRadius; ++testPoint.x) {\r\n        for (testPoint.y = testPointView.y - pixelRadius; testPoint.y <= testPointView.y + pixelRadius; ++testPoint.y) {\r\n          const pixel = pixels.getPixel(testPoint.x, testPoint.y);\r\n          if (undefined === pixel || undefined === pixel.elementId || Id64.isInvalid(pixel.elementId))\r\n            continue; // no geometry at this location...\r\n\r\n          const distXY = testPointView.distance(testPoint);\r\n          if (distXY > pixelRadius)\r\n            continue; // ignore corners. it's a locate circle not square...\r\n\r\n          const oldPoint = elmHits.get(pixel.elementId);\r\n          if (undefined !== oldPoint) {\r\n            if (this.comparePixel(pixel, pixels.getPixel(oldPoint.x, oldPoint.y), distXY, testPointView.distance(oldPoint)) < 0)\r\n              oldPoint.setFrom(testPoint); // new hit is better, update location...\r\n          } else {\r\n            elmHits.set(pixel.elementId, testPoint.clone());\r\n          }\r\n        }\r\n      }\r\n      if (0 === elmHits.size)\r\n        return;\r\n\r\n      for (const elmPoint of elmHits.values()) {\r\n        const pixel = pixels.getPixel(elmPoint.x, elmPoint.y);\r\n        if (undefined === pixel || undefined === pixel.elementId)\r\n          continue;\r\n\r\n        const hitPointWorld = vp.getPixelDataWorldPoint({\r\n          pixels,\r\n          x: elmPoint.x,\r\n          y: elmPoint.y,\r\n          preserveModelDisplayTransforms: options.preserveModelDisplayTransforms,\r\n        });\r\n\r\n        if (!hitPointWorld)\r\n          continue;\r\n\r\n        const hit = new HitDetail({\r\n          ...pixel.toHitProps(vp),\r\n          testPoint: pickPointWorld,\r\n          viewport: vp,\r\n          hitSource: options.hitSource,\r\n          hitPoint: hitPointWorld,\r\n          distXY: testPointView.distance(elmPoint),\r\n        });\r\n\r\n        this.hitList!.addHit(hit);\r\n        if (this.hitList!.hits.length > options.maxHits)\r\n          this.hitList!.hits.length = options.maxHits; // truncate array...\r\n      }\r\n\r\n      result = this.hitList!.length;\r\n    }, !options.allowNonLocatable);\r\n\r\n    return result;\r\n  }\r\n\r\n  public testHit(hit: HitDetail, vp: ScreenViewport, pickPointWorld: Point3d, pickRadiusView: number, options: LocateOptions): boolean {\r\n    if (0 === this.doPick(vp, pickPointWorld, pickRadiusView, options))\r\n      return false;\r\n\r\n    return this.hitList!.hits.some((thisHit) => hit.isSameHit(thisHit));\r\n  }\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport class ElementLocateManager {\r\n  public hitList?: HitList<HitDetail>;\r\n  public currHit?: HitDetail;\r\n  public readonly options = new LocateOptions();\r\n  public readonly picker = new ElementPicker();\r\n\r\n  /** get the full message key for a locate failure  */\r\n  public static getFailureMessageKey(key: string) { return `LocateFailure.${key}`; }\r\n  public onInitialized() { }\r\n  public get apertureInches() { return 0.11; }\r\n  public get touchApertureInches() { return 0.22; }\r\n\r\n  public clear(): void { this.setCurrHit(undefined); }\r\n  public setHitList(list?: HitList<HitDetail>) { this.hitList = list; }\r\n  public setCurrHit(hit?: HitDetail): void { this.currHit = hit; }\r\n  public getNextHit(): HitDetail | undefined { return this.hitList ? this.hitList.getNextHit() : undefined; }\r\n\r\n  /** return the current path from either the snapping logic or the pre-locating systems. */\r\n  public getPreLocatedHit(): HitDetail | undefined {\r\n    // NOTE: Check AccuSnap first as Tentative is used to build intersect snap. For normal snaps when a Tentative is active there should be no AccuSnap.\r\n    let preLocated = IModelApp.accuSnap.getHitAndList(this);\r\n\r\n    if (!preLocated && !!(preLocated = IModelApp.tentativePoint.getHitAndList(this))) {\r\n      const vp = preLocated.viewport;\r\n      this.picker.empty(); // Get new hit list at hit point; want reset to cycle hits using adjusted point location...\r\n      this.picker.doPick(vp, preLocated.getPoint(), (vp.pixelsFromInches(this.apertureInches) / 2.0) + 1.5, this.options);\r\n      this.setHitList(this.picker.getHitList(true));\r\n    }\r\n\r\n    if (this.hitList)\r\n      this.hitList.resetCurrentHit();\r\n\r\n    return preLocated;\r\n  }\r\n\r\n  public async filterHit(hit: HitDetail, _action: LocateAction, out: LocateResponse): Promise<LocateFilterStatus> {\r\n    // Tools must opt-in to locate of transient geometry as it requires special treatment.\r\n    if (!this.options.allowDecorations && !hit.isElementHit) {\r\n      if (hit.isModelHit)\r\n        out.reason = ElementLocateManager.getFailureMessageKey(\"RealityModel\");\r\n      else if (hit.isMapHit)\r\n        out.reason = ElementLocateManager.getFailureMessageKey(\"Map\");\r\n      else\r\n        out.reason = ElementLocateManager.getFailureMessageKey(\"Transient\");\r\n      return LocateFilterStatus.Reject;\r\n    }\r\n\r\n    // Tools must opt-in to locate geometry from external iModels.\r\n    if (!this.options.allowExternalIModels && hit.isExternalIModelHit) {\r\n      out.reason = ElementLocateManager.getFailureMessageKey(\"ExternalIModel\");\r\n      return LocateFilterStatus.Reject;\r\n    }\r\n\r\n    if (undefined !== hit.subCategoryId && !hit.isExternalIModelHit) {\r\n      const appearance = hit.viewport.getSubCategoryAppearance(hit.subCategoryId);\r\n      if (appearance.dontLocate) {\r\n        out.reason = ElementLocateManager.getFailureMessageKey(\"NotLocatableSubCategory\");\r\n        return LocateFilterStatus.Reject;\r\n      }\r\n    }\r\n\r\n    const tool = IModelApp.toolAdmin.activeTool;\r\n    if (!(tool && tool instanceof InteractiveTool))\r\n      return LocateFilterStatus.Accept;\r\n\r\n    const status = await tool.filterHit(hit, out);\r\n    if (LocateFilterStatus.Reject === status)\r\n      out.reason = ElementLocateManager.getFailureMessageKey(\"ByApp\");\r\n\r\n    return status;\r\n  }\r\n\r\n  public initLocateOptions() { this.options.init(); }\r\n  public initToolLocate() {\r\n    this.initLocateOptions();\r\n    this.clear();\r\n    this.picker.empty();\r\n    IModelApp.tentativePoint.clear(true);\r\n  }\r\n\r\n  private async _doLocate(response: LocateResponse, newSearch: boolean, testPoint: Point3d, vp: ScreenViewport | undefined, source: InputSource, filterHits: boolean): Promise<HitDetail | undefined> {\r\n    if (!vp)\r\n      return;\r\n\r\n    // the \"newSearch\" flag indicates whether the caller wants us to conduct a new search at the testPoint, or just continue returning paths from the previous search.\r\n    if (newSearch) {\r\n      const hit = this.getPreLocatedHit();\r\n\r\n      // if we're snapped to something, that path has the highest priority and becomes the active hit.\r\n      if (hit) {\r\n        if (!filterHits || LocateFilterStatus.Accept === await this.filterHit(hit, LocateAction.Identify, response))\r\n          return hit;\r\n\r\n        response = new LocateResponse(); // we have the reason and explanation we want.\r\n      }\r\n\r\n      this.picker.empty();\r\n      this.picker.doPick(vp, testPoint, (vp.pixelsFromInches(InputSource.Touch === source ? this.touchApertureInches : this.apertureInches) / 2.0) + 1.5, this.options);\r\n\r\n      const hitList = this.picker.getHitList(true);\r\n      this.setHitList(hitList);\r\n    }\r\n\r\n    let newHit: HitDetail | undefined;\r\n    while (undefined !== (newHit = this.getNextHit())) {\r\n      if (!filterHits || LocateFilterStatus.Accept === await this.filterHit(newHit, LocateAction.Identify, response))\r\n        return newHit;\r\n      response = new LocateResponse(); // we have the reason and explanation we want.\r\n    }\r\n\r\n    return undefined;\r\n  }\r\n\r\n  public async doLocate(response: LocateResponse, newSearch: boolean, testPoint: Point3d, view: ScreenViewport | undefined, source: InputSource, filterHits = true): Promise<HitDetail | undefined> {\r\n    response.reason = ElementLocateManager.getFailureMessageKey(\"NoElements\");\r\n    response.explanation = \"\";\r\n\r\n    const hit = await this._doLocate(response, newSearch, testPoint, view, source, filterHits);\r\n    this.setCurrHit(hit);\r\n\r\n    // if we found a hit, remove it from the list of remaining hits near the current search point.\r\n    if (hit && this.hitList)\r\n      this.hitList.removeHitsFrom(hit.sourceId);\r\n    return hit;\r\n  }\r\n}\r\n"]}

package/lib/esm/EnvironmentDecorations.js

@@ -8,7 +8,7 @@
 import { assert, Id64 } from "@itwin/core-bentley";
 import { ColorDef, Gradient, GraphicParams, RenderTexture, SkyCube, SkySphere, TextureMapping, } from "@itwin/core-common";
 import { Point2d, PolyfaceBuilder, StrokeOptions } from "@itwin/core-geometry";
-import { tryImageElementFromUrl } from "./ImageUtil";
+import { tryImageElementFromUrl } from "./common/ImageUtil";
 import { IModelApp } from "./IModelApp";
 import { GraphicType } from "./render/GraphicBuilder";
 /** @internal */

package/lib/esm/EnvironmentDecorations.js.map

@@ -1 +1 @@
-{"version":3,"file":"EnvironmentDecorations.js","sourceRoot":"","sources":["../../src/EnvironmentDecorations.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Views\r\n */\r\n\r\nimport { assert, Id64 } from \"@itwin/core-bentley\";\r\nimport {\r\n  ColorDef, Environment, Gradient, GraphicParams, RenderTexture, SkyCube, SkySphere, TextureImageSpec, TextureMapping,\r\n} from \"@itwin/core-common\";\r\nimport { Point2d, Point3d, PolyfaceBuilder, StrokeOptions } from \"@itwin/core-geometry\";\r\nimport { tryImageElementFromUrl } from \"./ImageUtil\";\r\nimport { IModelApp } from \"./IModelApp\";\r\nimport { GraphicType } from \"./render/GraphicBuilder\";\r\nimport { RenderGraphic } from \"./render/RenderGraphic\";\r\nimport { RenderSkyBoxParams } from \"./render/RenderSystem\";\r\nimport { DecorateContext } from \"./ViewContext\";\r\nimport { ViewState3d } from \"./ViewState\";\r\n\r\n/** @internal */\r\nexport interface GroundPlaneDecorations {\r\n  readonly aboveParams: GraphicParams;\r\n  readonly belowParams: GraphicParams;\r\n}\r\n\r\ninterface SkyBoxParamsLoader {\r\n  // Invoke to obtain sky box params.\r\n  load(): RenderSkyBoxParams | undefined;\r\n  // If defined, await before invoking load().\r\n  preload?: Promise<boolean>;\r\n}\r\n\r\n/** @internal */\r\nexport interface SkyBoxDecorations {\r\n  params?: RenderSkyBoxParams;\r\n  promise?: Promise<boolean>;\r\n}\r\n\r\n/** @internal */\r\nexport class EnvironmentDecorations {\r\n  protected readonly _view: ViewState3d;\r\n  protected readonly _onLoaded: () => void;\r\n  protected readonly _onDispose: () => void;\r\n  protected _environment: Environment;\r\n  protected _ground?: GroundPlaneDecorations;\r\n  protected _sky: SkyBoxDecorations;\r\n\r\n  public constructor(view: ViewState3d, onLoaded: () => void, onDispose: () => void) {\r\n    this._environment = view.displayStyle.environment;\r\n    this._view = view;\r\n    this._onLoaded = onLoaded;\r\n    this._onDispose = onDispose;\r\n    this._sky = {};\r\n    this.loadSkyBox();\r\n    if (this._environment.displayGround)\r\n      this.loadGround();\r\n  }\r\n\r\n  public dispose(): void {\r\n    this._ground = undefined;\r\n    this._sky.params = this._sky.promise = undefined;\r\n\r\n    this._onDispose();\r\n  }\r\n\r\n  public setEnvironment(env: Environment): void {\r\n    const prev = this._environment;\r\n    if (prev === env)\r\n      return;\r\n\r\n    this._environment = env;\r\n\r\n    // Update ground plane\r\n    if (!env.displayGround || env.ground !== prev.ground)\r\n      this._ground = undefined;\r\n\r\n    if (env.displayGround && !this._ground)\r\n      this.loadGround();\r\n\r\n    // Update sky box\r\n    if (env.sky !== prev.sky)\r\n      this.loadSkyBox();\r\n  }\r\n\r\n  public decorate(context: DecorateContext): void {\r\n    const env = this._environment;\r\n\r\n    let sky: RenderGraphic | undefined;\r\n    if (env.displayAtmosphere) {\r\n      sky = IModelApp.renderSystem.createSkyBox(this.createSkyGradientParams());\r\n    } else if (env.displaySky && this._sky.params) {\r\n      sky = IModelApp.renderSystem.createSkyBox(this._sky.params);\r\n    }\r\n    if (sky)\r\n      context.setSkyBox(sky);\r\n\r\n    if (!env.displayGround || !this._ground)\r\n      return;\r\n\r\n    const extents = this._view.getGroundExtents(context.viewport);\r\n    if (extents.isNull)\r\n      return;\r\n\r\n    const points: Point3d[] = [extents.low.clone(), extents.low.clone(), extents.high.clone(), extents.high.clone()];\r\n    points[1].x = extents.high.x;\r\n    points[3].x = extents.low.x;\r\n\r\n    const aboveGround = this._view.isEyePointAbove(extents.low.z);\r\n    const params = aboveGround ? this._ground.aboveParams : this._ground.belowParams;\r\n    const builder = context.createGraphicBuilder(GraphicType.WorldDecoration);\r\n    builder.activateGraphicParams(params);\r\n\r\n    const strokeOptions = new StrokeOptions();\r\n    strokeOptions.needParams = true;\r\n    const polyfaceBuilder = PolyfaceBuilder.create(strokeOptions);\r\n    polyfaceBuilder.toggleReversedFacetFlag();\r\n    const uvParams: Point2d[] = [Point2d.create(0, 0), Point2d.create(1, 0), Point2d.create(1, 1), Point2d.create(0, 1)];\r\n    polyfaceBuilder.addQuadFacet(points, uvParams);\r\n    const polyface = polyfaceBuilder.claimPolyface(false);\r\n\r\n    builder.addPolyface(polyface, true);\r\n    context.addDecorationFromBuilder(builder);\r\n  }\r\n\r\n  private loadGround(): void {\r\n    assert(undefined === this._ground);\r\n    const aboveParams = this.createGroundParams(true);\r\n    const belowParams = this.createGroundParams(false);\r\n    if (aboveParams && belowParams)\r\n      this._ground = { aboveParams, belowParams };\r\n  }\r\n\r\n  private createGroundParams(above: boolean): GraphicParams | undefined {\r\n    // Create a gradient texture.\r\n    const ground = this._environment.ground;\r\n    const values = [0, 0.25, 0.5];\r\n    const color = above ? ground.aboveColor : ground.belowColor;\r\n    const alpha = above ? 0x80 : 0x85;\r\n    const groundColors = [color.withTransparency(0xff), color, color];\r\n    groundColors[1] = groundColors[2] = color.withTransparency(alpha);\r\n\r\n    const gradient = new Gradient.Symb();\r\n    gradient.mode = Gradient.Mode.Spherical;\r\n    gradient.keys = [{ color: groundColors[0], value: values[0] }, { color: groundColors[1], value: values[1] }, { color: groundColors[2], value: values[2] }];\r\n    const texture = IModelApp.renderSystem.getGradientTexture(gradient, this._view.iModel);\r\n    if (!texture)\r\n      return undefined;\r\n\r\n    // Create a material using the gradient texture\r\n    const material = IModelApp.renderSystem.createRenderMaterial({\r\n      diffuse: { color: ColorDef.white, weight: 0 },\r\n      textureMapping: {\r\n        texture,\r\n        transform: new TextureMapping.Trans2x3(0, 1, 0, 1, 0, 0),\r\n      },\r\n    });\r\n\r\n    if (!material)\r\n      return undefined;\r\n\r\n    // Create GraphicParams using the material.\r\n    const params = new GraphicParams();\r\n    params.lineColor = gradient.keys[0].color;\r\n    params.fillColor = ColorDef.white;  // Fill should be set to opaque white for gradient texture...\r\n    params.material = material;\r\n\r\n    return params;\r\n  }\r\n\r\n  private loadSkyBox(): void {\r\n    const loader = this.loadSkyBoxParams();\r\n    if (undefined === loader.preload) {\r\n      this.setSky(loader.load());\r\n      return;\r\n    }\r\n\r\n    const promise = loader.preload;\r\n    this._sky.promise = promise;\r\n    loader.preload.then((loaded) => {\r\n      if (promise === this._sky.promise)\r\n        this.setSky(loaded ? loader.load() : undefined);\r\n    }).catch(() => {\r\n      if (promise === this._sky.promise)\r\n        this.setSky(undefined);\r\n    });\r\n  }\r\n\r\n  private setSky(params: RenderSkyBoxParams | undefined): void {\r\n    this._sky.promise = undefined;\r\n    this._sky.params = params ?? this.createSkyGradientParams();\r\n    this._onLoaded();\r\n  }\r\n\r\n  private loadSkyBoxParams(): SkyBoxParamsLoader {\r\n    let load: (() => RenderSkyBoxParams | undefined);\r\n    let preload: Promise<boolean> | undefined;\r\n\r\n    const sky = this._environment.sky;\r\n    if (sky instanceof SkyCube) {\r\n      const key = this.createCubeImageKey(sky);\r\n      load = () => {\r\n        const texture = IModelApp.renderSystem.findTexture(key, this._view.iModel);\r\n        return texture ? { type: \"cube\", texture } : undefined;\r\n      };\r\n\r\n      if (!IModelApp.renderSystem.findTexture(key, this._view.iModel)) {\r\n        // Some faces may use the same image. Only request each image once.\r\n        const promises = [];\r\n        const specs = new Set<string>([sky.images.front, sky.images.back, sky.images.left, sky.images.right, sky.images.top, sky.images.bottom]);\r\n        for (const spec of specs)\r\n          promises.push(this.imageFromSpec(spec));\r\n\r\n        preload = Promise.all(promises).then((images) => {\r\n          const idToImage = new Map<TextureImageSpec, HTMLImageElement>();\r\n          let index = 0;\r\n          for (const spec of specs) {\r\n            const image = images[index++];\r\n            if (!image)\r\n              return false;\r\n            else\r\n              idToImage.set(spec, image);\r\n          }\r\n\r\n          // eslint-disable-next-line deprecation/deprecation\r\n          const params = new RenderTexture.Params(key, RenderTexture.Type.SkyBox);\r\n          const txImgs = [\r\n            idToImage.get(sky.images.front)!, idToImage.get(sky.images.back)!, idToImage.get(sky.images.top)!,\r\n            idToImage.get(sky.images.bottom)!, idToImage.get(sky.images.right)!, idToImage.get(sky.images.left)!,\r\n          ];\r\n\r\n          return undefined !== IModelApp.renderSystem.createTextureFromCubeImages(txImgs[0], txImgs[1], txImgs[2], txImgs[3], txImgs[4], txImgs[5], this._view.iModel, params);\r\n        });\r\n      }\r\n    } else if (sky instanceof SkySphere) {\r\n      load = () => {\r\n        const texture = IModelApp.renderSystem.findTexture(sky.image, this._view.iModel);\r\n        return texture ? {\r\n          type: \"sphere\",\r\n          texture,\r\n          rotation: 0,\r\n          zOffset: this._view.iModel.globalOrigin.z,\r\n        } : undefined;\r\n      };\r\n\r\n      if (!IModelApp.renderSystem.findTexture(sky.image, this._view.iModel)) {\r\n        preload = this.imageFromSpec(sky.image).then((image) => {\r\n          if (!image)\r\n            return false;\r\n\r\n          return undefined !== IModelApp.renderSystem.createTexture({\r\n            image: { source: image },\r\n            ownership: { iModel: this._view.iModel, key: sky.image },\r\n          });\r\n        });\r\n      }\r\n    } else {\r\n      load = () => this.createSkyGradientParams();\r\n    }\r\n\r\n    return { load, preload };\r\n  }\r\n\r\n  private createCubeImageKey(sky: SkyCube): string {\r\n    const i = sky.images;\r\n    return `skycube:${i.front}:${i.back}:${i.left}:${i.right}:${i.top}:${i.bottom}`;\r\n  }\r\n\r\n  private createSkyGradientParams(): RenderSkyBoxParams {\r\n    return {\r\n      type: \"gradient\",\r\n      gradient: this._environment.sky.gradient,\r\n      zOffset: this._view.iModel.globalOrigin.z,\r\n    };\r\n  }\r\n\r\n  private async imageFromSpec(spec: TextureImageSpec): Promise<HTMLImageElement | undefined> {\r\n    if (Id64.isValidId64(spec))\r\n      return (await IModelApp.renderSystem.loadTextureImage(spec, this._view.iModel))?.image;\r\n\r\n    return tryImageElementFromUrl(spec);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"EnvironmentDecorations.js","sourceRoot":"","sources":["../../src/EnvironmentDecorations.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Views\r\n */\r\n\r\nimport { assert, Id64 } from \"@itwin/core-bentley\";\r\nimport {\r\n  ColorDef, Environment, Gradient, GraphicParams, RenderTexture, SkyCube, SkySphere, TextureImageSpec, TextureMapping,\r\n} from \"@itwin/core-common\";\r\nimport { Point2d, Point3d, PolyfaceBuilder, StrokeOptions } from \"@itwin/core-geometry\";\r\nimport { tryImageElementFromUrl } from \"./common/ImageUtil\";\r\nimport { IModelApp } from \"./IModelApp\";\r\nimport { GraphicType } from \"./render/GraphicBuilder\";\r\nimport { RenderGraphic } from \"./render/RenderGraphic\";\r\nimport { RenderSkyBoxParams } from \"./render/RenderSystem\";\r\nimport { DecorateContext } from \"./ViewContext\";\r\nimport { ViewState3d } from \"./ViewState\";\r\n\r\n/** @internal */\r\nexport interface GroundPlaneDecorations {\r\n  readonly aboveParams: GraphicParams;\r\n  readonly belowParams: GraphicParams;\r\n}\r\n\r\ninterface SkyBoxParamsLoader {\r\n  // Invoke to obtain sky box params.\r\n  load(): RenderSkyBoxParams | undefined;\r\n  // If defined, await before invoking load().\r\n  preload?: Promise<boolean>;\r\n}\r\n\r\n/** @internal */\r\nexport interface SkyBoxDecorations {\r\n  params?: RenderSkyBoxParams;\r\n  promise?: Promise<boolean>;\r\n}\r\n\r\n/** @internal */\r\nexport class EnvironmentDecorations {\r\n  protected readonly _view: ViewState3d;\r\n  protected readonly _onLoaded: () => void;\r\n  protected readonly _onDispose: () => void;\r\n  protected _environment: Environment;\r\n  protected _ground?: GroundPlaneDecorations;\r\n  protected _sky: SkyBoxDecorations;\r\n\r\n  public constructor(view: ViewState3d, onLoaded: () => void, onDispose: () => void) {\r\n    this._environment = view.displayStyle.environment;\r\n    this._view = view;\r\n    this._onLoaded = onLoaded;\r\n    this._onDispose = onDispose;\r\n    this._sky = {};\r\n    this.loadSkyBox();\r\n    if (this._environment.displayGround)\r\n      this.loadGround();\r\n  }\r\n\r\n  public dispose(): void {\r\n    this._ground = undefined;\r\n    this._sky.params = this._sky.promise = undefined;\r\n\r\n    this._onDispose();\r\n  }\r\n\r\n  public setEnvironment(env: Environment): void {\r\n    const prev = this._environment;\r\n    if (prev === env)\r\n      return;\r\n\r\n    this._environment = env;\r\n\r\n    // Update ground plane\r\n    if (!env.displayGround || env.ground !== prev.ground)\r\n      this._ground = undefined;\r\n\r\n    if (env.displayGround && !this._ground)\r\n      this.loadGround();\r\n\r\n    // Update sky box\r\n    if (env.sky !== prev.sky)\r\n      this.loadSkyBox();\r\n  }\r\n\r\n  public decorate(context: DecorateContext): void {\r\n    const env = this._environment;\r\n\r\n    let sky: RenderGraphic | undefined;\r\n    if (env.displayAtmosphere) {\r\n      sky = IModelApp.renderSystem.createSkyBox(this.createSkyGradientParams());\r\n    } else if (env.displaySky && this._sky.params) {\r\n      sky = IModelApp.renderSystem.createSkyBox(this._sky.params);\r\n    }\r\n    if (sky)\r\n      context.setSkyBox(sky);\r\n\r\n    if (!env.displayGround || !this._ground)\r\n      return;\r\n\r\n    const extents = this._view.getGroundExtents(context.viewport);\r\n    if (extents.isNull)\r\n      return;\r\n\r\n    const points: Point3d[] = [extents.low.clone(), extents.low.clone(), extents.high.clone(), extents.high.clone()];\r\n    points[1].x = extents.high.x;\r\n    points[3].x = extents.low.x;\r\n\r\n    const aboveGround = this._view.isEyePointAbove(extents.low.z);\r\n    const params = aboveGround ? this._ground.aboveParams : this._ground.belowParams;\r\n    const builder = context.createGraphicBuilder(GraphicType.WorldDecoration);\r\n    builder.activateGraphicParams(params);\r\n\r\n    const strokeOptions = new StrokeOptions();\r\n    strokeOptions.needParams = true;\r\n    const polyfaceBuilder = PolyfaceBuilder.create(strokeOptions);\r\n    polyfaceBuilder.toggleReversedFacetFlag();\r\n    const uvParams: Point2d[] = [Point2d.create(0, 0), Point2d.create(1, 0), Point2d.create(1, 1), Point2d.create(0, 1)];\r\n    polyfaceBuilder.addQuadFacet(points, uvParams);\r\n    const polyface = polyfaceBuilder.claimPolyface(false);\r\n\r\n    builder.addPolyface(polyface, true);\r\n    context.addDecorationFromBuilder(builder);\r\n  }\r\n\r\n  private loadGround(): void {\r\n    assert(undefined === this._ground);\r\n    const aboveParams = this.createGroundParams(true);\r\n    const belowParams = this.createGroundParams(false);\r\n    if (aboveParams && belowParams)\r\n      this._ground = { aboveParams, belowParams };\r\n  }\r\n\r\n  private createGroundParams(above: boolean): GraphicParams | undefined {\r\n    // Create a gradient texture.\r\n    const ground = this._environment.ground;\r\n    const values = [0, 0.25, 0.5];\r\n    const color = above ? ground.aboveColor : ground.belowColor;\r\n    const alpha = above ? 0x80 : 0x85;\r\n    const groundColors = [color.withTransparency(0xff), color, color];\r\n    groundColors[1] = groundColors[2] = color.withTransparency(alpha);\r\n\r\n    const gradient = new Gradient.Symb();\r\n    gradient.mode = Gradient.Mode.Spherical;\r\n    gradient.keys = [{ color: groundColors[0], value: values[0] }, { color: groundColors[1], value: values[1] }, { color: groundColors[2], value: values[2] }];\r\n    const texture = IModelApp.renderSystem.getGradientTexture(gradient, this._view.iModel);\r\n    if (!texture)\r\n      return undefined;\r\n\r\n    // Create a material using the gradient texture\r\n    const material = IModelApp.renderSystem.createRenderMaterial({\r\n      diffuse: { color: ColorDef.white, weight: 0 },\r\n      textureMapping: {\r\n        texture,\r\n        transform: new TextureMapping.Trans2x3(0, 1, 0, 1, 0, 0),\r\n      },\r\n    });\r\n\r\n    if (!material)\r\n      return undefined;\r\n\r\n    // Create GraphicParams using the material.\r\n    const params = new GraphicParams();\r\n    params.lineColor = gradient.keys[0].color;\r\n    params.fillColor = ColorDef.white;  // Fill should be set to opaque white for gradient texture...\r\n    params.material = material;\r\n\r\n    return params;\r\n  }\r\n\r\n  private loadSkyBox(): void {\r\n    const loader = this.loadSkyBoxParams();\r\n    if (undefined === loader.preload) {\r\n      this.setSky(loader.load());\r\n      return;\r\n    }\r\n\r\n    const promise = loader.preload;\r\n    this._sky.promise = promise;\r\n    loader.preload.then((loaded) => {\r\n      if (promise === this._sky.promise)\r\n        this.setSky(loaded ? loader.load() : undefined);\r\n    }).catch(() => {\r\n      if (promise === this._sky.promise)\r\n        this.setSky(undefined);\r\n    });\r\n  }\r\n\r\n  private setSky(params: RenderSkyBoxParams | undefined): void {\r\n    this._sky.promise = undefined;\r\n    this._sky.params = params ?? this.createSkyGradientParams();\r\n    this._onLoaded();\r\n  }\r\n\r\n  private loadSkyBoxParams(): SkyBoxParamsLoader {\r\n    let load: (() => RenderSkyBoxParams | undefined);\r\n    let preload: Promise<boolean> | undefined;\r\n\r\n    const sky = this._environment.sky;\r\n    if (sky instanceof SkyCube) {\r\n      const key = this.createCubeImageKey(sky);\r\n      load = () => {\r\n        const texture = IModelApp.renderSystem.findTexture(key, this._view.iModel);\r\n        return texture ? { type: \"cube\", texture } : undefined;\r\n      };\r\n\r\n      if (!IModelApp.renderSystem.findTexture(key, this._view.iModel)) {\r\n        // Some faces may use the same image. Only request each image once.\r\n        const promises = [];\r\n        const specs = new Set<string>([sky.images.front, sky.images.back, sky.images.left, sky.images.right, sky.images.top, sky.images.bottom]);\r\n        for (const spec of specs)\r\n          promises.push(this.imageFromSpec(spec));\r\n\r\n        preload = Promise.all(promises).then((images) => {\r\n          const idToImage = new Map<TextureImageSpec, HTMLImageElement>();\r\n          let index = 0;\r\n          for (const spec of specs) {\r\n            const image = images[index++];\r\n            if (!image)\r\n              return false;\r\n            else\r\n              idToImage.set(spec, image);\r\n          }\r\n\r\n          // eslint-disable-next-line deprecation/deprecation\r\n          const params = new RenderTexture.Params(key, RenderTexture.Type.SkyBox);\r\n          const txImgs = [\r\n            idToImage.get(sky.images.front)!, idToImage.get(sky.images.back)!, idToImage.get(sky.images.top)!,\r\n            idToImage.get(sky.images.bottom)!, idToImage.get(sky.images.right)!, idToImage.get(sky.images.left)!,\r\n          ];\r\n\r\n          return undefined !== IModelApp.renderSystem.createTextureFromCubeImages(txImgs[0], txImgs[1], txImgs[2], txImgs[3], txImgs[4], txImgs[5], this._view.iModel, params);\r\n        });\r\n      }\r\n    } else if (sky instanceof SkySphere) {\r\n      load = () => {\r\n        const texture = IModelApp.renderSystem.findTexture(sky.image, this._view.iModel);\r\n        return texture ? {\r\n          type: \"sphere\",\r\n          texture,\r\n          rotation: 0,\r\n          zOffset: this._view.iModel.globalOrigin.z,\r\n        } : undefined;\r\n      };\r\n\r\n      if (!IModelApp.renderSystem.findTexture(sky.image, this._view.iModel)) {\r\n        preload = this.imageFromSpec(sky.image).then((image) => {\r\n          if (!image)\r\n            return false;\r\n\r\n          return undefined !== IModelApp.renderSystem.createTexture({\r\n            image: { source: image },\r\n            ownership: { iModel: this._view.iModel, key: sky.image },\r\n          });\r\n        });\r\n      }\r\n    } else {\r\n      load = () => this.createSkyGradientParams();\r\n    }\r\n\r\n    return { load, preload };\r\n  }\r\n\r\n  private createCubeImageKey(sky: SkyCube): string {\r\n    const i = sky.images;\r\n    return `skycube:${i.front}:${i.back}:${i.left}:${i.right}:${i.top}:${i.bottom}`;\r\n  }\r\n\r\n  private createSkyGradientParams(): RenderSkyBoxParams {\r\n    return {\r\n      type: \"gradient\",\r\n      gradient: this._environment.sky.gradient,\r\n      zOffset: this._view.iModel.globalOrigin.z,\r\n    };\r\n  }\r\n\r\n  private async imageFromSpec(spec: TextureImageSpec): Promise<HTMLImageElement | undefined> {\r\n    if (Id64.isValidId64(spec))\r\n      return (await IModelApp.renderSystem.loadTextureImage(spec, this._view.iModel))?.image;\r\n\r\n    return tryImageElementFromUrl(spec);\r\n  }\r\n}\r\n"]}

package/lib/esm/GeoServices.d.ts

@@ -3,14 +3,13 @@
  */
 import { BeEvent, Dictionary, SortedArray } from "@itwin/core-bentley";
 import { WritableXYAndZ, XYAndZ, XYZProps } from "@itwin/core-geometry";
-import { GeoCoordinatesResponseProps, GeographicCRSProps, IModelCoordinatesResponseProps, PointWithStatus } from "@itwin/core-common";
+import { GeoCoordinatesRequestProps, GeoCoordinatesResponseProps, GeographicCRSProps, IModelCoordinatesRequestProps, IModelCoordinatesResponseProps, PointWithStatus } from "@itwin/core-common";
 import { IModelConnection } from "./IModelConnection";
 /** Options used to create a [[CoordinateConverter]].
  * @internal exported strictly for tests.
  */
 export interface CoordinateConverterOptions {
-    /** The iModel for which to perform the conversions. */
-    iModel: IModelConnection;
+    isIModelClosed: () => boolean;
     /** Asynchronously convert each point. The resultant array should have the same number and order of points as the input. */
     requestPoints: (points: XYAndZ[]) => Promise<PointWithStatus[]>;
     /** Maximum number of points to include in each request. Default: 300. */
@@ -42,8 +41,10 @@ export declare class CoordinateConverter {
         z: number;
     };
     protected readonly _maxPointsPerRequest: number;
-    protected readonly _iModel: IModelConnection;
+    protected readonly _isIModelClosed: () => boolean;
     protected readonly _requestPoints: (points: XYAndZ[]) => Promise<PointWithStatus[]>;
+    protected _redispatchOnCompletion: boolean;
+    get isIdle(): boolean;
     protected toXYAndZ(input: XYZProps, output: WritableXYAndZ): XYAndZ;
     constructor(opts: CoordinateConverterOptions);
     protected dispatch(): Promise<void>;
@@ -65,6 +66,15 @@ export interface CachedIModelCoordinatesResponseProps {
     /** An array of points in the input array which were not found in the cache, or undefined if all points were found in the cache. */
     missing?: XYZProps[];
 }
+/** Options used to create a [[GeoConverter]].
+ * @internal exported strictly for tests.
+ */
+export interface GeoConverterOptions {
+    readonly datum: string;
+    isIModelClosed: () => boolean;
+    toIModelCoords: (request: IModelCoordinatesRequestProps) => Promise<PointWithStatus[]>;
+    fromIModelCoords: (request: GeoCoordinatesRequestProps) => Promise<PointWithStatus[]>;
+}
 /** An object capable of communicating with the backend to convert between coordinates in a geographic coordinate system and coordinates in an [[IModelConnection]]'s own coordinate system.
  * @see [[GeoServices.getConverter]] to obtain a converter.
  * @see [GeographicCRS]($common) for more information about geographic coordinate reference systems.
@@ -73,8 +83,12 @@ export interface CachedIModelCoordinatesResponseProps {
 export declare class GeoConverter {
     private readonly _geoToIModel;
     private readonly _iModelToGeo;
+    /** Used for removing this converter from GeoServices' cache after all requests are completed.
+     * @internal
+     */
+    readonly onAllRequestsCompleted: BeEvent<() => void>;
     /** @internal */
-    constructor(iModel: IModelConnection, datumOrGCRS: string | GeographicCRSProps);
+    constructor(opts: GeoConverterOptions);
     /** Convert the specified geographic coordinates into iModel coordinates. */
     convertToIModelCoords(geoPoints: XYZProps[]): Promise<PointWithStatus[]>;
     /** Convert the specified iModel coordinates into geographic coordinates. */
@@ -83,17 +97,33 @@ export declare class GeoConverter {
     getIModelCoordinatesFromGeoCoordinates(geoPoints: XYZProps[]): Promise<IModelCoordinatesResponseProps>;
     /** @internal */
     getGeoCoordinatesFromIModelCoordinates(iModelPoints: XYZProps[]): Promise<GeoCoordinatesResponseProps>;
+    private checkCompletion;
     /** @internal */
     getCachedIModelCoordinatesFromGeoCoordinates(geoPoints: XYZProps[]): CachedIModelCoordinatesResponseProps;
 }
+/** @internal */
+export type GeoServicesOptions = Omit<GeoConverterOptions, "datum">;
 /** The Geographic Services available for an [[IModelConnection]].
  * @see [[IModelConnection.geoServices]] to obtain the GeoServices for a specific iModel.
  * @public
  */
 export declare class GeoServices {
-    private _iModel;
+    private readonly _options;
+    /** Each GeoConverter has its own independent request queue and cache of previously-converted points.
+     * Some callers like RealityTileTree obtain a single GeoConverter and reuse it throughout their own lifetime. Therefore they benefit from both batching and caching, and
+     * the cache gets deleted once the RealityTileTree becomes disused.
+     *
+     * Other callers like IModelConnection.spatialToCartographic obtain a new GeoConverter every time they need one, use it to convert a single point(!), and then discard the converter.
+     * This entirely prevents batching - e.g., calling spatialToCartographic 20 times in one frame results in 20 http requests.
+     * To address that, we cache each GeoConverter returned by getConverter until it has converted at least one point and has no further outstanding conversion requests.
+     * In this way, the converter lives for as long as (and no longer than) any caller is awaiting conversion to/from its datum - it and its cache are deleted once it becomes disused.
+     * This makes the coordinate caching generally less useful, but at least bounded - and maximizes batching of requests.
+     */
+    private readonly _cache;
+    /** @internal */
+    constructor(options: GeoServicesOptions);
     /** @internal */
-    constructor(iModel: IModelConnection);
+    static createForIModel(iModel: IModelConnection): GeoServices;
     /** Obtain a converter that can convert between a geographic coordinate system and the iModel's own coordinate system.
      * @param datumOrGCRS The name or JSON representation of the geographic coordinate system datum - for example, "WGS84".
      * @returns a converter, or `undefined` if the iModel is not open.

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

@@ -1 +1 @@
-{"version":3,"file":"GeoServices.d.ts","sourceRoot":"","sources":["../../src/GeoServices.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GeoServices.d.ts","sourceRoot":"","sources":["../../src/GeoServices.ts"],"names":[],"mappings":"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"}

package/lib/esm/GeoServices.js

@@ -8,7 +8,7 @@
 // cspell:ignore GCRS
 import { assert, BeEvent, Dictionary, Logger, SortedArray, } from "@itwin/core-bentley";
 import { GeoCoordStatus, IModelReadRpcInterface, } from "@itwin/core-common";
-import { FrontendLoggerCategory } from "./FrontendLoggerCategory";
+import { FrontendLoggerCategory } from "./common/FrontendLoggerCategory";
 function compareXYAndZ(lhs, rhs) {
     return lhs.x - rhs.x || lhs.y - rhs.y || lhs.z - rhs.z;
 }
@@ -29,6 +29,9 @@ function cloneXYAndZ(xyz) {
  * @internal exported strictly for tests.
  */
 export class CoordinateConverter {
+    get isIdle() {
+        return "idle" === this._state;
+    }
     toXYAndZ(input, output) {
         if (Array.isArray(input)) {
             output.x = input[0] ?? 0;
@@ -48,8 +51,12 @@ export class CoordinateConverter {
         this._onCompleted = new BeEvent();
         // Used for creating cache keys (XYAndZ) from XYZProps without having to allocate temporary objects.
         this._scratchXYZ = { x: 0, y: 0, z: 0 };
+        // If true, [[dispatch]] will schedule another dispatch after it receives a response.
+        // This is needed when all the points requested after the most recent dispatch were included in the currently-in-flight request -
+        // _pending will be empty but new callers will be awaiting the results of the in-flight request.
+        this._redispatchOnCompletion = false;
         this._maxPointsPerRequest = Math.max(1, opts.maxPointsPerRequest ?? 300);
-        this._iModel = opts.iModel;
+        this._isIModelClosed = opts.isIModelClosed;
         this._requestPoints = opts.requestPoints;
         this._cache = new Dictionary(compareXYAndZ, cloneXYAndZ);
         this._pending = new SortedArray(compareXYAndZ, false, cloneXYAndZ);
@@ -57,7 +64,7 @@ export class CoordinateConverter {
     }
     async dispatch() {
         assert(this._state === "scheduled");
-        if (this._iModel.isClosed || this._pending.isEmpty) {
+        if (this._isIModelClosed() || this._pending.isEmpty) {
             this._state = "idle";
             this._onCompleted.raiseEvent();
             return;
@@ -76,7 +83,7 @@ export class CoordinateConverter {
         for (let i = 0; i < inflight.length; i += this._maxPointsPerRequest) {
             const requests = inflight.slice(i, i + this._maxPointsPerRequest).extractArray();
             const promise = this._requestPoints(requests).then((results) => {
-                if (this._iModel.isClosed)
+                if (this._isIModelClosed())
                     return;
                 if (results.length !== requests.length)
                     Logger.logError(`${FrontendLoggerCategory.Package}.geoservices`, `requested conversion of ${requests.length} points, but received ${results.length} points`);
@@ -94,8 +101,10 @@ export class CoordinateConverter {
         this._state = "idle";
         this._inflight.clear();
         // If any more pending conversions arrived while awaiting this request, schedule another request.
-        if (!this._pending.isEmpty)
+        if (!this._pending.isEmpty || this._redispatchOnCompletion) {
+            this._redispatchOnCompletion = false;
             this.scheduleDispatch(); // eslint-disable-line @typescript-eslint/no-floating-promises
+        }
         // Resolve promises of all callers who were awaiting this request.
         onCompleted.raiseEvent();
     }
@@ -107,7 +116,9 @@ export class CoordinateConverter {
             const xyz = this.toXYAndZ(point, this._scratchXYZ);
             if (this._cache.get(xyz))
                 ++numInCache;
-            else if (!this._inflight.contains(xyz))
+            else if (this._inflight.contains(xyz))
+                this._redispatchOnCompletion = true;
+            else
                 this._pending.insert(xyz);
         }
         return numInCache;
@@ -168,25 +179,19 @@ export class CoordinateConverter {
  */
 export class GeoConverter {
     /** @internal */
-    constructor(iModel, datumOrGCRS) {
-        const datum = typeof datumOrGCRS === "object" ? JSON.stringify(datumOrGCRS) : datumOrGCRS;
+    constructor(opts) {
+        /** Used for removing this converter from GeoServices' cache after all requests are completed.
+         * @internal
+         */
+        this.onAllRequestsCompleted = new BeEvent();
+        const isIModelClosed = opts.isIModelClosed;
         this._geoToIModel = new CoordinateConverter({
-            iModel,
-            requestPoints: async (geoCoords) => {
-                const request = { source: datum, geoCoords };
-                const rpc = IModelReadRpcInterface.getClientForRouting(iModel.routingContext.token);
-                const response = await rpc.getIModelCoordinatesFromGeoCoordinates(iModel.getRpcProps(), request);
-                return response.iModelCoords;
-            },
+            isIModelClosed,
+            requestPoints: async (geoCoords) => opts.toIModelCoords({ source: opts.datum, geoCoords }),
         });
         this._iModelToGeo = new CoordinateConverter({
-            iModel,
-            requestPoints: async (iModelCoords) => {
-                const request = { target: datum, iModelCoords };
-                const rpc = IModelReadRpcInterface.getClientForRouting(iModel.routingContext.token);
-                const response = await rpc.getGeoCoordinatesFromIModelCoordinates(iModel.getRpcProps(), request);
-                return response.geoCoords;
-            },
+            isIModelClosed,
+            requestPoints: async (iModelCoords) => opts.fromIModelCoords({ target: opts.datum, iModelCoords }),
         });
     }
     /** Convert the specified geographic coordinates into iModel coordinates. */
@@ -202,6 +207,7 @@ export class GeoConverter {
     /** @internal */
     async getIModelCoordinatesFromGeoCoordinates(geoPoints) {
         const result = await this._geoToIModel.convert(geoPoints);
+        this.checkCompletion();
         return {
             iModelCoords: result.points,
             fromCache: result.fromCache,
@@ -210,11 +216,16 @@ export class GeoConverter {
     /** @internal */
     async getGeoCoordinatesFromIModelCoordinates(iModelPoints) {
         const result = await this._iModelToGeo.convert(iModelPoints);
+        this.checkCompletion();
         return {
             geoCoords: result.points,
             fromCache: result.fromCache,
         };
     }
+    checkCompletion() {
+        if (this._geoToIModel.isIdle && this._iModelToGeo.isIdle)
+            this.onAllRequestsCompleted.raiseEvent();
+    }
     /** @internal */
     getCachedIModelCoordinatesFromGeoCoordinates(geoPoints) {
         return this._geoToIModel.findCached(geoPoints);
@@ -226,8 +237,35 @@ export class GeoConverter {
  */
 export class GeoServices {
     /** @internal */
-    constructor(iModel) {
-        this._iModel = iModel;
+    constructor(options) {
+        /** Each GeoConverter has its own independent request queue and cache of previously-converted points.
+         * Some callers like RealityTileTree obtain a single GeoConverter and reuse it throughout their own lifetime. Therefore they benefit from both batching and caching, and
+         * the cache gets deleted once the RealityTileTree becomes disused.
+         *
+         * Other callers like IModelConnection.spatialToCartographic obtain a new GeoConverter every time they need one, use it to convert a single point(!), and then discard the converter.
+         * This entirely prevents batching - e.g., calling spatialToCartographic 20 times in one frame results in 20 http requests.
+         * To address that, we cache each GeoConverter returned by getConverter until it has converted at least one point and has no further outstanding conversion requests.
+         * In this way, the converter lives for as long as (and no longer than) any caller is awaiting conversion to/from its datum - it and its cache are deleted once it becomes disused.
+         * This makes the coordinate caching generally less useful, but at least bounded - and maximizes batching of requests.
+         */
+        this._cache = new Map();
+        this._options = options;
+    }
+    /** @internal */
+    static createForIModel(iModel) {
+        return new GeoServices({
+            isIModelClosed: () => iModel.isClosed,
+            toIModelCoords: async (request) => {
+                const rpc = IModelReadRpcInterface.getClientForRouting(iModel.routingContext.token);
+                const response = await rpc.getIModelCoordinatesFromGeoCoordinates(iModel.getRpcProps(), request);
+                return response.iModelCoords;
+            },
+            fromIModelCoords: async (request) => {
+                const rpc = IModelReadRpcInterface.getClientForRouting(iModel.routingContext.token);
+                const response = await rpc.getGeoCoordinatesFromIModelCoordinates(iModel.getRpcProps(), request);
+                return response.geoCoords;
+            },
+        });
     }
     /** Obtain a converter that can convert between a geographic coordinate system and the iModel's own coordinate system.
      * @param datumOrGCRS The name or JSON representation of the geographic coordinate system datum - for example, "WGS84".
@@ -235,7 +273,19 @@ export class GeoServices {
      * @note A [[BlankConnection]] has no connection to a backend, so it is never "open"; therefore it always returns `undefined`.
      */
     getConverter(datumOrGCRS) {
-        return this._iModel.isOpen ? new GeoConverter(this._iModel, datumOrGCRS ? datumOrGCRS : "") : undefined;
+        if (this._options.isIModelClosed())
+            return undefined;
+        const datum = (typeof datumOrGCRS === "object" ? JSON.stringify(datumOrGCRS) : datumOrGCRS) ?? "";
+        let converter = this._cache.get(datum);
+        if (!converter) {
+            converter = new GeoConverter({ ...this._options, datum });
+            this._cache.set(datum, converter);
+            converter.onAllRequestsCompleted.addOnce(() => {
+                if (converter === this._cache.get(datum))
+                    this._cache.delete(datum);
+            });
+        }
+        return converter;
     }
 }
 //# sourceMappingURL=GeoServices.js.map