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

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

@@ -0,0 +1,155 @@
+/*---------------------------------------------------------------------------------------------
+* 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 { JsonUtils, utf8ToString } from "@itwin/core-bentley";
+import { AxisOrder, Matrix3d, Point3d, Vector3d } from "@itwin/core-geometry";
+import { Feature, FeatureTable, I3dmHeader, TileReadStatus } from "@itwin/core-common";
+import { GltfReader, GltfReaderProps } from "../../tile/internal";
+function setTransform(transforms, index, rotation, origin) {
+    const i = index * 12;
+    let rot = rotation.coffs;
+    const ignoreRotation = false;
+    if (ignoreRotation)
+        rot = new Float64Array([1, 0, 0, 0, 1, 0, 0, 0, 1]);
+    const ignoreOrigin = false;
+    if (ignoreOrigin)
+        origin.x = origin.y = origin.z = 0;
+    transforms[i + 0] = rot[0];
+    transforms[i + 1] = rot[1];
+    transforms[i + 2] = rot[2];
+    transforms[i + 3] = origin.x;
+    transforms[i + 4] = rot[3];
+    transforms[i + 5] = rot[4];
+    transforms[i + 6] = rot[5];
+    transforms[i + 7] = origin.y;
+    transforms[i + 8] = rot[6];
+    transforms[i + 9] = rot[7];
+    transforms[i + 10] = rot[8];
+    transforms[i + 11] = origin.z;
+}
+/**
+ * Deserializes a tile in [i3dm](https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/specification/TileFormats/Instanced3DModel) format.
+ */
+export class I3dmReader extends GltfReader {
+    _featureBinary;
+    _featureJson;
+    _batchTableJson;
+    _range;
+    _isLeaf;
+    _instanceCount = 0;
+    _featureTable;
+    _modelId;
+    static create(stream, iModel, modelId, is3d, range, system, yAxisUp, isLeaf, isCanceled, idMap, deduplicateVertices = false) {
+        const header = new I3dmHeader(stream);
+        if (!header.isValid)
+            return undefined;
+        const props = GltfReaderProps.create(stream.nextBytes(header.length - stream.curPos), yAxisUp);
+        if (undefined === props)
+            return undefined;
+        stream.curPos = header.featureTableJsonPosition;
+        const featureStr = utf8ToString(stream.nextBytes(header.featureTableJsonLength));
+        if (undefined === featureStr)
+            return undefined;
+        const featureBinary = new Uint8Array(stream.arrayBuffer, header.featureTableJsonPosition + header.featureTableJsonLength, header.featureTableBinaryLength);
+        return new I3dmReader(featureBinary, JSON.parse(featureStr), header.batchTableJson, props, iModel, modelId, is3d, system, range, isLeaf, isCanceled, idMap, deduplicateVertices);
+    }
+    constructor(_featureBinary, _featureJson, _batchTableJson, props, iModel, modelId, is3d, system, _range, _isLeaf, shouldAbort, _idMap, deduplicateVertices = false) {
+        super({
+            props, iModel, system, shouldAbort, deduplicateVertices,
+            is2d: !is3d, idMap: _idMap,
+        });
+        this._featureBinary = _featureBinary;
+        this._featureJson = _featureJson;
+        this._batchTableJson = _batchTableJson;
+        this._range = _range;
+        this._isLeaf = _isLeaf;
+        this._modelId = modelId;
+    }
+    async read() {
+        this._instanceCount = JsonUtils.asInt(this._featureJson.INSTANCES_LENGTH, 0);
+        // NB: For reality models with no batch table, we want the model ID in the feature table
+        this._featureTable = new FeatureTable(undefined === this._batchTableJson ? this._instanceCount : 1, this._modelId, this._type);
+        if (this._idMap !== undefined && this._batchTableJson !== undefined) {
+            for (let i = 0; i < this._instanceCount; i++) {
+                const feature = {};
+                for (const key in this._batchTableJson) // eslint-disable-line guard-for-in
+                    feature[key] = this._batchTableJson[key][i];
+                this._featureTable.insert(new Feature(this._idMap.getBatchId(feature)));
+            }
+        }
+        else {
+            // NB: For reality models with no batch table, we want the model ID in the feature table
+            const feature = new Feature(this._modelId);
+            this._featureTable.insert(feature);
+        }
+        await this.resolveResources();
+        if (this._isCanceled)
+            return { readStatus: TileReadStatus.Canceled, isLeaf: this._isLeaf };
+        const instances = this.readInstances();
+        if (undefined === instances)
+            return { readStatus: TileReadStatus.InvalidTileData, isLeaf: this._isLeaf };
+        return this.readGltfAndCreateGraphics(this._isLeaf, this._featureTable, this._range, undefined, undefined, instances);
+    }
+    readFeatures(_features, _json) {
+        return false;
+    }
+    readInstances() {
+        const count = JsonUtils.asInt(this._featureJson.INSTANCES_LENGTH, 0);
+        if (count <= 0)
+            return undefined;
+        const json = this._featureJson;
+        const binary = this._featureBinary;
+        const batchIds = json.BATCH_ID ? new Int32Array(binary.buffer, binary.byteOffset + json.BATCH_ID.byteOffset, count) : undefined;
+        const positions = json.POSITION ? new Float32Array(binary.buffer, binary.byteOffset + json.POSITION.byteOffset, count * 3) : undefined;
+        const upNormals = json.NORMAL_UP ? new Float32Array(binary.buffer, binary.byteOffset + json.NORMAL_UP.byteOffset, count * 3) : undefined;
+        const rightNormals = json.NORMAL_RIGHT ? new Float32Array(binary.buffer, binary.byteOffset + json.NORMAL_RIGHT.byteOffset, count * 3) : undefined;
+        const scales = json.SCALE ? new Float32Array(binary.buffer, binary.byteOffset + json.SCALE.byteOffset, count) : undefined;
+        const nonUniformScales = json.SCALE_NON_UNIFORM ? new Float32Array(binary.buffer, binary.byteOffset + json.SCALE_NON_UNIFORM.byteOffset, count * 3) : undefined;
+        const matrix = Matrix3d.createIdentity();
+        const position = Point3d.createZero();
+        const upNormal = Vector3d.create(0, 0, 1);
+        const rightNormal = Vector3d.create(1, 0, 0);
+        const scale = Vector3d.create(1, 1, 1);
+        const transformCenter = this._range.center;
+        const transforms = new Float32Array(12 * count);
+        for (let i = 0; i < count; i++) {
+            const index = i * 3;
+            if (positions)
+                position.set(positions[index] - transformCenter.x, positions[index + 1] - transformCenter.y, positions[index + 2] - transformCenter.z);
+            if (upNormals || rightNormals) {
+                if (upNormals)
+                    upNormal.set(upNormals[index], upNormals[index + 1], upNormals[index + 2]);
+                if (rightNormals)
+                    rightNormal.set(rightNormals[index], rightNormals[index + 1], rightNormals[index + 2]);
+                if (scales)
+                    scale.x = scale.y = scale.z = scales[i];
+                if (nonUniformScales) {
+                    scale.x *= nonUniformScales[index + 0];
+                    scale.y *= nonUniformScales[index + 1];
+                    scale.z *= nonUniformScales[index + 2];
+                }
+                Matrix3d.createRigidFromColumns(rightNormal, upNormal, AxisOrder.XYZ, matrix);
+                if (scales || nonUniformScales)
+                    matrix.scaleColumnsInPlace(scale.x, scale.y, scale.z);
+                setTransform(transforms, i, matrix, position);
+            }
+        }
+        let featureIds;
+        if (undefined !== batchIds) {
+            featureIds = new Uint8Array(3 * batchIds.length);
+            for (let i = 0, j = 0; i < batchIds.length; i++) {
+                const batchId = batchIds[i];
+                featureIds[j++] = batchId & 0x000000ff;
+                featureIds[j++] = (batchId & 0x0000ff00) >> 8;
+                featureIds[j++] = (batchId & 0x00ff0000) >> 16;
+            }
+        }
+        const symbologyOverrides = undefined;
+        return { count, transforms, symbologyOverrides, featureIds, transformCenter };
+    }
+}
+//# sourceMappingURL=I3dmReader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"I3dmReader.js","sourceRoot":"","sources":["../../../../src/internal/tile/I3dmReader.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AACH,OAAO,EAA0B,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAuB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAK5G,OAAO,EAAoB,UAAU,EAAE,eAAe,EAAyC,MAAM,qBAAqB,CAAC;AAE3H,SAAS,YAAY,CAAC,UAAwB,EAAE,KAAa,EAAE,QAAkB,EAAE,MAAe;IAChG,MAAM,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;IACrB,IAAI,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC;IAEzB,MAAM,cAAc,GAAG,KAAK,CAAC;IAC7B,IAAI,cAAc;QAChB,GAAG,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEtD,MAAM,YAAY,GAAG,KAAK,CAAC;IAC3B,IAAI,YAAY;QACd,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;IAErC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3B,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3B,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3B,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAE7B,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3B,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3B,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3B,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAE7B,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3B,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3B,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5B,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IAyBZ;IAAoC;IAA2B;IACG;IACpF;IA1BF,cAAc,GAAG,CAAC,CAAC;IACnB,aAAa,CAAgB;IACpB,QAAQ,CAAa;IAE/B,MAAM,CAAC,MAAM,CAAC,MAAkB,EAAE,MAAwB,EAAE,OAAmB,EAAE,IAAa,EAAE,KAA0B,EAC/H,MAAoB,EAAE,OAAgB,EAAE,MAAe,EAAE,UAAgC,EAAE,KAAwB,EAAE,mBAAmB,GAAC,KAAK;QAC9I,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,OAAO;YACjB,OAAO,SAAS,CAAC;QAEnB,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/F,IAAI,SAAS,KAAK,KAAK;YACrB,OAAO,SAAS,CAAC;QAEnB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,wBAAwB,CAAC;QAChD,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACjF,IAAI,SAAS,KAAK,UAAU;YAC1B,OAAO,SAAS,CAAC;QAEnB,MAAM,aAAa,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,wBAAwB,GAAG,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAC3J,OAAO,IAAI,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EACtH,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAC3D,CAAC;IAED,YAA4B,cAA0B,EAAU,YAAiB,EAAU,eAAoB,EAAE,KAAsB,EACrI,MAAwB,EAAE,OAAmB,EAAE,IAAa,EAAE,MAAoB,EAAU,MAA2B,EAC/G,OAAgB,EAAE,WAAiC,EAAE,MAAyB,EAAE,mBAAmB,GAAC,KAAK;QACjH,KAAK,CAAC;YACJ,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB;YACvD,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM;SAC3B,CAAC,CAAC;QANuB,mBAAc,GAAd,cAAc,CAAY;QAAU,iBAAY,GAAZ,YAAY,CAAK;QAAU,oBAAe,GAAf,eAAe,CAAK;QACjB,WAAM,GAAN,MAAM,CAAqB;QAC/G,YAAO,GAAP,OAAO,CAAS;QAKxB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAE7E,wFAAwF;QACxF,IAAI,CAAC,aAAa,GAAG,IAAI,YAAY,CAAC,SAAS,KAAK,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/H,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACpE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,MAAM,OAAO,GAAQ,EAAE,CAAC;gBACxB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,eAAe,EAAE,mCAAmC;oBACzE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAE9C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;aAAM,CAAC;YACN,wFAAwF;YACxF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,WAAW;YAClB,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAEvE,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,IAAI,SAAS,KAAK,SAAS;YACzB,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAE9E,OAAO,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACxH,CAAC;IAES,YAAY,CAAC,SAAwB,EAAE,KAAU;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,aAAa;QACnB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;QACrE,IAAI,KAAK,IAAI,CAAC;YACZ,OAAO,SAAS,CAAC;QAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC;QAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChI,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvI,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzI,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1H,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEhK,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEvC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,YAAY,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YACpB,IAAI,SAAS;gBACX,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;YAEzI,IAAI,SAAS,IAAI,YAAY,EAAE,CAAC;gBAC9B,IAAI,SAAS;oBACX,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;gBAE7E,IAAI,YAAY;oBACd,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;gBAEzF,IAAI,MAAM;oBACR,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBAE1C,IAAI,gBAAgB,EAAE,CAAC;oBACrB,KAAK,CAAC,CAAC,IAAI,gBAAgB,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;oBACvC,KAAK,CAAC,CAAC,IAAI,gBAAgB,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;oBACvC,KAAK,CAAC,CAAC,IAAI,gBAAgB,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;gBACzC,CAAC;gBAED,QAAQ,CAAC,sBAAsB,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAC9E,IAAI,MAAM,IAAI,gBAAgB;oBAC5B,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;gBAExD,YAAY,CAAC,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,IAAI,UAAU,CAAC;QACf,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3B,UAAU,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC5B,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,GAAG,UAAU,CAAC;gBACvC,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;gBAC9C,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;YACjD,CAAC;QACH,CAAC;QACD,MAAM,kBAAkB,GAAG,SAAS,CAAC;QAErC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;IAChF,CAAC;CACF","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 */\nimport { ByteStream, Id64String, JsonUtils, utf8ToString } from \"@itwin/core-bentley\";\nimport { AxisOrder, Matrix3d, Point3d, Vector3d } from \"@itwin/core-geometry\";\nimport { ElementAlignedBox3d, Feature, FeatureTable, I3dmHeader, TileReadStatus } from \"@itwin/core-common\";\nimport { IModelConnection } from \"../../IModelConnection\";\nimport { InstancedGraphicParams } from \"../../common/render/InstancedGraphicParams\";\nimport { Mesh } from \"../../common/internal/render/MeshPrimitives\";\nimport { RenderSystem } from \"../../render/RenderSystem\";\nimport { BatchedTileIdMap, GltfReader, GltfReaderProps, GltfReaderResult, ShouldAbortReadGltf } from \"../../tile/internal\";\n\nfunction setTransform(transforms: Float32Array, index: number, rotation: Matrix3d, origin: Point3d): void {\n  const i = index * 12;\n  let rot = rotation.coffs;\n\n  const ignoreRotation = false;\n  if (ignoreRotation)\n    rot = new Float64Array([1, 0, 0, 0, 1, 0, 0, 0, 1]);\n\n  const ignoreOrigin = false;\n  if (ignoreOrigin)\n    origin.x = origin.y = origin.z = 0;\n\n  transforms[i + 0] = rot[0];\n  transforms[i + 1] = rot[1];\n  transforms[i + 2] = rot[2];\n  transforms[i + 3] = origin.x;\n\n  transforms[i + 4] = rot[3];\n  transforms[i + 5] = rot[4];\n  transforms[i + 6] = rot[5];\n  transforms[i + 7] = origin.y;\n\n  transforms[i + 8] = rot[6];\n  transforms[i + 9] = rot[7];\n  transforms[i + 10] = rot[8];\n  transforms[i + 11] = origin.z;\n}\n\n/**\n * Deserializes a tile in [i3dm](https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/specification/TileFormats/Instanced3DModel) format.\n */\nexport class I3dmReader extends GltfReader {\n  private _instanceCount = 0;\n  private _featureTable?: FeatureTable;\n  private readonly _modelId: Id64String;\n\n  public static create(stream: ByteStream, iModel: IModelConnection, modelId: Id64String, is3d: boolean, range: ElementAlignedBox3d,\n    system: RenderSystem, yAxisUp: boolean, isLeaf: boolean, isCanceled?: ShouldAbortReadGltf, idMap?: BatchedTileIdMap, deduplicateVertices=false): I3dmReader | undefined {\n    const header = new I3dmHeader(stream);\n    if (!header.isValid)\n      return undefined;\n\n    const props = GltfReaderProps.create(stream.nextBytes(header.length - stream.curPos), yAxisUp);\n    if (undefined === props)\n      return undefined;\n\n    stream.curPos = header.featureTableJsonPosition;\n    const featureStr = utf8ToString(stream.nextBytes(header.featureTableJsonLength));\n    if (undefined === featureStr)\n      return undefined;\n\n    const featureBinary = new Uint8Array(stream.arrayBuffer, header.featureTableJsonPosition + header.featureTableJsonLength, header.featureTableBinaryLength);\n    return new I3dmReader(featureBinary, JSON.parse(featureStr), header.batchTableJson, props, iModel, modelId, is3d, system,\n      range, isLeaf, isCanceled, idMap, deduplicateVertices);\n  }\n\n  private constructor(private _featureBinary: Uint8Array, private _featureJson: any, private _batchTableJson: any, props: GltfReaderProps,\n    iModel: IModelConnection, modelId: Id64String, is3d: boolean, system: RenderSystem, private _range: ElementAlignedBox3d,\n    private _isLeaf: boolean, shouldAbort?: ShouldAbortReadGltf, _idMap?: BatchedTileIdMap, deduplicateVertices=false) {\n    super({\n      props, iModel, system, shouldAbort, deduplicateVertices,\n      is2d: !is3d, idMap: _idMap,\n    });\n    this._modelId = modelId;\n  }\n\n  public async read(): Promise<GltfReaderResult> {\n    this._instanceCount = JsonUtils.asInt(this._featureJson.INSTANCES_LENGTH, 0);\n\n    // NB: For reality models with no batch table, we want the model ID in the feature table\n    this._featureTable = new FeatureTable(undefined === this._batchTableJson ? this._instanceCount : 1, this._modelId, this._type);\n    if (this._idMap !== undefined && this._batchTableJson !== undefined) {\n      for (let i = 0; i < this._instanceCount; i++) {\n        const feature: any = {};\n        for (const key in this._batchTableJson) // eslint-disable-line guard-for-in\n          feature[key] = this._batchTableJson[key][i];\n\n        this._featureTable.insert(new Feature(this._idMap.getBatchId(feature)));\n      }\n    } else {\n      // NB: For reality models with no batch table, we want the model ID in the feature table\n      const feature = new Feature(this._modelId);\n      this._featureTable.insert(feature);\n    }\n\n    await this.resolveResources();\n    if (this._isCanceled)\n      return { readStatus: TileReadStatus.Canceled, isLeaf: this._isLeaf };\n\n    const instances = this.readInstances();\n    if (undefined === instances)\n      return { readStatus: TileReadStatus.InvalidTileData, isLeaf: this._isLeaf };\n\n    return this.readGltfAndCreateGraphics(this._isLeaf, this._featureTable, this._range, undefined, undefined, instances);\n  }\n\n  protected readFeatures(_features: Mesh.Features, _json: any): boolean {\n    return false;\n  }\n\n  private readInstances(): InstancedGraphicParams | undefined {\n    const count = JsonUtils.asInt(this._featureJson.INSTANCES_LENGTH, 0);\n    if (count <= 0)\n      return undefined;\n\n    const json = this._featureJson;\n    const binary = this._featureBinary;\n\n    const batchIds = json.BATCH_ID ? new Int32Array(binary.buffer, binary.byteOffset + json.BATCH_ID.byteOffset, count) : undefined;\n    const positions = json.POSITION ? new Float32Array(binary.buffer, binary.byteOffset + json.POSITION.byteOffset, count * 3) : undefined;\n    const upNormals = json.NORMAL_UP ? new Float32Array(binary.buffer, binary.byteOffset + json.NORMAL_UP.byteOffset, count * 3) : undefined;\n    const rightNormals = json.NORMAL_RIGHT ? new Float32Array(binary.buffer, binary.byteOffset + json.NORMAL_RIGHT.byteOffset, count * 3) : undefined;\n    const scales = json.SCALE ? new Float32Array(binary.buffer, binary.byteOffset + json.SCALE.byteOffset, count) : undefined;\n    const nonUniformScales = json.SCALE_NON_UNIFORM ? new Float32Array(binary.buffer, binary.byteOffset + json.SCALE_NON_UNIFORM.byteOffset, count * 3) : undefined;\n\n    const matrix = Matrix3d.createIdentity();\n    const position = Point3d.createZero();\n    const upNormal = Vector3d.create(0, 0, 1);\n    const rightNormal = Vector3d.create(1, 0, 0);\n    const scale = Vector3d.create(1, 1, 1);\n\n    const transformCenter = this._range.center;\n    const transforms = new Float32Array(12 * count);\n    for (let i = 0; i < count; i++) {\n      const index = i * 3;\n      if (positions)\n        position.set(positions[index] - transformCenter.x, positions[index + 1] - transformCenter.y, positions[index + 2] - transformCenter.z);\n\n      if (upNormals || rightNormals) {\n        if (upNormals)\n          upNormal.set(upNormals[index], upNormals[index + 1], upNormals[index + 2]);\n\n        if (rightNormals)\n          rightNormal.set(rightNormals[index], rightNormals[index + 1], rightNormals[index + 2]);\n\n        if (scales)\n          scale.x = scale.y = scale.z = scales[i];\n\n        if (nonUniformScales) {\n          scale.x *= nonUniformScales[index + 0];\n          scale.y *= nonUniformScales[index + 1];\n          scale.z *= nonUniformScales[index + 2];\n        }\n\n        Matrix3d.createRigidFromColumns(rightNormal, upNormal, AxisOrder.XYZ, matrix);\n        if (scales || nonUniformScales)\n          matrix.scaleColumnsInPlace(scale.x, scale.y, scale.z);\n\n        setTransform(transforms, i, matrix, position);\n      }\n    }\n\n    let featureIds;\n    if (undefined !== batchIds) {\n      featureIds = new Uint8Array(3 * batchIds.length);\n      for (let i = 0, j = 0; i < batchIds.length; i++) {\n        const batchId = batchIds[i];\n        featureIds[j++] = batchId & 0x000000ff;\n        featureIds[j++] = (batchId & 0x0000ff00) >> 8;\n        featureIds[j++] = (batchId & 0x00ff0000) >> 16;\n      }\n    }\n    const symbologyOverrides = undefined;\n\n    return { count, transforms, symbologyOverrides, featureIds, transformCenter };\n  }\n}\n"]}

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

