@itwin/core-frontend 3.4.0-dev.9 → 3.5.0-dev.4

package/lib/esm/tile/map/MapTileTree.d.ts

@@ -2,7 +2,7 @@
  * @module Tiles
  */
 import { Id64String } from "@itwin/core-bentley";
-import { BackgroundMapSettings, BaseLayerSettings, ColorDef, GlobeMode, MapLayerSettings, TerrainProviderName } from "@itwin/core-common";
+import { BackgroundMapSettings, BaseLayerSettings, ColorDef, GlobeMode, MapLayerSettings } from "@itwin/core-common";
 import { Ellipsoid, EllipsoidPatch, Point3d, Range1d, Range3d, Ray3d, Transform, Vector3d } from "@itwin/core-geometry";
 import { TerrainDisplayOverrides } from "../../DisplayStyleState";
 import { HitDetail } from "../../HitDetail";
@@ -12,67 +12,132 @@ import { RenderPlanarClassifier } from "../../render/RenderPlanarClassifier";
 import { SceneContext } from "../../ViewContext";
 import { ScreenViewport } from "../../Viewport";
 import { DisclosedTileTreeSet, GeometryTileTreeReference, ImageryMapLayerTreeReference, ImageryMapTileTree, MapCartoRectangle, MapLayerFeatureInfo, MapLayerTileTreeReference, MapTile, MapTileLoader, MapTilingScheme, ModelMapLayerTileTreeReference, QuadId, RealityTile, RealityTileTree, RealityTileTreeParams, Tile, TileDrawArgs, TileParams, TileTree, TileTreeOwner, TileTreeReference } from "../internal";
