Working with the Cursor-Snap System in Altium NEXUS

Now reading version 2.0. For the latest, read: Working with the Cursor-Snap System in Altium NEXUS for version 5

Nexus message

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 and a connected Altium 365 Workspace. Check out the FAQs page for more information.

 

The PCB Editor is a grid-based design environment - design objects are placed on what is referred to as the placement, or snap grid. Multiple snap grids can be defined, and these can be restricted to a specified area if required. Snap grids are prioritized, with the highest priority grid available at the current location, being applied automatically. Snap grids can also be restricted to Components, or Non Components.

As well as the snap grid, the software includes a number of additional snap features, designed to help you accurately position and align design objects. Together, these features are referred to as the Unified Cursor-Snap System. 'Cursor-snap' is the process whereby the physical mouse cursor's pixel position on the screen drives the position of a 'logical cursor' in the coordinate space of a design document such as a PCB. The objective is for the system to be able to place the logical cursor onto sensible and useful coordinates without the user needing to specify these in a high resolution way. Variable geometry boards - where component pins are often placed on quite different metric and imperial grids - serve to add greater complexity to this objective.

The system brings together three different sub-systems to collectively drive the way that the cursor snaps onto given sets of preferred coordinates:

  • User-Definable Grids - available in both Cartesian and Polar formats.
  • Snap Guides - that can be freely placed and provide a handy visual cue for object alignment.
  • Hotspot Snapping - enabling placed objects to pull the cursor into position, based on cursor proximity to that object's hotspot(s).

These features combine to ensure streamlined placement and alignment of objects in the PCB workspace.

Accessing the Unified Cursor-Snap System

The Unified Cursor-Snap System is configured in the Properties panel (accessed when there are no design objects currently selected in the design workspace). The images below show the sections of the panel that are used to configure the unified cursor-snap system.

Access controls for the Unified Cursor-Snap System in the Properties panel, including the Snap Options, Grid Manager and Guide Manager. Access controls for the Unified Cursor-Snap System in the Properties panel, including the Snap Options, Grid Manager and Guide Manager.

The following three sections of the panel are used to configure:

  • Snap Options - providing options to determine cursor snapping:
    • Snap To Grids - used to toggle whether the cursor will snap to the defined grids. When this option is enabled the cursor will pull, or snap, to the nearest snap grid location. The current snap grid is displayed on the Status bar, and in the PCB editor Heads Up display (Shift+H to toggle on/off).
    • Snap To Guides - used to toggle whether the cursor will snap to manually placed linear or point Snap Guides. A Snap Guide will override the Snap Grid.
    • Snap to Object Hotspots - used to control whether the cursor will snap to the hotspot(s) of placed objects, when it is within the current Snap Distance from a hotspot. An Object Hotspot will override a Snap Guide, which overrides the Snap Grid.
    • Objects for snapping - used to control whether the cursor will align to a placed object's hotspot (snap to, but only in the X or the Y direction). A dynamic alignment guide line is displayed when alignment is achieved, from the current cursor location to an Object Hotspot that is within the current Near Range, for object-types that have their Near option enabled. If an object-type has the Far option enabled, the alignment guide will be displayed, regardless of the distance from the cursor to an Object Hotspot. Use the axial alignment feature to help align design objects that need to have the same X or Y workspace value.
  • Grid Manager - where local customized grids can be defined and managed, as well as the default Snap Grid for the board.
  • Guide Manager - where a range of manual Snap Guides and Snap Points for the board can be defined and managed.

Snap behavior only occurs when there is an edit cursor displayed (cross-hair), such as during object placement or movement.

Select View » Toggle Units (or press the Q shortcut) to switch the workspace units between imperial and metric. The current Snap Grid and workspace location are displayed on the Status bar, and also in the Heads-Up display (Shift+H to toggle on/off).

User-Definable Grids

Any number of user-defined grids can be configured for the workspace, with all grid management performed from within the Grid Manager section of the Properties panel (accessed when there are no design objects currently selected in the design workspace). Use the controls available to define custom local grids by which to place design objects - especially components - with greater precision.


