Points of Interest (Annotations & Measurements)

A Point of Interest (POI) is a versatile scene item used for annotations, line measurements, area measurements, and paths. Single-point annotations, multi-point lines, and closed area polygons are all stored as POI items.

See also Measurements for detailed information on using the line and area measurement tools, and Height Measurement for the separate height measurement tool.

Creating a POI

Tool	Description
Single Annotation	Click in the tool bar, then click in the scene to place a single annotation point.
Line Measurement	Click multiple points in the scene to create a polyline.
Area Measurement	Click multiple points to create a closed area polygon.

Right-clicking a point in the scene and choosing Add New Item also allows placing annotations.

Ribbon Settings

Basic

Show Name — Show or hide the POI name label in the scene.
Show Line Length — Display the total cumulative length of all line segments.
Show 2D Length — Display the projected 2D (horizontal) length of the line.
Show All Lengths — Display individual segment lengths along the line.
Line Closed — Join the first and last points to form a closed polygon.
Show Area — Display the area enclosed by the polygon (requires Line Closed).
Show Fill — Show a filled polygon (requires Line Closed).
Area Extrusion — Extrude the area polygon to a given height.

Style

Line Width — Set the line thickness in pixels.
Line Mode — Choose how the line is oriented in 3D space:
- Screen Line — Always rendered facing the camera.
- Fence — Vertical plane along the line.
- Horizontal Path — Horizontal plane along the line.
Line Style — Choose a visual style: Solid, Arrow, Glow, or Diagonal.
Primary Line Colour — Main line colour.
Secondary Line Colour — Alternate colour for dual-colour line mode.
Fill Colour — Colour of the area fill (if enabled).
Name Text Colour — Colour of the label text.
Background Colour — Colour of the label background.
Use Pin — Replace the point marker with a custom pin image.
Pin Tint — Tint colour applied to the pin image.

Extra

Displays read-only measurement values:

Total 3D length
Total 2D (horizontal) length
Enclosed area (if closed polygon)

Scene Explorer Settings

Expanding a POI in the Scene Explorer shows individual vertex controls:

Selected Point slider — Select a specific vertex. Set to -1 to select all.
X / Y / Z — Position of the selected vertex. Edit to reposition precisely.
Remove Point — Delete the selected vertex.
Description — Free-text description saved with the item.

Right-Click Context Menu

Option	Description
Edit Name	Rename the item.
Move To	Move the camera to frame the POI.
Fly Camera Through All Points	Animate the camera along the line path.
Attach Model	Attach a 3D model that animates along the line.
Chainage Tool	Add distance markers along the line.
Remove Item	Delete the item from the scene.

Scene Node Metadata

The following keys can be set in the scene node metadata to configure a POI programmatically.

Key	Type	Description
`nameColour`	uint	Text colour for the name label (BGRA packed).
`backColour`	uint	Background colour of the name label (BGRA packed).
`lineColourPrimary`	uint	Primary line colour (BGRA packed).
`lineColourSecondary`	uint	Secondary line colour for dual-colour mode (BGRA packed).
`measurementAreaFillColour`	uint	Fill colour for area polygons (BGRA packed).
`lineWidth`	double	Line width in pixels.
`lineStyle`	string	Line style: `Arrow`, `Glow`, `Solid`, or `Diagonal`.
`lineMode`	string	Line orientation: `Screen Line`, `Fence`, or `Flat`.
`lineDualColour`	bool	Enable dual-colour line rendering.
`lineClosed`	bool	Close the polygon by joining first and last points.
`showName`	bool	Show the name label.
`showLength`	bool	Show the total line length measurement.
`show2DLength`	bool	Show the projected 2D length measurement.
`showAllLengths`	bool	Show individual segment lengths.
`showAngles`	bool	Show vertex angles.
`showArea`	bool	Show the enclosed area measurement.
`showFill`	bool	Show the area fill polygon.
`extrusion`	double	Height (metres) to extrude the area polygon.
`hyperlink`	string	URL to open when the POI is clicked.
`description`	string	Free-text description.
`pin`	string	URI of a custom pin image.
`pinTint`	uint	Tint colour for the pin image (BGRA packed).
`icon.URL`	string	URI of a custom icon image.
`icon.scale`	double	Scale factor for the icon.
`icon.tint`	uint	Tint colour for the icon (BGRA packed).
`attachmentURI`	string	URI of a model to attach and animate along the line.
`attachmentSpeed`	double	Speed of the attached model animation (km/h).
`attachmentCulling`	string	Face culling for the attached model: `back`, `front`, or `none`.
`sectionWidth`	double	Width of the section geometry.
`vertexLabelDistance`	double	Distance threshold for showing vertex labels.