Measurement

Model Editor includes measurement tools for obtaining coordinates, distances, and area data in model space.

Measurement tools

Note: Measurement data is kept only while the editor is open. Closing the editor clears the measurement history.

Measurement Types

Coordinate Measurement

Obtains the absolute coordinates (X, Y, Z) of a point in the scene.

How to use: Click Coordinate Measurement in the toolbar → click the target point on the model surface → view the coordinate values.

Note: Before Coordinate Measurement is used, the system checks whether every model in the current scene contains RTK data. All models must have RTK data for Coordinate Measurement to work.

Distance Measurement

Measures the straight-line distance between two points.

How to use:

1. Click Distance Measurement in the toolbar.
2. Click the first measurement point.
3. Move the mouse to display the distance in real time.
4. Click the second measurement point to finish.

Area Measurement

Measures the area of a closed polygon.

How to use:

1. Click Area Measurement in the toolbar.
2. Click multiple measurement points in sequence, with at least three points.
3. Click the start point to close the polygon, or double-click to finish.

Note: The area measurement result displays only the area. Hover over a segment to display its length.

Snapping Aids

Surface Snapping

When measurement is active, the cursor becomes a crosshair with a surface patch that automatically snaps to the model surface. It is enabled by default.

Use case: Keeps measurement points precisely on the model surface and prevents accidental clicks in empty space.

Drag to Adjust

Line and area measurements support dragging existing points to adjust their positions. The measurement result updates in real time.

Use case: Fine-tune an imprecise measurement point without measuring again.

Selecting a Measurement Point from a Depth Profile

When the same screen position corresponds to multiple model surfaces, such as a wall behind a foreground object or another model, the system analyzes candidate surfaces at different depths along the current viewing direction and helps you select the desired measurement point.

This feature does not modify the model or select a batch of points by depth. It selects a measurement depth along the viewing direction at the clicked screen position. The selected depth is converted into a position in model space and used to create or adjust the measurement point.

Depth selection panel

Panel Markers

After opening the depth selection panel, you can see a depth curve:

• Yellow curve: Shows the candidate likelihood at different depths along the current viewing direction. A higher curve indicates that the depth is more likely to correspond to a visible model surface.
• Green triangles: Show candidate depth peaks identified by the system. Multiple green markers usually correspond to multiple model surfaces along the viewing direction.
• Orange line and marker: Show the depth currently selected for measurement. The measurement point is placed on the surface corresponding to the orange marker.
• Peak drop-down: Lists the candidate peaks. Select another peak to move the measurement point to another depth layer.
• Selected depth: Shows the currently selected depth. The depth is calculated from the current camera view and is not the model's global Z coordinate or elevation.

Automatic Depth Selection

When a new measurement point is added, the system automatically selects the clearest candidate peak and places the orange marker there. In most cases, this corresponds to the clearest and most visible model surface along the current viewing direction.

The message The best depth position has been matched automatically indicates that automatic matching is complete.

Switching Depth Manually

If the automatically selected surface is not the target surface:

1. Click a green triangle to switch to the corresponding candidate depth.
2. Use the Peak drop-down to select another candidate peak.
3. Drag the orange marker directly on the depth curve to fine-tune the depth.

After adjustment, the measurement point moves to the new depth along the current viewing direction. Distance, area, or coordinate results update accordingly. The curve itself does not change; only the position of the current measurement point changes.

Recommendations

• When foreground and background models overlap, use the green peaks or the Peak drop-down to switch surfaces.
• When measuring thin walls, doors, windows, railings, or dense models, enlarge the depth curve before dragging the orange marker to reduce incorrect selections.
• When reopening the depth panel for an existing measurement point, the orange marker initially remains at the point's current position. The measurement point changes only after you select another peak or drag the marker.
• If the clicked position has no valid depth sample, the system uses ordinary model-surface snapping or indicates that it cannot obtain a valid measurement point.

Delete a Measurement

Hover over a measurement result. A delete icon appears below it. Click the icon to delete the corresponding measurement data.