# Measure Tool

The Measure Tool allows you to measure distances between objects or surfaces. 

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV5IFh3rk5kqfCwJPPYhE%2Fuploads%2FYqYqOz4gseutnJqTslJm%2FMeasuring%20Tool%20Clip.mp4?alt=media&token=a25f285a-356c-47c9-85a4-1a33d0764029>" %}

#### How to create a measurement

You can create measurements in **Direct** or **Ray-based** mode.

1. **Open the Measure Tool**
   * Press the **A/X** button on your dominant controller to open the **Toolbar**.
   * Select the **Measure Tool**.
2. **Choose a Mode**
   * Select **Direct** (from the hand) or **Ray-based** (from a distance) mode in the menu.
   * You can also switch modes using the **stick** on your dominant controller.
3. **Create a Ruler**
   * **Option 1:** Press and hold the **trigger button** to draw a ruler of any size, then release to set it.
   * **Option 2:** Press the **trigger button** once to set the start point, then press it again to set the end point.

You can create rulers between objects, surfaces, or in empty space.

#### How to manage measurements

* All created rulers are listed in the Measure Tool menu.
* Point at a ruler in the list to highlight it in the scene — ShapesXR will display the connected measurement line.
* You can:
  * **Hide** the ruler on the current frame.
  * **Teleport** to the ruler.
  * **Delete** the ruler.

To hide all rulers at once, enable the **“Hide all rulers”** toggle in the menu.

#### Axis snap (perpendicular drawing)

You can press the **alt-trigger button** (the trigger button on your non-dominant controller) during the ruler creation to activate **axis snapping mode** - it snaps the endpoint to the nearest axis.

If you draw the ruler from an object, it activates **local axes**; otherwise, if you start drawing in empty space, it activates **world axes**.&#x20;

You can enable Axis Snap **by default** in the Measure Tool menu (toggle name: *\[insert toggle name here]*).

#### How to change a ruler's length

There are several ways to adjust the length of an existing ruler:

1. **Grab and Move**
   * Grab one of the ruler’s endpoints and move it to a new position.
2. **Edit via Label**
   * Select the **Measure Tool**.
   * Click on the ruler’s **label** to open the numpad and enter a new value.
   * Alternatively, point at the label and move the **stick** left or right to adjust the length.
3. **Edit via Menu**
   * Open the **Measure Tool menu**.
   * Find the ruler in the list, click on its **length field**, and change the value using the **numpad** (click on the field to call it) or **arrows**.

#### How to change measurement units&#x20;

You can switch between **meters** and **feet**:

* Open the **Measure Tool menu** or **Settings**, and choose your preferred unit.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.shapesxr.com/objects-creation/measure-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.