@itwin/core-frontend 5.0.0-dev.57 → 5.0.0-dev.59

package/lib/esm/internal/tile/ThreeDTileFormatInterpreter.js

@@ -0,0 +1,172 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { JsonUtils, Logger, RealityDataStatus } from "@itwin/core-bentley";
+import { Cartographic, EcefLocation } from "@itwin/core-common";
+import { Matrix3d, Point3d, Range3d, Transform, Vector3d } from "@itwin/core-geometry";
+import { FrontendLoggerCategory } from "../../common/FrontendLoggerCategory";
+import { RealityDataError } from "../../RealityDataSource";
+const loggerCategory = FrontendLoggerCategory.RealityData;
+/**
+ * This class provide methods used to interpret Cesium 3dTile format
+ */
+export class ThreeDTileFormatInterpreter {
+    /** Gets reality data spatial location and extents
+     * @param json root document file in json format
+     * @returns spatial location and volume of interest, in meters, centered around `spatial location`
+     * @throws [[RealityDataError]] if source is invalid or cannot be read
+     */
+    static getSpatialLocationAndExtents(json) {
+        const worldRange = new Range3d();
+        let isGeolocated = true;
+        let location;
+        Logger.logTrace(loggerCategory, "RealityData getSpatialLocationAndExtents");
+        if (undefined === json?.root) {
+            Logger.logWarning(loggerCategory, `Error getSpatialLocationAndExtents - no root in json`);
+            // return first 1024 char from the json
+            const getMetaData = () => {
+                return { json: JSON.stringify(json).substring(0, 1024) };
+            };
+            const error = new RealityDataError(RealityDataStatus.InvalidData, "Invalid or unknown data - no root in json", getMetaData);
+            throw error;
+        }
+        try {
+            if (undefined !== json?.root?.boundingVolume?.region) {
+                const region = JsonUtils.asArray(json.root.boundingVolume.region);
+                Logger.logTrace(loggerCategory, "RealityData json.root.boundingVolume.region", () => ({ ...region }));
+                if (undefined === region) {
+                    Logger.logError(loggerCategory, `Error getSpatialLocationAndExtents - region undefined`);
+                    throw new TypeError("Unable to determine GeoLocation - no root Transform or Region on root.");
+                }
+                const ecefLow = (Cartographic.fromRadians({ longitude: region[0], latitude: region[1], height: region[4] })).toEcef();
+                const ecefHigh = (Cartographic.fromRadians({ longitude: region[2], latitude: region[3], height: region[5] })).toEcef();
+                const ecefRange = Range3d.create(ecefLow, ecefHigh);
+                const cartoCenter = Cartographic.fromRadians({ longitude: (region[0] + region[2]) / 2.0, latitude: (region[1] + region[3]) / 2.0, height: (region[4] + region[5]) / 2.0 });
+                location = cartoCenter;
+                const ecefLocation = EcefLocation.createFromCartographicOrigin(cartoCenter);
+                // iModelDb.setEcefLocation(ecefLocation);
+                const ecefToWorld = ecefLocation.getTransform().inverse();
+                worldRange.extendRange(Range3d.fromJSON(ecefToWorld.multiplyRange(ecefRange)));
+            }
+            else {
+                let worldToEcefTransform = ThreeDTileFormatInterpreter.transformFromJson(json.root.transform);
+                Logger.logTrace(loggerCategory, "RealityData json.root.transform", () => ({ ...worldToEcefTransform }));
+                const range = ThreeDTileFormatInterpreter.rangeFromBoundingVolume(json.root.boundingVolume);
+                if (undefined === worldToEcefTransform)
+                    worldToEcefTransform = Transform.createIdentity();
+                const ecefRange = worldToEcefTransform.multiplyRange(range); // range in model -> range in ecef
+                const ecefCenter = worldToEcefTransform.multiplyPoint3d(range.center); // range center in model -> range center in ecef
+                const cartoCenter = Cartographic.fromEcef(ecefCenter); // ecef center to cartographic center
+                const isNotNearEarthSurface = cartoCenter && (cartoCenter.height < -5000); // 5 km under ground!
+                const earthCenterToRangeCenterRayLenght = range.center.magnitude();
+                if (worldToEcefTransform.matrix.isIdentity && (earthCenterToRangeCenterRayLenght < 1.0E5 || isNotNearEarthSurface)) {
+                    isGeolocated = false;
+                    worldRange.extendRange(Range3d.fromJSON(ecefRange));
+                    const centerOfEarth = new EcefLocation({ origin: { x: 0.0, y: 0.0, z: 0.0 }, orientation: { yaw: 0.0, pitch: 0.0, roll: 0.0 } });
+                    location = centerOfEarth;
+                    Logger.logTrace(loggerCategory, "RealityData NOT Geolocated", () => ({ ...location }));
+                }
+                else {
+                    let ecefLocation = EcefLocation.createFromTransform(worldToEcefTransform);
+                    // Fix Bug 445630: [RDV][Regression] Orientation of georeferenced Reality Mesh is wrong.
+                    // Use json.root.transform only if defined and not identity -> otherwise will use a transform computed from cartographic center.
+                    if (worldToEcefTransform.matrix.isIdentity) {
+                        // For georeferenced Reality Meshes, its origin is translated to model origin (0,0,0).
+                        // Apply range center to translate it back to its original position.
+                        const worldCenter = !worldToEcefTransform.matrix.isIdentity ? range.center : undefined;
+                        if (cartoCenter)
+                            ecefLocation = EcefLocation.createFromCartographicOrigin(cartoCenter, worldCenter);
+                    }
+                    location = ecefLocation;
+                    Logger.logTrace(loggerCategory, "RealityData is worldToEcefTransform.matrix.isIdentity", () => ({ isIdentity: worldToEcefTransform.matrix.isIdentity }));
+                    // iModelDb.setEcefLocation(ecefLocation);
+                    const ecefToWorld = ecefLocation.getTransform().inverse();
+                    worldRange.extendRange(Range3d.fromJSON(ecefToWorld.multiplyRange(ecefRange)));
+                    Logger.logTrace(loggerCategory, "RealityData ecefToWorld", () => ({ ...ecefToWorld }));
+                }
+            }
+        }
+        catch {
+            Logger.logWarning(loggerCategory, `Error getSpatialLocationAndExtents - cannot interpret json`);
+            // return first 1024 char from the json
+            const getMetaData = () => {
+                return { json: JSON.stringify(json).substring(0, 1024) };
+            };
+            const error = new RealityDataError(RealityDataStatus.InvalidData, "Invalid or unknown data", getMetaData);
+            throw error;
+        }
+        const spatialLocation = { location, worldRange, isGeolocated };
+        return spatialLocation;
+    }
+    /** Gets information to identify the product and engine that create this reality data
+     * Will return undefined if cannot be resolved
+     * @param rootDocjson root document file in json format
+     * @returns information to identify the product and engine that create this reality data
+     */
+    static getPublisherProductInfo(rootDocjson) {
+        const info = { product: "", engine: "", version: "" };
+        if (rootDocjson && rootDocjson.root) {
+            if (rootDocjson.root.SMPublisherInfo) {
+                info.product = rootDocjson.root.SMPublisherInfo.Product ? rootDocjson.root.SMPublisherInfo.Product : "";
+                info.engine = rootDocjson.root.SMPublisherInfo.Publisher ? rootDocjson.root.SMPublisherInfo.Publisher : "";
+                info.version = rootDocjson.root.SMPublisherInfo["Publisher Version"] ? rootDocjson.root.SMPublisherInfo["Publisher Version"] : "";
+            }
+        }
+        return info;
+    }
+    /** Gets information about 3dTile file for this reality data
+     * Will return undefined if cannot be resolved
+     * @param rootDocjson root document file in json format
+     * @returns information about 3dTile file for this reality data
+     */
+    static getFileInfo(rootDocjson) {
+        const info = {
+            rootChildren: rootDocjson?.root?.children?.length ?? 0,
+        };
+        return info;
+    }
+    /** Convert a boundingVolume into a range
+     * @param boundingVolume the bounding volume to convert
+     * @returns the range or undefined if cannot convert
+     */
+    static rangeFromBoundingVolume(boundingVolume) {
+        if (undefined === boundingVolume)
+            return undefined;
+        if (Array.isArray(boundingVolume.box)) {
+            const box = boundingVolume.box;
+            const center = Point3d.create(box[0], box[1], box[2]);
+            const ux = Vector3d.create(box[3], box[4], box[5]);
+            const uy = Vector3d.create(box[6], box[7], box[8]);
+            const uz = Vector3d.create(box[9], box[10], box[11]);
+            const corners = [];
+            for (let j = 0; j < 2; j++) {
+                for (let k = 0; k < 2; k++) {
+                    for (let l = 0; l < 2; l++) {
+                        corners.push(center.plus3Scaled(ux, (j ? -1.0 : 1.0), uy, (k ? -1.0 : 1.0), uz, (l ? -1.0 : 1.0)));
+                    }
+                }
+            }
+            return Range3d.createArray(corners);
+        }
+        else if (Array.isArray(boundingVolume.sphere)) {
+            const sphere = boundingVolume.sphere;
+            const center = Point3d.create(sphere[0], sphere[1], sphere[2]);
+            const radius = sphere[3];
+            return Range3d.createXYZXYZ(center.x - radius, center.y - radius, center.z - radius, center.x + radius, center.y + radius, center.z + radius);
+        }
+        return undefined;
+    }
+    /** Convert a boundingVolume into a range
+     */
+    static maximumSizeFromGeometricTolerance(range, geometricError) {
+        const minToleranceRatio = .5; // Nominally the error on screen size of a tile.  Increasing generally increases performance (fewer draw calls) at expense of higher load times.
+        return minToleranceRatio * range.diagonal().magnitude() / geometricError;
+    }
+    /** Convert a boundingVolume into a range
+     */
+    static transformFromJson(jTrans) {
+        return (jTrans === undefined) ? undefined : Transform.createOriginAndMatrix(Point3d.create(jTrans[12], jTrans[13], jTrans[14]), Matrix3d.createRowValues(jTrans[0], jTrans[4], jTrans[8], jTrans[1], jTrans[5], jTrans[9], jTrans[2], jTrans[6], jTrans[10]));
+    }
+}
+//# sourceMappingURL=ThreeDTileFormatInterpreter.js.map