@@ -0,0 +1,54 @@
+/** @packageDocumentation
+ * @module Tiles
+ */
+import { BeTimePoint } from "@itwin/core-bentley";
+import { ColorDef, TileProps } from "@itwin/core-common";
+import { GraphicBuilder } from "../../render/GraphicBuilder";
+import { RenderSystem } from "../../render/RenderSystem";
+import { IModelTileTree, Tile, TileBoundingBoxes, TileContent, TileDrawArgs, TileParams, TileRequest, TileRequestChannel } from "./../../tile/internal";
+/** Parameters used to construct an [[IModelTile]].
+ */
+export interface IModelTileParams extends TileParams {
+    sizeMultiplier?: number;
+}
+export declare function iModelTileParamsFromJSON(props: TileProps, parent: IModelTile | undefined): IModelTileParams;
+/**
+ * Indicates whether a parent tile should be drawn in place of a child tile.
+ */
+export declare enum SelectParent {
+    No = 0,
+    Yes = 1
+}
+export interface IModelTileContent extends TileContent {
+    /** If this tile was produced by refinement, the multiplier applied to its screen size. */
+    sizeMultiplier?: number;
+    /** A bitfield describing empty sub-volumes of this tile's volume. */
+    emptySubRangeMask?: number;
+}
+/** A tile belonging to an [[IModelTileTree].
+ */
+export declare class IModelTile extends Tile {
+    private _sizeMultiplier?;
+    private _emptySubRangeMask?;
+    /** If an initial attempt to obtain this tile's content (e.g., from cloud storage cache) failed,
+     * the next channel to try.
+     */
+    requestChannel?: TileRequestChannel;
+    constructor(params: IModelTileParams, tree: IModelTileTree);
+    get iModelTree(): IModelTileTree;
+    get iModelChildren(): IModelTile[] | undefined;
+    get emptySubRangeMask(): number;
+    get sizeMultiplier(): number | undefined;
+    get hasSizeMultiplier(): boolean;
+    get maximumSize(): number;
+    get channel(): TileRequestChannel;
+    requestContent(): Promise<TileRequest.Response>;
+    readContent(data: TileRequest.ResponseData, system: RenderSystem, isCanceled?: () => boolean): Promise<IModelTileContent>;
+    setContent(content: IModelTileContent): void;
+    protected _loadChildren(resolve: (children: Tile[]) => void, reject: (error: Error) => void): void;
+    protected get rangeGraphicColor(): ColorDef;
+    protected addRangeGraphic(builder: GraphicBuilder, type: TileBoundingBoxes): void;
+    pruneChildren(olderThan: BeTimePoint): void;
+    selectTiles(selected: Tile[], args: TileDrawArgs, numSkipped: number): SelectParent;
+}
+//# sourceMappingURL=IModelTile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IModelTile.d.ts","sourceRoot":"","sources":["../../../../src/internal/tile/IModelTile.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAwB,WAAW,EAAc,MAAM,qBAAqB,CAAC;AAEpF,OAAO,EACL,QAAQ,EAAyH,SAAS,EAC3I,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACY,cAAc,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAkB,UAAU,EAAE,WAAW,EAC5H,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B;GACG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,gBAAgB,CAS3G;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,EAAE,IAAA;IACF,GAAG,IAAA;CACJ;AAED,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;GACG;AACH,qBAAa,UAAW,SAAQ,IAAI;IAClC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,kBAAkB,CAAC,CAAS;IACpC;;OAEG;IACI,cAAc,CAAC,EAAE,kBAAkB,CAAC;gBAExB,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc;IAYjE,IAAW,UAAU,IAAI,cAAc,CAAwC;IAC/E,IAAW,cAAc,IAAI,UAAU,EAAE,GAAG,SAAS,CAAsD;IAC3G,IAAW,iBAAiB,IAAI,MAAM,CAAyC;IAE/E,IAAW,cAAc,IAAI,MAAM,GAAG,SAAS,CAAiC;IAChF,IAAW,iBAAiB,YAAgD;IAC5E,IAAoB,WAAW,IAAI,MAAM,CAExC;IAED,IAAW,OAAO,IAAI,kBAAkB,CAEvC;IAEY,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC;IAI/C,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgCtH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAoB5D,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAkBlG,cAAuB,iBAAiB,IAAI,QAAQ,CAEnD;cAEkB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAgBnF,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IAc3C,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY;CAkI3F"}

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