The Grid Manager section of the Properties panel - command central for defining and organizing the
grids for use with your board.

The cursor will only snap to a defined grid provided the option Snap To Grids is enabled, in the Snap Options section of the Properties panel.

Grid Types

The software supports the creation of the following two custom grid types:

  • Cartesian Grid - create a new grid of this type using the Add Cartesian Grid command (available from the  button). A new grid entry will appear in the list, initially with the default name New Cartesian Grid. To edit the grid, simply double-click on its entry, or select its entry and click the  button. The Cartesian Grid Editor dialog will appear, presenting options with which to define the grid.

Example Cartesian grid definition, using the Cartesian Grid Editor dialog, and resulting appearance in the workspace.Example Cartesian grid definition, using the Cartesian Grid Editor dialog, and resulting appearance in the workspace.

  • Polar Grid - create a new grid of this type using the Add Polar Grid command (available from the  button). A new grid entry will appear in the list, initially with the default name New Polar Grid. To edit the grid, simply double-click on its entry, or select its entry and click the  button. The Polar Grid Editor dialog will appear presenting options with which to define the grid.

Example Polar grid definition, using the Polar Grid Editor dialog, and resulting appearance in the workspace.Example Polar grid definition, using the Polar Grid Editor dialog, and resulting appearance in the workspace.

Quickly access the relevant editor for a defined grid in the workspace, by hovering the cursor over an area of the board using that grid and pressing the Ctrl+G keyboard shortcut.

Default Snap Grid

A default snap grid is defined for the board, named Global Board Snap Grid. This is the grid that is used for object placement and movement in any area of the board not covered by a dedicated local grid.

Global Board Snap Grid - used in any area of the board where a custom local grid has not been defined.Global Board Snap Grid - used in any area of the board where a custom local grid has not been defined.

The default grid is a Cartesian-type grid. The step size and/or display for the grid can be modified, but the grid cannot be renamed, disabled, or deleted.

Defining the Purpose of a Grid

A local grid can be used in a variety of situations:

  • In the placement of non-component objects only.
  • In the placement of components only.
  • In the placement of both non-component objects and components.

Definition of how a grid can be used - its purpose or application - is performed using the Comp and Non Comp options, associated with that grid's entry in the Grid Manager section of the Properties panel.

Use the Comp and Non Comp options to determine local grid application.Use the Comp and Non Comp options to determine local grid application.

When specifying a component-only grid (Non Comp option disabled, Comp option enabled), the grid will only display when performing a component-based action, such as moving a component.

Defining the Grid Display

For any custom grid you define, as well as the Global Board Snap Grid, options are provided to control how the grid is presented visually in the workspace. Two levels can be defined:

  • Fine - the fine-level display grid is for when you are more zoomed-in. The grid markers for this level of grid display follow directly the defined step sizes for the grid.
  • Coarse - the optional coarse-level display grid comes into play as you zoom out. The grid markers for this level of grid display are based on a specified multiple of the defined step sizes.

Example Cartesian grid with fine- and coarse-level display grids presented in the workspace. Left: Fine-level displayed using dots, coarse-level using Lines. Right: Both fine- and
coarse-level grids displayed using Lines.

Individual grid display coloring is defined when editing a grid in the relevant grid editor (Cartesian Grid Editor dialog, or Polar Grid Editor dialog). Alternatively, a single nominated color can quickly be assigned for the Fine and Coarse display grids, from the Grid Manager section of the Properties panel. To do this, simply click the color swatch in the grid's associated Color field, then choose the required color from the subsequent color palette that appears.
Fine and Coarse display grid colors can be reset to a specified default color by clicking the Reset to Default link in a grid editor. Default coloring is defined in the General Settings section, on the View Options tab of the View Configuration panel. Simply click the color swtch to the right of the Show Grid option, and choose the required color from the subsequent color palette that appears. Note that this single default color will be used for both Fine and Coarse display grids. Note also, that changing the color here will affect only the default Global Board Snap Grid. Existing custom grids will retain the dispaly colors set for them - only reverting to this new color if the Reset to Default link is used.