package/lib/esm/internal/tile/ThreeDTileFormatInterpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreeDTileFormatInterpreter.js","sourceRoot":"","sources":["../../../../src/internal/tile/ThreeDTileFormatInterpreter.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\nimport { JsonUtils, Logger, LoggingMetaData, RealityDataStatus } from \"@itwin/core-bentley\";\nimport { Cartographic, EcefLocation } from \"@itwin/core-common\";\nimport { Matrix3d, Point3d, Range3d, Transform, Vector3d } from \"@itwin/core-geometry\";\nimport { FrontendLoggerCategory } from \"../../common/FrontendLoggerCategory\";\nimport { PublisherProductInfo, RealityDataError, SpatialLocationAndExtents } from \"../../RealityDataSource\";\n\nconst loggerCategory: string = FrontendLoggerCategory.RealityData;\n/** This interface provides information about 3dTile files for this reality data\n * Currently only used for debbugging\n */\nexport interface ThreeDTileFileInfo {\n  /** the number of children at the root of this reality data */\n  rootChildren?: number;\n}\n/**\n * This class provide methods used to interpret Cesium 3dTile format\n */\nexport class ThreeDTileFormatInterpreter  {\n  /** Gets reality data spatial location and extents\n   * @param json root document file in json format\n   * @returns spatial location and volume of interest, in meters, centered around `spatial location`\n   * @throws [[RealityDataError]] if source is invalid or cannot be read\n   */\n  public static getSpatialLocationAndExtents(json: any): SpatialLocationAndExtents {\n    const worldRange = new Range3d();\n    let isGeolocated = true;\n    let location: Cartographic | EcefLocation;\n    Logger.logTrace(loggerCategory, \"RealityData getSpatialLocationAndExtents\");\n    if (undefined === json?.root) {\n      Logger.logWarning(loggerCategory, `Error getSpatialLocationAndExtents - no root in json`);\n      // return first 1024 char from the json\n      const getMetaData: LoggingMetaData = () => {\n        return {json: JSON.stringify(json).substring(0,1024)};\n      };\n      const error = new RealityDataError(RealityDataStatus.InvalidData, \"Invalid or unknown data - no root in json\", getMetaData);\n      throw error;\n    }\n    try {\n      if (undefined !== json?.root?.boundingVolume?.region) {\n        const region = JsonUtils.asArray(json.root.boundingVolume.region);\n\n        Logger.logTrace(loggerCategory, \"RealityData json.root.boundingVolume.region\", () => ({ ...region }));\n        if (undefined === region) {\n          Logger.logError(loggerCategory, `Error getSpatialLocationAndExtents - region undefined`);\n          throw new TypeError(\"Unable to determine GeoLocation - no root Transform or Region on root.\");\n        }\n        const ecefLow = (Cartographic.fromRadians({ longitude: region[0], latitude: region[1], height: region[4] })).toEcef();\n        const ecefHigh = (Cartographic.fromRadians({ longitude: region[2], latitude: region[3], height: region[5] })).toEcef();\n        const ecefRange = Range3d.create(ecefLow, ecefHigh);\n        const cartoCenter = Cartographic.fromRadians({ longitude: (region[0] + region[2]) / 2.0, latitude: (region[1] + region[3]) / 2.0, height: (region[4] + region[5]) / 2.0 });\n        location = cartoCenter;\n        const ecefLocation = EcefLocation.createFromCartographicOrigin(cartoCenter);\n        // iModelDb.setEcefLocation(ecefLocation);\n        const ecefToWorld = ecefLocation.getTransform().inverse()!;\n        worldRange.extendRange(Range3d.fromJSON(ecefToWorld.multiplyRange(ecefRange)));\n      } else {\n        let worldToEcefTransform = ThreeDTileFormatInterpreter.transformFromJson(json.root.transform);\n\n        Logger.logTrace(loggerCategory, \"RealityData json.root.transform\", () => ({ ...worldToEcefTransform }));\n        const range = ThreeDTileFormatInterpreter.rangeFromBoundingVolume(json.root.boundingVolume)!;\n        if (undefined === worldToEcefTransform)\n          worldToEcefTransform = Transform.createIdentity();\n\n        const ecefRange = worldToEcefTransform.multiplyRange(range); // range in model -> range in ecef\n        const ecefCenter = worldToEcefTransform.multiplyPoint3d(range.center); // range center in model -> range center in ecef\n        const cartoCenter = Cartographic.fromEcef(ecefCenter); // ecef center to cartographic center\n        const isNotNearEarthSurface = cartoCenter && (cartoCenter.height < -5000); // 5 km under ground!\n        const earthCenterToRangeCenterRayLenght = range.center.magnitude();\n\n        if (worldToEcefTransform.matrix.isIdentity && (earthCenterToRangeCenterRayLenght < 1.0E5 || isNotNearEarthSurface)) {\n          isGeolocated = false;\n          worldRange.extendRange(Range3d.fromJSON(ecefRange));\n          const centerOfEarth =  new EcefLocation({ origin: { x: 0.0, y: 0.0, z: 0.0 }, orientation: { yaw: 0.0, pitch: 0.0, roll: 0.0 } });\n          location = centerOfEarth;\n          Logger.logTrace(loggerCategory, \"RealityData NOT Geolocated\", () => ({ ...location }));\n        } else {\n          let ecefLocation = EcefLocation.createFromTransform(worldToEcefTransform);\n          // Fix Bug 445630: [RDV][Regression] Orientation of georeferenced Reality Mesh is wrong.\n          // Use json.root.transform only if defined and not identity -> otherwise will use a transform computed from cartographic center.\n          if (worldToEcefTransform.matrix.isIdentity) {\n            // For georeferenced Reality Meshes, its origin is translated to model origin (0,0,0).\n            // Apply range center to translate it back to its original position.\n            const worldCenter = !worldToEcefTransform.matrix.isIdentity ? range.center : undefined;\n            if (cartoCenter)\n              ecefLocation = EcefLocation.createFromCartographicOrigin(cartoCenter, worldCenter);\n          }\n\n          location = ecefLocation;\n          Logger.logTrace(loggerCategory, \"RealityData is worldToEcefTransform.matrix.isIdentity\", () => ({ isIdentity: worldToEcefTransform.matrix.isIdentity }));\n          // iModelDb.setEcefLocation(ecefLocation);\n          const ecefToWorld = ecefLocation.getTransform().inverse()!;\n          worldRange.extendRange(Range3d.fromJSON(ecefToWorld.multiplyRange(ecefRange)));\n          Logger.logTrace(loggerCategory, \"RealityData ecefToWorld\", () => ({ ...ecefToWorld }));\n        }\n      }\n    } catch {\n      Logger.logWarning(loggerCategory, `Error getSpatialLocationAndExtents - cannot interpret json`);\n      // return first 1024 char from the json\n      const getMetaData: LoggingMetaData = () => {\n        return {json: JSON.stringify(json).substring(0,1024)};\n      };\n      const error = new RealityDataError(RealityDataStatus.InvalidData, \"Invalid or unknown data\", getMetaData);\n      throw error;\n    }\n\n    const spatialLocation: SpatialLocationAndExtents = { location, worldRange, isGeolocated };\n    return spatialLocation;\n  }\n  /** Gets information to identify the product and engine that create this reality data\n   * Will return undefined if cannot be resolved\n   * @param rootDocjson root document file in json format\n   * @returns information to identify the product and engine that create this reality data\n   */\n  public static getPublisherProductInfo(rootDocjson: any): PublisherProductInfo {\n    const info: PublisherProductInfo = {product: \"\", engine: \"\", version: \"\"};\n    if (rootDocjson && rootDocjson.root) {\n      if (rootDocjson.root.SMPublisherInfo) {\n        info.product = rootDocjson.root.SMPublisherInfo.Product ? rootDocjson.root.SMPublisherInfo.Product : \"\";\n        info.engine =  rootDocjson.root.SMPublisherInfo.Publisher ? rootDocjson.root.SMPublisherInfo.Publisher : \"\";\n        info.version = rootDocjson.root.SMPublisherInfo[\"Publisher Version\"] ? rootDocjson.root.SMPublisherInfo[\"Publisher Version\"] : \"\" ;\n      }\n    }\n    return info;\n  }\n  /** Gets information about 3dTile file for this reality data\n   * Will return undefined if cannot be resolved\n   * @param rootDocjson root document file in json format\n   * @returns information about 3dTile file for this reality data\n   */\n  public static getFileInfo(rootDocjson: any): ThreeDTileFileInfo {\n    const info: ThreeDTileFileInfo = {\n      rootChildren: rootDocjson?.root?.children?.length ?? 0,\n    };\n    return info;\n  }\n  /** Convert a boundingVolume into a range\n   * @param boundingVolume the bounding volume to convert\n   * @returns the range or undefined if cannot convert\n   */\n  public static rangeFromBoundingVolume(boundingVolume: any): Range3d | undefined {\n    if (undefined === boundingVolume)\n      return undefined;\n    if (Array.isArray(boundingVolume.box)) {\n      const box: number[] = boundingVolume.box;\n      const center = Point3d.create(box[0], box[1], box[2]);\n      const ux = Vector3d.create(box[3], box[4], box[5]);\n      const uy = Vector3d.create(box[6], box[7], box[8]);\n      const uz = Vector3d.create(box[9], box[10], box[11]);\n      const corners: Point3d[] = [];\n      for (let j = 0; j < 2; j++) {\n        for (let k = 0; k < 2; k++) {\n          for (let l = 0; l < 2; l++) {\n            corners.push(center.plus3Scaled(ux, (j ? -1.0 : 1.0), uy, (k ? -1.0 : 1.0), uz, (l ? -1.0 : 1.0)));\n          }\n        }\n      }\n      return Range3d.createArray(corners);\n    } else if (Array.isArray(boundingVolume.sphere)) {\n      const sphere: number[] = boundingVolume.sphere;\n      const center = Point3d.create(sphere[0], sphere[1], sphere[2]);\n      const radius = sphere[3];\n      return Range3d.createXYZXYZ(center.x - radius, center.y - radius, center.z - radius, center.x + radius, center.y + radius, center.z + radius);\n    }\n    return undefined;\n  }\n  /** Convert a boundingVolume into a range\n   */\n  public static maximumSizeFromGeometricTolerance(range: Range3d, geometricError: number): number {\n    const minToleranceRatio = .5;   // Nominally the error on screen size of a tile.  Increasing generally increases performance (fewer draw calls) at expense of higher load times.\n    return minToleranceRatio * range.diagonal().magnitude() / geometricError;\n  }\n  /** Convert a boundingVolume into a range\n   */\n  public static transformFromJson(jTrans: number[] | undefined): Transform | undefined {\n    return (jTrans === undefined) ? undefined : Transform.createOriginAndMatrix(Point3d.create(jTrans[12], jTrans[13], jTrans[14]), Matrix3d.createRowValues(jTrans[0], jTrans[4], jTrans[8], jTrans[1], jTrans[5], jTrans[9], jTrans[2], jTrans[6], jTrans[10]));\n  }\n}\n"]}

