> ## Documentation Index
> Fetch the complete documentation index at: https://support.lumafield.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Direct Dimensions

> Distance, Angle, and Diameter measurements on extracted features in Dimensioning Mode

Direct Dimensions are the foundational measurement Tools of [3D Auto-Dimensioning](/voyager/voyager-auto-dimensioning). Use them to measure between automatically extracted features (planes and cylinders) on a Voyager scan with sub-voxel precision. Every Direct Dimension supports tolerance definition with pass/fail color coding, and leader and label placement can be adjusted at any time after creation.

<Warning>
  All measurements should be performed on an [ROI](/voyager/voyager-region-of-interest) that roughly orients your part to the correct orientation. Skipping this step is the most common cause of poorly-oriented measurements.
</Warning>

The Direct Dimensions Tools are available in [Dimensioning Mode](/voyager/voyager-modes#dimensioning-mode) once Automatic Feature Extraction has run on the parent reconstruction. Every ROI built on that reconstruction inherits the extracted features, so a single extraction surfaces planes and cylinders across all child ROIs.

<h2 id="distance">
  Distance
</h2>

The Distance Tool measures between two extracted features. The supported feature pairs and methods today are:

* **Plane to Plane** — Center to Center, Max Perpendicular, Min Perpendicular, Min
* **Plane to Cylinder** — Center to Center, Centroid
* **Cylinder to Cylinder** — Center to Center, Centroid

<Frame>
  ![Using the Distance Tool to measure the maximum perpendicular distance between two planes](https://lumafield-support-assets.s3.us-east-1.amazonaws.com/distance.gif)
</Frame>

<h3 id="distance-workflow">
  Workflow
</h3>

<Steps>
  <Step title="Select the Distance Tool">
    Choose **Distance** from the Toolbar in Dimensioning Mode.
  </Step>

  <Step title="Pick two features">
    Click the first extracted feature in the Viewport, then click the second. Eligible features highlight on hover so you know which surfaces are available.
  </Step>

  <Step title="Choose method and tolerance">
    Pick a method from the dropdown in the Workflow Editor (the available methods depend on the feature pair you selected) and enter a tolerance.
  </Step>

  <Step title="Submit">
    Submit to compute the dimension. The result is added to the scene with a leader line and a tolerance-aware color code.
  </Step>
</Steps>

<Note>
  The supported method matrix is actively being extended. Reach out to Lumafield to share dimensional requirements that aren't yet covered.
</Note>

<h2 id="angle">
  Angle
</h2>

The Angle Tool measures the angle between two features. Supported pairs:

* **Plane to Plane**
* **Plane to Cylinder**
* **Cylinder to Cylinder**

<Frame>
  ![Using the Angle Tool to measure the angle between two planes](https://lumafield-support-assets.s3.us-east-1.amazonaws.com/angle.gif)
</Frame>

<h3 id="angle-workflow">
  Workflow
</h3>

<Steps>
  <Step title="Select the Angle Tool">
    Choose **Angle** from the Toolbar.
  </Step>

  <Step title="Pick two features">
    Select the two extracted features whose included angle you want to evaluate.
  </Step>

  <Step title="Add tolerance and submit">
    Enter the tolerance and submit. The angle and pass/fail state appear in the dimension label.
  </Step>
</Steps>

<h2 id="diameter">
  Diameter
</h2>

The Diameter Tool measures the diameter of any extracted cylinder. This is the simplest of the Direct Dimensions Tools — point and select.

<Frame>
  ![Using the Diameter Tool to measure the diameter of a cylindrical feature](https://lumafield-support-assets.s3.us-east-1.amazonaws.com/diameter2.gif)
</Frame>

<h3 id="diameter-workflow">
  Workflow
</h3>

<Steps>
  <Step title="Select the Diameter Tool">
    Choose **Diameter** from the Toolbar.
  </Step>

  <Step title="Pick a cylinder">
    Click an extracted cylindrical feature.
  </Step>

  <Step title="Add tolerance and submit">
    Enter the tolerance and submit.
  </Step>
</Steps>

<h2 id="tolerance">
  Tolerance and pass/fail color coding
</h2>

Every Direct Dimension supports tolerance definition. When a tolerance is set:

* The dimension label is **green** when the measurement is within tolerance.
* The dimension label is **red** when the measurement is out of tolerance.

Tolerance values can be modified after the measurement is completed — open the dimension in the Attributes Panel to update the value or method, and the color coding updates immediately. This makes it easy to iterate on tolerances without re-running the workflow.

<h2 id="adjusting-leaders">
  Adjusting leaders and labels
</h2>

Once a Direct Dimension is created, use the leader and label controls in the Attributes Panel to adjust orientation and offset. This keeps complex scenes with many dimensions easy to read and helps when preparing Bookmarks, Renders, and Animations in [Reporting Mode](/voyager/voyager-modes#reporting-mode).

<h2 id="related-pages">
  Related pages
</h2>

* [3D Auto-Dimensioning](/voyager/voyager-auto-dimensioning) — feature extraction and Mode setup
* [Flatness](/voyager/voyager-flatness)
* [Datum Definition](/voyager/voyager-datums)
* [Profile](/voyager/voyager-profile)
* [Voyager Modes](/voyager/voyager-modes)
* [Voyager 2.0 Release Notes](/platform/voyager-release-notes) and [Monthly Highlights](/platform/monthly-highlights)