Nesting and Grid Priority

The local grids you define in the Grid Manager section of the Properties panel can be freely stacked within the board area. By specifying origin coordinates accordingly, grids can be overlapped, creating a nested hierarchy of grids, with which to fine tune placement of design objects as you layout your board.

Grid contention - which grid in an overlapping stackup of grids should a design object snap to - is resolved using a priority system. Each local placement grid you create and define is given a numbered priority. By default, each new grid is given the highest priority of 1, with all existing grids moved down in priority accordingly.

The Global Board Snap Grid is an exception. As it is the default grid that is used in all areas of the board that are not 'covered' by defined custom grids, it is given the priority setting of 50 - a low enough priority setting to ensure that it has the lowest 'snapping priority' of all defined grids.

In the workspace, priority is distinguished by drawing order. The highest priority grid (priority 1) will be drawn in front of all other grids, then the grid with priority level 2, and so on, down to the default Global Board Snap Grid, which is drawn behind all other custom grids.

An example of three nested Polar grids. The Yellow Polar Grid has the highest priority and appears on top. The Red Polar Grid is next priority, appearing behind the yellow grid,
but in front of the aqua grid. The default grid appears behind all of these grids, as all custom grids take precedence over it in the priority stakes.

The priority of the Global Board Snap Grid cannot be changed - it is fixed to always have a priority of 50.

Disabling a Grid

There may be occasion where a grid isn't needed while placing or moving a particular design object. Rather than deleting the grid - it may be needed again later, in the same or different area of the board - it can simply be 'hidden' from the workspace. This can be achieved by disabling the grid's associated Comp and Non Comp attributes, in the Grid Manager section of the Properties panel.

Disable a local grid to effectively hide it, therefore preventing objects snapping to it. Using the nested grids example, the Red Polar grid has been disabled. As the grid has not
been deleted, you can re-enable and use again when needed, without having to redefine it!

The default Global Board Snap Grid is permanently enabled, as this is the default grid that is used when no local grid has been defined for an area of the board. However it, and all defined grids, can be hidden by disabling the Show Grid option, in the General Settings section, on the View Options tab of the View Configuration panel.

Deleting a Grid

Custom grids can be deleted simply by selecting their corresponding entry in the Grid Manager section of the Properties panel, and clicking the  button. You will be asked to confirm the deletion - click Yes to do so.

Remember that the default Global Board Snap Grid cannot be deleted.

Snap Guides

Snap Guides are special objects that are manually placed specifically for the purpose of driving the cursor-snap on a certain axis or point - assisting in object/component placement. They can also serve as a visual indicator for general layout or alignment purposes. The following types of snap guide are supported:

  • Linear Guide - a line-style guide that can be horizontal, vertical or +/- 45 Degrees.
  • Point Guide - a point-style guide offering finer control over object placement. It is simply a hotspot that is manually marked within the confines of a defined grid.

Any number of snap guides can be defined for the workspace, with controls for placement and management available from the Guide Manager section of the Properties panel (accessed when there are no design objects currently selected in the design workspace). And while controls are available for adding new snap guides from within this section (from the  button), it is far easier to visually add them (from the  button) directly in the workspace, then fine-tune them as required.

Snap Guides can also be placed using commands available from the Place » Work Guides sub-menu.

Snap Guides behave in the same manner as the snap grid, the cursor will snap to a guide as it passes, when an object is being moved.

The Guide Manager section of the Properties panel - command central for managing visual placement guides for use in the workspace.
Shown here are examples of the various Snap Guides available to assist object placement.

During an interactive process such as placing or moving, the cursor will snap to a placed Linear Guide, at the point where that guide intersects a defined grid. Using a Linear Guide, objects can quickly be aligned simply by dragging them until they 'snap' against the guideline. For a Point Guide, the hotspot for the object being moved will 'snap' to the guide when it passes into close proximity with it.

It can be easier to visually locate a Point Guide when the grid display is set to Dots.

