@cognite/reveal 2.2.2 → 3.0.0-alpha.0

package/packages/cad-styling/src/NodeAppearance.d.ts

@@ -1,62 +1,85 @@
-/*!
- * Copyright 2021 Cognite AS
- */
-export declare enum NodeOutlineColor {
-    NoOutline = 0,
-    White = 1,
-    Black = 2,
-    Cyan = 3,
-    Blue = 4,
-    Green = 5,
-    Red = 6,
-    Orange = 7
-}
-/**
- * Type for defining node appearance profiles to style a 3D CAD model.
- * @see {@link DefaultNodeAppearance}
- */
-export declare type NodeAppearance = {
-    /**
-     * Overrides the default color of the node in RGB. Each component
-     * is in range [0, 255]. `[0, 0, 0]` means no override.
-     */
-    readonly color?: [number, number, number];
-    /**
-     * Overrides the visibility of the node.
-     */
-    readonly visible?: boolean;
-    /**
-     * When set to true, the node is rendered in front
-     * of all other nodes even if it's occluded.
-     * Note that this take precedence over {@link renderGhosted}.
-     */
-    readonly renderInFront?: boolean;
-    /**
-     * When set to true, the node is rendered ghosted, i.e.
-     * transparent with a fixed color. This has no effect if {@link renderInFront}
-     * is `true`.
-     */
-    readonly renderGhosted?: boolean;
-    /**
-     * When set, an outline is drawn around the
-     * node to make it stand out.
-     */
-    readonly outlineColor?: NodeOutlineColor;
-};
-/**
- * A set of default node appearances used in Reveal.
- */
-export declare const DefaultNodeAppearance: {
-    Default: NodeAppearance;
-    Outlined: NodeAppearance;
-    Hidden: NodeAppearance;
-    InFront: NodeAppearance;
-    Ghosted: NodeAppearance;
-    Highlighted: {
-        color?: [number, number, number] | undefined;
-        visible?: boolean | undefined;
-        renderInFront?: boolean | undefined;
-        renderGhosted?: boolean | undefined;
-        outlineColor?: NodeOutlineColor | undefined;
-    };
-};
+/*!
+ * Copyright 2021 Cognite AS
+ */
+export declare enum NodeOutlineColor {
+    NoOutline = 0,
+    White = 1,
+    Black = 2,
+    Cyan = 3,
+    Blue = 4,
+    Green = 5,
+    Red = 6,
+    Orange = 7
+}
+/**
+ * Type for defining node appearance profiles to style a 3D CAD model.
+ * @see {@link DefaultNodeAppearance}
+ */
+export declare type NodeAppearance = {
+    /**
+     * Overrides the default color of the node in RGB. Each component
+     * is in range [0, 255]. `[0, 0, 0]` means no override.
+     */
+    readonly color?: [number, number, number];
+    /**
+     * Overrides the visibility of the node.
+     */
+    readonly visible?: boolean;
+    /**
+     * When set to true, the node is rendered in front
+     * of all other nodes even if it's occluded.
+     * Note that this take precedence over {@link renderGhosted}.
+     */
+    readonly renderInFront?: boolean;
+    /**
+     * When set to true, the node is rendered ghosted, i.e.
+     * transparent with a fixed color. This has no effect if {@link renderInFront}
+     * is `true`.
+     */
+    readonly renderGhosted?: boolean;
+    /**
+     * When set, an outline is drawn around the
+     * node to make it stand out.
+     */
+    readonly outlineColor?: NodeOutlineColor;
+    /**
+     * When provided, this value can be used to prioritize certain areas of the
+     * 3D model to be loaded. This can be useful to prioritize key objects in the
+     * 3D model to always be loaded.
+     *
+     * When non-zero, sectors containing geometry in the vicinity of the prioritized
+     * sectors are given an *extra* priority. Recommended values are in range 1 (somewhat
+     * higher priority to be loaded) to 10 (very likely to be loaded). Usually values around 4-5
+     * is recommended.
+     *
+     * Prioritized nodes are loaded at the expense of non-prioritized areas. There are no
+     * guarantees that the nodes are actually loaded, and the more prioritized areas/nodes
+     * provided, the less likely it is that the hint is obeyed.
+     *
+     * Extra priority doesn't accumulate when sectors are prioritized because they intersect/contain
+     * several nodes.
+     *
+     * **This is an advanced feature and not recommended for most users**
+     *
+     * @version Only works with 3D models converted later than Q4 2021.
+     */
+    readonly prioritizedForLoadingHint?: number;
+};
+/**
+ * A set of default node appearances used in Reveal.
+ */
+export declare const DefaultNodeAppearance: {
+    Default: NodeAppearance;
+    Outlined: NodeAppearance;
+    Hidden: NodeAppearance;
+    InFront: NodeAppearance;
+    Ghosted: NodeAppearance;
+    Highlighted: {
+        color?: [number, number, number] | undefined;
+        visible?: boolean | undefined;
+        renderInFront?: boolean | undefined;
+        renderGhosted?: boolean | undefined;
+        outlineColor?: NodeOutlineColor | undefined;
+        prioritizedForLoadingHint?: number | undefined;
+    };
+};