package/lib/esm/internal/tile/TileUserSet.d.ts

@@ -0,0 +1,26 @@
+/** @packageDocumentation
+ * @module Utils
+ */
+import { ReadonlySortedArray } from "@itwin/core-bentley";
+import { TileUser } from "../../tile/internal";
+/** An immutable set of [[TileUser]]s wherein uniqueness is determined by each TileUser's unique integer identifier.
+ * @see [[UniqueTileUserSets]].
+ */
+export declare class ReadonlyTileUserSet extends ReadonlySortedArray<TileUser> {
+    constructor(user?: TileUser);
+}
+/** Maintains a set of [[TileUserSets]] designed to minimize duplication.
+ * For example, the tile request scheduler needs to associate with each [[TileRequest]] the set of [[TileUser]]s awaiting the request's response.
+ * Using UniqueTileUserSets ensures all tiles requested by the same user use the same TileUserSet object.
+ * Additionally, whenever a user is unregistered there is no need to track down every associated tile request - the user can just be removed from the TileUserSets managed by this object.
+ * The TileUserSets managed by this object should be treated as immutable - "adding" a user to an existing set should be done using [[getTileUserSet]].
+ */
+export declare class UniqueTileUserSets {
+    private readonly _sets;
+    getTileUserSet(user: TileUser, users?: ReadonlyTileUserSet): ReadonlyTileUserSet;
+    clearAll(): void;
+    clear(): void;
+    remove(user: TileUser): void;
+    static get emptySet(): ReadonlyTileUserSet;
+}
+//# sourceMappingURL=TileUserSet.d.ts.map

