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

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

@@ -0,0 +1,204 @@
+/*---------------------------------------------------------------------------------------------
+* 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 { Logger, utf8ToString } from "@itwin/core-bentley";
+import { Point3d, Range3d } from "@itwin/core-geometry";
+import { BatchType, Feature, FeatureTable, PackedFeatureTable, PntsHeader, QParams3d, QPoint3d, Quantization } from "@itwin/core-common";
+import { FrontendLoggerCategory } from "../../common/FrontendLoggerCategory";
+import { Mesh } from "../../common/internal/render/MeshPrimitives";
+function readPntsColors(stream, dataOffset, pnts) {
+    const nPts = pnts.POINTS_LENGTH;
+    const nComponents = 3 * nPts;
+    if (pnts.RGB)
+        return new Uint8Array(stream.arrayBuffer, dataOffset + pnts.RGB.byteOffset, nComponents);
+    if (pnts.RGBA) {
+        // ###TODO support point cloud transparency.
+        const rgb = new Uint8Array(nComponents);
+        const rgba = new Uint8Array(stream.arrayBuffer, dataOffset + pnts.RGBA.byteOffset, nComponents);
+        for (let i = 0; i < nComponents; i += 4) {
+            rgb[i + 0] = rgba[i + 0];
+            rgb[i + 1] = rgba[i + 1];
+            rgb[i + 2] = rgba[i + 2];
+        }
+        return rgb;
+    }
+    else if (pnts.RGB565) {
+        // Each color is 16 bits: 5 red, 6 green, 5 blue.
+        const crgb = new Uint16Array(stream.arrayBuffer, dataOffset + pnts.RGB565.byteOffset, nPts);
+        const rgb = new Uint8Array(nComponents);
+        for (let i = 0; i < nPts; i++) {
+            const c = crgb[i];
+            rgb[i + 0] = (c >> 11) & 0x1f;
+            rgb[i + 1] = (c >> 5) & 0x3f;
+            rgb[i + 2] = c & 0x1f;
+        }
+        return rgb;
+    }
+    return undefined;
+}
+function readPnts(stream, dataOffset, pnts) {
+    const nPts = pnts.POINTS_LENGTH;
+    let params;
+    let points;
+    if (pnts.POSITION_QUANTIZED) {
+        const qpos = pnts.POSITION_QUANTIZED;
+        const offset = pnts.QUANTIZED_VOLUME_OFFSET;
+        const scale = pnts.QUANTIZED_VOLUME_SCALE;
+        const qOrigin = new Point3d(offset[0], offset[1], offset[2]);
+        const qScale = new Point3d(Quantization.computeScale(scale[0]), Quantization.computeScale(scale[1]), Quantization.computeScale(scale[2]));
+        params = QParams3d.fromOriginAndScale(qOrigin, qScale);
+        points = new Uint16Array(stream.arrayBuffer, dataOffset + qpos.byteOffset, 3 * nPts);
+    }
+    else {
+        const qOrigin = new Point3d(0, 0, 0);
+        const qScale = new Point3d(1, 1, 1);
+        params = QParams3d.fromOriginAndScale(qOrigin, qScale);
+        points = new Float32Array(stream.arrayBuffer, dataOffset + pnts.POSITION.byteOffset, 3 * nPts);
+    }
+    const colors = readPntsColors(stream, dataOffset, pnts);
+    return { params, points, colors };
+}
+async function decodeDracoPointCloud(buf) {
+    try {
+        const dracoLoader = (await import("@loaders.gl/draco")).DracoLoader;
+        const mesh = await dracoLoader.parse(buf, {});
+        if (mesh.topology !== "point-list")
+            return undefined;
+        const pos = mesh.attributes.POSITION?.value;
+        if (!pos || (pos.length % 3) !== 0)
+            return undefined;
+        let colors = mesh.attributes.RGB?.value ?? mesh.attributes.COLOR_0?.value;
+        if (!colors) {
+            // ###TODO support point cloud transparency.
+            const rgba = mesh.attributes.RGBA?.value;
+            if (rgba && (rgba.length % 4) === 0) {
+                // We currently don't support alpha channel for point clouds - strip it.
+                colors = new Uint8Array(3 * rgba.length / 4);
+                let j = 0;
+                for (let i = 0; i < rgba.length; i += 4) {
+                    colors[j++] = rgba[i];
+                    colors[j++] = rgba[i + 1];
+                    colors[j++] = rgba[i + 2];
+                }
+            }
+        }
+        let posRange;
+        const bbox = mesh.header?.boundingBox;
+        if (bbox) {
+            posRange = Range3d.createXYZXYZ(bbox[0][0], bbox[0][1], bbox[0][2], bbox[1][0], bbox[1][1], bbox[1][2]);
+        }
+        else {
+            posRange = Range3d.createNull();
+            for (let i = 0; i < pos.length; i += 3)
+                posRange.extendXYZ(pos[i], pos[i + 1], pos[i + 2]);
+        }
+        const params = QParams3d.fromRange(posRange);
+        const pt = Point3d.createZero();
+        const qpt = QPoint3d.create(pt, params);
+        const points = new Uint16Array(pos.length);
+        for (let i = 0; i < pos.length; i += 3) {
+            pt.set(pos[i], pos[i + 1], pos[i + 2]);
+            qpt.init(pt, params);
+            points[i] = qpt.x;
+            points[i + 1] = qpt.y;
+            points[i + 2] = qpt.z;
+        }
+        return { points, params, colors: colors instanceof Uint8Array ? colors : undefined };
+    }
+    catch (err) {
+        Logger.logWarning(FrontendLoggerCategory.Render, "Failed to decode draco-encoded point cloud");
+        Logger.logException(FrontendLoggerCategory.Render, err);
+        return undefined;
+    }
+}
+/** Deserialize a point cloud tile and return it as a RenderGraphic.
+ */
+export async function readPointCloudTileContent(stream, iModel, modelId, _is3d, tile, system) {
+    let graphic;
+    let rtcCenter;
+    const header = new PntsHeader(stream);
+    if (!header.isValid)
+        return { graphic, rtcCenter };
+    const range = tile.contentRange;
+    const featureTableJsonOffset = stream.curPos;
+    const featureStrData = stream.nextBytes(header.featureTableJsonLength);
+    const featureStr = utf8ToString(featureStrData);
+    const featureValue = JSON.parse(featureStr);
+    if (undefined === featureValue)
+        return { graphic, rtcCenter };
+    let props;
+    const dataOffset = featureTableJsonOffset + header.featureTableJsonLength;
+    const draco = featureValue.extensions ? featureValue.extensions["3DTILES_draco_point_compression"] : undefined;
+    if (draco) {
+        try {
+            const buf = new Uint8Array(stream.arrayBuffer, dataOffset + draco.byteOffset, draco.byteLength);
+            props = await decodeDracoPointCloud(buf);
+        }
+        catch {
+            //
+        }
+    }
+    else {
+        props = readPnts(stream, dataOffset, featureValue);
+    }
+    if (!props)
+        return { graphic, rtcCenter };
+    let batchRange = range;
+    if (featureValue.RTC_CENTER) {
+        rtcCenter = Point3d.fromJSON(featureValue.RTC_CENTER);
+        batchRange = range.clone();
+        batchRange.low.minus(rtcCenter, batchRange.low);
+        batchRange.high.minus(rtcCenter, batchRange.high);
+    }
+    if (!props.colors) {
+        // ###TODO we really should support uniform color instead of allocating an RGB value per point...
+        props.colors = new Uint8Array(3 * featureValue.POINTS_LENGTH);
+        const rgba = featureValue.CONSTANT_RGBA;
+        if (rgba) {
+            // ###TODO support point cloud transparency.
+            for (let i = 0; i < featureValue.POINTS_LENGTH * 3; i += 3) {
+                props.colors[i] = rgba[0];
+                props.colors[i + 1] = rgba[1];
+                props.colors[i + 2] = rgba[2];
+            }
+        }
+        else {
+            // Default to white.
+            props.colors.fill(0xff, 0, props.colors.length);
+        }
+    }
+    const featureTable = new FeatureTable(1, modelId, BatchType.Primary);
+    const features = new Mesh.Features(featureTable);
+    features.add(new Feature(modelId), 1);
+    let params = props.params;
+    if (props.points instanceof Float32Array) {
+        // we don't have a true range for unquantized points, so calc one here for voxelSize
+        const rng = Range3d.createNull();
+        for (let i = 0; i < props.points.length; i += 3)
+            rng.extendXYZ(props.points[i], props.points[i + 1], props.points[i + 2]);
+        params = QParams3d.fromRange(rng);
+    }
+    // 256 here is tile.maximumSize (on non-additive refinement tiles)
+    // If additiveRefinement, set voxelSize to 0 which will cause it draw to with minPixelsPerVoxel, which defaults to 2
+    // That way, it will draw as if in pixel mode, and voxelScale will still function
+    // Checking across a variety of 10 point clouds, 2 to 4 seems to work well for pixel settings (depending on the
+    // cloud), so 2 is a decent default
+    // (If voxelSize is used normally in this case, it draws different size pixels for different tiles, and since
+    // they can overlap ranges, no good way found to calculate a voxelSize)
+    const voxelSize = tile.additiveRefinement ? 0 : params.rangeDiagonal.maxAbs() / 256;
+    graphic = system.createPointCloud({
+        positions: props.points,
+        qparams: props.params,
+        colors: props.colors,
+        features: features.toFeatureIndex(),
+        voxelSize,
+        colorFormat: "rgb",
+    }, iModel);
+    graphic = system.createBatch(graphic, PackedFeatureTable.pack(featureTable), batchRange);
+    return { graphic, rtcCenter };
+}
+//# sourceMappingURL=PntsReader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PntsReader.js","sourceRoot":"","sources":["../../../../src/internal/tile/PntsReader.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 { ByteStream, Id64String, Logger, utf8ToString } from \"@itwin/core-bentley\";\nimport { Point3d, Range3d } from \"@itwin/core-geometry\";\nimport { BatchType, Feature, FeatureTable, PackedFeatureTable, PntsHeader, QParams3d, QPoint3d, Quantization } from \"@itwin/core-common\";\nimport { FrontendLoggerCategory } from \"../../common/FrontendLoggerCategory\";\nimport { IModelConnection } from \"../../IModelConnection\";\nimport { Mesh } from \"../../common/internal/render/MeshPrimitives\";\nimport { RenderGraphic } from \"../../render/RenderGraphic\";\nimport { RenderSystem } from \"../../render/RenderSystem\";\nimport { RealityTile } from \"../../tile/internal\";\n\n/** Schema for the [3DTILES_draco_point_compression](https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_draco_point_compression) extension. */\ninterface DracoPointCloud {\n  byteLength: number;\n  byteOffset: number;\n  /** Each specifies the Id of a compressed attribute. */\n  properties: {\n    POSITION?: number; // eslint-disable-line @typescript-eslint/naming-convention\n    RGB?: number; // eslint-disable-line @typescript-eslint/naming-convention\n    RGBA?: number; // eslint-disable-line @typescript-eslint/naming-convention\n    NORMAL?: number; // eslint-disable-line @typescript-eslint/naming-convention\n    BATCH_ID?: number; // eslint-disable-line @typescript-eslint/naming-convention\n    /** This is not in the spec but is present in sample data in Cesium's git repository. */\n    COLOR_0?: number; // eslint-disable-line @typescript-eslint/naming-convention\n  };\n}\n\ninterface PointCloudProps {\n  params: QParams3d;\n  points: Uint16Array | Float32Array;\n  colors?: Uint8Array;\n}\n\ninterface BinaryBodyReference {\n  byteOffset: number;\n}\n\n/** [3D tiles specification section 10.3](https://docs.opengeospatial.org/cs/18-053r2/18-053r2.html#199).\n * [JSON schema](https://github.com/CesiumGS/3d-tiles/blob/main/specification/schema/pnts.featureTable.schema.json).\n */\ninterface CommonPntsProps {\n  POINTS_LENGTH: number; // eslint-disable-line @typescript-eslint/naming-convention\n  RTC_CENTER?: number[]; // eslint-disable-line @typescript-eslint/naming-convention\n  CONSTANT_RGBA?: number[]; // eslint-disable-line @typescript-eslint/naming-convention\n  RGB?: BinaryBodyReference; // eslint-disable-line @typescript-eslint/naming-convention\n  RGBA?: BinaryBodyReference; // eslint-disable-line @typescript-eslint/naming-convention\n  RGB565?: BinaryBodyReference; // eslint-disable-line @typescript-eslint/naming-convention\n\n  extensions?: {\n    \"3DTILES_draco_point_compression\"?: DracoPointCloud;\n  };\n\n  // The following are currently ignored.\n  NORMAL?: BinaryBodyReference; // eslint-disable-line @typescript-eslint/naming-convention\n  NORMAL_OCT16P?: BinaryBodyReference; // eslint-disable-line @typescript-eslint/naming-convention\n  BATCH_ID?: BinaryBodyReference; // eslint-disable-line @typescript-eslint/naming-convention\n  BATCH_LENGTH?: number; // eslint-disable-line @typescript-eslint/naming-convention\n}\n\ntype QuantizedPntsProps = CommonPntsProps & {\n  POSITION_QUANTIZED: BinaryBodyReference; // eslint-disable-line @typescript-eslint/naming-convention\n  QUANTIZED_VOLUME_OFFSET: number[]; // eslint-disable-line @typescript-eslint/naming-convention\n  QUANTIZED_VOLUME_SCALE: number[]; // eslint-disable-line @typescript-eslint/naming-convention\n\n  POSITION?: never; // eslint-disable-line @typescript-eslint/naming-convention\n};\n\ntype UnquantizedPntsProps = CommonPntsProps & {\n  POSITION: BinaryBodyReference; // eslint-disable-line @typescript-eslint/naming-convention\n\n  POSITION_QUANTIZED?: never; // eslint-disable-line @typescript-eslint/naming-convention\n  QUANTIZED_VOLUME_OFFSET?: never; // eslint-disable-line @typescript-eslint/naming-convention\n  QUANTIZED_VOLUME_SCALE?: never; // eslint-disable-line @typescript-eslint/naming-convention\n};\n\ntype PntsProps = QuantizedPntsProps | UnquantizedPntsProps;\n\nfunction readPntsColors(stream: ByteStream, dataOffset: number, pnts: PntsProps): Uint8Array | undefined {\n  const nPts = pnts.POINTS_LENGTH;\n  const nComponents = 3 * nPts;\n  if (pnts.RGB)\n    return new Uint8Array(stream.arrayBuffer, dataOffset + pnts.RGB.byteOffset, nComponents);\n\n  if (pnts.RGBA) {\n    // ###TODO support point cloud transparency.\n    const rgb = new Uint8Array(nComponents);\n    const rgba = new Uint8Array(stream.arrayBuffer, dataOffset + pnts.RGBA.byteOffset, nComponents);\n    for (let i = 0; i < nComponents; i += 4) {\n      rgb[i + 0] = rgba[i + 0];\n      rgb[i + 1] = rgba[i + 1];\n      rgb[i + 2] = rgba[i + 2];\n    }\n\n    return rgb;\n  } else if (pnts.RGB565) {\n    // Each color is 16 bits: 5 red, 6 green, 5 blue.\n    const crgb = new Uint16Array(stream.arrayBuffer, dataOffset + pnts.RGB565.byteOffset, nPts);\n    const rgb = new Uint8Array(nComponents);\n    for (let i = 0; i < nPts; i++) {\n      const c = crgb[i];\n      rgb[i + 0] = (c >> 11) & 0x1f;\n      rgb[i + 1] = (c >> 5) & 0x3f;\n      rgb[i + 2] = c & 0x1f;\n    }\n\n    return rgb;\n  }\n\n  return undefined;\n}\n\nfunction readPnts(stream: ByteStream, dataOffset: number, pnts: PntsProps): PointCloudProps | undefined {\n  const nPts = pnts.POINTS_LENGTH;\n  let params: QParams3d;\n  let points: Uint16Array | Float32Array;\n\n  if (pnts.POSITION_QUANTIZED) {\n    const qpos = pnts.POSITION_QUANTIZED;\n    const offset = pnts.QUANTIZED_VOLUME_OFFSET;\n    const scale = pnts.QUANTIZED_VOLUME_SCALE;\n\n    const qOrigin = new Point3d(offset[0], offset[1], offset[2]);\n    const qScale = new Point3d(Quantization.computeScale(scale[0]), Quantization.computeScale(scale[1]), Quantization.computeScale(scale[2]));\n\n    params = QParams3d.fromOriginAndScale(qOrigin, qScale);\n    points = new Uint16Array(stream.arrayBuffer, dataOffset + qpos.byteOffset, 3 * nPts);\n  } else {\n    const qOrigin = new Point3d(0, 0, 0);\n    const qScale = new Point3d(1, 1, 1);\n    params = QParams3d.fromOriginAndScale(qOrigin, qScale);\n    points = new Float32Array(stream.arrayBuffer, dataOffset + pnts.POSITION.byteOffset, 3 * nPts);\n  }\n\n  const colors = readPntsColors(stream, dataOffset, pnts);\n  return { params, points, colors };\n}\n\nasync function decodeDracoPointCloud(buf: Uint8Array): Promise<PointCloudProps | undefined> {\n  try {\n    const dracoLoader = (await import(\"@loaders.gl/draco\")).DracoLoader;\n    const mesh = await dracoLoader.parse(buf, {});\n    if (mesh.topology !== \"point-list\")\n      return undefined;\n\n    const pos = mesh.attributes.POSITION?.value;\n    if (!pos || (pos.length % 3) !== 0)\n      return undefined;\n\n    let colors = mesh.attributes.RGB?.value ?? mesh.attributes.COLOR_0?.value;\n    if (!colors) {\n      // ###TODO support point cloud transparency.\n      const rgba = mesh.attributes.RGBA?.value;\n      if (rgba && (rgba.length % 4) === 0) {\n        // We currently don't support alpha channel for point clouds - strip it.\n        colors = new Uint8Array(3 * rgba.length / 4);\n        let j = 0;\n        for (let i = 0; i < rgba.length; i += 4) {\n          colors[j++] = rgba[i];\n          colors[j++] = rgba[i + 1];\n          colors[j++] = rgba[i + 2];\n        }\n      }\n    }\n\n    let posRange: Range3d;\n    const bbox = mesh.header?.boundingBox;\n    if (bbox) {\n      posRange = Range3d.createXYZXYZ(bbox[0][0], bbox[0][1], bbox[0][2], bbox[1][0], bbox[1][1], bbox[1][2]);\n    } else {\n      posRange = Range3d.createNull();\n      for (let i = 0; i < pos.length; i += 3)\n        posRange.extendXYZ(pos[i], pos[i + 1], pos[i + 2]);\n    }\n\n    const params = QParams3d.fromRange(posRange);\n    const pt = Point3d.createZero();\n    const qpt = QPoint3d.create(pt, params);\n    const points = new Uint16Array(pos.length);\n    for (let i = 0; i < pos.length; i += 3) {\n      pt.set(pos[i], pos[i + 1], pos[i + 2]);\n      qpt.init(pt, params);\n      points[i] = qpt.x;\n      points[i + 1] = qpt.y;\n      points[i + 2] = qpt.z;\n    }\n\n    return { points, params, colors: colors instanceof Uint8Array ? colors : undefined };\n  } catch (err) {\n    Logger.logWarning(FrontendLoggerCategory.Render, \"Failed to decode draco-encoded point cloud\");\n    Logger.logException(FrontendLoggerCategory.Render, err);\n    return undefined;\n  }\n}\n\n/** Deserialize a point cloud tile and return it as a RenderGraphic.\n */\nexport async function readPointCloudTileContent(stream: ByteStream, iModel: IModelConnection, modelId: Id64String, _is3d: boolean, tile: RealityTile, system: RenderSystem): Promise<{ graphic: RenderGraphic | undefined, rtcCenter: Point3d | undefined }> {\n  let graphic;\n  let rtcCenter;\n  const header = new PntsHeader(stream);\n  if (!header.isValid)\n    return { graphic, rtcCenter };\n\n  const range = tile.contentRange;\n  const featureTableJsonOffset = stream.curPos;\n  const featureStrData = stream.nextBytes(header.featureTableJsonLength);\n  const featureStr = utf8ToString(featureStrData);\n  const featureValue = JSON.parse(featureStr as string) as PntsProps;\n\n  if (undefined === featureValue)\n    return { graphic, rtcCenter };\n\n  let props: PointCloudProps | undefined;\n  const dataOffset = featureTableJsonOffset + header.featureTableJsonLength;\n  const draco = featureValue.extensions ? featureValue.extensions[\"3DTILES_draco_point_compression\"] : undefined;\n  if (draco) {\n    try {\n      const buf = new Uint8Array(stream.arrayBuffer, dataOffset + draco.byteOffset, draco.byteLength);\n      props = await decodeDracoPointCloud(buf);\n    } catch {\n      //\n    }\n  } else {\n    props = readPnts(stream, dataOffset, featureValue);\n  }\n\n  if (!props)\n    return { graphic, rtcCenter };\n\n  let batchRange = range;\n  if (featureValue.RTC_CENTER) {\n    rtcCenter = Point3d.fromJSON(featureValue.RTC_CENTER);\n    batchRange = range.clone();\n    batchRange.low.minus(rtcCenter, batchRange.low);\n    batchRange.high.minus(rtcCenter, batchRange.high);\n  }\n\n  if (!props.colors) {\n    // ###TODO we really should support uniform color instead of allocating an RGB value per point...\n    props.colors = new Uint8Array(3 * featureValue.POINTS_LENGTH);\n    const rgba = featureValue.CONSTANT_RGBA;\n    if (rgba) {\n      // ###TODO support point cloud transparency.\n      for (let i = 0; i < featureValue.POINTS_LENGTH * 3; i += 3) {\n        props.colors[i] = rgba[0];\n        props.colors[i + 1] = rgba[1];\n        props.colors[i + 2] = rgba[2];\n      }\n    } else {\n      // Default to white.\n      props.colors.fill(0xff, 0, props.colors.length);\n    }\n  }\n\n  const featureTable = new FeatureTable(1, modelId, BatchType.Primary);\n  const features = new Mesh.Features(featureTable);\n  features.add(new Feature(modelId), 1);\n  let params = props.params;\n  if (props.points instanceof Float32Array) {\n    // we don't have a true range for unquantized points, so calc one here for voxelSize\n    const rng = Range3d.createNull();\n    for (let i = 0; i < props.points.length; i += 3)\n      rng.extendXYZ(props.points[i], props.points[i + 1], props.points[i + 2]);\n    params = QParams3d.fromRange(rng);\n  }\n  // 256 here is tile.maximumSize (on non-additive refinement tiles)\n  // If additiveRefinement, set voxelSize to 0 which will cause it draw to with minPixelsPerVoxel, which defaults to 2\n  // That way, it will draw as if in pixel mode, and voxelScale will still function\n  // Checking across a variety of 10 point clouds, 2 to 4 seems to work well for pixel settings (depending on the\n  // cloud), so 2 is a decent default\n  // (If voxelSize is used normally in this case, it draws different size pixels for different tiles, and since\n  // they can overlap ranges, no good way found to calculate a voxelSize)\n  const voxelSize = tile.additiveRefinement ? 0 : params.rangeDiagonal.maxAbs() / 256;\n\n  graphic = system.createPointCloud({\n    positions: props.points,\n    qparams: props.params,\n    colors: props.colors,\n    features: features.toFeatureIndex(),\n    voxelSize,\n    colorFormat: \"rgb\",\n  }, iModel) as RenderGraphic;\n\n  graphic = system.createBatch(graphic, PackedFeatureTable.pack(featureTable), batchRange);\n  return { graphic, rtcCenter };\n}\n"]}

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