package/packages/cad-styling/src/NodeAppearanceProvider.d.ts

@@ -1,33 +1,36 @@
-/*!
- * Copyright 2021 Cognite AS
- */
-import { NodeAppearance } from './NodeAppearance';
-import { NodeCollectionBase } from './NodeCollectionBase';
-import { IndexSet } from '../../utilities';
-/**
- * Delegate for applying styles in {@see NodeStyleProvider}.
- * @param treeIndices Set of tree indices that the style is applied to.
- * @param appearance  Style to be applied to the nodes.
- */
-export declare type ApplyStyleDelegate = (treeIndices: IndexSet, appearance: NodeAppearance) => void;
-export declare class NodeAppearanceProvider {
-    private readonly _styledCollections;
-    private _lastFiredLoadingState?;
-    private readonly _events;
-    on(event: 'changed', listener: () => void): void;
-    on(event: 'loadingStateChanged', listener: (isLoading: boolean) => void): void;
-    off(event: 'changed', listener: () => void): void;
-    off(event: 'loadingStateChanged', listener: (isLoading: boolean) => void): void;
-    assignStyledNodeCollection(nodeCollection: NodeCollectionBase, appearance: NodeAppearance): void;
-    unassignStyledNodeCollection(nodeCollection: NodeCollectionBase): void;
-    applyStyles(applyCb: ApplyStyleDelegate): void;
-    clear(): void;
-    get isLoading(): boolean;
-    private notifyChanged;
-    /**
-     * Schedules event 'changed' to trigger at the next tick.
-     */
-    private readonly scheduleNotifyChanged;
-    private notifyLoadingStateChanged;
-    private handleNodeCollectionChanged;
-}
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import { NodeAppearance } from './NodeAppearance';
+import { NodeCollectionBase } from './NodeCollectionBase';
+import { IndexSet } from '../../utilities';
+import { PrioritizedArea } from './prioritized/types';
+/**
+ * Delegate for applying styles in {@see NodeStyleProvider}.
+ * @param treeIndices Set of tree indices that the style is applied to.
+ * @param appearance  Style to be applied to the nodes.
+ */
+export declare type ApplyStyleDelegate = (treeIndices: IndexSet, appearance: NodeAppearance) => void;
+export declare class NodeAppearanceProvider {
+    private readonly _styledCollections;
+    private _lastFiredLoadingState?;
+    private _cachedPrioritizedAreas?;
+    private readonly _events;
+    on(event: 'changed', listener: () => void): void;
+    on(event: 'loadingStateChanged', listener: (isLoading: boolean) => void): void;
+    off(event: 'changed', listener: () => void): void;
+    off(event: 'loadingStateChanged', listener: (isLoading: boolean) => void): void;
+    assignStyledNodeCollection(nodeCollection: NodeCollectionBase, appearance: NodeAppearance): void;
+    unassignStyledNodeCollection(nodeCollection: NodeCollectionBase): void;
+    applyStyles(applyCb: ApplyStyleDelegate): void;
+    getPrioritizedAreas(): PrioritizedArea[];
+    clear(): void;
+    get isLoading(): boolean;
+    private notifyChanged;
+    /**
+     * Schedules event 'changed' to trigger at the next tick.
+     */
+    private readonly scheduleNotifyChanged;
+    private notifyLoadingStateChanged;
+    private handleNodeCollectionChanged;
+}