package/lib/esm/internal/tile/TileUserSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TileUserSet.d.ts","sourceRoot":"","sources":["../../../../src/internal/tile/TileUserSet.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAe,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,mBAAmB,CAAC,QAAQ,CAAC;gBACjD,IAAI,CAAC,EAAE,QAAQ;CAKnC;AAwFD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAEvC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,mBAAmB,GAAG,mBAAmB;IAIhF,QAAQ,IAAI,IAAI;IAIhB,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAInC,WAAkB,QAAQ,IAAI,mBAAmB,CAEhD;CACF"}

package/lib/esm/internal/tile/TileUserSet.js

@@ -0,0 +1,114 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utils
+ */
+import { ReadonlySortedArray, SortedArray } from "@itwin/core-bentley";
+/** An immutable set of [[TileUser]]s wherein uniqueness is determined by each TileUser's unique integer identifier.
+ * @see [[UniqueTileUserSets]].
+ */
+export class ReadonlyTileUserSet extends ReadonlySortedArray {
+    constructor(user) {
+        super((lhs, rhs) => lhs.tileUserId - rhs.tileUserId);
+        if (undefined !== user)
+            this._array.push(user);
+    }
+}
+class TileUserSet extends ReadonlyTileUserSet {
+    copyFrom(src) {
+        this._array.length = src.length;
+        let i = 0;
+        for (const user of src)
+            this._array[i++] = user;
+    }
+    clone() {
+        const clone = new TileUserSet();
+        clone.copyFrom(this);
+        return clone;
+    }
+    insert(user) { return this._insert(user); }
+    remove(user) { return this._remove(user); }
+    clear() { this._clear(); }
+}
+function compareTileUserSets(lhs, rhs) {
+    if (lhs === rhs)
+        return 0;
+    let diff = lhs.length - rhs.length;
+    if (0 === diff) {
+        for (let i = 0; i < lhs.length; i++) {
+            diff = lhs.get(i).tileUserId - rhs.get(i).tileUserId;
+            if (0 !== diff)
+                break;
+        }
+    }
+    return diff;
+}
+const emptySet = new ReadonlyTileUserSet();
+const scratchSet = new TileUserSet();
+class TileUserSetSet extends SortedArray {
+    constructor() {
+        super((lhs, rhs) => compareTileUserSets(lhs, rhs));
+    }
+    getForUser(user) {
+        for (let i = 0; i < this.length; i++) {
+            const set = this._array[i];
+            if (1 === set.length && set.get(0) === user)
+                return set;
+        }
+        const newSet = new TileUserSet(user);
+        this.insert(newSet);
+        return newSet;
+    }
+    getTileUserSet(user, users) {
+        if (undefined === users || users.isEmpty)
+            return this.getForUser(user);
+        // Use the scratch set for equality comparison - only allocate if no equivalent set already exists.
+        const toFind = scratchSet;
+        toFind.copyFrom(users);
+        toFind.insert(user);
+        const found = this.findEqual(toFind);
+        if (undefined !== found) {
+            toFind.clear();
+            return found;
+        }
+        const newSet = toFind.clone();
+        toFind.clear();
+        this.insert(newSet);
+        return newSet;
+    }
+    clearAll() {
+        this.forEach((set) => set.clear());
+        this.clear();
+    }
+    forgetUser(user) {
+        for (const set of this)
+            set.remove(user);
+    }
+}
+/** Maintains a set of [[TileUserSets]] designed to minimize duplication.
+ * For example, the tile request scheduler needs to associate with each [[TileRequest]] the set of [[TileUser]]s awaiting the request's response.
+ * Using UniqueTileUserSets ensures all tiles requested by the same user use the same TileUserSet object.
+ * Additionally, whenever a user is unregistered there is no need to track down every associated tile request - the user can just be removed from the TileUserSets managed by this object.
+ * The TileUserSets managed by this object should be treated as immutable - "adding" a user to an existing set should be done using [[getTileUserSet]].
+ */
+export class UniqueTileUserSets {
+    _sets = new TileUserSetSet();
+    getTileUserSet(user, users) {
+        return this._sets.getTileUserSet(user, users);
+    }
+    clearAll() {
+        this._sets.clearAll();
+    }
+    clear() {
+        this._sets.clear();
+    }
+    remove(user) {
+        this._sets.forgetUser(user);
+    }
+    static get emptySet() {
+        return emptySet;
+    }
+}
+//# sourceMappingURL=TileUserSet.js.map

package/lib/esm/internal/tile/TileUserSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TileUserSet.js","sourceRoot":"","sources":["../../../../src/internal/tile/TileUserSet.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Utils\n */\n\nimport { ReadonlySortedArray, SortedArray } from \"@itwin/core-bentley\";\nimport { TileUser } from \"../../tile/internal\";\n\n/** An immutable set of [[TileUser]]s wherein uniqueness is determined by each TileUser's unique integer identifier.\n * @see [[UniqueTileUserSets]].\n */\nexport class ReadonlyTileUserSet extends ReadonlySortedArray<TileUser> {\n  public constructor(user?: TileUser) {\n    super((lhs, rhs) => lhs.tileUserId - rhs.tileUserId);\n    if (undefined !== user)\n      this._array.push(user);\n  }\n}\n\nclass TileUserSet extends ReadonlyTileUserSet {\n  public copyFrom(src: ReadonlyTileUserSet): void {\n    this._array.length = src.length;\n    let i = 0;\n    for (const user of src)\n      this._array[i++] = user;\n  }\n\n  public clone(): TileUserSet {\n    const clone = new TileUserSet();\n    clone.copyFrom(this);\n    return clone;\n  }\n\n  public insert(user: TileUser): number { return this._insert(user); }\n  public remove(user: TileUser): number { return this._remove(user); }\n  public clear(): void { this._clear(); }\n}\n\nfunction compareTileUserSets(lhs: TileUserSet, rhs: TileUserSet): number {\n  if (lhs === rhs)\n    return 0;\n\n  let diff = lhs.length - rhs.length;\n  if (0 === diff) {\n    for (let i = 0; i < lhs.length; i++) {\n      diff = lhs.get(i)!.tileUserId - rhs.get(i)!.tileUserId;\n      if (0 !== diff)\n        break;\n    }\n  }\n\n  return diff;\n}\n\nconst emptySet = new ReadonlyTileUserSet();\nconst scratchSet = new TileUserSet();\n\nclass TileUserSetSet extends SortedArray<TileUserSet> {\n  public constructor() {\n    super((lhs, rhs) => compareTileUserSets(lhs, rhs));\n  }\n\n  private getForUser(user: TileUser): TileUserSet {\n    for (let i = 0; i < this.length; i++) {\n      const set = this._array[i];\n      if (1 === set.length && set.get(0)! === user)\n        return set;\n    }\n\n    const newSet = new TileUserSet(user);\n    this.insert(newSet);\n    return newSet;\n  }\n\n  public getTileUserSet(user: TileUser, users?: ReadonlyTileUserSet): TileUserSet {\n    if (undefined === users || users.isEmpty)\n      return this.getForUser(user);\n\n    // Use the scratch set for equality comparison - only allocate if no equivalent set already exists.\n    const toFind = scratchSet;\n    toFind.copyFrom(users);\n    toFind.insert(user);\n    const found = this.findEqual(toFind);\n    if (undefined !== found) {\n      toFind.clear();\n      return found;\n    }\n\n    const newSet = toFind.clone();\n    toFind.clear();\n    this.insert(newSet);\n    return newSet;\n  }\n\n  public clearAll(): void {\n    this.forEach((set) => set.clear());\n    this.clear();\n  }\n\n  public forgetUser(user: TileUser): void {\n    for (const set of this)\n      set.remove(user);\n  }\n}\n\n/** Maintains a set of [[TileUserSets]] designed to minimize duplication.\n * For example, the tile request scheduler needs to associate with each [[TileRequest]] the set of [[TileUser]]s awaiting the request's response.\n * Using UniqueTileUserSets ensures all tiles requested by the same user use the same TileUserSet object.\n * Additionally, whenever a user is unregistered there is no need to track down every associated tile request - the user can just be removed from the TileUserSets managed by this object.\n * The TileUserSets managed by this object should be treated as immutable - \"adding\" a user to an existing set should be done using [[getTileUserSet]].\n */\nexport class UniqueTileUserSets {\n  private readonly _sets = new TileUserSetSet();\n\n  public getTileUserSet(user: TileUser, users?: ReadonlyTileUserSet): ReadonlyTileUserSet {\n    return this._sets.getTileUserSet(user, users);\n  }\n\n  public clearAll(): void {\n    this._sets.clearAll();\n  }\n\n  public clear(): void {\n    this._sets.clear();\n  }\n\n  public remove(user: TileUser): void {\n    this._sets.forgetUser(user);\n  }\n\n  public static get emptySet(): ReadonlyTileUserSet {\n    return emptySet;\n  }\n}\n"]}

package/lib/esm/internal/tile/ViewFlagOverrides.d.ts

@@ -0,0 +1,14 @@
+/** @packageDocumentation
+ * @module Tiles
+ */
+import { ViewFlagOverrides } from "@itwin/core-common";
+/** Create ViewFlagOverrides suitable for most non-iModel tile trees (reality/map tiles).
+ * @param options Customize the overrides. Any properties left unspecified use the current view settings, except white-on-white reversal is always disabled.
+ */
+export declare function createDefaultViewFlagOverrides(options: {
+    clipVolume?: boolean;
+    shadows?: boolean;
+    lighting?: boolean;
+    thematic?: false;
+}): ViewFlagOverrides;
+//# sourceMappingURL=ViewFlagOverrides.d.ts.map

package/lib/esm/internal/tile/ViewFlagOverrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewFlagOverrides.d.ts","sourceRoot":"","sources":["../../../../src/internal/tile/ViewFlagOverrides.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAc,iBAAiB,EAAa,MAAM,oBAAoB,CAAC;AAE9E;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG,iBAAiB,CA2B5J"}

package/lib/esm/internal/tile/ViewFlagOverrides.js

@@ -0,0 +1,35 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Tiles
+ */
+import { RenderMode, ViewFlags } from "@itwin/core-common";
+/** Create ViewFlagOverrides suitable for most non-iModel tile trees (reality/map tiles).
+ * @param options Customize the overrides. Any properties left unspecified use the current view settings, except white-on-white reversal is always disabled.
+ */
+export function createDefaultViewFlagOverrides(options) {
+    const noLights = undefined !== options.lighting ? !options.lighting : undefined;
+    const viewflags = ViewFlags.fromJSON({
+        renderMode: RenderMode.SmoothShade,
+        noCameraLights: noLights,
+        noSourceLights: noLights,
+        noSolarLight: noLights,
+        clipVol: options.clipVolume,
+        shadows: options.shadows,
+        noWhiteOnWhiteReversal: true,
+        thematicDisplay: false,
+    });
+    const ovrs = { ...viewflags };
+    if (undefined === options.clipVolume)
+        ovrs.clipVolume = undefined;
+    if (undefined === options.shadows)
+        ovrs.shadows = undefined;
+    if (undefined === options.lighting)
+        ovrs.lighting = undefined;
+    if (undefined === options.thematic)
+        ovrs.thematicDisplay = undefined;
+    return ovrs;
+}
+//# sourceMappingURL=ViewFlagOverrides.js.map

