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.