@itwin/core-frontend 3.6.0-dev.45 → 3.6.0-dev.47

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

@@ -12,11 +12,24 @@ import { ApproximateTerrainHeights } from "../../ApproximateTerrainHeights";
 import { IModelApp } from "../../IModelApp";
 import { PlanarClipMaskState } from "../../PlanarClipMaskState";
 import { FeatureSymbology } from "../../render/FeatureSymbology";
-import { BingElevationProvider, createDefaultViewFlagOverrides, createMapLayerTreeReference, EllipsoidTerrainProvider, GraphicsCollectorDrawArgs, ImageryMapTileTree, MapCartoRectangle, MapTile, MapTileLoader, ModelMapLayerTileTreeReference, PlanarTilePatch, QuadId, RealityTileDrawArgs, RealityTileTree, TileTreeLoadStatus, TileTreeReference, UpsampledMapTile, WebMercatorTilingScheme, } from "../internal";
+import { BingElevationProvider, createDefaultViewFlagOverrides, createMapLayerTreeReference, EllipsoidTerrainProvider, GraphicsCollectorDrawArgs, ImageryMapTileTree, ImageryTileTreeState, 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);
+/** Map tile tree scale range visibility values.
+ * @beta */
+export var MapTileTreeScaleRangeVisibility;
+(function (MapTileTreeScaleRangeVisibility) {
+    /** state is currently unknown (i.e. never been displayed)  */
+    MapTileTreeScaleRangeVisibility[MapTileTreeScaleRangeVisibility["Unknown"] = 0] = "Unknown";
+    /** all currently selected tree tiles are visible (i.e within the scale range)  */
+    MapTileTreeScaleRangeVisibility[MapTileTreeScaleRangeVisibility["Visible"] = 1] = "Visible";
+    /** all currently selected tree tiles are hidden (i.e outside the scale range)  */
+    MapTileTreeScaleRangeVisibility[MapTileTreeScaleRangeVisibility["Hidden"] = 2] = "Hidden";
+    /** currently selected tree tiles are partially visible (i.e some tiles are within the scale range, and some are outside.) */
+    MapTileTreeScaleRangeVisibility[MapTileTreeScaleRangeVisibility["Partial"] = 3] = "Partial";
+})(MapTileTreeScaleRangeVisibility || (MapTileTreeScaleRangeVisibility = {}));
 /** 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).
@@ -31,8 +44,9 @@ export class MapTileTree extends RealityTileTree {
     constructor(params, ecefToDb, bimElevationBias, geodeticOffset, sourceTilingScheme, id, applyTerrain) {
         super(params);
         /** @internal */
-        this.imageryTrees = [];
+        this.layerImageryTrees = [];
         this._layerSettings = new Map();
+        this._imageryTreeState = new Map();
         this._modelIdToIndex = new Map();
         /** @internal */
         this.layerClassifiers = new Map();
@@ -81,14 +95,34 @@ export class MapTileTree extends RealityTileTree {
         // by depth so that painters algorithm will approximate correct depth display.
         return this.useDepthBuffer ? this.loader.parentsAndChildrenExclusive : false;
     }
+    /** Return the imagery tile tree state of matching the provided imagery tree id.
+     * @internal
+     */
+    getImageryTreeState(imageryTreeId) {
+        return this._imageryTreeState.get(imageryTreeId);
+    }
+    /** Return a cloned dictionary of the imagery tile tree states
+     * @internal
+     */
+    cloneImageryTreeState() {
+        const clone = new Map();
+        for (const [treeId, state] of this._imageryTreeState) {
+            clone.set(treeId, state.clone());
+        }
+        return clone;
+    }
     /** @internal */
     tileFromQuadId(quadId) {
         return this._rootTile.tileFromQuadId(quadId);
     }
-    /** @internal */
+    /** Add a new imagery tile tree / map-layer settings pair and initialize the imagery tile tree state.
+     * @internal
+     */
     addImageryLayer(tree, settings, index) {
-        this.imageryTrees.push(tree);
+        this.layerImageryTrees.push({ tree, settings });
         this._layerSettings.set(tree.modelId, settings);
+        if (!this._imageryTreeState.has(tree.modelId))
+            this._imageryTreeState.set(tree.modelId, new ImageryTileTreeState());
         this._modelIdToIndex.set(tree.modelId, index);
     }
     /** @internal */
@@ -107,7 +141,7 @@ export class MapTileTree extends RealityTileTree {
     }
     /** @internal */
     clearImageryTreesAndClassifiers() {
-        this.imageryTrees.length = 0;
+        this.layerImageryTrees.length = 0;
         this._layerSettings.clear();
         this._modelIdToIndex.clear();
         this.layerClassifiers.clear();
@@ -120,7 +154,7 @@ export class MapTileTree extends RealityTileTree {
     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));
+        (_a = this.layerImageryTrees) === null || _a === void 0 ? void 0 : _a.forEach((layerImageryTree) => maxDepth = Math.max(maxDepth, layerImageryTree.tree.maxDepth));
         return maxDepth;
     }
     /** @internal */
@@ -308,6 +342,69 @@ export class MapTileTree extends RealityTileTree {
             resolveCorners(gridPoints);
         }
     }
