---
title: getMeasureSettings
slug: viewer-3d/methods/getMeasureSettings
docTags: 
createdAt: 2024-03-01T14:17:48.683Z
---

Returns the current measure tool settings.

## Example

::codepen{url="https://codepen.io/Catenda/embed/VwJRLwZ"}

## Usage

```javascript
const measureSettings = viewer3d.getMeasureSettings();
```

## Return Value

The measure tool settings.

| **Type** |
| -------- |
| Object   |

:::hint{type="info"}
The default unit for measurements is meters.
:::

**Properties**

| **Name**           | **Type** | **Description**                                           |
| ------------------ | -------- | --------------------------------------------------------- |
| `appendMeasures`   | Boolean  | Replaces existing measures when using `addMeasure` method |
| `conversionFactor` | Number   | Conversion factor applied to measure values               |
| `decimals`         | Number   | Number of decimals displayed for measure values           |
| `labelMode`        | String   | Position of measure label                                 |

**labelMode**

The following label modes are available:

- `pointDistance`
- `segmentLength`
- `segmentIndex`

### Example

```javascript
{
  appendMeasures: true,
  conversionFactor: 1000,
  decimals: 0,
  labelMode: "segmentLength",
};
```