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

package/lib/cjs/tile/map/MapTile.js

@@ -12,6 +12,8 @@ const core_bentley_1 = require("@itwin/core-bentley");
 const core_common_1 = require("@itwin/core-common");
 const core_geometry_1 = require("@itwin/core-geometry");
 const IModelApp_1 = require("../../IModelApp");
+const RealityMeshParams_1 = require("../../render/RealityMeshParams");
+const UpsampleRealityMeshParams_1 = require("../../render/UpsampleRealityMeshParams");
 const RenderSystem_1 = require("../../render/RenderSystem");
 const internal_1 = require("../internal");
 /** @internal */
@@ -34,16 +36,21 @@ class PlanarTilePatch {
     }
 }
 exports.PlanarTilePatch = PlanarTilePatch;
-/** @internal */
+/** Projects points within the rectangular region of a [[MapTile]] into 3d space.
+ * @see [[MapTile.getProjection]] to obtain the projection for a [[MapTile]].
+ * @beta
+ */
 class MapTileProjection {
+    /** @alpha */
     get ellipsoidPatch() { return undefined; }
+    /** @alpha */
     getGlobalPoint(u, v, z, result) {
         const point = this.getPoint(u, v, z, result);
         return this.transformFromLocal.multiplyPoint3d(point, point);
     }
 }
 exports.MapTileProjection = MapTileProjection;
-/** @internal */
+/** @alpha */
 class EllipsoidProjection extends MapTileProjection {
     constructor(_patch, heightRange) {
         super();
@@ -61,7 +68,7 @@ class EllipsoidProjection extends MapTileProjection {
 }
 EllipsoidProjection._scratchAngles = core_geometry_1.LongitudeLatitudeNumber.createZero();
 EllipsoidProjection._scratchRay = core_geometry_1.Ray3d.createZero();
-/** @internal */
+/** @alpha */
 class PlanarProjection extends MapTileProjection {
     constructor(patch, heightRange) {
         super();
@@ -83,53 +90,74 @@ const scratchViewZ = core_geometry_1.Vector3d.create();
 const scratchPoint = core_geometry_1.Point3d.create();
 const scratchClipPlanes = [core_geometry_1.ClipPlane.createNormalAndPoint(scratchNormal, scratchPoint), core_geometry_1.ClipPlane.createNormalAndPoint(scratchNormal, scratchPoint), core_geometry_1.ClipPlane.createNormalAndPoint(scratchNormal, scratchPoint), core_geometry_1.ClipPlane.createNormalAndPoint(scratchNormal, scratchPoint)];
 const scratchCorners = [core_geometry_1.Point3d.createZero(), core_geometry_1.Point3d.createZero(), core_geometry_1.Point3d.createZero(), core_geometry_1.Point3d.createZero(), core_geometry_1.Point3d.createZero(), core_geometry_1.Point3d.createZero(), core_geometry_1.Point3d.createZero(), core_geometry_1.Point3d.createZero()];
-/**
- * A specialization of Tile for maps imagery.  Holds the corners (possibly reprojected) as well as the height range.
- * @internal
+/** A [[Tile]] belonging to a [[MapTileTree]] representing a rectangular region of a map of the Earth.
+ * @beta
  */
-/** @internal */
 class MapTile extends internal_1.RealityTile {
-    constructor(params, mapTree, quadId, _patch, rectangle, heightRange, _cornerRays) {
+    /** @internal */
+    constructor(params, mapTree, quadId, patch, rectangle, heightRange, cornerRays) {
         super(params, mapTree);
+        /** @internal */
+        this.everLoaded = false; // If the tile is only required for availability metadata, load it once and then allow it to be unloaded.
         this.mapTree = mapTree;
         this.quadId = quadId;
-        this._patch = _patch;
+        this._patch = patch;
         this.rectangle = rectangle;
-        this._cornerRays = _cornerRays;
-        this.everLoaded = false; // If the tile is only required for availability metadata, load it once and then allow it to be unloaded.
-        this._heightRange = heightRange ? heightRange.clone() : undefined;
+        this._cornerRays = cornerRays;
+        this._heightRange = heightRange === null || heightRange === void 0 ? void 0 : heightRange.clone();
     }
-    get isReady() { return super.isReady && this.baseImageryIsReady; }
-    get hasGraphics() { return this._renderGeometry !== undefined; }
+    /** @internal */
+    get isReady() {
+        return super.isReady && this.baseImageryIsReady;
+    }
+    /** @internal */
+    get hasGraphics() {
+        return this._renderGeometry !== undefined;
+    }
+    /** @internal */
     get renderGeometry() { return this._renderGeometry; }
+    /** @internal */
     get mesh() { return this._mesh; }
+    /** @internal */
     get loadableTerrainTile() { return this.loadableTile; }
+    /** @internal */
     get isPlanar() { return this._patch instanceof PlanarTilePatch; }
+    /** @internal */
     get imageryTiles() { return this._imageryTiles; }
-    getRangeCorners(result) { return this._patch instanceof PlanarTilePatch ? this._patch.getRangeCorners(this.heightRange, result) : this.range.corners(result); }
+    /** @internal */
+    getRangeCorners(result) {
+        return this._patch instanceof PlanarTilePatch ? this._patch.getRangeCorners(this.heightRange, result) : this.range.corners(result);
+    }
+    /** @internal */
     getSizeProjectionCorners() {
         // Use only the first 4 corners -- On terrain tiles the height is initially exagerated to world height range which can cause excessive tile loading.
         const rangeCorners = this.getRangeCorners(scratchCorners);
         return rangeCorners.slice(0, 4);
     }
+    /** @internal */
     markUsed(args) {
         super.markUsed(args);
         if (this._imageryTiles)
             for (const imageryTile of this._imageryTiles)
                 imageryTile.markUsed(args);
     }
+    /** @internal */
     get graphicType() {
-        return this.mapTree.isOverlay ? internal_1.TileGraphicType.Overlay : ((this.mapTree.useDepthBuffer || this._forceDepthBuffer) ? internal_1.TileGraphicType.Scene : internal_1.TileGraphicType.BackgroundMap);
+        if (this.mapTree.isOverlay)
+            return internal_1.TileGraphicType.Overlay;
+        return (this.mapTree.useDepthBuffer || this._forceDepthBuffer) ? internal_1.TileGraphicType.Scene : internal_1.TileGraphicType.BackgroundMap;
     }
+    /** @internal */
     get mapLoader() { return this.realityRoot.loader; }
+    /** @internal */
     get isUpsampled() { return false; }
+    /** @internal */
     tileFromQuadId(quadId) {
         if (0 === quadId.compare(this.quadId))
             return this;
-        if (quadId.level <= this.quadId.level) {
-            (0, core_bentley_1.assert)(false);
+        (0, core_bentley_1.assert)(quadId.level > this.quadId.level);
+        if (quadId.level <= this.quadId.level)
             return undefined;
-        }
         if (this.children) {
             const shift = quadId.level - this.quadId.level - 1;
             const childRow = quadId.row >> shift;
@@ -144,8 +172,10 @@ class MapTile extends internal_1.RealityTile {
         return undefined;
     }
     get _forceDepthBuffer() {
-        return this.mapTree.globeMode === core_common_1.GlobeMode.Ellipsoid && this.depth < 8; // For large ellipsoidal globe tile force the depth buffer on to avoid anomalies at horizon.  These are large enough that they
+        // For large ellipsoidal globe tile force the depth buffer on to avoid anomalies at horizon.
+        return this.mapTree.globeMode === core_common_1.GlobeMode.Ellipsoid && this.depth < 8;
     }
+    /** @internal */
     addBoundingGraphic(builder, color) {
         if (!this.isDisplayable)
             return;
@@ -190,6 +220,7 @@ class MapTile extends internal_1.RealityTile {
         builder.setSymbology(transitionColor, transitionColor, 31);
         builder.addPointString(transitionPoints);
     }
+    /** @internal */
     getContentClip() {
         const points = this.getClipShape();
         if (points.length < 3)
@@ -217,19 +248,24 @@ class MapTile extends internal_1.RealityTile {
             return core_geometry_1.ClipVector.createCapture([core_geometry_1.ClipShape.createShape(points)]);
         }
     }
+    /** @internal */
     setNotFound() {
         super.setNotFound();
         // For map tiles assume that an unfound tile implies descendants and siblings will also be unfound.
         if (undefined !== this.parent)
             this.parent.setLeaf();
     }
-    getGraphic(_system, _texture) { return undefined; }
+    /** @internal */
+    getGraphic(_system, _texture) {
+        return undefined;
+    }
     /** For globe tiles displaying less then depth 2 appears distorted
      * @internal
      */
     get isDisplayable() {
         return this.mapTree.globeMode === core_common_1.GlobeMode.Ellipsoid ? (this.depth >= internal_1.MapTileTree.minDisplayableDepth) : super.isDisplayable;
     }
+    /** @internal */
     isOccluded(viewingSpace) {
         if (undefined === this._cornerRays || this.mapTree.globeMode !== core_common_1.GlobeMode.Ellipsoid)
             return false;
@@ -251,6 +287,7 @@ class MapTile extends internal_1.RealityTile {
         }
         return true;
     }
+    /** @internal */
     _loadChildren(resolve, _reject) {
         const mapTree = this.mapTree;
         const childLevel = this.quadId.level + 1;
@@ -318,6 +355,7 @@ class MapTile extends internal_1.RealityTile {
         resolve(children);
         return children;
     }
+    /** @internal */
     static computeRangeCorners(corners, normal, chordHeight, result, heightRange) {
         if (result === undefined) {
             result = [];
@@ -334,12 +372,15 @@ class MapTile extends internal_1.RealityTile {
             corner.plus(deltaHigh, result[index++]);
         return result;
     }
+    /** @internal */
     isRegionCulled(args) {
         return this.isContentCulled(args);
     }
+    /** @internal */
     isContentCulled(args) {
         return core_common_1.FrustumPlanes.Containment.Outside === args.frustumPlanes.computeContainment(this.getRangeCorners(scratchCorners));
     }
+    /** @internal */
     clearLayers() {
         this.clearImageryTiles();
         this._graphic = undefined;
@@ -353,6 +394,7 @@ class MapTile extends internal_1.RealityTile {
             this._imageryTiles = undefined;
         }
     }
+    /** @internal */
     produceGraphics() {
         if (undefined !== this._graphic && this.imageryIsReady)
             return this._graphic;
@@ -368,14 +410,21 @@ class MapTile extends internal_1.RealityTile {
             this._graphic = graphic;
         return graphic;
     }
+    /** @internal */
     getClipShape() {
         return (this._patch instanceof PlanarTilePatch) ? this._patch.getClipShape() : [this._cornerRays[0].origin, this._cornerRays[1].origin, this._cornerRays[3].origin, this._cornerRays[2].origin];
     }
+    /** @internal */
     _collectStatistics(stats) {
-        var _a, _b;
+        var _a;
         super._collectStatistics(stats);
         (_a = this._renderGeometry) === null || _a === void 0 ? void 0 : _a.collectStatistics(stats);
-        (_b = this._mesh) === null || _b === void 0 ? void 0 : _b.collectStatistics(stats);
+        if (this._mesh) {
+            stats.addTerrain(this._mesh.indices.byteLength
+                + this._mesh.positions.points.byteLength
+                + this._mesh.uvs.points.byteLength
+                + (this._mesh.normals ? this._mesh.normals.byteLength : 0));
+        }
     }
     /** Height range is along with the tile corners to detect if tile intersects view frustum.
      * Range will be single value fo ron-terrain tiles -- if terrain tile is not loaded it will
@@ -393,9 +442,11 @@ class MapTile extends internal_1.RealityTile {
         (0, core_bentley_1.assert)(false);
         return core_geometry_1.Range1d.createNull();
     }
+    /** @internal */
     get mapTilingScheme() {
         return this.mapTree.sourceTilingScheme;
     }
+    /** Adjust the minimum and maximum elevations of the terrain within this tile. */
     adjustHeights(minHeight, maxHeight) {
         if (undefined === this._heightRange)
             this._heightRange = core_geometry_1.Range1d.createXX(minHeight, maxHeight);
@@ -406,9 +457,11 @@ class MapTile extends internal_1.RealityTile {
         if (this.rangeCorners && this._patch instanceof PlanarTilePatch)
             this._patch.getRangeCorners(this.heightRange, this.rangeCorners);
     }
+    /** Obtain a [[MapTileProjection]] to project positions within this tile's area into 3d space. */
     getProjection(heightRange) {
         return this._patch instanceof PlanarTilePatch ? new PlanarProjection(this._patch, heightRange) : new EllipsoidProjection(this._patch, heightRange);
     }
+    /** @internal */
     get baseImageryIsReady() {
         if (undefined !== this.mapTree.baseColor || 0 === this.mapTree.imageryTrees.length)
             return true;
@@ -417,6 +470,7 @@ class MapTile extends internal_1.RealityTile {
         const baseTreeId = this.mapTree.imageryTrees[0].modelId;
         return this._imageryTiles.every((imageryTile) => imageryTile.imageryTree.modelId !== baseTreeId || imageryTile.isReady);
     }
+    /** @internal */
     get imageryIsReady() {
         if (undefined === this._imageryTiles)
             return 0 === this.mapTree.imageryTrees.length;
@@ -456,6 +510,7 @@ class MapTile extends internal_1.RealityTile {
             parentHeightDepth++;
         return parentHeightDepth > MapTile._maxParentHeightDepth;
     }
+    /** @internal */
     getDrapeTextures() {
         if (undefined === this._imageryTiles)
             return undefined;
@@ -514,28 +569,31 @@ class MapTile extends internal_1.RealityTile {
         const imageryModelId = imageryTile.tree.modelId;
         return new RenderSystem_1.TerrainTexture(imageryTile.texture, featureIndex, scale, translate, drapeRectangle, this.mapTree.getLayerIndex(imageryModelId), this.mapTree.getLayerTransparency(imageryModelId), clipRect);
     }
+    /** @internal */
     setContent(content) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e;
         this._mesh = (_a = content.terrain) === null || _a === void 0 ? void 0 : _a.mesh;
         if (this.mapTree.produceGeometry) {
             const iModelTransform = this.mapTree.iModelTransform;
             const geometryTransform = (_c = (_b = content.terrain) === null || _b === void 0 ? void 0 : _b.renderGeometry) === null || _c === void 0 ? void 0 : _c.transform;
             const transform = geometryTransform ? iModelTransform.multiplyTransformTransform(geometryTransform) : iModelTransform;
-            const polyface = (_e = (_d = content.terrain) === null || _d === void 0 ? void 0 : _d.mesh) === null || _e === void 0 ? void 0 : _e.createPolyface(transform);
+            const polyface = ((_d = content.terrain) === null || _d === void 0 ? void 0 : _d.mesh) ? RealityMeshParams_1.RealityMeshParams.toPolyface(content.terrain.mesh, { transform }) : undefined;
             this._geometry = polyface ? { polyfaces: [polyface] } : undefined;
         }
         else {
             (0, core_bentley_1.dispose)(this._renderGeometry);
-            this._renderGeometry = (_f = content.terrain) === null || _f === void 0 ? void 0 : _f.renderGeometry;
+            this._renderGeometry = (_e = content.terrain) === null || _e === void 0 ? void 0 : _e.renderGeometry;
         }
         this.everLoaded = true;
         if (undefined !== content.contentRange)
             this._contentRange = content.contentRange;
         this.setIsReady();
     }
+    /** @internal */
     freeMemory() {
         // ###TODO MapTiles and ImageryMapTiles share resources and don't currently interact well with TileAdmin.freeMemory(). Opt out for now.
     }
+    /** @internal */
     disposeContents() {
         super.disposeContents();
         this._renderGeometry = (0, core_bentley_1.dispose)(this._renderGeometry);
@@ -545,8 +603,8 @@ class MapTile extends internal_1.RealityTile {
 }
 exports.MapTile = MapTile;
 MapTile._maxParentHeightDepth = 4;
-MapTile._scratchRectangle1 = new internal_1.MapCartoRectangle();
-MapTile._scratchRectangle2 = new internal_1.MapCartoRectangle();
+MapTile._scratchRectangle1 = internal_1.MapCartoRectangle.createZero();
+MapTile._scratchRectangle2 = internal_1.MapCartoRectangle.createZero();
 MapTile._scratchThisDiagonal = core_geometry_1.Vector2d.create();
 MapTile._scratchDrapeDiagonal = core_geometry_1.Vector2d.create();
 MapTile._scratchIntersectRange = core_geometry_1.Range2d.createNull();
@@ -572,7 +630,7 @@ class UpsampledMapTile extends MapTile {
         const thisRow = thisId.row - (parentId.row << levelDelta);
         const scale = 1.0 / (1 << levelDelta);
         const parentParameterRange = core_geometry_1.Range2d.createXYXY(scale * thisColumn, scale * thisRow, scale * (thisColumn + 1), scale * (thisRow + 1));
-        const upsample = parentMesh.upsample(parentParameterRange);
+        const upsample = (0, UpsampleRealityMeshParams_1.upsampleRealityMeshParams)(parentMesh, parentParameterRange);
         this.adjustHeights(upsample.heightRange.low, upsample.heightRange.high);
         return upsample;
     }
@@ -581,7 +639,7 @@ class UpsampledMapTile extends MapTile {
             const upsample = this.upsampleFromParent();
             const projection = this.loadableTerrainTile.getProjection(this.heightRange);
             if (upsample)
-                this._renderGeometry = IModelApp_1.IModelApp.renderSystem.createRealityMeshFromTerrain(upsample.mesh, projection.transformFromLocal, true);
+                this._renderGeometry = IModelApp_1.IModelApp.renderSystem.createTerrainMesh(upsample.mesh, projection.transformFromLocal, true);
         }
         return this._renderGeometry;
     }