Disabling a Guide

There may be occasion where a snap guide isn't needed while placing or moving a particular design object. Rather than deleting the guide - it may be needed again later, in the same or different area of the board - it can simply be 'hidden' from the workspace. This can be achieved by disabling the guide's associated Enabled attribute in the Guide Manager section of the Properties panel.

Disable a snap guide to effectively hide it, therefore preventing objects snapping to it. In this image, the +45 and -45 guides have
been disabled. As the guides have not been deleted, you can re-enable and use them again when needed, without having to redefine
them!

Deleting a Guide

To delete a snap guide, select its entry in the Guide Manager section of the Properties panel, and click the  button. You will be asked to confirm the deletion - click Yes to do so.

Working with Object Hotspots

Every object in the PCB design space is considered to have a number of important points, such as the center of a pad, ends of an arc, corners of a fill, ends (and centerline) of a track, and so on. These Snap-Points are referred to as hotspots. Every object has one or more of these hotspots, and different hotspots on an object can have different attractive forces for the cursor. For example, the endpoints and mid-points of tracks have a higher 'pull' than other points along the track centerline.

There are two distinct types of cursor snap behaviors that use these hotspots:

  • Snap to an Object Hotspot - the edit cursor jumps to an object's hotspot when it is within the Snap Distance configured in the Properties panel.
  • Axis-align to an Object Hotspot - the edit cursor aligns to an object's hotspot when it is within the Near Range, for the Near objects enabled in the Objects for snapping options , and for any distance for the Far objects enabled in the Objects for snapping options configured in the Properties panel. When axis-alignment occurs a guide line is displayed, from the current cursor location to the object's hotspot. Use this to help align design objects that need to have the same X or Y workspace value.

Snap to an Object Hotspot

It is often impossible or impractical to define a grid that all design objects fall on to. In that situation you might need to position a new design object at an off-grid location. The software supports this through a feature called Object Snap, which is essentially a range of attraction around that object's hotspot. Hotspots only exist at meaningful locations, such as the center of a pad or via, and the end points of track segments.

This is a dual-axis system, where the mouse cursor must within the Snap Distance on both the X and Y axes, in order for the object to pull the cursor towards that hotspot. Object hotspot snapping provides an aid to routing electrical objects, especially those which may not fall on the active snap grid. The Snap Distance is configured in the Properties panel, when there are no objects selected in the workspace.

Off-grid objects can be snapped to, using the object hotspot snapping feature.Off-grid objects can be snapped to, using the object hotspot snapping feature.

The Snap to Object Hotspots feature has three modes, use the buttons in the Snap to Object Hotspots section of the Properties panel to select the required mode, or use the Shift+E keyboard shortcut to cycle through the modes as you work:

  • Current Layer - hotspot snap is enabled for the current layer. That is, the cursor will snap to object hotspots on the current layer only. This mode is reflected on the Status Bar as (Hotspot Snap).
  • All Layers - hotspot snap is enabled for all visible layers. That is, the cursor will snap to object hotspots on any layer, not just the current layer. This mode is reflected on the Status Bar as (Hotspot Snap (All Layers)).
  • Off - hotspot snapping is disabled. The Status Bar displays nothing about Hotspot snap in this mode.
  • The Status Bar reflects the current state of object hotspot snapping.
  • Hold the Ctrl shortcut key to temporarily disable object hotspot snapping.

Axial Alignment to an Object Hotspot

As well as snapping the cursor to an object's hotspot, the software also supports axial alignment to an object's hotspot. Use this to align the moving object to an existing off-grid object. As an object is moved in the workspace, guides are automatically generated by the system (dynamic alignment guides), based on the hotspots of existing placed objects, within the vicinity of the cursor. The cursor can be pulled into alignment with either the horizontal or vertical position of an object's hotspot. This allows an object hotspot that is close to the mouse cursor on one axis, but distant on the other axis, to drive the cursor position.

With the axial alignment feature dynamic alignment guides appear in the workspace, from the cursor to the hotspots
of existing placed objects.

 

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Content