+    /** Scan the list of currently selected reality tiles, and fire the viewport's 'onMapLayerScaleRangeVisibilityChanged ' event
+     * if any scale range visibility change is detected for one more map-layer definition.
+     * @internal
+     */
+    reportTileVisibility(args, selected) {
+        const debugControl = args.context.target.debugControl;
+        const layersVisibilityBefore = this.cloneImageryTreeState();
+        const changes = new Array();
+        if (!layersVisibilityBefore)
+            return;
+        for (const [treeId] of layersVisibilityBefore) {
+            const treeVisibility = this.getImageryTreeState(treeId);
+            if (treeVisibility) {
+                treeVisibility.reset();
+            }
+        }
+        let allTilesRead = true;
+        for (const selectedTile of selected) {
+            if (selectedTile instanceof MapTile) {
+                if (!selectedTile.isReady)
+                    allTilesRead = false;
+                let selectedImageryTiles = selectedTile.imageryTiles;
+                if (selectedTile.hiddenImageryTiles) {
+                    selectedImageryTiles = selectedImageryTiles ? [...selectedImageryTiles, ...selectedTile.hiddenImageryTiles] : selectedTile.hiddenImageryTiles;
+                }
+                if (selectedImageryTiles) {
+                    for (const selectedImageryTile of selectedImageryTiles) {
+                        const treeState = this.getImageryTreeState(selectedImageryTile.tree.id);
+                        if (treeState) {
+                            if (selectedImageryTile.isOutOfLodRange) {
+                                treeState.setScaleRangeVisibility(false);
+                            }
+                            else {
+                                treeState.setScaleRangeVisibility(true);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        if (!allTilesRead)
+            changes;
+        for (const [treeId, prevState] of layersVisibilityBefore) {
+            const newState = this.getImageryTreeState(treeId);
+            if (newState) {
+                const prevVisibility = prevState.getScaleRangeVisibility();
+                const visibility = newState.getScaleRangeVisibility();
+                if (prevVisibility !== visibility) {
+                    if (debugControl && debugControl.logRealityTiles) {
+                        // eslint-disable-next-line no-console
+                        console.log(`ImageryTileTree '${treeId}' changed prev state: '${MapTileTreeScaleRangeVisibility[prevVisibility]}' new state: '${MapTileTreeScaleRangeVisibility[visibility]}'`);
+                    }
+                    const mapLayersIndexes = args.context.viewport.getMapLayerIndexesFromIds(this.id, treeId);
+                    for (const index of mapLayersIndexes) {
+                        changes.push({ index: index.index, isOverlay: index.isOverlay, visibility });
+                    }
+                }
+            }
+        }
+        if (changes.length !== 0) {
+            args.context.viewport.onMapLayerScaleRangeVisibilityChanged.raiseEvent(changes);
+        }
+    }
     /** @internal */
     getFractionalTileCorners(quadId) {
         const corners = [];
@@ -623,11 +720,28 @@ export class MapTileTreeReference extends TileTreeReference {
         const treeIndex = index + baseLayerIndex;
         return index < 0 || treeIndex >= this._layerTrees.length ? undefined : this._layerTrees[treeIndex];
     }
+    /** Return the map-layer scale range visibility for the provided map-layer index.
+   * @internal
+   */
+    getMapLayerScaleRangeVisibility(index) {
+        var _a;
+        const tree = this.treeOwner.tileTree;
+        if (undefined !== tree) {
+            const tileTreeRef = this.getLayerImageryTreeRef(index);
+            const treeId = (_a = tileTreeRef === null || tileTreeRef === void 0 ? void 0 : tileTreeRef.treeOwner.tileTree) === null || _a === void 0 ? void 0 : _a.id;
+            if (treeId !== undefined) {
+                const treeState = tree.getImageryTreeState(treeId);
+                if (treeState !== undefined)
+                    return treeState.getScaleRangeVisibility();
+            }
+        }
+        return MapTileTreeScaleRangeVisibility.Unknown;
+    }
     initializeLayers(context) {
         const tree = this.treeOwner.load();
         if (undefined === tree)
             return false; // Not loaded yet.
-        tree.imageryTrees.length = 0;
+        tree.layerImageryTrees.length = 0;
         if (0 === this._layerTrees.length)
             return !this.isOverlay;
         let treeIndex = this._layerTrees.length - 1;
@@ -639,7 +753,10 @@ export class MapTileTreeReference extends TileTreeReference {
         }
         for (; treeIndex < this._layerTrees.length; treeIndex++) {
             const layerTreeRef = this._layerTrees[treeIndex];
-            if (layerTreeRef && TileTreeLoadStatus.NotFound !== layerTreeRef.treeOwner.loadStatus && layerTreeRef.layerSettings.visible && !layerTreeRef.layerSettings.allSubLayersInvisible) {
+            // Load tile tree for each configured layer.
+            // Note: Non-visible layer are also added to allow proper tile tree scale range visibility reporting.
+            if (layerTreeRef && TileTreeLoadStatus.NotFound !== layerTreeRef.treeOwner.loadStatus
+                && !layerTreeRef.layerSettings.allSubLayersInvisible) {
                 const layerTree = layerTreeRef.treeOwner.load();
                 if (undefined === layerTree)
                     return false; // Not loaded yet.