Altium NEXUS Documentation


Created: July 7, 2022 | Updated: July 7, 2022
Applies to Altium NEXUS Client version: 5
This documentation page references Altium NEXUS/NEXUS Client (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer (with Altium Designer Enterprise Subscription) and a connected Altium 365 Workspace. Check out the FAQs page for more information.

Parent page: PCB Commands

The following pre-packaged resource, derived from this base command, is available:

Applied Parameters: None


This command is used to measure distances between objects when viewing the PCB in 3D. Object-to-object and distance by board surfaces are calculated. Using this tool, you can quickly verify that clearances between objects are indeed correct in conjunction with 3D clearance checking.

You can also refer to the Measure Distance command.


This command is accessed from the PCB Editor in 3D Layout Mode by choosing the Reports » Measure 3D Objects command from the main menus.

The current viewing mode for the PCB document can be changed using the corresponding commands from the main View menu. To switch to 3D Layout Mode, use the command of the same name or use the 3 keyboard shortcut.


After launching the command, the cursor will change to a cross-hair and you will enter measurement mode. Measurement is performed as follows:

  1. Choose the first 3D object or specific face of that object. As you move the cursor over a potential 3D object, the color of that object will change to green. If you want to select a specific face of the object, hold the Ctrl key as you move the cursor - the face currently under the cursor will be highlighted. With the cursor in place click or press Enter to confirm object/face selection.
  2. The tool will present visual measurements in the workspace for the shortest distance from the underside of this first object (face) to the board surface, and the shortest distance from this first object (face) to the board edge.
  3. Choose the second 3D object or specific face of that object.
  4. The tool will present visual measurements in the workspace for the shortest distance from the underside of this second object (face) to the board surface, and the shortest distance from this second object (face) to the board edge. In addition, the tool also visually presents the shortest distance between the two chosen objects (faces).
  5. The 3D Distance dialog will open, displaying the measurement results. When you have finished examining the results in the dialog, click the OK button to close it.
  6. Continue measuring the distance between other objects/faces or right-click or press Esc to exit measurement mode.
During the measurement process, you can press Shift+C to clear the display of measurements.


  • All measurement results are logged in the Messages panel. You can double-click on a previous entry to cross probe to that measurement.
  • The information about the chosen 3D object includes the Identifier of the chosen 3D Body objects (in parentheses). Having a value for the Identifier will help you know that you have clicked on the right object.
  • The tool calculates the distance between the two closest points on the chosen objects (or faces) - this distance is displayed in yellow. All other measurements are shown in light blue.
  • To calculate the object-to-object distance, the tool must first calculate the location of each of the selected objects. The results of these object-location measurements are also displayed. For the object-to-board measurements, the software calculates the distance from:
    1. the reference point on the object, to the board surface (Z measurement), and
    2. the reference point on the object, to the board edge (X or Y measurement).
    As with the object-to-object measurement, it also triangulates from the reference point on the object to the reference point on the board and displays this direct distance in yellow.
  • To copy the contents of the 3D Distance dialog to Windows Clipboard, press Ctrl+C when the dialog is open.


Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: