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

package/lib/cjs/tile/map/MapTile.d.ts

@@ -4,7 +4,7 @@
 import { ColorDef, RenderTexture } from "@itwin/core-common";
 import { ClipVector, EllipsoidPatch, Point3d, Range1d, Range3d, Ray3d, Transform, Vector3d } from "@itwin/core-geometry";
 import { GraphicBuilder } from "../../render/GraphicBuilder";
-import { TerrainMeshPrimitive } from "../../render/primitives/mesh/TerrainMeshPrimitive";
+import { RealityMeshParams } from "../../render/RealityMeshParams";
 import { RenderGraphic } from "../../render/RenderGraphic";
 import { RenderMemory } from "../../render/RenderMemory";
 import { RenderSystem, RenderTerrainGeometry, TerrainTexture } from "../../render/RenderSystem";
@@ -21,12 +21,22 @@ export declare class PlanarTilePatch {
 }
 /** @internal */
 export declare type TilePatch = PlanarTilePatch | EllipsoidPatch;
-/** @internal */
+/** Projects points within the rectangular region of a [[MapTile]] into 3d space.
+ * @see [[MapTile.getProjection]] to obtain the projection for a [[MapTile]].
+ * @beta
+ */
 export declare abstract class MapTileProjection {
+    /** The extents of the volume of space associated with the projected [[MapTile]]. */
     abstract get localRange(): Range3d;
+    /** @alpha */
     abstract get transformFromLocal(): Transform;
+    /** Given parametric coordinates in [0, 1] within the tile's rectangular region, and an elevation above the Earth,
+     * compute the 3d position in space.
+     */
     abstract getPoint(u: number, v: number, height: number, result?: Point3d): Point3d;
+    /** @alpha */
     get ellipsoidPatch(): EllipsoidPatch | undefined;
+    /** @alpha */
     getGlobalPoint(u: number, v: number, z: number, result?: Point3d): Point3d;
 }
 /** @internal */
@@ -34,60 +44,94 @@ export interface TerrainTileContent extends TileContent {
     terrain?: {
         renderGeometry?: RenderTerrainGeometry;
         /** Used on leaves to support up-sampling. */
-        mesh?: TerrainMeshPrimitive;
+        mesh?: RealityMeshParams;
     };
 }