-/** @internal */
+/** A [quad tree](https://en.wikipedia.org/wiki/Quadtree) consisting of [[MapTile]]s representing the map imagery draped onto the surface of the Earth.
+ * A `MapTileTree` enables display of a globe or planar map with [map imagery](https://en.wikipedia.org/wiki/Tiled_web_map) obtained from any number of sources, such as
+ * [Bing](https://learn.microsoft.com/en-us/bingmaps/), [OpenStreetMap](https://wiki.openstreetmap.org/wiki/API), and [GIS servers](https://wiki.openstreetmap.org/wiki/API).
+ * The specific imagery displayed is determined by a [[Viewport]]'s [MapImagerySettings]($common) and [BackgroundMapSettings]($common).
+ *
+ * The map or globe may be smooth, or feature 3d geometry supplied by a [[TerrainProvider]].
+ * The terrain displayed in a [[Viewport]] is determined by its [TerrainSettings]($common).
+ * @beta
+ */
 export declare class MapTileTree extends RealityTileTree {
+    /** @internal */
     ecefToDb: Transform;
+    /** @internal */
     bimElevationBias: number;
+    /** @internal */
     geodeticOffset: number;
+    /** @internal */
     sourceTilingScheme: MapTilingScheme;
+    /** @internal */
     private _mercatorFractionToDb;
+    /** @internal */
     earthEllipsoid: Ellipsoid;
+    /** @internal */
     minEarthEllipsoid: Ellipsoid;
+    /** @internal */
     maxEarthEllipsoid: Ellipsoid;
-    globeMode: GlobeMode;
+    /** Determines whether the map displays as a plane or an ellipsoid. */
+    readonly globeMode: GlobeMode;
+    /** @internal */
     globeOrigin: Point3d;
+    /** @internal */
     private _mercatorTilingScheme;
+    /** @internal */
     useDepthBuffer: boolean;
+    /** @internal */
     isOverlay: boolean;
+    /** @internal */
     terrainExaggeration: number;
+    /** @internal */
     baseColor?: ColorDef;
+    /** @internal */
     baseTransparent: boolean;
+    /** @internal */
     mapTransparent: boolean;
+    /** @internal */
     produceGeometry?: boolean;
-    constructor(params: RealityTileTreeParams, ecefToDb: Transform, bimElevationBias: number, geodeticOffset: number, sourceTilingScheme: MapTilingScheme, id: MapTreeId, applyTerrain: boolean);
-    get parentsAndChildrenExclusive(): boolean;
-    tileFromQuadId(quadId: QuadId): MapTile | undefined;
+    /** @internal */
     imageryTrees: ImageryMapTileTree[];
     private _layerSettings;
     private _modelIdToIndex;
+    /** @internal */
     layerClassifiers: Map<number, RenderPlanarClassifier>;
+    /** @internal */
+    constructor(params: RealityTileTreeParams, ecefToDb: Transform, bimElevationBias: number, geodeticOffset: number, sourceTilingScheme: MapTilingScheme, id: MapTreeId, applyTerrain: boolean);
+    /** @internal */
+    get parentsAndChildrenExclusive(): boolean;
+    /** @internal */
+    tileFromQuadId(quadId: QuadId): MapTile | undefined;
+    /** @internal */
     addImageryLayer(tree: ImageryMapTileTree, settings: MapLayerSettings, index: number): void;
+    /** @internal */
     addModelLayer(layerTreeRef: ModelMapLayerTileTreeReference, context: SceneContext): void;
+    /** @internal */
     protected collectClassifierGraphics(args: TileDrawArgs, selectedTiles: RealityTile[]): void;
+    /** @internal */
     clearImageryTreesAndClassifiers(): void;
+    /** @internal */
     get isTransparent(): boolean;
+    /** @internal */
     get maxDepth(): number;
+    /** @internal */
     createPlanarChild(params: TileParams, quadId: QuadId, corners: Point3d[], normal: Vector3d, rectangle: MapCartoRectangle, chordHeight: number, heightRange?: Range1d): MapTile | undefined;
+    /** @internal */
     createGlobeChild(params: TileParams, quadId: QuadId, _rangeCorners: Point3d[], rectangle: MapCartoRectangle, ellipsoidPatch: EllipsoidPatch, heightRange?: Range1d): MapTile;
+    /** @internal */
     getChildHeightRange(quadId: QuadId, rectangle: MapCartoRectangle, parent: MapTile): Range1d | undefined;
+    /** @internal */
     clearLayers(): void;
+    /** Reprojection does not work with very large tiles so just do linear transform.
+     * @internal
+     */
     static minReprojectionDepth: number;
+    /** @internal */
     static maxGlobeDisplayDepth: number;
+    /** @internal */
     static minDisplayableDepth: number;
+    /** @internal */
     get mapLoader(): MapTileLoader;
+    /** @internal */
     getBaseRealityDepth(sceneContext: SceneContext): number;
+    /** @internal */
     doCreateGlobeChildren(tile: Tile): boolean;
+    /** @internal */
     doReprojectChildren(tile: Tile): boolean;
+    /** @internal */
     getCornerRays(rectangle: MapCartoRectangle): Ray3d[] | undefined;
+    /** @internal */
     pointAboveEllipsoid(point: Point3d): boolean;
     private getMercatorFractionChildGridPoints;
     private getChildCornersFromGridPoints;
+    /** @internal */
     getCachedReprojectedPoints(gridPoints: Point3d[]): (Point3d | undefined)[] | undefined;
+    /** Minimize reprojection requests by requesting this corners tile and a grid that will include all points for 4 levels of descendants.
+     * This greatly reduces the number of reprojection requests which currently require a roundtrip through the backend.
+     * @internal
+     */
     loadReprojectionCache(tile: MapTile): Promise<void>;
     private static _scratchCarto;
+    /** Get the corners for planar children.
+     * This generally will resolve immediately, but may require an asynchronous request for reprojecting the corners.
+     * @internal
+     */
     getPlanarChildCorners(tile: MapTile, columnCount: number, rowCount: number, resolve: (childCorners: Point3d[][]) => void): void;
+    /** @internal */
     getFractionalTileCorners(quadId: QuadId): Point3d[];
+    /** @internal */
     getTileRectangle(quadId: QuadId): MapCartoRectangle;
+    /** @internal */
     getLayerIndex(imageryTreeId: Id64String): number;
+    /** @internal */
     getLayerTransparency(imageryTreeId: Id64String): number;
 }
 interface MapTreeId {
     tileUserId: number;
     applyTerrain: boolean;
-    terrainProviderName: TerrainProviderName;
+    terrainProviderName: string;
     terrainHeightOrigin: number;
     terrainHeightOriginMode: number;
     terrainExaggeration: number;

package/lib/esm/tile/map/MapTileTree.d.ts.map

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

package/lib/esm/tile/map/MapTileTree.js

@@ -9,32 +9,44 @@ import { assert, compareBooleans, compareBooleansOrUndefined, compareNumbers, co
 import { Cartographic, FeatureAppearance, GeoCoordStatus, GlobeMode, MapLayerSettings, PlanarClipMaskPriority, TerrainHeightOriginMode, } from "@itwin/core-common";
 import { Angle, AngleSweep, Constant, Ellipsoid, EllipsoidPatch, Point3d, Range1d, Range3d, Ray3d, Transform, Vector3d, } from "@itwin/core-geometry";
 import { ApproximateTerrainHeights } from "../../ApproximateTerrainHeights";
+import { IModelApp } from "../../IModelApp";
 import { PlanarClipMaskState } from "../../PlanarClipMaskState";
 import { FeatureSymbology } from "../../render/FeatureSymbology";
-import { BingElevationProvider, createDefaultViewFlagOverrides, createMapLayerTreeReference, EllipsoidTerrainProvider, getCesiumTerrainProvider, GraphicsCollectorDrawArgs, ImageryMapTileTree, MapCartoRectangle, MapTile, MapTileLoader, ModelMapLayerTileTreeReference, PlanarTilePatch, QuadId, RealityTileDrawArgs, RealityTileTree, TileTreeLoadStatus, TileTreeReference, UpsampledMapTile, WebMercatorTilingScheme, } from "../internal";
+import { BingElevationProvider, createDefaultViewFlagOverrides, createMapLayerTreeReference, EllipsoidTerrainProvider, GraphicsCollectorDrawArgs, ImageryMapTileTree, MapCartoRectangle, MapTile, MapTileLoader, ModelMapLayerTileTreeReference, PlanarTilePatch, QuadId, RealityTileDrawArgs, RealityTileTree, TileTreeLoadStatus, TileTreeReference, UpsampledMapTile, WebMercatorTilingScheme, } from "../internal";
 const scratchPoint = Point3d.create();
 const scratchCorners = [Point3d.createZero(), Point3d.createZero(), Point3d.createZero(), Point3d.createZero(), Point3d.createZero(), Point3d.createZero(), Point3d.createZero(), Point3d.createZero()];
 const scratchCorner = Point3d.createZero();
 const scratchZNormal = Vector3d.create(0, 0, 1);
-/** @internal */
+/** A [quad tree](https://en.wikipedia.org/wiki/Quadtree) consisting of [[MapTile]]s representing the map imagery draped onto the surface of the Earth.
+ * A `MapTileTree` enables display of a globe or planar map with [map imagery](https://en.wikipedia.org/wiki/Tiled_web_map) obtained from any number of sources, such as
+ * [Bing](https://learn.microsoft.com/en-us/bingmaps/), [OpenStreetMap](https://wiki.openstreetmap.org/wiki/API), and [GIS servers](https://wiki.openstreetmap.org/wiki/API).
+ * The specific imagery displayed is determined by a [[Viewport]]'s [MapImagerySettings]($common) and [BackgroundMapSettings]($common).
+ *
+ * The map or globe may be smooth, or feature 3d geometry supplied by a [[TerrainProvider]].
+ * The terrain displayed in a [[Viewport]] is determined by its [TerrainSettings]($common).
+ * @beta
+ */
 export class MapTileTree extends RealityTileTree {
+    /** @internal */
     constructor(params, ecefToDb, bimElevationBias, geodeticOffset, sourceTilingScheme, id, applyTerrain) {
         super(params);
-        this.ecefToDb = ecefToDb;
-        this.bimElevationBias = bimElevationBias;
-        this.geodeticOffset = geodeticOffset;
-        this.sourceTilingScheme = sourceTilingScheme;
+        /** @internal */
         this.imageryTrees = [];
         this._layerSettings = new Map();
         this._modelIdToIndex = new Map();
+        /** @internal */
         this.layerClassifiers = new Map();
+        this.ecefToDb = ecefToDb;
+        this.bimElevationBias = bimElevationBias;
+        this.geodeticOffset = geodeticOffset;
+        this.sourceTilingScheme = sourceTilingScheme;
         this._mercatorTilingScheme = new WebMercatorTilingScheme();
         this._mercatorFractionToDb = this._mercatorTilingScheme.computeMercatorFractionToDb(ecefToDb, bimElevationBias, params.iModel, applyTerrain);
         const quadId = new QuadId(sourceTilingScheme.rootLevel, 0, 0);
         this.globeOrigin = this.ecefToDb.getOrigin().clone();
         this.earthEllipsoid = Ellipsoid.createCenterMatrixRadii(this.globeOrigin, this.ecefToDb.matrix, Constant.earthRadiusWGS84.equator, Constant.earthRadiusWGS84.equator, Constant.earthRadiusWGS84.polar);
         const globalHeightRange = applyTerrain ? ApproximateTerrainHeights.instance.globalHeightRange : Range1d.createXX(0, 0);
-        const globalRectangle = MapCartoRectangle.create();
+        const globalRectangle = MapCartoRectangle.createMaximum();
         this.globeMode = id.globeMode;
         this.isOverlay = id.isOverlay;
         this.useDepthBuffer = id.useDepthBuffer;
@@ -63,21 +75,29 @@ export class MapTileTree extends RealityTileTree {
         }
         this._rootTile = this.createGlobeChild({ contentId: quadId.contentId, maximumSize: 0, range }, quadId, range.corners(), globalRectangle, rootPatch, undefined);
     }
-    // If we are not depth buffering we force parents and exclusive to false to cause the map tiles to be sorted by depth so that painters algorithm will approximate correct depth display.
-    get parentsAndChildrenExclusive() { return this.useDepthBuffer ? this.loader.parentsAndChildrenExclusive : false; }
+    /** @internal */
+    get parentsAndChildrenExclusive() {
+        // If we are not depth buffering we force parents and exclusive to false to cause the map tiles to be sorted
+        // by depth so that painters algorithm will approximate correct depth display.
+        return this.useDepthBuffer ? this.loader.parentsAndChildrenExclusive : false;
+    }
+    /** @internal */
     tileFromQuadId(quadId) {
         return this._rootTile.tileFromQuadId(quadId);
     }
+    /** @internal */
     addImageryLayer(tree, settings, index) {
         this.imageryTrees.push(tree);
         this._layerSettings.set(tree.modelId, settings);
         this._modelIdToIndex.set(tree.modelId, index);
     }
+    /** @internal */
     addModelLayer(layerTreeRef, context) {
         const classifier = context.addPlanarClassifier(`MapLayer ${this.modelId}-${layerTreeRef.layerIndex}`, layerTreeRef);
         if (classifier)
             this.layerClassifiers.set(layerTreeRef.layerIndex, classifier);
     }
+    /** @internal */
     collectClassifierGraphics(args, selectedTiles) {
         super.collectClassifierGraphics(args, selectedTiles);
         this.layerClassifiers.forEach((layerClassifier) => {
@@ -85,21 +105,25 @@ export class MapTileTree extends RealityTileTree {
                 layerClassifier.collectGraphics(args.context, { modelId: this.modelId, tiles: selectedTiles, location: args.location, isPointCloud: this.isPointCloud });
         });
     }
+    /** @internal */
     clearImageryTreesAndClassifiers() {
         this.imageryTrees.length = 0;
         this._layerSettings.clear();
         this._modelIdToIndex.clear();
         this.layerClassifiers.clear();
     }
+    /** @internal */
     get isTransparent() {
         return this.mapTransparent || this.baseTransparent;
     }
+    /** @internal */
     get maxDepth() {
         var _a;
         let maxDepth = this.loader.maxDepth;
         (_a = this.imageryTrees) === null || _a === void 0 ? void 0 : _a.forEach((imageryTree) => maxDepth = Math.max(maxDepth, imageryTree.maxDepth));
         return maxDepth;
     }
+    /** @internal */
     createPlanarChild(params, quadId, corners, normal, rectangle, chordHeight, heightRange) {
         const childAvailable = this.mapLoader.isTileAvailable(quadId);
         if (!childAvailable && this.produceGeometry)
@@ -109,20 +133,26 @@ export class MapTileTree extends RealityTileTree {
         const ctor = childAvailable ? MapTile : UpsampledMapTile;
         return new ctor(params, this, quadId, patch, rectangle, heightRange, cornerNormals);
     }
+    /** @internal */
     createGlobeChild(params, quadId, _rangeCorners, rectangle, ellipsoidPatch, heightRange) {
         return new MapTile(params, this, quadId, ellipsoidPatch, rectangle, heightRange, this.getCornerRays(rectangle));
     }
+    /** @internal */
     getChildHeightRange(quadId, rectangle, parent) {
         return this.mapLoader.getChildHeightRange(quadId, rectangle, parent);
     }
+    /** @internal */
     clearLayers() {
         this._rootTile.clearLayers();
     }
+    /** @internal */
     get mapLoader() { return this.loader; }
+    /** @internal */
     getBaseRealityDepth(sceneContext) {
         // If the view has ever had global scope then preload low level (global) tiles.
         return (sceneContext.viewport.view.maxGlobalScopeFactor > 1) ? MapTileTree.minDisplayableDepth : -1;
     }
+    /** @internal */
     doCreateGlobeChildren(tile) {
         if (this.globeMode !== GlobeMode.Ellipsoid)
             return false;
@@ -131,6 +161,7 @@ export class MapTileTree extends RealityTileTree {
             return true;
         return false; // Display as globe if more than 100 KM from project.
     }
+    /** @internal */
     doReprojectChildren(tile) {
         if (this._gcsConverter === undefined)
             return false;
@@ -139,6 +170,7 @@ export class MapTileTree extends RealityTileTree {
             return false;
         return this.cartesianRange.intersectsRange(tile.range);
     }
+    /** @internal */
     getCornerRays(rectangle) {
         const rays = new Array();
         if (this.globeMode === GlobeMode.Ellipsoid) {
@@ -156,6 +188,7 @@ export class MapTileTree extends RealityTileTree {
         }
         return rays;
     }
+    /** @internal */
     pointAboveEllipsoid(point) {
         return this.earthEllipsoid.worldToLocal(point, scratchPoint).magnitude() > 1;
     }
@@ -187,6 +220,7 @@ export class MapTileTree extends RealityTileTree {
         }
         return childCorners;
     }
+    /** @internal */
     getCachedReprojectedPoints(gridPoints) {
         const requestProps = [];
         for (const gridPoint of gridPoints)
@@ -200,8 +234,10 @@ export class MapTileTree extends RealityTileTree {
             return undefined;
         return iModelCoordinates.result.map((result) => !result || result.s ? undefined : Point3d.fromJSON(result.p));
     }
-    // Minimize reprojection requests by requesting this corners tile and a grid that will include all points for 4 levels of descendants.
-    // This greatly reduces the number of reprojection requests which currently require a roundtrip through the backend.
+    /** Minimize reprojection requests by requesting this corners tile and a grid that will include all points for 4 levels of descendants.
+     * This greatly reduces the number of reprojection requests which currently require a roundtrip through the backend.
+     * @internal
+     */
     async loadReprojectionCache(tile) {
         const quadId = tile.quadId;
         const xRange = Range1d.createXX(this.sourceTilingScheme.tileXToFraction(quadId.column, quadId.level), this.sourceTilingScheme.tileXToFraction(quadId.column + 1, quadId.level));
@@ -223,7 +259,10 @@ export class MapTileTree extends RealityTileTree {
         }
         await this._gcsConverter.getIModelCoordinatesFromGeoCoordinates(requestProps);
     }
-    // Get the corners for planar children -- This generally will resolve immediately, but may require an asynchronous request for reprojecting the corners.
+    /** Get the corners for planar children.
+     * This generally will resolve immediately, but may require an asynchronous request for reprojecting the corners.
+     * @internal
+     */
     getPlanarChildCorners(tile, columnCount, rowCount, resolve) {
         const resolveCorners = (points, reprojected = undefined) => {
             for (let i = 0; i < points.length; i++) {
@@ -269,6 +308,7 @@ export class MapTileTree extends RealityTileTree {
             resolveCorners(gridPoints);
         }
     }
+    /** @internal */
     getFractionalTileCorners(quadId) {
         const corners = [];
         corners.push(Point3d.create(this.sourceTilingScheme.tileXToFraction(quadId.column, quadId.level), this.sourceTilingScheme.tileYToFraction(quadId.row, quadId.level), 0.0));
@@ -277,21 +317,29 @@ export class MapTileTree extends RealityTileTree {
         corners.push(Point3d.create(this.sourceTilingScheme.tileXToFraction(quadId.column + 1, quadId.level), this.sourceTilingScheme.tileYToFraction(quadId.row + 1, quadId.level), 0.0));
         return corners;
     }
+    /** @internal */
     getTileRectangle(quadId) {
         return this.sourceTilingScheme.tileXYToRectangle(quadId.column, quadId.row, quadId.level);
     }
+    /** @internal */
     getLayerIndex(imageryTreeId) {
         const index = this._modelIdToIndex.get(imageryTreeId);
         return index === undefined ? -1 : index;
     }
+    /** @internal */
     getLayerTransparency(imageryTreeId) {
         const layerSettings = this._layerSettings.get(imageryTreeId);
         assert(undefined !== layerSettings);
         return undefined === layerSettings || !layerSettings.transparency ? 0.0 : layerSettings.transparency;
     }
 }
-MapTileTree.minReprojectionDepth = 8; // Reprojection does not work with very large tiles so just do linear transform.
+/** Reprojection does not work with very large tiles so just do linear transform.
+ * @internal
+ */
+MapTileTree.minReprojectionDepth = 8;
+/** @internal */
 MapTileTree.maxGlobeDisplayDepth = 8;
+/** @internal */
 MapTileTree.minDisplayableDepth = 3;
 MapTileTree._scratchCarto = Cartographic.createZero();
 /** @internal */
@@ -385,20 +433,26 @@ class MapTreeSupplier {
         let applyTerrain = id.applyTerrain;
         const modelId = iModel.transientIds.next;
         const gcsConverterAvailable = await getGcsConverterAvailable(iModel);
+        const terrainOpts = {
+            wantSkirts: id.wantSkirts,
+            exaggeration: id.terrainExaggeration,
+            wantNormals: id.wantNormals,
+        };
         if (id.applyTerrain) {
-            assert(id.terrainProviderName === "CesiumWorldTerrain");
             await ApproximateTerrainHeights.instance.initialize();
             const elevationProvider = new BingElevationProvider();
             bimElevationBias = -await this.computeHeightBias(id.terrainHeightOrigin, id.terrainHeightOriginMode, id.terrainExaggeration, iModel, elevationProvider);
             geodeticOffset = await elevationProvider.getGeodeticToSeaLevelOffset(iModel.projectExtents.center, iModel);
-            terrainProvider = await getCesiumTerrainProvider(iModel, modelId, id.wantSkirts, id.wantNormals, id.terrainExaggeration);
+            const provider = IModelApp.terrainProviderRegistry.find(id.terrainProviderName);
+            if (provider)
+                terrainProvider = await provider.createTerrainMeshProvider(terrainOpts);
             if (!terrainProvider) {
                 applyTerrain = false;
                 geodeticOffset = 0;
             }
         }
         if (!terrainProvider) {
-            terrainProvider = new EllipsoidTerrainProvider(iModel, modelId, id.wantSkirts);
+            terrainProvider = new EllipsoidTerrainProvider(terrainOpts);
             bimElevationBias = id.mapGroundBias;
         }
         const loader = new MapTileLoader(iModel, modelId, bimElevationBias, terrainProvider);
@@ -455,7 +509,9 @@ export class MapTileTreeReference extends TileTreeReference {
     _createGeometryTreeReference() {
         if (!this._settings.applyTerrain || this._isDrape)
             return undefined; // Don't bother generating non-terrain (flat) geometry.
-        const ref = new MapTileTreeReference(this._settings, undefined, [], this._iModel, this._tileUserId, false, false, () => { return { produceGeometry: true }; });
+        const ref = new MapTileTreeReference(this._settings, undefined, [], this._iModel, this._tileUserId, false, false, () => {
+            return { produceGeometry: true };
+        });
         assert(undefined !== ref.collectTileGeometry);
         return ref;
     }