Mesh Measurements
==================

The algorithm performs curve length measurements on the surface defined by the mesh.
The curves on the surface can be specified by the user interactively inside the 3D views.

Input
-----

A single mesh.

Output
------

A table of measurements that can be exported into a text file.


Description
-----------

In the 3D view a user can select two points on the mesh surface by double clicking on the mesh. Depending on the mode (**Geodesic distance** ticked or unticked), two different distance measurements are taken.

* **Geodesic distance**: The algorithm computes the shortest curve on the mesh that connects the two specified points and computes its length.

* **Non-geodesic distance**: The algorithm cuts the mesh with a plane, which goes through the selected points. The resulting cutting curve is determined together with its length.

After a measurement is taken, it can be modified (only for non-geodesic mode) by selecting **Advanced mode** and adjusting the plane by translating or rotating it.
Or it can be added to the table by clicking **Append measurement to the table**. The measurement table allows to rename (by double clicking the cell in the **Name** column) or delete a measurement. When the distance is geodesic, a user can also decide to close the measurement contour by checking the **Closed** checkbox.

This process can be iterated for several measurements. The measurements can be exported as annotations to the annotation widget by clicking on **Export to annotation model**, stored via **Save measurements** or loaded by **Load measurements**.