-/**
- * 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 */
 export declare class MapTile extends RealityTile {
-    readonly mapTree: MapTileTree;
-    quadId: QuadId;
-    private _patch;
-    readonly rectangle: MapCartoRectangle;
-    protected _cornerRays: Ray3d[] | undefined;
     private static _maxParentHeightDepth;
     private _imageryTiles?;
+    /** @internal */
     everLoaded: boolean;
+    /** @internal */
     protected _heightRange: Range1d | undefined;
+    /** @internal */
     protected _renderGeometry?: RenderTerrainGeometry;
-    protected _mesh?: TerrainMeshPrimitive;
+    /** @internal */
+    protected _mesh?: RealityMeshParams;
+    /** @internal */
     get isReady(): boolean;
+    /** @internal */
     get hasGraphics(): boolean;
+    /** @internal */
     get renderGeometry(): RenderTerrainGeometry | undefined;
-    get mesh(): TerrainMeshPrimitive | undefined;
+    /** @internal */
+    get mesh(): RealityMeshParams | undefined;
+    /** @internal */
     get loadableTerrainTile(): MapTile;
+    /** @internal */
     get isPlanar(): boolean;
+    /** @internal */
     get imageryTiles(): ImageryMapTile[] | undefined;
+    /** The [[MapTileTree]] to which this tile belongs. */
+    readonly mapTree: MapTileTree;
+    /** Uniquely identifies this tile within its [[mapTree]]. */
+    readonly quadId: QuadId;
+    private _patch;
+    /** The area of the surface of the Earth that this tile represents. */
+    readonly rectangle: MapCartoRectangle;
+    /** @internal */
+    protected _cornerRays?: Ray3d[];
+    /** @internal */
+    constructor(params: RealityTileParams, mapTree: MapTileTree, quadId: QuadId, patch: TilePatch, rectangle: MapCartoRectangle, heightRange: Range1d | undefined, cornerRays: Ray3d[] | undefined);
+    /** @internal */
     getRangeCorners(result: Point3d[]): Point3d[];
-    constructor(params: RealityTileParams, mapTree: MapTileTree, quadId: QuadId, _patch: TilePatch, rectangle: MapCartoRectangle, heightRange: Range1d | undefined, _cornerRays: Ray3d[] | undefined);
+    /** @internal */
     getSizeProjectionCorners(): Point3d[] | undefined;
+    /** @internal */
     markUsed(args: TileDrawArgs): void;
+    /** @internal */
     get graphicType(): TileGraphicType;
+    /** @internal */
     get mapLoader(): MapTileLoader;
+    /** @internal */
     get isUpsampled(): boolean;
+    /** @internal */
     tileFromQuadId(quadId: QuadId): MapTile | undefined;
     private get _forceDepthBuffer();
+    /** @internal */
     addBoundingGraphic(builder: GraphicBuilder, color: ColorDef): void;
+    /** @internal */
     getContentClip(): ClipVector | undefined;
+    /** @internal */
     setNotFound(): void;
+    /** @internal */
     getGraphic(_system: RenderSystem, _texture: RenderTexture): RenderGraphic | undefined;
     /** For globe tiles displaying less then depth 2 appears distorted
      * @internal
      */
     get isDisplayable(): boolean;
+    /** @internal */
     isOccluded(viewingSpace: ViewingSpace): boolean;
+    /** @internal */
     protected _loadChildren(resolve: (children: Tile[] | undefined) => void, _reject: (error: Error) => void): void;
     private createGlobeChildren;
+    /** @internal */
     static computeRangeCorners(corners: Point3d[], normal: Vector3d, chordHeight: number, result?: Point3d[], heightRange?: Range1d): Point3d[];
+    /** @internal */
     isRegionCulled(args: TileDrawArgs): boolean;
+    /** @internal */
     isContentCulled(args: TileDrawArgs): boolean;
+    /** @internal */
     clearLayers(): void;
     private clearImageryTiles;
+    /** @internal */
     produceGraphics(): RenderGraphic | undefined;
+    /** @internal */
     getClipShape(): Point3d[];
+    /** @internal */
     protected _collectStatistics(stats: RenderMemory.Statistics): void;
     /** 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
@@ -95,10 +139,15 @@ export declare class MapTile extends RealityTile {
      * @internal
      */
     get heightRange(): Range1d | undefined;
+    /** @internal */
     get mapTilingScheme(): import("./MapTilingScheme").MapTilingScheme;
+    /** Adjust the minimum and maximum elevations of the terrain within this tile. */
     adjustHeights(minHeight: number, maxHeight: number): void;
+    /** Obtain a [[MapTileProjection]] to project positions within this tile's area into 3d space. */
     getProjection(heightRange?: Range1d): MapTileProjection;
+    /** @internal */
     get baseImageryIsReady(): boolean;
+    /** @internal */
     get imageryIsReady(): boolean;
     /** Select secondary (imagery) tiles
      * @internal
@@ -114,11 +163,15 @@ export declare class MapTile extends RealityTile {
     forceSelectRealityTile(): boolean;
     private static _scratchThisDiagonal;
     private static _scratchDrapeDiagonal;
+    /** @internal */
     getDrapeTextures(): TerrainTexture[] | undefined;
     private static _scratchIntersectRange;
     private computeDrapeTexture;
+    /** @internal */
     setContent(content: TerrainTileContent): void;
+    /** @internal */
     freeMemory(): void;
+    /** @internal */
     disposeContents(): void;
 }
 /** @internal */

package/lib/cjs/tile/map/MapTile.d.ts.map

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

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;
     }