AngleMeasurement

A measurement tool to measure angles between 3 points in 3D and display a visual arc with the numeric angle value.

Extends

• Measurement <Angle, "angle">

Properties

cameraStopDelay

cameraStopDelay: number = 80

Idle window after the last wheel pulse before picks resume. Wheel zoom doesn't fire controlstart / controlend, so we debounce on the canvas-level wheel event. Drag suspension is gated by the user-input pair directly and resumes the moment controlend fires (no debounce, no waiting on damping inertia).

Inherited from

Measurement . cameraStopDelay

---

modes

modes: "free"[]

The list of available measurement modes.

Overrides

Measurement.modes

---

pickMode

pickMode: MeasurementPickMode = MeasurementPickMode.MOUSE_MOVE

When to run the snap pick that drives the preview marker. See MeasurementPickMode. Defaults to MOUSE_MOVE (pick on every animation frame the cursor is moving). On big models you may want MOUSE_STOP (pick once after the cursor settles for delay ms): the per-pick cost is the same, but you pay it once per intentional stop rather than once per frame, and the marker only appears where the user is actually about to click. The onPointerStop event still fires in both modes; in MOUSE_STOP we just align the pick to that same moment.

Inherited from

Measurement . pickMode

Accessors

lineType

get lineType(): MeasurementLineType

The line rendering style. See MeasurementLineType. Defaults to Basic. Switching at runtime rebuilds existing measurement lines so it applies live.

Returns

MeasurementLineType

---

lineWidth

get lineWidth(): number

Width of measurement lines in screen pixels. Only has a visible effect when lineType is Fat; WebGL ignores width on the basic material.

Returns

number

---

linesMaterial

set linesMaterial(value): void

The active lines material for the current lineType: a THREE.LineBasicMaterial in Basic mode, a LineMaterial (fat line) in Fat mode. Setting it replaces the material matching its type.

Parameters

Parameter	Type
value	LineMaterial | LineBasicMaterial

---

mode

get mode(): "free"

The current measurement mode. Changing the mode cancels any in-progress creation.

Returns

"free"

---

pickerMode

get pickerMode(): GraphicVertexPickerMode

Deprecated

Sync mode is gone — picks are fast enough through the unified GPU-pick path that the synchronous workaround is no longer needed. Reading still returns the underlying picker mode for compatibility, but setting it has no functional effect.

set pickerMode(value): void

Deprecated

See the getter.

Parameters

Parameter	Type
value	GraphicVertexPickerMode

Returns

GraphicVertexPickerMode

Methods

cancelCreation()

cancelCreation(): void

OBC.Createable.cancelCreation. Cancels the in-progress angle and disposes preview visuals.

Returns

void

Overrides

Measurement.cancelCreation

---

create()

create(): Promise<void>

OBC.Createable.create. Requires 3 successive calls (start, vertex, end) to complete an angle.

Returns

Promise<void>

Overrides

Measurement.create

---

delete()

delete(): void

OBC.Createable.delete. Deletes the angle measurement under the cursor via raycasting.

Returns

void

Overrides

Measurement.delete

---

dispose()

dispose(): void

OBC.Disposable.dispose.

Returns

void

Overrides

Measurement.dispose

---

endCreation()

endCreation(): void

OBC.Createable.endCreation. Finalizes the current angle after the third point is set.

Returns

void

Overrides

Measurement.endCreation