@cognite/reveal 4.28.6-dev.20260105 → 4.28.6-dev.20260107

package/dist/packages/3d-overlays/src/IconOctree.d.ts

@@ -2,15 +2,66 @@
  * Copyright 2023 Cognite AS
  */
 import { Node, PointOctant, PointOctree } from 'sparse-octree';
-import { Box3, Matrix4 } from 'three';
+import { Box3, Matrix4, Vector3 } from 'three';
 import { Overlay3DIcon } from './Overlay3DIcon';
 import { DefaultOverlay3DContentType } from './OverlayCollection';
 export declare class IconOctree<ContentType = DefaultOverlay3DContentType> extends PointOctree<Overlay3DIcon<ContentType>> {
     private readonly _nodeCenters;
+    private readonly _distanceBoxChecker;
     static getMinimalOctreeBoundsFromIcons<ContentType>(icons: Overlay3DIcon<ContentType>[]): Box3;
     constructor(icons: Overlay3DIcon<ContentType>[], bounds: Box3, maxLeafSize: number);
     getNodeIcon(node: Node): Overlay3DIcon | undefined;
+    /**
+     * Get all icons from a node's subtree recursively
+     * @param node - The octree node to get icons from
+     * @returns Array of Overlay3DIcons contained in the node's subtree
+     */
+    getAllIconsFromNode(node: Node): Overlay3DIcon<ContentType>[];
+    /**
+     * Check if a node or any of its descendants exists in the given set
+     * @param node - The octree node to check
+     * @param nodeSet - Set of nodes to check against
+     * @returns True if the node or any descendant is in the set, false otherwise
+     */
+    hasDescendantInSet(node: Node, nodeSet: Set<Node>): boolean;
+    /**
+     * Get LOD nodes based on projected screen area.
+     * Nodes with projected area above the threshold are expanded,
+     * while those below are selected as LOD representatives.
+     * @param areaThreshold - Screen area threshold (0 to 1) for LOD selection
+     * @param projection - View projection matrix
+     * @param minimumLevel - Minimum octree level to expand to (default: 0)
+     * @returns Set of PointOctant nodes selected for LOD based on screen area
+     */
     getLODByScreenArea(areaThreshold: number, projection: Matrix4, minimumLevel?: number): Set<PointOctant<Overlay3DIcon>>;
+    /**
+     * Get LOD nodes based purely on camera distance.
+     * This provides consistent behavior regardless of view angle.
+     *
+     * @param cameraPosition - Camera position in model space
+     * @param distanceThreshold - Distance from camera within which all icons are shown (no clustering)
+     * @param clusteringLevel - The octree level at which to cluster far icons (higher = finer clusters)
+     * @returns Set of PointOctant nodes selected for LOD based on distance
+     */
+    getLODByDistance(cameraPosition: Vector3 | undefined, distanceThreshold: number, clusteringLevel?: number): Set<PointOctant<Overlay3DIcon>>;
+    /**
+     * Get all icons from a node's subtree that are within the given distance from a point.
+     * Also returns the representative icon if no close icons are found (for clustering).
+     *
+     * @param node - The octree node to get icons from
+     * @param cameraPosition - Camera position for distance calculation
+     * @param distanceThreshold - Distance threshold for "close" icons
+     * @returns Object containing close icons and whether to show representative
+     */
+    getIconsFromClusteredNode(node: Node, cameraPosition: Vector3, distanceThreshold: number): Overlay3DIcon<ContentType | DefaultOverlay3DContentType>[];
+    /**
+     * Check if any icon in the node's subtree is within the given distance from a point
+     * @param node - The octree node to check
+     * @param point - The point to measure distance from
+     * @param distance - Distance threshold
+     * @returns True if any icon is within distance, false otherwise
+     */
+    private isNodeWithinDistance;
     private populateNodeCenters;
     private filterEmptyLeaves;
     private hasChildren;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognite/reveal",
-  "version": "4.28.6-dev.20260105",
+  "version": "4.28.6-dev.20260107",
   "description": "WebGL based 3D viewer for CAD and point clouds processed in Cognite Data Fusion.",
   "homepage": "https://github.com/cognitedata/reveal/tree/master/viewer",
   "repository": {