package/lib/esm/internal/tile/ViewFlagOverrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewFlagOverrides.js","sourceRoot":"","sources":["../../../../src/internal/tile/ViewFlagOverrides.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAqB,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE9E;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAA0F;IACvI,MAAM,QAAQ,GAAG,SAAS,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC;QACnC,UAAU,EAAE,UAAU,CAAC,WAAW;QAClC,cAAc,EAAE,QAAQ;QACxB,cAAc,EAAE,QAAQ;QACxB,YAAY,EAAE,QAAQ;QACtB,OAAO,EAAE,OAAO,CAAC,UAAU;QAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,sBAAsB,EAAE,IAAI;QAC5B,eAAe,EAAE,KAAK;KACvB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAsB,EAAE,GAAG,SAAS,EAAE,CAAC;IACjD,IAAI,SAAS,KAAK,OAAO,CAAC,UAAU;QAClC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAE9B,IAAI,SAAS,KAAK,OAAO,CAAC,OAAO;QAC/B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAE3B,IAAI,SAAS,KAAK,OAAO,CAAC,QAAQ;QAChC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAE5B,IAAI,SAAS,KAAK,OAAO,CAAC,QAAQ;QAChC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;IAEnC,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Tiles\n */\n\nimport { RenderMode, ViewFlagOverrides, ViewFlags } from \"@itwin/core-common\";\n\n/** Create ViewFlagOverrides suitable for most non-iModel tile trees (reality/map tiles).\n * @param options Customize the overrides. Any properties left unspecified use the current view settings, except white-on-white reversal is always disabled.\n */\nexport function createDefaultViewFlagOverrides(options: { clipVolume?: boolean, shadows?: boolean, lighting?: boolean, thematic?: false }): ViewFlagOverrides {\n  const noLights = undefined !== options.lighting ? !options.lighting : undefined;\n  const viewflags = ViewFlags.fromJSON({\n    renderMode: RenderMode.SmoothShade,\n    noCameraLights: noLights,\n    noSourceLights: noLights,\n    noSolarLight: noLights,\n    clipVol: options.clipVolume,\n    shadows: options.shadows,\n    noWhiteOnWhiteReversal: true,\n    thematicDisplay: false,\n  });\n\n  const ovrs: ViewFlagOverrides = { ...viewflags };\n  if (undefined === options.clipVolume)\n    ovrs.clipVolume = undefined;\n\n  if (undefined === options.shadows)\n    ovrs.shadows = undefined;\n\n  if (undefined === options.lighting)\n    ovrs.lighting = undefined;\n\n  if (undefined === options.thematic)\n    ovrs.thematicDisplay = undefined;\n\n  return ovrs;\n}\n"]}