@@ -0,0 +1,268 @@
+/*---------------------------------------------------------------------------------------------
+* 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 { assert, BentleyError, ByteStream } from "@itwin/core-bentley";
+import { Range3d } from "@itwin/core-geometry";
+import { ColorDef, computeChildTileProps, computeChildTileRanges, computeTileChordTolerance, LinePixels, TileFormat, } from "@itwin/core-common";
+import { IModelApp } from "../../IModelApp";
+import { addRangeGraphic, Tile, TileBoundingBoxes, TileLoadStatus, TileTreeLoadStatus, TileVisibility, } from "./../../tile/internal";
+export function iModelTileParamsFromJSON(props, parent) {
+    const { contentId, maximumSize, isLeaf, sizeMultiplier } = props;
+    const range = Range3d.fromJSON(props.range);
+    let contentRange;
+    if (undefined !== props.contentRange)
+        contentRange = Range3d.fromJSON(props.contentRange);
+    return { contentId, range, maximumSize, isLeaf, parent, contentRange, sizeMultiplier };
+}
+/**
+ * Indicates whether a parent tile should be drawn in place of a child tile.
+ */
+export var SelectParent;
+(function (SelectParent) {
+    SelectParent[SelectParent["No"] = 0] = "No";
+    SelectParent[SelectParent["Yes"] = 1] = "Yes";
+})(SelectParent || (SelectParent = {}));
+/** A tile belonging to an [[IModelTileTree].
+ */
+export class IModelTile extends Tile {
+    _sizeMultiplier;
+    _emptySubRangeMask;
+    /** If an initial attempt to obtain this tile's content (e.g., from cloud storage cache) failed,
+     * the next channel to try.
+     */
+    requestChannel;
+    constructor(params, tree) {
+        super(params, tree);
+        this._sizeMultiplier = params.sizeMultiplier;
+        if (!this.isLeaf && this.tree.is3d && !this.isReady) { // ###TODO: Want to know specifically if tree is *spatial*.
+            // Do not sub-divide such that chord tolerance would be below specified minimum, if minimum defined.
+            const minTolerance = IModelApp.tileAdmin.minimumSpatialTolerance;
+            if (minTolerance > 0 && computeTileChordTolerance(this, this.tree.is3d, this.iModelTree.tileScreenSize) <= minTolerance)
+                this.setLeaf();
+        }
+    }
+    get iModelTree() { return this.tree; }
+    get iModelChildren() { return this.children; }
+    get emptySubRangeMask() { return this._emptySubRangeMask ?? 0; }
+    get sizeMultiplier() { return this._sizeMultiplier; }
+    get hasSizeMultiplier() { return undefined !== this.sizeMultiplier; }
+    get maximumSize() {
+        return super.maximumSize * (this.sizeMultiplier ?? 1.0);
+    }
+    get channel() {
+        return IModelApp.tileAdmin.channels.getIModelTileChannel(this);
+    }
+    async requestContent() {
+        return IModelApp.tileAdmin.generateTileContent(this);
+    }
+    async readContent(data, system, isCanceled) {
+        if (undefined === isCanceled)
+            isCanceled = () => !this.isLoading;
+        assert(data instanceof Uint8Array);
+        const streamBuffer = ByteStream.fromUint8Array(data);
+        const position = streamBuffer.curPos;
+        const format = streamBuffer.readUint32();
+        streamBuffer.curPos = position;
+        let content = { isLeaf: true };
+        assert(TileFormat.IModel === format);
+        if (format !== TileFormat.IModel)
+            return content;
+        const sizeMultiplier = this.hasSizeMultiplier ? this.sizeMultiplier : undefined;
+        try {
+            content = await this.iModelTree.decoder.decode({
+                stream: streamBuffer,
+                options: { tileId: this.contentId },
+                system,
+                isCanceled,
+                sizeMultiplier,
+            });
+        }
+        catch {
+            //
+        }
+        return content;
+    }
+    setContent(content) {
+        super.setContent(content);
+        this._emptySubRangeMask = content.emptySubRangeMask;
+        // NB: If this tile has no graphics, it may or may not have children - but we don't want to load the children until
+        // this tile is too coarse for view based on its size in pixels.
+        // That is different than an "undisplayable" tile (maximumSize=0) whose children should be loaded immediately.
+        if (undefined !== content.graphic && 0 === this.maximumSize)
+            this._maximumSize = this.iModelTree.tileScreenSize;
+        const sizeMult = content.sizeMultiplier;
+        if (undefined !== sizeMult && (undefined === this._sizeMultiplier || sizeMult > this._sizeMultiplier)) {
+            this._sizeMultiplier = sizeMult;
+            this._contentId = this.iModelTree.contentIdProvider.idFromParentAndMultiplier(this.contentId, sizeMult);
+            if (undefined !== this.children && this.children.length > 1)
+                this.disposeChildren();
+        }
+    }
+    _loadChildren(resolve, reject) {
+        try {
+            const tree = this.iModelTree;
+            const kids = computeChildTileProps(this, tree.contentIdProvider, tree);
+            IModelApp.tileAdmin.onTilesElided(kids.numEmpty);
+            const children = [];
+            for (const props of kids.children) {
+                const child = new IModelTile(iModelTileParamsFromJSON(props, this), tree);
+                children.push(child);
+            }
+            resolve(children);
+        }
+        catch (err) {
+            reject(err instanceof Error ? err : new Error(BentleyError.getErrorMessage(err)));
+        }
+    }
+    get rangeGraphicColor() {
+        return this.hasSizeMultiplier ? ColorDef.red : super.rangeGraphicColor;
+    }
+    addRangeGraphic(builder, type) {
+        if (TileBoundingBoxes.ChildVolumes !== type) {
+            super.addRangeGraphic(builder, type);
+            return;
+        }
+        const ranges = computeChildTileRanges(this, this.iModelTree);
+        for (const range of ranges) {
+            const color = range.isEmpty ? ColorDef.blue : ColorDef.green;
+            const pixels = !range.isEmpty ? LinePixels.HiddenLine : LinePixels.Solid;
+            const width = !range.isEmpty ? 2 : 1;
+            builder.setSymbology(color, color, width, pixels);
+            addRangeGraphic(builder, range.range, this.tree.is2d);
+        }
+    }
+    pruneChildren(olderThan) {
+        // A tile's usage marker indicates its the most recent time its *children* were used.
+        if (this.usageMarker.isExpired(olderThan)) {
+            this.disposeChildren();
+            return;
+        }
+        // this node has been used recently. Keep it, but potentially unload its grandchildren.
+        const children = this.iModelChildren;
+        if (undefined !== children)
+            for (const child of children)
+                child.pruneChildren(olderThan);
+    }
+    selectTiles(selected, args, numSkipped) {
+        let vis = this.computeVisibility(args);
+        if (TileVisibility.OutsideFrustum === vis)
+            return SelectParent.No;
+        const maxDepth = this.iModelTree.debugMaxDepth;
+        if (undefined !== maxDepth && this.depth >= maxDepth)
+            vis = TileVisibility.Visible;
+        if (TileVisibility.Visible === vis) {
+            // This tile is of appropriate resolution to draw. If need loading or refinement, enqueue.
+            if (!this.isReady)
+                args.insertMissing(this);
+            if (this.hasGraphics) {
+                // It can be drawn - select it
+                args.markReady(this);
+                selected.push(this);
+            }
+            else if (!this.isReady) {
+                // It can't be drawn. Try to draw children in its place; otherwise draw the parent.
+                // Do not load/request the children for this purpose.
+                const initialSize = selected.length;
+                const kids = this.iModelChildren;
+                if (undefined === kids)
+                    return SelectParent.Yes;
+                // Find any descendant to draw, until we exceed max initial tiles to skip.
+                if (this.depth < this.iModelTree.maxInitialTilesToSkip) {
+                    for (const kid of kids) {
+                        if (SelectParent.Yes === kid.selectTiles(selected, args, numSkipped)) {
+                            selected.length = initialSize;
+                            return SelectParent.Yes;
+                        }
+                        return SelectParent.No;
+                    }
+                }
+                // If all visible direct children can be drawn, draw them.
+                for (const kid of kids) {
+                    if (TileVisibility.OutsideFrustum !== kid.computeVisibility(args)) {
+                        if (!kid.hasGraphics) {
+                            selected.length = initialSize;
+                            return SelectParent.Yes;
+                        }
+                        else {
+                            selected.push(kid);
+                        }
+                    }
+                }
+                args.markUsed(this);
+            }
+            // We're drawing either this tile, or its direct children.
+            return SelectParent.No;
+        }
+        // This tile is too coarse to draw. Try to draw something more appropriate.
+        // If it is not ready to draw, we may want to skip loading in favor of loading its descendants.
+        // If we previously loaded and later unloaded content for this tile to free memory, don't force it to reload its content - proceed to children.
+        let canSkipThisTile = (this._hadGraphics && !this.hasGraphics) || this.depth < this.iModelTree.maxInitialTilesToSkip;
+        if (canSkipThisTile) {
+            numSkipped = 1;
+        }
+        else {
+            canSkipThisTile = this.isReady || this.isParentDisplayable || this.depth < this.iModelTree.maxInitialTilesToSkip;
+            if (canSkipThisTile && this.isDisplayable) { // skipping an undisplayable tile doesn't count toward the maximum
+                // Some tiles do not sub-divide - they only facet the same geometry to a higher resolution. We can skip directly to the correct resolution.
+                const isNotReady = !this.isReady && !this.hasGraphics && !this.hasSizeMultiplier;
+                if (isNotReady) {
+                    if (numSkipped >= this.iModelTree.maxTilesToSkip)
+                        canSkipThisTile = false;
+                    else
+                        numSkipped += 1;
+                }
+            }
+        }
+        const childrenLoadStatus = this.loadChildren(); // NB: asynchronous
+        const children = canSkipThisTile ? this.iModelChildren : undefined;
+        if (canSkipThisTile && TileTreeLoadStatus.Loading === childrenLoadStatus) {
+            args.markChildrenLoading();
+            args.markUsed(this);
+        }
+        if (undefined !== children) {
+            // If we are the root tile and we are not displayable, then we want to draw *any* currently available children in our place, or else we would draw nothing.
+            // Otherwise, if we want to draw children in our place, we should wait for *all* of them to load, or else we would show missing chunks where not-yet-loaded children belong.
+            const isUndisplayableRootTile = this.isUndisplayableRootTile;
+            args.markUsed(this);
+            let drawChildren = true;
+            const initialSize = selected.length;
+            for (const child of children) {
+                // NB: We must continue iterating children so that they can be requested if missing.
+                if (SelectParent.Yes === child.selectTiles(selected, args, numSkipped)) {
+                    if (child.loadStatus === TileLoadStatus.NotFound) {
+                        // At least one child we want to draw failed to load. e.g., we reached max depth of map tile tree. Draw parent instead.
+                        drawChildren = canSkipThisTile = false;
+                    }
+                    else {
+                        // At least one child we want to draw is not yet loaded. Wait for it to load before drawing it and its siblings, unless we have nothing to draw in their place.
+                        drawChildren = isUndisplayableRootTile;
+                    }
+                }
+            }
+            if (drawChildren)
+                return SelectParent.No;
+            // Some types of tiles (like maps) allow the ready children to be drawn on top of the parent while other children are not yet loaded.
+            if (args.parentsAndChildrenExclusive)
+                selected.length = initialSize;
+        }
+        if (this.isReady) {
+            if (this.hasGraphics) {
+                selected.push(this);
+                if (!canSkipThisTile) {
+                    // This tile is too coarse, but we require loading it before we can start loading higher-res children.
+                    args.markReady(this);
+                }
+            }
+            return SelectParent.No;
+        }
+        // This tile is not ready to be drawn. Request it *only* if we cannot skip it.
+        if (!canSkipThisTile)
+            args.insertMissing(this);
+        return this.isParentDisplayable ? SelectParent.Yes : SelectParent.No;
+    }
+}
+//# sourceMappingURL=IModelTile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IModelTile.js","sourceRoot":"","sources":["../../../../src/internal/tile/IModelTile.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 Tiles\n */\n\nimport { assert, BentleyError, BeTimePoint, ByteStream } from \"@itwin/core-bentley\";\nimport { Range3d } from \"@itwin/core-geometry\";\nimport {\n  ColorDef, computeChildTileProps, computeChildTileRanges, computeTileChordTolerance, ElementAlignedBox3d, LinePixels, TileFormat, TileProps,\n} from \"@itwin/core-common\";\nimport { IModelApp } from \"../../IModelApp\";\nimport { GraphicBuilder } from \"../../render/GraphicBuilder\";\nimport { RenderSystem } from \"../../render/RenderSystem\";\nimport {\n  addRangeGraphic, IModelTileTree, Tile, TileBoundingBoxes, TileContent, TileDrawArgs, TileLoadStatus, TileParams, TileRequest,\n  TileRequestChannel, TileTreeLoadStatus, TileVisibility,\n} from \"./../../tile/internal\";\n\n/** Parameters used to construct an [[IModelTile]].\n */\nexport interface IModelTileParams extends TileParams {\n  sizeMultiplier?: number;\n}\n\nexport function iModelTileParamsFromJSON(props: TileProps, parent: IModelTile | undefined): IModelTileParams {\n  const { contentId, maximumSize, isLeaf, sizeMultiplier } = props;\n  const range = Range3d.fromJSON(props.range);\n\n  let contentRange;\n  if (undefined !== props.contentRange)\n    contentRange = Range3d.fromJSON<ElementAlignedBox3d>(props.contentRange);\n\n  return { contentId, range, maximumSize, isLeaf, parent, contentRange, sizeMultiplier };\n}\n\n/**\n * Indicates whether a parent tile should be drawn in place of a child tile.\n */\nexport enum SelectParent {\n  No,\n  Yes,\n}\n\nexport interface IModelTileContent extends TileContent {\n  /** If this tile was produced by refinement, the multiplier applied to its screen size. */\n  sizeMultiplier?: number;\n  /** A bitfield describing empty sub-volumes of this tile's volume. */\n  emptySubRangeMask?: number;\n}\n\n/** A tile belonging to an [[IModelTileTree].\n */\nexport class IModelTile extends Tile {\n  private _sizeMultiplier?: number;\n  private _emptySubRangeMask?: number;\n  /** If an initial attempt to obtain this tile's content (e.g., from cloud storage cache) failed,\n   * the next channel to try.\n   */\n  public requestChannel?: TileRequestChannel;\n\n  public constructor(params: IModelTileParams, tree: IModelTileTree) {\n    super(params, tree);\n    this._sizeMultiplier = params.sizeMultiplier;\n\n    if (!this.isLeaf && this.tree.is3d && !this.isReady) { // ###TODO: Want to know specifically if tree is *spatial*.\n      // Do not sub-divide such that chord tolerance would be below specified minimum, if minimum defined.\n      const minTolerance = IModelApp.tileAdmin.minimumSpatialTolerance;\n      if (minTolerance > 0 && computeTileChordTolerance(this, this.tree.is3d, this.iModelTree.tileScreenSize) <= minTolerance)\n        this.setLeaf();\n    }\n  }\n\n  public get iModelTree(): IModelTileTree { return this.tree as IModelTileTree; }\n  public get iModelChildren(): IModelTile[] | undefined { return this.children as IModelTile[] | undefined; }\n  public get emptySubRangeMask(): number { return this._emptySubRangeMask ?? 0; }\n\n  public get sizeMultiplier(): number | undefined { return this._sizeMultiplier; }\n  public get hasSizeMultiplier() { return undefined !== this.sizeMultiplier; }\n  public override get maximumSize(): number {\n    return super.maximumSize * (this.sizeMultiplier ?? 1.0);\n  }\n\n  public get channel(): TileRequestChannel {\n    return IModelApp.tileAdmin.channels.getIModelTileChannel(this);\n  }\n\n  public async requestContent(): Promise<TileRequest.Response> {\n    return IModelApp.tileAdmin.generateTileContent(this);\n  }\n\n  public async readContent(data: TileRequest.ResponseData, system: RenderSystem, isCanceled?: () => boolean): Promise<IModelTileContent> {\n    if (undefined === isCanceled)\n      isCanceled = () => !this.isLoading;\n\n    assert(data instanceof Uint8Array);\n    const streamBuffer = ByteStream.fromUint8Array(data);\n\n    const position = streamBuffer.curPos;\n    const format = streamBuffer.readUint32();\n    streamBuffer.curPos = position;\n\n    let content: IModelTileContent = { isLeaf: true };\n    assert(TileFormat.IModel === format);\n    if (format !== TileFormat.IModel)\n      return content;\n\n    const sizeMultiplier = this.hasSizeMultiplier ? this.sizeMultiplier : undefined;\n    try {\n      content = await this.iModelTree.decoder.decode({\n        stream: streamBuffer,\n        options: { tileId: this.contentId },\n        system,\n        isCanceled,\n        sizeMultiplier,\n      });\n    } catch {\n      //\n    }\n\n    return content;\n  }\n\n  public override setContent(content: IModelTileContent): void {\n    super.setContent(content);\n\n    this._emptySubRangeMask = content.emptySubRangeMask;\n\n    // NB: If this tile has no graphics, it may or may not have children - but we don't want to load the children until\n    // this tile is too coarse for view based on its size in pixels.\n    // That is different than an \"undisplayable\" tile (maximumSize=0) whose children should be loaded immediately.\n    if (undefined !== content.graphic && 0 === this.maximumSize)\n      this._maximumSize = this.iModelTree.tileScreenSize;\n\n    const sizeMult = content.sizeMultiplier;\n    if (undefined !== sizeMult && (undefined === this._sizeMultiplier || sizeMult > this._sizeMultiplier)) {\n      this._sizeMultiplier = sizeMult;\n      this._contentId = this.iModelTree.contentIdProvider.idFromParentAndMultiplier(this.contentId, sizeMult);\n      if (undefined !== this.children && this.children.length > 1)\n        this.disposeChildren();\n    }\n  }\n\n  protected _loadChildren(resolve: (children: Tile[]) => void, reject: (error: Error) => void): void {\n    try {\n      const tree = this.iModelTree;\n      const kids = computeChildTileProps(this, tree.contentIdProvider, tree);\n      IModelApp.tileAdmin.onTilesElided(kids.numEmpty);\n\n      const children: IModelTile[] = [];\n      for (const props of kids.children) {\n        const child = new IModelTile(iModelTileParamsFromJSON(props, this), tree);\n        children.push(child);\n      }\n\n      resolve(children);\n    } catch (err) {\n      reject(err instanceof Error ? err : new Error(BentleyError.getErrorMessage(err)));\n    }\n  }\n\n  protected override get rangeGraphicColor(): ColorDef {\n    return this.hasSizeMultiplier ? ColorDef.red : super.rangeGraphicColor;\n  }\n\n  protected override addRangeGraphic(builder: GraphicBuilder, type: TileBoundingBoxes): void {\n    if (TileBoundingBoxes.ChildVolumes !== type) {\n      super.addRangeGraphic(builder, type);\n      return;\n    }\n\n    const ranges = computeChildTileRanges(this, this.iModelTree);\n    for (const range of ranges) {\n      const color = range.isEmpty ? ColorDef.blue : ColorDef.green;\n      const pixels = !range.isEmpty ? LinePixels.HiddenLine : LinePixels.Solid;\n      const width = !range.isEmpty ? 2 : 1;\n      builder.setSymbology(color, color, width, pixels);\n      addRangeGraphic(builder, range.range, this.tree.is2d);\n    }\n  }\n\n  public pruneChildren(olderThan: BeTimePoint): void {\n    // A tile's usage marker indicates its the most recent time its *children* were used.\n    if (this.usageMarker.isExpired(olderThan)) {\n      this.disposeChildren();\n      return;\n    }\n\n    // this node has been used recently. Keep it, but potentially unload its grandchildren.\n    const children = this.iModelChildren;\n    if (undefined !== children)\n      for (const child of children)\n        child.pruneChildren(olderThan);\n  }\n\n  public selectTiles(selected: Tile[], args: TileDrawArgs, numSkipped: number): SelectParent {\n    let vis = this.computeVisibility(args);\n    if (TileVisibility.OutsideFrustum === vis)\n      return SelectParent.No;\n\n    const maxDepth = this.iModelTree.debugMaxDepth;\n    if (undefined !== maxDepth && this.depth >= maxDepth)\n      vis = TileVisibility.Visible;\n\n    if (TileVisibility.Visible === vis) {\n      // This tile is of appropriate resolution to draw. If need loading or refinement, enqueue.\n      if (!this.isReady)\n        args.insertMissing(this);\n\n      if (this.hasGraphics) {\n        // It can be drawn - select it\n        args.markReady(this);\n        selected.push(this);\n      } else if (!this.isReady) {\n        // It can't be drawn. Try to draw children in its place; otherwise draw the parent.\n        // Do not load/request the children for this purpose.\n        const initialSize = selected.length;\n        const kids = this.iModelChildren;\n        if (undefined === kids)\n          return SelectParent.Yes;\n\n        // Find any descendant to draw, until we exceed max initial tiles to skip.\n        if (this.depth < this.iModelTree.maxInitialTilesToSkip) {\n          for (const kid of kids) {\n            if (SelectParent.Yes === kid.selectTiles(selected, args, numSkipped)) {\n              selected.length = initialSize;\n              return SelectParent.Yes;\n            }\n\n            return SelectParent.No;\n          }\n        }\n\n        // If all visible direct children can be drawn, draw them.\n        for (const kid of kids) {\n          if (TileVisibility.OutsideFrustum !== kid.computeVisibility(args)) {\n            if (!kid.hasGraphics) {\n              selected.length = initialSize;\n              return SelectParent.Yes;\n            } else {\n              selected.push(kid);\n            }\n          }\n        }\n\n        args.markUsed(this);\n      }\n\n      // We're drawing either this tile, or its direct children.\n      return SelectParent.No;\n    }\n\n    // This tile is too coarse to draw. Try to draw something more appropriate.\n    // If it is not ready to draw, we may want to skip loading in favor of loading its descendants.\n    // If we previously loaded and later unloaded content for this tile to free memory, don't force it to reload its content - proceed to children.\n    let canSkipThisTile = (this._hadGraphics && !this.hasGraphics) || this.depth < this.iModelTree.maxInitialTilesToSkip;\n    if (canSkipThisTile) {\n      numSkipped = 1;\n    } else {\n      canSkipThisTile = this.isReady || this.isParentDisplayable || this.depth < this.iModelTree.maxInitialTilesToSkip;\n      if (canSkipThisTile && this.isDisplayable) { // skipping an undisplayable tile doesn't count toward the maximum\n        // Some tiles do not sub-divide - they only facet the same geometry to a higher resolution. We can skip directly to the correct resolution.\n        const isNotReady = !this.isReady && !this.hasGraphics && !this.hasSizeMultiplier;\n        if (isNotReady) {\n          if (numSkipped >= this.iModelTree.maxTilesToSkip)\n            canSkipThisTile = false;\n          else\n            numSkipped += 1;\n        }\n      }\n    }\n\n    const childrenLoadStatus = this.loadChildren(); // NB: asynchronous\n    const children = canSkipThisTile ? this.iModelChildren : undefined;\n    if (canSkipThisTile && TileTreeLoadStatus.Loading === childrenLoadStatus) {\n      args.markChildrenLoading();\n      args.markUsed(this);\n    }\n\n    if (undefined !== children) {\n      // If we are the root tile and we are not displayable, then we want to draw *any* currently available children in our place, or else we would draw nothing.\n      // Otherwise, if we want to draw children in our place, we should wait for *all* of them to load, or else we would show missing chunks where not-yet-loaded children belong.\n      const isUndisplayableRootTile = this.isUndisplayableRootTile;\n      args.markUsed(this);\n      let drawChildren = true;\n      const initialSize = selected.length;\n      for (const child of children) {\n        // NB: We must continue iterating children so that they can be requested if missing.\n        if (SelectParent.Yes === child.selectTiles(selected, args, numSkipped)) {\n          if (child.loadStatus === TileLoadStatus.NotFound) {\n            // At least one child we want to draw failed to load. e.g., we reached max depth of map tile tree. Draw parent instead.\n            drawChildren = canSkipThisTile = false;\n          } else {\n            // At least one child we want to draw is not yet loaded. Wait for it to load before drawing it and its siblings, unless we have nothing to draw in their place.\n            drawChildren = isUndisplayableRootTile;\n          }\n        }\n      }\n\n      if (drawChildren)\n        return SelectParent.No;\n\n      // Some types of tiles (like maps) allow the ready children to be drawn on top of the parent while other children are not yet loaded.\n      if (args.parentsAndChildrenExclusive)\n        selected.length = initialSize;\n    }\n\n    if (this.isReady) {\n      if (this.hasGraphics) {\n        selected.push(this);\n        if (!canSkipThisTile) {\n          // This tile is too coarse, but we require loading it before we can start loading higher-res children.\n          args.markReady(this);\n        }\n      }\n\n      return SelectParent.No;\n    }\n\n    // This tile is not ready to be drawn. Request it *only* if we cannot skip it.\n    if (!canSkipThisTile)\n      args.insertMissing(this);\n\n    return this.isParentDisplayable ? SelectParent.Yes : SelectParent.No;\n  }\n}\n"]}

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

