Measurements

A Line Measurement is a series of connected points in the scene, useful to visualise boundaries and measure distances.

To begin a line measurement click on the line measure icon in the tool panel and click in the scene to place line nodes. A panel will appear in the top right with a few options, and information about the line measurement. See below for a description.

Show Length Display the cumulative length of the line segments.
Show All Lengths Display the individual lengths of each of the line segments.
Show Angles Display the angles between joining line segments.
Show Area Display the area encompassed by the line segments. The area is calculated by first meshing the point set, then totaling the area of each triangle in the mesh. To give a correct area, the shape should be simple, that is cannot contain lines that cross over. Note: the Close Polygon option must be selected for an area to be calculated.
Close Polygon Join the first and last points, thereby creating a 'closed' shape.
Line Width Set the width of the line in the scene.
Line Orientation There are three options to choose from: Screen Line, Vertical/Fence and Horizontal/Path. The Screen Line is simply a basic single-colour line drawn on the screen. The Vertical/Fence and Horizontal/Path options will create a vertical and horizontal oriented line object, respectively. These options are helpful when looking at the line from different angles.
Line Colour Set the colours of the line.
Selected Point Move the slider to select a node in the line. Once selected, you can manually change the position of the node by setting the x-y-z coordinates or remove the node from the line. A value of -1 indicates all points are selected.
Text Colour / Background Colour Set the colours of the text displayed along the line in the scene.
Description Add a description to the line. This will be saved out with the project.

Right clicking on the name in the scene explorer will bring up a context menu with additional options.

Edit Name Change the name of the line.
Move To Move the camera such that the line is in view.
Fly Camera Through All Points This option will begin a fly-through of all points along the lines. The fly-through speed is determined by the Camera Move Speed. If the Close Polygon line setting is checked, the fly-through will repeat until cancelled.
Attach Model A model can be attached to a line, and will continuously move along the segments of the line. This is useful for vehicle or flight paths. Once attached, more options will become available in the scene explorer under the respective line. These are used to control the speed of the model and set the type of face culling.
Remove Item Deletes the item from the scene.

Scene Node Metadata

Line and area measurements are stored as POI items. The following metadata keys apply:

Key	Type	Description
`nameColour`	uint	Text colour for measurement labels (BGRA packed).
`backColour`	uint	Background colour for measurement labels (BGRA packed).
`lineColourPrimary`	uint	Primary line colour (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`.
`lineClosed`	bool	Close the polygon by joining first and last points.
`showLength`	bool	Show the total line length.
`show2DLength`	bool	Show the projected 2D length.
`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.
`measurementAreaFillColour`	uint	Fill colour for area polygons (BGRA packed).
`description`	string	Free-text description saved with the measurement.

See Points of Interest for the complete list of POI metadata keys.