package/packages/cad-styling/src/NodeCollectionBase.d.ts

@@ -1,47 +1,54 @@
-/*!
- * Copyright 2021 Cognite AS
- */
-import { IndexSet } from '../../utilities';
-export declare type SerializedNodeCollection = {
-    token: string;
-    state: any;
-    options?: any;
-};
-/**
- * Abstract class for implementing a set of nodes to be styled.
- */
-export declare abstract class NodeCollectionBase {
-    private readonly _changedEvent;
-    private readonly _classToken;
-    protected constructor(classToken: string);
-    get classToken(): string;
-    /**
-     * Subscribe a listener to events about the set changing, i.e.
-     * when nodes are added or removed to the set.
-     */
-    on(event: 'changed', listener: () => void): void;
-    /**
-     * Unsubscribe a listener to events about the set changing, i.e.
-     * when nodes are added or removed to the set.
-     */
-    off(event: 'changed', listener: () => void): void;
-    /**
-     * Returns true when the set currently is running an operation
-     * for loading the full set of nodes contained by the set.
-     */
-    abstract get isLoading(): boolean;
-    /**
-     * Returns the {@link IndexSet} that holds the tree indices
-     * of the nodes contained by the set.
-     */
-    abstract getIndexSet(): IndexSet;
-    /**
-     * Clears the set, making it empty.
-     */
-    abstract clear(): void;
-    /**
-     * Triggers the changed-event.
-     */
-    protected notifyChanged(): void;
-    abstract serialize(): SerializedNodeCollection;
-}
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import { IndexSet } from '../../utilities';
+import { AreaCollection } from './prioritized/AreaCollection';
+export declare type SerializedNodeCollection = {
+    token: string;
+    state: any;
+    options?: any;
+};
+/**
+ * Abstract class for implementing a set of nodes to be styled.
+ */
+export declare abstract class NodeCollectionBase {
+    private readonly _changedEvent;
+    private readonly _classToken;
+    protected constructor(classToken: string);
+    get classToken(): string;
+    /**
+     * Subscribe a listener to events about the set changing, i.e.
+     * when nodes are added or removed to the set.
+     */
+    on(event: 'changed', listener: () => void): void;
+    /**
+     * Unsubscribe a listener to events about the set changing, i.e.
+     * when nodes are added or removed to the set.
+     */
+    off(event: 'changed', listener: () => void): void;
+    /**
+     * Returns true when the set currently is running an operation
+     * for loading the full set of nodes contained by the set.
+     */
+    abstract get isLoading(): boolean;
+    /**
+     * Returns the {@link IndexSet} that holds the tree indices
+     * of the nodes contained by the set.
+     */
+    abstract getIndexSet(): IndexSet;
+    /**
+     * Returns a set of areas that together contain all the nodes
+     * in the node collection. Note that this not necessarily is a minimum
+     * set of encapsulating areas.
+     */
+    abstract getAreas(): AreaCollection;
+    /**
+     * Clears the set, making it empty.
+     */
+    abstract clear(): void;
+    /**
+     * Triggers the changed-event.
+     */
+    protected notifyChanged(): void;
+    abstract serialize(): SerializedNodeCollection;
+}

package/packages/cad-styling/src/TreeIndexNodeCollection.d.ts