@@ -0,0 +1,24 @@
+/** @packageDocumentation
+ * @module Tiles
+ */
+import { IModelTile, IModelTileContent, TileRequestChannel } from "../../tile/internal";
+/** TileRequestChannels used for requesting content for IModelTiles.
+ */
+export declare class IModelTileRequestChannels {
+    private _cloudStorage;
+    private readonly _contentCache?;
+    readonly rpc: TileRequestChannel;
+    constructor(args: {
+        concurrency: number;
+        usesHttp: boolean;
+        cacheMetadata: boolean;
+        cacheConcurrency: number;
+    });
+    get cloudStorage(): TileRequestChannel;
+    [Symbol.iterator](): Iterator<TileRequestChannel>;
+    setRpcConcurrency(concurrency: number): void;
+    getChannelForTile(tile: IModelTile): TileRequestChannel;
+    /** Strictly for tests. */
+    getCachedContent(tile: IModelTile): IModelTileContent | undefined;
+}
+//# sourceMappingURL=IModelTileRequestChannels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IModelTileRequestChannels.d.ts","sourceRoot":"","sources":["../../../../src/internal/tile/IModelTileRequestChannels.ts"],"names":[],"mappings":"AAIA;;GAEG;AAOH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAqB,kBAAkB,EAAY,MAAM,qBAAqB,CAAC;AAoIrH;GACG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAiC;IAChE,SAAgB,GAAG,EAAE,kBAAkB,CAAC;gBAErB,IAAI,EAAE;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,EAAE,OAAO,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAaD,IAAW,YAAY,IAAI,kBAAkB,CAE5C;IAEM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IAWjD,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI5C,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,kBAAkB;IAI9D,0BAA0B;IACnB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,GAAG,SAAS;CAGzE"}