xeokit Measurements

SVG + DOM overlay widgets that paint world-space measurements on a View's canvas — diagonal distance with X/Y/Z decomposition, and three-anchor angle in degrees.

The measurements module ships one tool per measurement type. Each tool is a long-lived overlay attached to a single View, owning a keyed collection of measurement instances. Optional mouse-control helpers turn canvas clicks into measurements without the caller having to connect pickers.

Sub-modules

• distance — point-to-point 3D distance with X/Y/Z axis decomposition. Two-click creation via MouseDistanceMeasurementsControl.
• angle — three-anchor (origin, corner, target) angle at the corner, in degrees. Three-click creation via MouseAngleMeasurementsControl.

Shape

Both sub-modules share the same tool / measurement / mouse-control shape:

classDiagram
    direction TB
    class Tool {
      <<distance or angle>>
      +view              : View
      +measurements      : Map
      +createMeasurement(params)
      +destroyMeasurement(id)
      +clear()
      +show() / hide() / toggle()
      +destroy()
    }
    class Measurement {
      <<one per anchor set>>
    }
    class MouseControl {
      +activate()
      +deactivate()
      +destroy()
    }
    class View {
      <<viewer>>
    }
    class PickStrategy {
      <<picking>>
    }
    Tool "1" *-- "*" Measurement : owns
    Tool "1" o-- "0..1" MouseControl : lazy
    Tool o-- View : paints over
    Tool o-- PickStrategy : routes clicks

Each tool is a per-View singleton — openFor(params) returns the existing instance for params.view (showing it again if hidden) or constructs a fresh one. See the sub-module docs for end-to-end snippets.