package/lib/esm/internal/tile/map/ArcGISTileMap.d.ts

@@ -0,0 +1,29 @@
+/** @packageDocumentation
+ * @module Tiles
+ */
+import { QuadId } from "../../../tile/internal";
+import { ImageMapLayerSettings } from "@itwin/core-common";
+export type FetchFunction = (url: URL, options?: RequestInit) => Promise<Response>;
+export declare class ArcGISTileMap {
+    tileMapRequestSize: number;
+    private static maxLod;
+    get tileMapOffset(): number;
+    fallbackTileMapRequestSize: number;
+    private _callQueues;
+    private _tilesCache;
+    private _restBaseUrl;
+    private _fetchFunc;
+    private _settings;
+    constructor(restBaseUrl: string, settings: ImageMapLayerSettings, fetchFunc: FetchFunction);
+    protected fetchTileMapFromServer(level: number, row: number, column: number, width: number, height: number): Promise<any>;
+    protected getAvailableTilesFromCache(tiles: QuadId[]): {
+        allTilesFound: boolean;
+        available: boolean[];
+    };
+    getChildrenAvailability(childIds: QuadId[]): Promise<boolean[]>;
+    private isCacheMissingTile;
+    private collectTilesMissingFromCache;
+    fetchAndReadTilemap(queryTiles: QuadId[], reqWidth: number, reqHeight: number): Promise<boolean[]>;
+    protected getChildrenAvailabilityFromServer(childIds: QuadId[]): Promise<boolean[]>;
+}
+//# sourceMappingURL=ArcGISTileMap.d.ts.map

package/lib/esm/internal/tile/map/ArcGISTileMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArcGISTileMap.d.ts","sourceRoot":"","sources":["../../../../../src/internal/tile/map/ArcGISTileMap.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAInF,qBAAa,aAAa;IAGjB,kBAAkB,SAAK;IAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAM;IAK3B,IAAW,aAAa,WAA4C;IAE5D,0BAA0B,SAAK;IAEvC,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,WAAW,CAA2E;IAC9F,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,SAAS,CAAwB;gBAE7B,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,SAAS,EAAE,aAAa;cAO1E,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAM/H,SAAS,CAAC,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,EAAE,CAAA;KAAC;IAexF,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAiC5E,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,4BAA4B;IAcvB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;cAyH1E,iCAAiC,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAa1F"}