Measure module

The Measure module serves as the central logic unit for the creation, editing and deletion of measures. Using the provided input fields, it is possible to easily generate single line and multi-line measures from UI or providing a JSON with the necessary information, whereas the module handles the necessary logic.

Fields

• Configuration fields

• Input fields

• Output fields

Supported measures

The module currently supports:

• Single-line measures, consisting of a single linear segment;

• Multi-line measures, comprising multiple connected line segments;

• Thickness measures, represented by a dotted line indicating the thickness of an object;

• Diameter measures, featuring a dotted line denoting the diameter of a cylindrical component, accompanied by a circular outline encasing the element.

Whereas single and multi-line measures are generated through user-defined point selection, the creation of thickness and diameter measures involves more complex computations. These can be delegated to the PickManager module, using the appropriate input.

Aspects of a measure

Each measure is composed of:

• Lines

• Points

• A label displaying its total length, and, in the multi-line mode case, a label per each line of the measure showing the length of the single line

• A pin icon, shown beside the total length label, used to pin the measure.

• A point contextual menu, shown when the point of a multi-line measure is selected.

In the images below, the contextual menu during the creation phase (left side) offers options to either close the measure or remove the current point. After the creation is complete (right side), the menu is limited to just deleting the point.

Length

Length is calculated by default in meters, but it can be converted to centimeters, millimeters, inches and feet, depending on the input measureUOM. After this input is set, all the lines created or selected are automatically converted to the chosen unit of measure.

Axis components

Additionally, when the configuration field enable_AxisComponents is enabled, each single line measure is paired with its respective axis components, as illustrated below.

These axis components appear only when the measure is selected. To streamline the measure editing process, the axis components are temporarily hidden while dragging a point. After the editing is completed, the components are updated and automatically redisplay.

State

Measures have two different states: selected and deselected. The selection of a measure can be achieved by clicking on the line, the total length label or one of the points. The selection of the measures also affects the visibility of the pin icon and, in multi-line, of the labels displaying the length of each lines. When a measure is deselected the total length label is visible within a pre-calculated distance range proportional to the measure total length, with a minimum of 20. When it is selected, instead, labels and pin icon are always visible and their dimension is dynamically recalculated in in order to always occupy the same amount of pixels. A similar calculation is applied when screen is resized.

• Also single points can be selected. If the line is deselected, a single click interaction will select the line and the point and will show the contextual menu. While, if the line is deselected, a single click interaction will deselect the point and hide the contextual menu.

• Clicking and dragging a point will allow you to edit its position and select the line, if measure mode is enabled.

• Selected measures are always represented with no Z depth.

Pinned measures

When a measure is pinned: it cannot be deselected, it remains selected after exiting measure mode and will have no Z depth. The pin icon has 4 states as illustrated in following the table.

Colors

Colors used for measures are currently hardcoded. As shown in the image below, in idle mode and inside the distance range, when a measure is deselected (on the left), the lines and the borders of points are dark red and the label background is darker. When the measure is selected (on the right), the lines and the borders of points are light red and the label background is lighter. In both cases, lines have no Z depth.

Selected measures will be represented with no Z depth and with the point background painted light red, when the module input_enable is false, as shown in the below image on the right. Instead, deselected lines are represented in context when the module input_enable is false or when it is true but camera is out of the distance range. In this case, solid spheres are used for points instead of Hotspot and lines might be hidden by the models in the scene.

Outside of measure mode, lines cannot be deleted or edited, but they can be selected, pinned, or deselected.

States for points

The following table resumes the different states for points.

States for labels

The below table illustrates the different states for the labels.

After creation, measures can be edited, by dragging points, and deleted. Measures can be deleted one-by-one, setting the input mode to delete and selecting the desired measure, or all at once by invoking the events deleteAllMeasures. It is worth noting that a pinned measure cannot be deleted by selection; however, it is deleted when the deleteAllMeasures event is invoked.

When the measure module is used, a PickSensor node, named moduleName::pickSensor, is instantiated in the scene.