📏 Measurement Tool Documentation

The Measurement Tool allows for precise dimensional analysis of the 3D model. It supports linear distances and angular measurements directly on the model surface.

📏 Modes

The tool offers three distinct modes:

1. 📏 Distance (2 Points)

  • • Action: Click two points on the model.
  • • Result: Displays the straight-line distance between them.
  • • Details: Shows the breakdown of the distance in X, Y, and Z axes (Delta).

2. 📐 Angle (3 Points)

  • • Action: Click three points:
1. Start Point (Leg 1)

2. Vertex (Corner of the angle)

3. End Point (Leg 2)

  • • Result: Calculates the angle at the vertex.

3. 📐 Angle (4 Points)

  • • Action: Click four points to define two separate lines:
* Line 1: Point 1 & Point 2

* Line 2: Point 3 & Point 4

  • • Result: Calculates the angle between the two lines (projected).

🖱️ Controls & Usage

Activation**: Click *"Start Measurement" (or the tool icon) to enter measurement mode. The cursor will change to a crosshair.
  • • Placing Points: Click on any surface of the model. Points will snap to the exact geometry.
Adjusting Points**: You can *drag existing markers to fine-tune your measurement.
  • • Hover Effect: The cursor changes to "Grab" when hovering over an existing marker.

🛰️ Precision Mechanism (Raycasting)

The tool uses a technique called Raycasting. When you click on the screen, the viewer "projects a ray" from your mouse cursor into the 3D scene. The measurement marker is placed exactly where this ray first hits a piece of geometry.

💡
TIP Measuring Internal Parts*: If you need to measure a part hidden inside the model (e.g., an internal frame or engine component), simply **hide** the outer skins or fairings using the **Node Tree** or the **Parts Analyzer. Because raycasting only hits *visible surfaces, hiding obstructions allows you to "reach through" and click on internal components with millimeter precision.

📜 Measurement History

Every measurement is automatically saved to your local history.

  • • View: See a list of all past measurements below the result panel.
  • • Recall: Click on a history item to re-visualize it in the 3D view.
  • • Rename: Double-click the name (e.g., "Measurement 1") to give it a custom label (e.g., "Wing Span").
Delete**: Click the *× button to remove a measurement.
  • • Clear All: Use the "Clear History" button to wipe all data.

> Note: Measurements are persistent and saved in your browser's local storage. They will remain available even if you refresh the page.

👁️ Visual Cues

  • • 🟢 Green Marker: First point (or Vertex).
  • • 🔴 Red Marker: Subsequent points.
  • • Yellow Line: Active measurement visualization.

PitForge 3D Technical Documentation

v2.1.2