Measure Tool

Overview

The measure tool is available in Omniverse USD Composer as a beta feature. It can be used to query for distances between objects with a variety of options. In the latest version, it is also possible to determine staggered distances, angles and areas.

Enabling the Extension

In any supported Kit based App, the measure tool can be enabled via the Extension Manager Simply search for “Measure” and install the extension. Once the extension is installed, The measurement can be activated by clicking the slider.

../_images/ext_measure-tool_activate.png

Measure can be called in Omniverse USD Composer under Tools > Measure. An additional tab will then appear next to Render Settings.

../_images/ext_measure-tool_tools.png

Using Measure

Measure is built up of measurement sub-tools. The main interface panel controls options for each sub-tool.

../_images/ext_measure-tool_ui.png

Note

The Placement area is only visible when one of the sub-tool collectors is selected.

Color

Option

Result

Red

The Sub-tool Selector
This holds the following sub-tools: Measure Selected, Point-to-point, Multi-point, Angle, and Area

Green

Sub-tool Placement Options
This panel holds options to aid in making measurements within the viewport. Some fields are tool-specific. See Placement Parameters for more information.

Yellow

Measurement Display Options
This panel holds options for the measurement during and after the measurement is created. See Display Parameters for more information.

Placement Parameters

The Placement panel is the single source of control for placing points in the viewport to create a measurement.

../_images/ext_measure-tool_placement.png

Option

Result

Snap To
Provides the option to select from custom snapping for Perpendicular (Point-to-point sub-tool only)

Snap: Pivot
Snaps the point to the first raycast-hit object pivot.

Snap: Center
Snaps to the center bound point of the first raycast-hit object. May inherit parent xform center if no transform exists.

Snap: Vertex
Snaps the point to the first raycast-hit surface vertex.

Snap: Mid Point
Snaps the point to the first raycast-hit edge midpoint.

Snap: Edge
Snape the point to the first raycast-hit edge.

Options: Constrain To
Area sub-tool only. Constrains measurement to a plane based on the constrain axis selected.

Display Parameters

The display panel handles configuration options for measurements being created:

../_images/ext_measure-tool_display.png

Option

Result

Display XYZ
Allows for the ability to display World or Local (based on first selection) XYZ dimensions.

Units
Controls the display of measurements in common units (centimeter, inch, millimeter, etc.)

Precision
The number decimal places to use before rounding.

Label Size
The font size of the generated labels for the measurement.

Line Color
Defines the main color of the created measurement.

Note

The line color must be specified before the first measurement selection.

Sub-tools

Sub-tools allow for the creation and viewing of a measurement based on the tool’s context:

Measure Selected

../_images/ext_measure-tool_selected.png

  1. Select 2 prims in the scene. This is required in order to enabled the tool activation.

  2. Adjust the Selected Mode and display options as required for your measuring operation in the Measure panel.

  3. Press the Selected toolbar button in the Measure panel.

  4. A measurement is then established denoting distance in the viewport.

Note

To delete the measurement, select the Measurement in the viewport and press delete.

Point-to-point

../_images/ext_measure-tool_p2p.png

  1. Enable Point-to-Point by pressing the Point-to-Point toolbar button in the Measure Panel.

  2. Adjust the placement and display options for making the selection of the first point in the viewport.

  3. Left-Click in the viewport to make the first point of the measurement.

  4. Left-Click a second time in the viewport to make the end point of the measurement.

  5. Right click in the viewport to clear the measurement and start over (at any time).

Multi-point

../_images/ext_measure-tool_multipoint.png

  1. Enable Multi Point by pressing the Multi Point toolbar button in the Measure Panel.

  2. Adjust the placement and display options for making the selection of the first point in the viewport.

  3. Left-Click in the viewport to make the first point of the measurement.

  4. Append points for each additional Left-Click in the viewport.

  5. Right click in the viewport to finalize the measurement.

  6. Right click to clear the final measurement and start over.

Angle

../_images/ext_measure-tool_angle.png

  1. Enable Angle by pressing the Angle toolbar button in the Measure Panel.

  2. Adjust the placement and display options for making the selection of the first point in the viewport.

  3. Left-Click in the viewport to make the first point of the measurement.

  4. Left-Click a second time in the viewport to make the mid point of the measurement.

  5. Left-Click a third and final time in the viewport to make the end point of the measurement.

  6. Right click in the viewport to clear the measurement and start over (at any time).

Area

../_images/ext_measure-tool_area.png

  1. Enable Area by pressing the Area toolbar button in the Measure Panel.

  2. Adjust the placement and display options for making the selection of the first point in the viewport.

  3. Left-Click in the viewport to make the first point of the measurement.

  4. Append points for each additional Left-Click in the viewport. Three points are required to calculate the area.

  5. Right click in the viewport to finalize the measurement.

  6. Right click to clear the final measurement and start over.

Note

Use the Constrain to property to align points along a specific axis plane. Default aligns to the Scene Up of the stage.