@cognite/reveal 4.0.0-dev.20221123 → 4.0.0-dev.20221125

package/dist/packages/360-images/index.d.ts

@@ -4,3 +4,4 @@
 export { Image360Facade } from './src/Image360Facade';
 export { Image360EntityFactory } from './src/Image360EntityFactory';
 export { Image360Entity } from './src/Image360Entity';
+export { Image360Visualization } from './src/Image360Visualization';

package/dist/packages/360-images/src/Image360Entity.d.ts

@@ -5,16 +5,15 @@ import * as THREE from 'three';
 import { SceneHandler } from '../../utilities';
 import { Image360Descriptor, Image360FileProvider } from '../../data-providers';
 import { Image360Icon } from './Image360Icon';
+import { Image360Visualization } from './Image360Visualization';
 export declare class Image360Entity {
     private readonly _imageProvider;
     private readonly _image360Metadata;
-    private readonly _sceneHandler;
     private readonly _transform;
     private readonly _image360Icon;
-    private _faceMaterials;
-    private _imageContainer;
+    private readonly _image360VisualzationBox;
     /**
-     * Get the model-to-world transformation matrix
+     * Get a copy of the model-to-world transformation matrix
      * of the given 360 image.
      * @returns model-to-world transform of the 360 Image
      */
@@ -26,21 +25,23 @@ export declare class Image360Entity {
      */
     get icon(): Image360Icon;
     /**
-     * Sets the opacity of this 360 image.
+     * The object containing the unit cube with the 360 images.
+     * @returns Image360Visualization
      */
-    set opacity(alpha: number);
+    get image360Visualization(): Image360Visualization;
     constructor(image360Metadata: Image360Descriptor, sceneHandler: SceneHandler, imageProvider: Image360FileProvider, postTransform: THREE.Matrix4, preComputedRotation: boolean);
     /**
-     * Enables a unit inverted cube which contains the 360 image.
+     * Loads the 360 image (6 faces) into the visualization object.
      */
-    activate360Image(): Promise<void>;
+    load360Image(): Promise<void>;
     /**
-     * Disables the unit inverted cube which contains the 360 image.
+     * Drops the GPU resources for the 360 image
+     * the icon will be preserved.
      */
-    deactivate360Image(): Promise<void>;
-    load360Image(): Promise<void>;
-    unload360Image(): Promise<void>;
-    dispose(): Promise<void>;
-    private createImage360VisualizationObject;
+    unload360Image(): void;
+    /**
+     * @obvious
+     */
+    dispose(): void;
     private computeTransform;
 }

package/dist/packages/360-images/src/Image360Icon.d.ts

@@ -1,15 +1,18 @@
 /*!
  * Copyright 2022 Cognite AS
  */
+import { SceneHandler } from '../../utilities';
 import * as THREE from 'three';
 export declare class Image360Icon extends THREE.Group {
     private readonly MIN_PIXEL_SIZE;
     private readonly MAX_PIXEL_SIZE;
     private readonly _hoverSprite;
     private readonly _outerSprite;
-    constructor(modelToWorldTransform: THREE.Matrix4);
+    private readonly _sceneHandler;
+    constructor(modelToWorldTransform: THREE.Matrix4, sceneHandler: SceneHandler);
     set hoverSpriteVisible(visible: boolean);
     raycast(raycaster: THREE.Raycaster, intersects: THREE.Intersection<THREE.Object3D<THREE.Event>>[]): void;
+    dispose(): void;
     private setupAdaptiveScaling;
     private createOuterRingsSprite;
     private createHoverSprite;

package/dist/packages/360-images/src/Image360LoadingCache.d.ts

@@ -7,7 +7,8 @@ export declare class Image360LoadingCache {
     private readonly _loaded360Images;
     private readonly _inFlightEntities;
     get cachedEntities(): Image360Entity[];
-    get currentlyLoadingEntities(): Set<Image360Entity>;
+    get currentlyLoadingEntities(): Map<Image360Entity, Promise<void>>;
     constructor(_cacheSize?: number);
     cachedPreload(entity: Image360Entity): Promise<void>;
+    purge(entity: Image360Entity): Promise<void>;
 }

package/dist/packages/360-images/src/Image360Visualization.d.ts

@@ -0,0 +1,22 @@
+/*!
+ * Copyright 2022 Cognite AS
+ */
+import * as THREE from 'three';
+export interface Image360Visualization {
+    /**
+     * Opaqueness of the 360 image
+     */
+    opacity: number;
+    /**
+     * Visibility of the 360 image
+     */
+    visible: boolean;
+    /**
+     * Scale of the box containing the 360 image
+     */
+    scale: THREE.Vector3;
+    /**
+     * Render order of the mesh containing the 360 image
+     */
+    renderOrder: number;
+}

package/dist/packages/360-images/src/Image360VisualizationBox.d.ts

@@ -0,0 +1,21 @@
+/*!
+ * Copyright 2022 Cognite AS
+ */
+import * as THREE from 'three';
+import { SceneHandler } from '../../utilities';
+import { Image360Face } from '../../data-providers';
+import { Image360Visualization } from './Image360Visualization';
+export declare class Image360VisualizationBox implements Image360Visualization {
+    private readonly _worldTransform;
+    private _visualizationMesh;
+    private _faceMaterials;
+    private readonly _sceneHandler;
+    private readonly _visualizationState;
+    set opacity(alpha: number);
+    set visible(isVisible: boolean);
+    set scale(newScale: THREE.Vector3);
+    set renderOrder(newRenderOrder: number);
+    constructor(worldTransform: THREE.Matrix4, sceneHandler: SceneHandler);
+    loadImages(faces: Image360Face[]): Promise<void>;
+    unloadImages(): void;
+}

package/dist/packages/api/index.d.ts

@@ -5,5 +5,6 @@ export { Cognite3DViewer } from './src/public/migration/Cognite3DViewer';
 export { CogniteCadModel } from '../cad-model';
 export { ViewerState, ModelState } from './src/utilities/ViewStateHelper';
 export * from './src/public/types';
+export { CDF_TO_VIEWER_TRANSFORMATION } from './src/public/constants';
 declare const REVEAL_VERSION: string;
 export { REVEAL_VERSION };

package/dist/packages/api/src/api-helpers/Image360ApiHelper.d.ts

@@ -9,6 +9,7 @@ import { ProxyCameraManager } from '../../../camera-manager';
 export declare class Image360ApiHelper {
     private readonly _image360Facade;
     private readonly _domElement;
+    private _transitionInProgress;
     private readonly _interactionState;
     private readonly _domEventHandlers;
     private readonly _requestRedraw;
@@ -19,7 +20,11 @@ export declare class Image360ApiHelper {
     add360ImageSet(eventFilter: {
         [key: string]: string;
     }, collectionTransform: THREE.Matrix4, preMultipliedRotation: boolean): Promise<Image360Entity[]>;
+    remove360Images(entities: Image360Entity[]): Promise<void>;
     enter360Image(image360Entity: Image360Entity): Promise<void>;
+    private transition;
+    private tweenVisualizationAlpha;
+    private set360CameraManager;
     exit360Image(): void;
     dispose(): void;
     private enter360ImageOnIntersect;

package/dist/packages/api/src/public/constants.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * Copyright 2022 Cognite AS
+ */
+import { Matrix4 } from 'three';
+/**
+ * The transformation matrix from CDF coordinates to ThreeJS/Reveal.
+ * Note that this is already applied to {@link CogniteCadModel} and {@link CognitePointCloudModel}
+ * automatically, as it is factored into the matrix returned from e.g.
+ * the {@link CogniteCadModel.getCdfToDefaultModelTransformation} method.
+ */
+export declare const CDF_TO_VIEWER_TRANSFORMATION: Matrix4;

package/dist/packages/api/src/public/migration/Cognite3DViewer.d.ts

@@ -178,9 +178,8 @@ export declare class Cognite3DViewer {
     /**
      * Sets the active camera manager instance for current Cognite3Dviewer.
      * @param cameraManager Camera manager instance.
-     * @param preserveCameraState Whether to set current camera state to new camera manager.
      */
-    setCameraManager(cameraManager: CameraManager, preserveCameraState?: boolean): void;
+    setCameraManager(cameraManager: CameraManager): void;
     /**
      * Gets the current viewer state which includes the camera pose as well as applied styling.
      * @returns JSON object containing viewer state.
@@ -248,12 +247,17 @@ export declare class Cognite3DViewer {
      * @example
      * ```js
      * const eventFilter = { site_id: "12345" };
-     * await viewer.add360ImageSet(eventFilter);
+     * await viewer.add360ImageSet('events', eventFilter);
      * ```
      */
     add360ImageSet(datasource: 'events', eventFilter: {
         [key: string]: string;
     }, add360ImageOptions?: AddImage360Options): Promise<Image360Entity[]>;
+    /**
+     * Remove a set of 360 images.
+     * @param image360Entities
+     */
+    remove360Images(...image360Entities: Image360Entity[]): Promise<void>;
     /**
      * Enter visualization of a 360 image.
      * @param image360

package/dist/packages/api/src/public/migration/types.d.ts

@@ -129,7 +129,7 @@ export interface Cognite3DViewerOptions {
      * the camera is moving. Note that this option should left to false on
      * low-end devices as more loading can cause frame drops.
      *
-     * Default value is set to false.
+     * Default value is set to true.
      */
     continuousModelStreaming?: boolean;
 }

package/dist/packages/cad-model/src/wrappers/CadNode.d.ts

@@ -1,26 +1,28 @@
 /**
  * Copyright 2021 Cognite AS
  */
-import * as THREE from 'three';
 import { NodeAppearanceProvider, NodeAppearance, PrioritizedArea } from '../../../cad-styling';
 import { SectorScene, CadModelMetadata, RootSectorNode, WantedSector, ConsumedSector } from '../../../cad-parsers';
 import { SectorRepository } from '../../../sector-loader';
 import { ParsedGeometry } from '../../../sector-parser';
 import { CadMaterialManager, NodeTransformProvider, RenderMode } from '../../../rendering';
-export declare class CadNode extends THREE.Object3D {
+import { Object3D, Plane, Matrix4 } from 'three';
+export declare class CadNode extends Object3D {
     private readonly _cadModelMetadata;
     private readonly _materialManager;
     private readonly _sectorRepository;
     private _rootSector;
     private _sectorScene;
     private _geometryBatchingManager?;
+    private readonly _sourceTransform;
+    private readonly _customTransform;
     constructor(model: CadModelMetadata, materialManager: CadMaterialManager, sectorRepository: SectorRepository);
     get nodeTransformProvider(): NodeTransformProvider;
     get nodeAppearanceProvider(): NodeAppearanceProvider;
     get defaultNodeAppearance(): NodeAppearance;
     set defaultNodeAppearance(appearance: NodeAppearance);
-    get clippingPlanes(): THREE.Plane[];
-    set clippingPlanes(planes: THREE.Plane[]);
+    get clippingPlanes(): Plane[];
+    set clippingPlanes(planes: Plane[]);
     get cadModelMetadata(): CadModelMetadata;
     get cadModelIdentifier(): string;
     get sectorScene(): SectorScene;
@@ -33,12 +35,13 @@ export declare class CadNode extends THREE.Object3D {
      * Sets transformation matrix of the model. This overrides the current transformation.
      * @param matrix Transformation matrix.
      */
-    setModelTransformation(matrix: THREE.Matrix4): void;
+    setModelTransformation(matrix: Matrix4): void;
     /**
      * Gets transformation matrix of the model
      * @param out Preallocated `THREE.Matrix4` (optional).
      */
-    getModelTransformation(out?: THREE.Matrix4): THREE.Matrix4;
+    getModelTransformation(out?: Matrix4): Matrix4;
+    getCdfToDefaultModelTransformation(out?: Matrix4): Matrix4;
     get prioritizedAreas(): PrioritizedArea[];
     batchGeometry(geometryBatchingQueue: ParsedGeometry[], sectorId: number): void;
     removeBatchedSectorGeometries(sectorId: number): void;

package/dist/packages/cad-model/src/wrappers/CogniteCadModel.d.ts

@@ -25,6 +25,18 @@ export declare class CogniteCadModel implements CdfModelNodeCollectionDataProvid
      * return undefined if the model has been stored in an unsupported unit.
      */
     get modelUnitToMetersFactor(): number | undefined;
+    /**
+     * Sets the model visibility.
+     * @example
+     * ```js
+     * model.visible = false
+     * ```
+     */
+    set visible(value: boolean);
+    /**
+     * Returns the model visibility.
+     */
+    get visible(): boolean;
     /**
      * The CDF model ID of the model.
      */
@@ -125,45 +137,6 @@ export declare class CogniteCadModel implements CdfModelNodeCollectionDataProvid
      * @param applyToChildren
      */
     resetNodeTransformByTreeIndex(treeIndex: number, applyToChildren?: boolean): Promise<number>;
-    /**
-     * Maps a position retrieved from the CDF API (e.g. 3D node information) to
-     * coordinates in "ThreeJS model space". This is necessary because CDF has a right-handed
-     * Z-up coordinate system while ThreeJS uses a right-hand Y-up coordinate system.
-     * @param p     The CDF coordinate to transform.
-     * @param out   Optional preallocated buffer for storing the result. May be `p`.
-     * @returns Transformed position.
-     */
-    mapFromCdfToModelCoordinates(p: THREE.Vector3, out?: THREE.Vector3): THREE.Vector3;
-    /**
-     * Maps from a 3D position in "ThreeJS model space" (e.g. a ray intersection coordinate)
-     * to coordinates in "CDF space". This is necessary because CDF has a right-handed
-     * Z-up coordinate system while ThreeJS uses a right-hand Y-up coordinate system.
-     * This function also accounts for transformation applied to the model.
-     * @param p       The ThreeJS coordinate to transform.
-     * @param out     Optional preallocated buffer for storing the result. May be `p`.
-     * @returns Transformed position.
-     */
-    mapPositionFromModelToCdfCoordinates(p: THREE.Vector3, out?: THREE.Vector3): THREE.Vector3;
-    /**
-     * Maps from a 3D position in "ThreeJS model space" to coordinates in "CDF space".
-     * This is necessary because CDF has a right-handed Z-up coordinate system while ThreeJS
-     * uses a right-hand Y-up coordinate system. This function also accounts for transformation
-     * applied to the model.
-     * @param box     The box in ThreeJS/model coordinates.
-     * @param out     Optional preallocated buffer for storing the result. May be same input as `box`.
-     * @returns       Transformed box.
-     */
-    mapBoxFromModelToCdfCoordinates(box: THREE.Box3, out?: THREE.Box3): THREE.Box3;
-    /**
-     * Maps from a 3D position in "CDF space" to coordinates in "ThreeJS model space".
-     * This is necessary because CDF has a right-handed Z-up coordinate system while ThreeJS
-     * uses a right-hand Y-up coordinate system. This function also accounts for transformation
-     * applied to the model.
-     * @param box     The box in CDF model coordinates.
-     * @param out     Optional preallocated buffer for storing the result. May be same input as `box`.
-     * @returns       Transformed box.
-     */
-    mapBoxFromCdfToModelCoordinates(box: THREE.Box3, out?: THREE.Box3): THREE.Box3;
     /**
      * Cleans up used resources.
      */
@@ -218,10 +191,17 @@ export declare class CogniteCadModel implements CdfModelNodeCollectionDataProvid
      */
     setModelTransformation(matrix: THREE.Matrix4): void;
     /**
-     * Gets transformation matrix of the model.
+     * Gets transformation matrix that has previously been set with {@link CogniteCadModel.setModelTransformation}.
      * @param out Preallocated `THREE.Matrix4` (optional).
      */
     getModelTransformation(out?: THREE.Matrix4): THREE.Matrix4;
+    /**
+     * Gets transformation from CDF space to ThreeJS space,
+     * which includes any additional "default" transformations assigned to this model.
+     * Does not include any custom transformations set by {@link CognitePointcloudmodel.setModelTransformation}
+     * @param out Preallocated `THREE.Matrix4` (optional)
+     */
+    getCdfToDefaultModelTransformation(out?: THREE.Matrix4): THREE.Matrix4;
     /**
      * Fetches a bounding box from the CDF by the nodeId.
      * @param nodeId

package/dist/packages/cad-styling/src/CdfModelNodeCollectionDataProvider.d.ts

@@ -7,13 +7,15 @@ import * as THREE from 'three';
  */
 export interface CdfModelNodeCollectionDataProvider {
     /**
-     * Maps a box from Reveal space to CDF space
+     * Gets the transformation of the model in ThreeJS space
      */
-    mapBoxFromModelToCdfCoordinates: (box: THREE.Box3, out?: THREE.Box3) => THREE.Box3;
+    getModelTransformation(out?: THREE.Matrix4): THREE.Matrix4;
     /**
-     * Maps a box from CDF space to Reveal space
+     * Gets the default transformation of the model from CDF space.
+     * The current total transformation of the model from the backend to its transform in ThreeJS space
+     * is thus `model.getCdfToDefaultModelTransformation() * model.getModelTransformation()`.
      */
-    mapBoxFromCdfToModelCoordinates: (box: THREE.Box3, out?: THREE.Box3) => THREE.Box3;
+    getCdfToDefaultModelTransformation(out?: THREE.Matrix4): THREE.Matrix4;
     /**
      * Total count of nodes in the model
      */

package/dist/packages/cad-styling/src/CdfNodeCollectionBase.d.ts

@@ -6,7 +6,7 @@ import { IndexSet } from '../../utilities';
 export declare abstract class CdfNodeCollectionBase extends NodeCollection {
     private _indexSet;
     private _areas;
-    private readonly _boundsMapper;
+    private readonly _cadModelData;
     private _fetchResultHelper;
     constructor(classToken: string, model: CdfModelNodeCollectionDataProvider);
     get isLoading(): boolean;

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

@@ -40,6 +40,21 @@ export interface CameraManager {
      * @returns Camera state: position, target and rotation.
      */
     getCameraState(): Required<CameraState>;
+    /**
+     * Set this manager as active and enable controls.
+     *
+     * Should update {@link CameraManager.enabled} to reflect the state of the manager.
+     * Note that this is called automatically when a new CameraManager is set on the {@link Cognite3DViewer}.
+     * @param cameraManager Previously used camera manager.
+     */
+    activate(cameraManager?: CameraManager): void;
+    /**
+     * Deactivate this manager and disable controls.
+     *
+     * Should update {@link CameraManager.enabled} to reflect the state of the manager.
+     * Note that this is called automatically when a new CameraManager is set on the {@link Cognite3DViewer}.
+     */
+    deactivate(): void;
     /**
      * Subscribes to changes of the camera event. This is used by Reveal to react on changes of the camera.
      * @param event Name of the event.
@@ -72,7 +87,7 @@ export interface CameraManager {
      */
     dispose(): void;
     /**
-     * Enables or disables camera manager. When disabled, camera manager shouldn't consume or react to any DOM events.
+     * Enabled is true if this camera manager is active. When disabled, the camera manager shouldn't consume or react to any DOM events.
      */
-    enabled?: boolean;
+    enabled: boolean;
 }

package/dist/packages/camera-manager/src/DefaultCameraManager.d.ts

@@ -19,7 +19,7 @@ export declare class DefaultCameraManager implements CameraManager {
     private readonly _raycaster;
     private isDisposed;
     private _nearAndFarNeedsUpdate;
-    private _enabledCopy;
+    private isEnabled;
     private readonly _modelRaycastCallback;
     private _onClick;
     private _onWheel;
@@ -69,23 +69,11 @@ export declare class DefaultCameraManager implements CameraManager {
     /**
      * Sets whether camera controls through mouse, touch and keyboard are enabled.
      */
-    set enabled(enabled: boolean);
+    private set enabled(value);
     /**
      * Gets whether camera controls through mouse, touch and keyboard are enabled.
      */
     get enabled(): boolean;
-    /**
-     * Sets whether camera controls through mouse, touch and keyboard are enabled.
-     * This can be useful to e.g. temporarily disable navigation when manipulating other
-     * objects in the scene or when implementing a "cinematic" viewer.
-     * @deprecated Will be removed in 4.0.0. Use {@link DefaultCameraManager.enabled} instead.
-     */
-    set cameraControlsEnabled(enabled: boolean);
-    /**
-     * Gets whether camera controls through mouse, touch and keyboard are enabled.
-     * @deprecated Will be removed in 4.0.0. Use {@link DefaultCameraManager.enabled} instead.
-     */
-    get cameraControlsEnabled(): boolean;
     /**
      * Sets whether keyboard control of the camera is enabled/disabled.
      */
@@ -103,6 +91,8 @@ export declare class DefaultCameraManager implements CameraManager {
      * **/
     setCameraState(state: CameraState): void;
     getCameraState(): Required<CameraState>;
+    activate(cameraManager?: CameraManager): void;
+    deactivate(): void;
     /**
      * Gets current camera controls options.
      */

package/dist/packages/camera-manager/src/ProxyCameraManager.d.ts

@@ -8,14 +8,15 @@ export declare class ProxyCameraManager implements CameraManager {
     private readonly _cameraChangedListeners;
     private _activeCameraManager;
     private readonly _activeCameraEventHandler;
-    set enabled(value: boolean);
     get enabled(): boolean;
     get innerCameraManager(): CameraManager;
     constructor(initialActiveCamera: CameraManager);
-    setActiveCameraManager(cameraManager: CameraManager, preserveCameraState?: boolean): void;
+    setActiveCameraManager(cameraManager: CameraManager): void;
     getCamera(): THREE.PerspectiveCamera;
     setCameraState(state: CameraState): void;
     getCameraState(): Required<CameraState>;
+    activate(cameraManager?: CameraManager): void;
+    deactivate(): void;
     on(_: 'cameraChange', callback: CameraChangeDelegate): void;
     off(_: 'cameraChange', callback: CameraChangeDelegate): void;
     fitCameraToBoundingBox(boundingBox: THREE.Box3, duration?: number | undefined, radiusFactor?: number | undefined): void;

package/dist/packages/camera-manager/src/StationaryCameraManager.d.ts

@@ -11,17 +11,19 @@ export declare class StationaryCameraManager implements CameraManager {
     private _isEnabled;
     private _isDragging;
     constructor(domElement: HTMLElement, camera: THREE.PerspectiveCamera);
-    set enabled(value: boolean);
     get enabled(): boolean;
     getCamera(): THREE.PerspectiveCamera;
     setCameraState(state: CameraState): void;
     getCameraState(): Required<CameraState>;
+    activate(): void;
+    deactivate(): void;
     on(_: 'cameraChange', callback: CameraChangeDelegate): void;
     off(_: 'cameraChange', callback: CameraChangeDelegate): void;
     fitCameraToBoundingBox(boundingBox: THREE.Box3, _?: number, radiusFactor?: number): void;
+    moveTo(targetPosition: THREE.Vector3, duration?: number): Promise<void>;
     update(_: number, boundingBox: THREE.Box3): void;
     dispose(): void;
-    private enableDragging;
-    private disableDragging;
-    private rotateCamera;
+    private readonly enableDragging;
+    private readonly disableDragging;
+    private readonly rotateCamera;
 }

package/dist/packages/data-providers/index.d.ts

@@ -17,5 +17,6 @@ export { PointCloudStylableObjectProvider } from './src/PointCloudStylableObject
 export { StylableObject, SerializableStylableObject } from './src/pointcloud-stylable-object-providers/StylableObject';
 export { CdfPointCloudStylableObjectProvider } from './src/pointcloud-stylable-object-providers/CdfPointCloudStylableObjectProvider';
 export { DummyPointCloudStylableObjectProvider } from './src/pointcloud-stylable-object-providers/DummyPointCloudStylableObjectProvider';
+export { cadFromCdfToThreeMatrix } from './src/utilities/applyDefaultModelTransformation';
 export { Image360Provider } from './src/Image360Provider';
 export { BinaryFileProvider, JsonFileProvider, File3dFormat, BlobOutputMetadata, Image360Descriptor, Image360FileProvider, Image360Face } from './src/types';

package/dist/packages/data-providers/src/utilities/applyDefaultModelTransformation.d.ts

@@ -3,4 +3,5 @@
  */
 import * as THREE from 'three';
 import { File3dFormat } from '../types';
+export declare const cadFromCdfToThreeMatrix: THREE.Matrix4;
 export declare function applyDefaultModelTransformation(matrix: THREE.Matrix4, format: File3dFormat | string): void;

package/dist/packages/pointclouds/src/CognitePointCloudModel.d.ts

@@ -48,14 +48,22 @@ export declare class CognitePointCloudModel {
     getCameraConfiguration(): CameraConfiguration | undefined;
     /**
      * Sets transformation matrix of the model. This overrides the current transformation.
-     * @param transformationMatrix
+     * @param transformationMatrix The new transformation matrix
      */
     setModelTransformation(transformationMatrix: THREE.Matrix4): void;
     /**
-     * Gets transformation matrix of the model.
+     * Gets transformation matrix that has previously been
+     * set with {@link CognitePointCloudmodel.setModelTransformation}.
      * @param out Preallocated `THREE.Matrix4` (optional).
      */
     getModelTransformation(out?: THREE.Matrix4): THREE.Matrix4;
+    /**
+     * Gets transformation from CDF space to ThreeJS space,
+     * which includes any additional "default" transformations assigned to this model.
+     * Does not include any custom transformations set by {@link CognitePointcloudmodel.setModelTransformation}
+     * @param out Preallocated `THREE.Matrix4` (optional)
+     */
+    getCdfToDefaultModelTransformation(out?: THREE.Matrix4): THREE.Matrix4;
     /**
      * Sets a visible filter on points of a given class.
      * @param pointClass ASPRS classification class code. Either one of the well known

package/dist/packages/pointclouds/src/PointCloudNode.d.ts

@@ -1,14 +1,14 @@
 /*!
  * Copyright 2021 Cognite AS
  */
-import * as THREE from 'three';
 import { CameraConfiguration } from '../../utilities';
 import { ClassificationInfo, PointCloudOctree, PickPoint } from './potree-three-loader';
 import { WellKnownAsprsPointClassCodes } from './types';
 import { PointColorType, PointShape, PointSizeType } from '../../rendering';
 import { PointCloudObjectMetadata, PointCloudObject } from '../../data-providers';
 import { CompletePointCloudAppearance, StyledPointCloudObjectCollection } from '../../pointcloud-styling';
-export declare class PointCloudNode extends THREE.Group {
+import { Matrix4, Group } from 'three';
+export declare class PointCloudNode extends Group {
     private readonly _cameraConfiguration?;
     private readonly _octree;
     private readonly _annotations;
@@ -16,7 +16,9 @@ export declare class PointCloudNode extends THREE.Group {
     private _needsRedraw;
     private static readonly pickingWindowSize;
     private readonly _modelIdentifier;
-    constructor(modelIdentifier: symbol, octree: PointCloudOctree, annotations: PointCloudObject[], classificationInfo: ClassificationInfo, cameraConfiguration?: CameraConfiguration);
+    private readonly _sourceTransform;
+    private readonly _customTransform;
+    constructor(modelIdentifier: symbol, sourceTransform: Matrix4, octree: PointCloudOctree, annotations: PointCloudObject[], classificationInfo: ClassificationInfo, cameraConfiguration?: CameraConfiguration);
     get modelIdentifier(): symbol;
     get octree(): PointCloudOctree;
     get needsRedraw(): boolean;
@@ -73,7 +75,8 @@ export declare class PointCloudNode extends THREE.Group {
     }>;
     getBoundingBox(outBbox?: THREE.Box3): THREE.Box3;
     setModelTransformation(matrix: THREE.Matrix4): void;
-    getModelTransformation(out?: THREE.Matrix4): THREE.Matrix4;
+    getModelTransformation(out?: Matrix4): THREE.Matrix4;
+    getCdfToDefaultModelTransformation(out?: Matrix4): Matrix4;
     get stylableObjectAnnotationMetadata(): Iterable<PointCloudObjectMetadata>;
     get stylableObjects(): PointCloudObject[];
     get defaultAppearance(): CompletePointCloudAppearance;

package/dist/packages/rendering/src/CadMaterialManager.d.ts

@@ -27,6 +27,7 @@ export declare class CadMaterialManager {
     getModelBackTreeIndices(modelIdentifier: string): IndexSet;
     getModelInFrontTreeIndices(modelIdentifier: string): IndexSet;
     getModelGhostedTreeIndices(modelIdentifier: string): IndexSet;
+    getModelVisibleTreeIndices(modelIdentifier: string): IndexSet;
     setRenderMode(mode: RenderMode): void;
     getRenderMode(): RenderMode;
     dispose(): void;

package/dist/packages/rendering/src/rendering/NodeAppearanceTextureBuilder.d.ts

@@ -15,6 +15,7 @@ export declare class NodeAppearanceTextureBuilder {
     private readonly _regularNodesTreeIndices;
     private readonly _ghostedNodesTreeIndices;
     private readonly _infrontNodesTreeIndices;
+    private readonly _visibleNodesTreeIndices;
     constructor(treeIndexCount: number, styleProvider: NodeAppearanceProvider);
     getDefaultAppearance(): NodeAppearance;
     /**
@@ -27,6 +28,7 @@ export declare class NodeAppearanceTextureBuilder {
     get regularNodeTreeIndices(): IndexSet;
     get ghostedNodeTreeIndices(): IndexSet;
     get infrontNodeTreeIndices(): IndexSet;
+    get visibleNodeTreeIndices(): IndexSet;
     get needsUpdate(): boolean;
     /**
      * A texture holding at least one element per node with color override

package/dist/packages/sector-parser/src/GltfSectorParser.d.ts

@@ -1,7 +1,6 @@
 import { ParsedGeometry } from './types';
 export declare class GltfSectorParser {
     private readonly _glbMetadataParser;
-    private readonly _dracoDecoderHelper;
     constructor();
     parseSector(data: ArrayBuffer): Promise<ParsedGeometry[]>;
     private traverseDefaultSceneNodes;

package/dist/packages/tools/index.d.ts

@@ -2,7 +2,6 @@
  * Copyright 2021 Cognite AS
  */
 export { HtmlOverlayTool, HtmlOverlayOptions, HtmlOverlayPositionUpdatedDelegate, HtmlOverlayCreateClusterDelegate } from './src/HtmlOverlay/HtmlOverlayTool';
-export { ExplodedViewTool } from './src/ExplodedViewTool';
 export { DebugCameraTool } from './src/DebugCameraTool';
 export { AxisViewTool } from './src/AxisView/AxisViewTool';
 export { AxisBoxConfig, AxisBoxCompassConfig, AxisBoxFaceConfig, Corner, AbsolutePosition, RelativePosition } from './src/AxisView/types';