# 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.