@@ -1,23 +1,39 @@
-/*!
- * Copyright 2021 Cognite AS
- */
-import { NumericRange, IndexSet } from '../../utilities';
-import { NodeCollectionBase, SerializedNodeCollection } from './NodeCollectionBase';
-/**
- * Node collection that holds a set of nodes defined by a set of tree indices.
- */
-export declare class TreeIndexNodeCollection extends NodeCollectionBase {
-    static readonly classToken = "TreeIndexNodeCollection";
-    private _treeIndices;
-    constructor(treeIndexSet?: IndexSet);
-    constructor(treeIndices?: Iterable<number>);
-    constructor(treeIndexRange?: NumericRange);
-    updateSet(treeIndices: IndexSet): void;
-    /**
-     * Sets this set to hold an empty set.
-     */
-    clear(): void;
-    getIndexSet(): IndexSet;
-    get isLoading(): boolean;
-    serialize(): SerializedNodeCollection;
-}
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import * as THREE from 'three';
+import { AreaCollection } from './prioritized/AreaCollection';
+import { NodeCollectionBase, SerializedNodeCollection } from './NodeCollectionBase';
+import { NumericRange, IndexSet } from '../../utilities';
+/**
+ * Node collection that holds a set of nodes defined by a set of tree indices.
+ */
+export declare class TreeIndexNodeCollection extends NodeCollectionBase {
+    static readonly classToken = "TreeIndexNodeCollection";
+    private _treeIndices;
+    private _areaCollection;
+    constructor(treeIndexSet?: IndexSet);
+    constructor(treeIndices?: Iterable<number>);
+    constructor(treeIndexRange?: NumericRange);
+    updateSet(treeIndices: IndexSet): void;
+    /**
+     * Sets this set to hold an empty set.
+     */
+    clear(): void;
+    getIndexSet(): IndexSet;
+    getAreas(): AreaCollection;
+    /**
+     * Add areas to this node collection's area set.
+     * Nearby areas may be clustered and merged together to keep
+     * the number of areas in the set small.
+     */
+    addAreas(areas: THREE.Box3[]): void;
+    /**
+     * Add points to this node collection's area set.
+     * This effectively adds boxes of size 1x1x1 meter with the points as their centers.
+     */
+    addAreaPoints(points: THREE.Vector3[]): void;
+    clearAreas(): void;
+    get isLoading(): boolean;
+    serialize(): SerializedNodeCollection;
+}

package/packages/cad-styling/src/UnionNodeCollection.d.ts

@@ -1,15 +1,18 @@
-/*!
- * Copyright 2021 Cognite AS
- */
-import { NodeCollectionBase, SerializedNodeCollection } from './NodeCollectionBase';
-import { CombineNodeCollectionBase } from './CombineNodeCollectionBase';
-import { IndexSet } from '../../utilities';
-/**
- * Node collection that takes the set union of multiple node collections.
- */
-export declare class UnionNodeCollection extends CombineNodeCollectionBase {
-    static readonly classToken = "UnionNodeCollection";
-    constructor(nodeCollections?: NodeCollectionBase[]);
-    serialize(): SerializedNodeCollection;
-    protected createCombinedIndexSet(): IndexSet;
-}
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import { NodeCollectionBase, SerializedNodeCollection } from './NodeCollectionBase';
+import { CombineNodeCollectionBase } from './CombineNodeCollectionBase';
+import { AreaCollection } from './prioritized/AreaCollection';
+import { IndexSet } from '../../utilities';
+/**
+ * Node collection that takes the set union of multiple node collections.
+ */
+export declare class UnionNodeCollection extends CombineNodeCollectionBase {
+    private _cachedNodeAreas;
+    static readonly classToken = "UnionNodeCollection";
+    constructor(nodeCollections?: NodeCollectionBase[]);
+    serialize(): SerializedNodeCollection;
+    protected createCombinedIndexSet(): IndexSet;
+    getAreas(): AreaCollection;
+}

package/packages/cad-styling/src/prioritized/AreaCollection.d.ts

