Skip to main content
Version: 4.x

Class: CognitePointCloudModel

Properties​

modelId​

readonly modelId: number

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:30


revisionId​

readonly revisionId: number

The modelId of the point cloud model in Cognite Data Fusion.

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:34


type​

readonly type: SupportedModelTypes = 'pointcloud'

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:29

Accessors​

pointColorType​

get pointColorType(): PointColorType

Determines how points currently are colored.

set pointColorType(type): void

Specifies how points are colored.

Default​

PointColorType.Rgb

Example​

model.pointColorType = PointColorType.Rgb

Parameters​

• type: PointColorType

Returns​

PointColorType

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:186


pointShape​

get pointShape(): PointShape

Sets the point shape of each rendered point in the point cloud.

Default​

PointShape.Circle

See​

PointShape.

set pointShape(shape): void

Gets the point shape of each rendered point in the point cloud.

See​

PointShape.

Parameters​

• shape: PointShape

Returns​

PointShape

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:238


pointSize​

get pointSize(): number

Returns the size of each rendered point in the point cloud.

set pointSize(size): void

Sets the size of each rendered point in the point cloud.

Default​

1

Parameters​

• size: number

Returns​

number

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:205


pointSizeType​

get pointSizeType(): PointSizeType

Get the point size type.

set pointSizeType(type): void

Set the point size type for the point cloud. The point size type can be either Fixed or Adaptive.

Default​

PointSizeType.Adaptive

Parameters​

• type: PointSizeType

Returns​

PointSizeType

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:220


stylableObjectCount​

get stylableObjectCount(): number

Returns​

number

The number of stylable objects

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:358


styledCollections​

get styledCollections(): StyledPointCloudObjectCollection[]

Gets the object collections that have been assigned a style

Returns​

StyledPointCloudObjectCollection[]

All object collections and their associated style

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:303


visible​

get visible(): boolean

Returns the model visibility.

set visible(value): void

Sets the model visibility.

Example​

model.visible = false

Parameters​

• value: boolean

Returns​

boolean

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:264


visiblePointCount​

get visiblePointCount(): number

Returns the current number of visible/loaded points.

Returns​

number

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:179

Methods​

assignStyledObjectCollection()​

assignStyledObjectCollection(objectCollection, appearance): void

Assign a style to a collection of objects. If the object collection has been assigned a style previously, the previous style will be replaced by the new one.

Parameters​

• objectCollection: PointCloudObjectCollection

The object collection to assign a style to

• appearance: PointCloudAppearance

The style to assign to the object collection

Returns​

void

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:313


dispose()​

dispose(): void

Used to clean up memory.

Returns​

void

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:58


getCameraConfiguration()​

getCameraConfiguration(): undefined | CameraConfiguration

Retrieves the camera position and target stored for the model. Typically this is used to store a good starting position for a model. Returns undefined if there isn't any stored camera configuration for the model.

Returns​

undefined | CameraConfiguration

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:84


getCdfToDefaultModelTransformation()​

getCdfToDefaultModelTransformation(out?): 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 CognitePointCloudModel.setModelTransformation

Parameters​

• out?: Matrix4

Preallocated THREE.Matrix4 (optional)

Returns​

Matrix4

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:111


getClasses()​

getClasses(): object[]

Returns a list of sorted classification names and codes present in the model. Names will be the custom names provided by the user, or a default one if none have been provided.

Returns​

object[]

A sorted list of classification codes and names from the model.

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:172


getDefaultPointCloudAppearance()​

getDefaultPointCloudAppearance(): PointCloudAppearance

Gets default point appearance

Returns​

PointCloudAppearance

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:286


getModelBoundingBox()​

getModelBoundingBox(outBoundingBox?): Box3

Parameters​

• outBoundingBox?: Box3

Optional. Used to write result to.

Returns​

Box3

Model's bounding box.

Example​

const boundingBox = new THREE.Box3()
model.getModelBoundingBox(boundingBox);
// boundingBox now has the bounding box
// the following code does the same
const boundingBox = model.getModelBoundingBox();

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:75


getModelClippingPlanes()​

getModelClippingPlanes(): Plane[]

Get the clipping planes for this model.

Returns​

Plane[]

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:279


getModelTransformation()​

getModelTransformation(out?): Matrix4

Gets transformation matrix that has previously been set with CognitePointCloudModel.setModelTransformation.

Parameters​

• out?: Matrix4

Preallocated THREE.Matrix4 (optional).

Returns​

Matrix4

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:101


hasClass()​

hasClass(pointClass): boolean

Returns true if the model has values with the given classification class.

Parameters​

• pointClass: number

ASPRS classification class code. Either one of the well known classes from WellKnownAsprsPointClassCodes or a number for user defined classes.

Returns​

boolean

True if model has values in the class given.

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:163


isClassVisible()​

isClassVisible(pointClass): boolean

Determines if points from a given class are visible.

Parameters​

• pointClass: number

ASPRS classification class code. Either one of the well known classes from WellKnownAsprsPointClassCodes or a number for user defined classes.

Returns​

boolean

True if points from the given class will be visible.

Throws​

Error if the model doesn't have the class given.

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:153


mapBoxFromCdfToModelCoordinates()​

mapBoxFromCdfToModelCoordinates(box, out): Box3

Map bounding box from CDF to model space, taking the model's custom transformation into account

Parameters​

• box: Box3

Box to compute transformation from

• out: Box3 = ...

Optional pre-allocated box

Returns​

Box3

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:130


mapPointFromCdfToModelCoordinates()​

mapPointFromCdfToModelCoordinates(point, out): Vector3

Map point from CDF to model space, taking the model's custom transformation into account

Parameters​

• point: Vector3

Point to compute transformation from

• out: Vector3 = ...

Optional pre-allocated point

Returns​

Vector3

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:120


removeAllStyledObjectCollections()​

removeAllStyledObjectCollections(): void

Removes styling on all object collections in this model

Returns​

void

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:350


setClassVisible()​

setClassVisible(pointClass, visible): void

Sets a visible filter on points of a given class.

Parameters​

• pointClass: number

ASPRS classification class code. Either one of the well known classes from WellKnownAsprsPointClassCodes or a number for user defined classes.

• visible: boolean

Boolean flag that determines if the point class type should be visible or not.

Returns​

void

Throws​

Error if the model doesn't have the class given.

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:142


setDefaultPointCloudAppearance()​

setDefaultPointCloudAppearance(appearance): void

Sets default apparance for points that are not styled otherwise

Parameters​

• appearance: PointCloudAppearance

Appearance to assign as default

Returns​

void

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:294


setModelClippingPlanes()​

setModelClippingPlanes(clippingPlanes): void

Sets the clipping planes for this model. They will be combined with the global clipping planes.

Parameters​

• clippingPlanes: Plane[]

Returns​

void

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:272


setModelTransformation()​

setModelTransformation(transformationMatrix): void

Sets transformation matrix of the model. This overrides the current transformation.

Parameters​

• transformationMatrix: Matrix4

The new transformation matrix

Returns​

void

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:92


traverseStylableObjects()​

traverseStylableObjects(callback): void

Iterates through all stylable objects for this model

Parameters​

• callback

Returns​

void

Example​

model.traverseStylableObjects(
annotationMetadata => console.log(annotationMetadata.annotationId)
);

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:371


unassignStyledObjectCollection()​

unassignStyledObjectCollection(objectCollection): void

Unassign style from an already styled object collection.

Parameters​

• objectCollection: PointCloudObjectCollection

The object collection from which to remove the style

Returns​

void

Defined in​

packages/pointclouds/src/CognitePointCloudModel.ts:331