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

Adds a measure to the scene.

## Example

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

## Usage

```javascript
const measure = {
  mode: "laser",
  point: {
    x: 0,
    y: 0,
    z: 0
  },
  normal: {
    x: 0,
    y: 0,
    z: 1
  }
};

viewer3d.addMeasure(measure);
```

## Parameters

### measure

The measure to add.

| **Type** | **Required** |
| -------- | ------------ |
| Object   | Yes          |

**Laser Mode**

| **Name** | **Type**                                | **Required** | **Description**                   |
| -------- | --------------------------------------- | ------------ | --------------------------------- |
| `mode`   | String                                  | Yes          | `laser`                           |
| `point`  | [Vector3](docId\:kEwRHKTC8Iq2HlT48sRFQ) | Yes          | The point to measure              |
| `normal` | [Vector3](docId\:kEwRHKTC8Iq2HlT48sRFQ) | Yes          | The normal vector                 |
| `uuid`   | String                                  | No           | Optional id for the added measure |

**Point Mode**

| **Name** | **Type**                                | **Required** | **Description**                   |
| -------- | --------------------------------------- | ------------ | --------------------------------- |
| `mode`   | String                                  | Yes          | `point`                           |
| `point`  | [Vector3](docId\:kEwRHKTC8Iq2HlT48sRFQ) | Yes          | The point to measure              |
| `normal` | [Vector3](docId\:kEwRHKTC8Iq2HlT48sRFQ) | No           | The normal vector                 |
| `uuid`   | String                                  | No           | Optional id for the added measure |