@@ -0,0 +1,39 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+/**
+ * Represents a collection of areas/axis-aligned
+ * bounding boxes for use e.g. for load prioritization. Implementations
+ * are not expected to store all areas inserted with `addAreas`,
+ * but rather some "representative box set" covering the inserted areas.
+ * Performance will be better the fewer boxes the representative set contains,
+ * while the effectiveness of node prioritization will suffer if the
+ * representative set covers too much area that is not part
+ * of the inserted boxes
+ */
+export interface AreaCollection {
+    readonly isEmpty: boolean;
+    /**
+     * Return some set of boxes that cover the boxes inserted with `addAreas`.
+     * It is required that each inserted box is completely covered by some
+     * subset of boxes in the set returned from `areas`
+     */
+    areas(): Generator<THREE.Box3>;
+    /**
+     * Return whether the input box intersects the AreaCollection.
+     */
+    intersectsBox(box: THREE.Box3): boolean;
+    /**
+     * Add areas to be covered by the representative set of this
+     * AreaCollection.
+     */
+    addAreas(boxes: Iterable<THREE.Box3>): void;
+    /**
+     * Alter the representative set to cover only the intersection between the
+     * representative set of this AreaCollection and the incoming boxes.
+     * Note that the intersection of two representative sets A' and B' that
+     * represent the original box sets A and B will cover the intersection between
+     * A and B, and will thus be a valid representative set for the intersection of A and B.
+     */
+    intersectWith(boxes: Iterable<THREE.Box3>): void;
+}

package/packages/cad-styling/src/prioritized/BoxClusterer.d.ts

@@ -0,0 +1,29 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import { Box3 } from 'three';
+/**
+ * SmartMergeBoxes - takes in batches of bounding boxes and
+ * clusters them together in larger bounding boxes. The union of the larger
+ * boxes contains all boxes that have been inserted
+ */
+export declare class BoxClusterer {
+    private readonly resultBoxes;
+    private addedSinceSquash;
+    constructor();
+    constructor(boxes: Box3[]);
+    private mergeBoxesAtIndices;
+    private readonly _surfaceAreaVars;
+    private surfaceArea;
+    private readonly _shouldMergeBoxesVars;
+    private shouldMergeBoxes;
+    private addBox;
+    get boxCount(): number;
+    addBoxes(boxes: Iterable<Box3>): void;
+    squashBoxes(): void;
+    getBoxes(): Generator<Box3>;
+    intersectsBox(box: Box3): boolean;
+    union(boxes: Iterable<Box3>): BoxClusterer;
+    private addIntersectionIfNonempty;
+    intersection(other: Iterable<THREE.Box3>): BoxClusterer;
+}

package/packages/cad-styling/src/prioritized/ClusteredAreaCollection.d.ts

@@ -0,0 +1,17 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import { AreaCollection } from './AreaCollection';
+/**
+ * AreaCollection that stores a representative box set by merging
+ * inserted boxes that are overlapping or close to each other.
+ * It uses simple heuristics to determine which boxes are to be merged.
+ */
+export declare class ClusteredAreaCollection implements AreaCollection {
+    private readonly _clusterer;
+    get isEmpty(): boolean;
+    areas(): Generator<THREE.Box3>;
+    intersectsBox(box: THREE.Box3): boolean;
+    addAreas(boxes: Iterable<THREE.Box3>): void;
+    intersectWith(boxes: Iterable<THREE.Box3>): void;
+}

package/packages/cad-styling/src/prioritized/EmptyAreaCollection.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import { AreaCollection } from './AreaCollection';
+/**
+ * Convenience implementation to represent an empty collection of areas.
+ * that can be shared among several instances.
+ */
+export declare class EmptyAreaCollection implements AreaCollection {
+    private static _instance;
+    static instance(): AreaCollection;
+    private constructor();
+    areas(): Generator<THREE.Box3>;
+    intersectsBox(_box: THREE.Box3): boolean;
+    addAreas(_: Iterable<THREE.Box3>): void;
+    intersectWith(_: Iterable<THREE.Box3>): void;
+    get isEmpty(): boolean;
+}

package/packages/cad-styling/src/prioritized/types.d.ts

@@ -0,0 +1,7 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+export declare type PrioritizedArea = {
+    area: THREE.Box3;
+    extraPriority: number;
+};

package/packages/camera-manager/index.d.ts