@@ -0,0 +1,106 @@
+/** @packageDocumentation
+ * @module Tiles
+ */
+import { Id64String, OrderedId64Iterable } from "@itwin/core-bentley";
+import { FeatureAppearanceProvider, HiddenLine, MapLayerSettings, ModelMapLayerSettings, PrimaryTileTreeId, RenderSchedule, SpatialClassifier, ViewFlagOverrides, ViewFlagsProperties } from "@itwin/core-common";
+import { Range3d, StringifiedClipVector, Transform } from "@itwin/core-geometry";
+import { DisplayStyleState } from "../../DisplayStyleState";
+import { IModelConnection } from "../../IModelConnection";
+import { GeometricModelState } from "../../ModelState";
+import { RenderClipVolume } from "../../render/RenderClipVolume";
+import { SpatialViewState } from "../../SpatialViewState";
+import { SceneContext } from "../../ViewContext";
+import { AttachToViewportArgs, ViewState } from "../../ViewState";
+import { MapLayerTileTreeReference, TileDrawArgs, TileTree, TileTreeOwner, TileTreeReference } from "../../tile/internal";
+interface PrimaryTreeId {
+    treeId: PrimaryTileTreeId;
+    modelId: Id64String;
+    is3d: boolean;
+    isPlanProjection: boolean;
+    timeline?: RenderSchedule.ModelTimeline;
+}
+/** Find all extant tile trees associated with the specified model Ids and dispose of them.
+ * This is used by BriefcaseConnection when a GraphicalEditingScope is exited or after a change to the models' geometry guids
+ * is committed, undone, redone, or merged.
+ */
+export declare function disposeTileTreesForGeometricModels(modelIds: Set<Id64String>, iModel: IModelConnection): void;
+declare class PrimaryTreeReference extends TileTreeReference {
+    readonly view: ViewState;
+    readonly model: GeometricModelState;
+    /** Chiefly for debugging - disables iteration of this reference in SpatialModelRefs to e.g. omit the reference from the scene. */
+    deactivated: boolean;
+    protected _viewFlagOverrides: ViewFlagOverrides;
+    protected _id: PrimaryTreeId;
+    private _owner;
+    private readonly _sectionClip?;
+    private readonly _sectionCutAppearanceProvider?;
+    protected readonly _animationTransformNodeId?: number;
+    constructor(view: ViewState, model: GeometricModelState, planProjection: boolean, transformNodeId: number | undefined, sectionClip?: StringifiedClipVector);
+    protected getAnimationTransformNodeId(): number;
+    protected getViewFlagOverrides(_tree: TileTree): Partial<import("@itwin/core-bentley").Mutable<import("@itwin/core-bentley").NonFunctionPropertiesOf<import("@itwin/core-common").ViewFlags>>>;
+    protected getAppearanceProvider(_tree: TileTree): FeatureAppearanceProvider | undefined;
+    protected getHiddenLineSettings(_tree: TileTree): HiddenLine.Settings | undefined;
+    get castsShadows(): boolean;
+    protected get isPlanProjection(): boolean;
+    protected getClipVolume(_tree: TileTree): RenderClipVolume | undefined;
+    canSupplyToolTip(): boolean;
+    createDrawArgs(context: SceneContext): TileDrawArgs | undefined;
+    get treeOwner(): TileTreeOwner;
+    protected createTreeId(view: ViewState, modelId: Id64String): PrimaryTileTreeId;
+    protected computeBaseTransform(tree: TileTree): Transform;
+    protected computeTransform(tree: TileTree): Transform;
+}
+export declare class AnimatedTreeReference extends PrimaryTreeReference {
+    private readonly _branchId;
+    constructor(view: ViewState, model: GeometricModelState, transformNodeId: number);
+    protected computeBaseTransform(tree: TileTree): Transform;
+    createDrawArgs(context: SceneContext): TileDrawArgs | undefined;
+}
+export declare function createPrimaryTileTreeReference(view: ViewState, model: GeometricModelState): PrimaryTreeReference;
+export declare function createMaskTreeReference(view: ViewState, model: GeometricModelState): TileTreeReference;
+export declare class ModelMapLayerTileTreeReference extends MapLayerTileTreeReference {
+    private _classifier;
+    private _source?;
+    private _id;
+    private _owner;
+    get isPlanar(): boolean;
+    get activeClassifier(): SpatialClassifier;
+    constructor(layerSettings: MapLayerSettings, _classifier: SpatialClassifier, layerIndex: number, iModel: IModelConnection, _source?: DisplayStyleState | undefined);
+    protected createTreeId(): PrimaryTileTreeId;
+    get treeOwner(): TileTreeOwner;
+    get viewFlags(): Partial<ViewFlagsProperties>;
+}
+export declare function createModelMapLayerTileTreeReference(layerSettings: ModelMapLayerSettings, layerIndex: number, iModel: IModelConnection): ModelMapLayerTileTreeReference | undefined;
+/** Provides [[TileTreeReference]]s for the loaded models present in a [[SpatialViewState]]'s [[ModelSelectorState]].
+ * @internal
+ */
+export interface SpatialTileTreeReferences extends Iterable<TileTreeReference> {
+    /** Supplies an iterator over all of the [[TileTreeReference]]s. */
+    [Symbol.iterator](): Iterator<TileTreeReference>;
+    /** Requests that the set of [[TileTreeReference]]s be updated to match the current state of the view, e.g., after the model selector's contents have changed. */
+    update(): void;
+    /** See SpatialViewState.setTileTreeReferencesDeactivated. */
+    setDeactivated(modelIds: Id64String | Id64String[] | undefined, deactivated: boolean | undefined, refs: "all" | "animated" | "primary" | "section" | number[]): void;
+    /** See SpatialViewState.attachToViewport. */
+    attachToViewport(args: AttachToViewportArgs): void;
+    /** See SpatialViewState.detachFromViewport. */
+    detachFromViewport(): void;
+    /** See SpatialViewState.collectMaskRefs */
+    collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void;
+    /** See SpatialViewState.getModelsNotInMask */
+    getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined;
+}
+/** Provides [[TileTreeReference]]s for the loaded models present in a [[SpatialViewState]]'s [[ModelSelectorState]] and
+ * not present in the optionally-supplied exclusion list.
+ * @internal
+ */
+export declare function createSpatialTileTreeReferences(view: SpatialViewState, excludedModels?: Set<Id64String>): SpatialTileTreeReferences;
+/** Provides [[TileTreeReference]]s for the loaded models present in a [[SpatialViewState]]'s [[ModelSelectorState]].
+ * @internal
+ */
+export declare namespace SpatialTileTreeReferences {
+    /** Create a SpatialTileTreeReferences object reflecting the contents of the specified view. */
+    function create(view: SpatialViewState): SpatialTileTreeReferences;
+}
+export {};
+//# sourceMappingURL=PrimaryTileTree.d.ts.map

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

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