MeasurementsTool

This extension provides basic configurable measurement capabilities. The tool is autonomous, and is able to create measurements on it’s own.

This extension requires and active CameraController extension implementation.

Accessors

activeMeasurement

get activeMeasurement(): Measurement

Gets the currently ongoing measurement. Null if there is none.

Returns: Measurement

enabled

get enabled(): boolean
set enabled(value: boolean)

Enables/disables the extension.

Returns: boolean

options

get options(): MeasurementOptions
set options(value: MeasurementOptions)

Gets and sets the extension options.

Returns: MeasurementOptions

selectedMeasurement

get selectedMeasurement(): Measurement

Gets the currently selected measurement. Null if there is none.

Returns: Measurement

Methods

clearMeasurements

clearMeasurements(): void

Removes all measurements, including finished or ongoing now.

Returns: void

fromMeasurementData

fromMeasurementData(startPoint: Vector3, endPoint: Vector3): void

Programatically adds a measurements.

Currently only PointToPoint measurements can pe programatically added

Parameters

• startPoint: Vector3
• endPoint: Vector3

Returns: void

removeMeasurement

removeMeasurement(): void

Removes any currently ongoing measurements.

Returns: void

Typedefs

Measurement

abstract class Measurement extends Object3D

Abstract class for all measurement types.

MeasurementOptions

interface MeasurementOptions {
  visible: boolean;
  type?: MeasurementType;
  vertexSnap?: boolean;
  units?: string;
  precision?: number;
  chain?: boolean;
}

The options for newly created measurements.

• visible: If the measurements are visible
• optional type: Current measurement type to create
• optional vertexSnap: Should the cursor snap to the nearest vertex
• optional units: The measurement units
• optional precision: The number of decimals to be displayed
• optional chain: Automatically connects last measurement with the new one

MeasurementType

enum MeasurementType {
  PERPENDICULAR,
  POINTTOPOINT,
  AREA,
  POINT,
}

Measurement types.

Constants

DefaultMeasurementsOptions

const DefaultMeasurementsOptions = {
  visible: true,
  type: MeasurementType.POINTTOPOINT,
  vertexSnap: true,
  units: 'm',
  precision: 2,
  chain: false,
};

The default extension options.