@@ -1,4 +1,6 @@
-/*!
- * Copyright 2021 Cognite AS
- */
-export { default } from './src/ComboControls';
+/*!
+ * Copyright 2021 Cognite AS
+ */
+export { ComboControls } from './src/ComboControls';
+export { CameraManager } from './src/CameraManager';
+export * from './src/types';

package/packages/camera-manager/src/CameraManager.d.ts

@@ -0,0 +1,84 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import * as THREE from 'three';
+import { ComboControls } from './ComboControls';
+import { CameraManagerCallbackData, CameraControlsOptions, CameraChangeData, ControlsState } from './types';
+export declare class CameraManager {
+    private readonly _events;
+    private readonly _controls;
+    private readonly _camera;
+    private readonly _domElement;
+    private readonly _inputHandler;
+    private readonly _raycaster;
+    private isDisposed;
+    private readonly _modelRaycastCallback;
+    private _onClick;
+    private _onWheel;
+    private static readonly DefaultAnimationDuration;
+    private static readonly DefaultMinAnimationDuration;
+    private static readonly DefaultMaxAnimationDuration;
+    private static readonly DefaultMinDistance;
+    private static readonly DefaultMinZoomDistance;
+    private static readonly DefaultMinimalTimeBetweenRaycasts;
+    private static readonly DefaultCameraControlsOptions;
+    private _cameraControlsOptions;
+    automaticNearFarPlane: boolean;
+    automaticControlsSensitivity: boolean;
+    /**
+     * Reusable buffers used by functions in Cognite3dViewer to avoid allocations.
+     */
+    private readonly _updateNearAndFarPlaneBuffers;
+    private readonly _calculateCameraFarBuffers;
+    constructor(camera: THREE.PerspectiveCamera, domElement: HTMLElement, raycastFunction: (x: number, y: number) => Promise<CameraManagerCallbackData>);
+    on(event: 'cameraChange', callback: CameraChangeData): void;
+    off(event: 'cameraChange', callback: CameraChangeData): void;
+    fitCameraToBoundingBox(box: THREE.Box3, duration?: number, radiusFactor?: number): void;
+    set cameraControlsEnabled(enabled: boolean);
+    get cameraControlsEnabled(): boolean;
+    set keyboardNavigationEnabled(enabled: boolean);
+    get keyboardNavigationEnabled(): boolean;
+    get cameraControls(): ComboControls;
+    setCameraTarget(target: THREE.Vector3, animated?: boolean): void;
+    setCameraControlsState(controlsState: ControlsState): void;
+    getCameraControlsState(): ControlsState;
+    getCameraControlsOptions(): CameraControlsOptions;
+    setCameraControlsOptions(controlsOptions: CameraControlsOptions): void;
+    moveCameraTo(position: THREE.Vector3, target: THREE.Vector3, duration?: number): void;
+    moveCameraTargetTo(target: THREE.Vector3, duration?: number): void;
+    updateCameraNearAndFar(camera: THREE.PerspectiveCamera, combinedBbox: THREE.Box3): void;
+    updateCameraControlsState(deltaTime: number): void;
+    dispose(): void;
+    private calculateAnimationStartTarget;
+    private createTweenAnimation;
+    private calculateCameraFar;
+    private calculateCameraNear;
+    /**
+     * Calculates new target when raycaster doesn't have any intersections with the model.
+     * @param cursorPosition Cursor position for desired calculations.
+     * @param cursorPosition.x
+     * @param cursorPosition.y
+     */
+    private calculateNewTargetWithoutModel;
+    /**
+     * Calculates new camera target based on cursor position.
+     * @param event MouseEvent that contains pointer location data.
+     */
+    private calculateNewTarget;
+    /**
+     * Removes controls event listeners if they are defined.
+     */
+    private teardownControls;
+    private handleMouseWheelActionChange;
+    /**
+     * Method for setting up camera controls listeners and values inside current controls class.
+     */
+    private setupControls;
+    /**
+     * Convert pixel coordinates of the cursor to [-1,1]^2 coordinates.
+     * @param pixelX
+     * @param pixelY
+     */
+    private convertPixelCoordinatesToNormalized;
+    private calculateDefaultDuration;
+}