Altium Designer Documentation

PlaceRegion

Created: December 30, 2020 | Updated: January 8, 2021

Parent page: PCB Commands

The following pre-packaged resources, derived from this base command, are available:


Applied Parameters: UpdateCaption=False

Summary

This command is used to place a Region object onto the active document, whose Kind property is set to Copper. Referred to thereafter as a copper (or solid) region, it is a polygonal-shaped primitive object that can be placed on any layer. It can have any number of sides and vertices (corners). It can be placed on a signal layer to define an area of solid copper, to be used to provide shielding, or to carry large currents. Positive regions can be combined with tracks or arc segments and be connected to a net. In the PCB Library Editor, regions can be used to create custom pad shapes on copper layers or special mask shapes on the solder and paste masks. On non-electrical layers regions can be used to define custom shapes for tasks such as logos.

For detailed information about this object type, see Region.

Access

This command can be accessed from the PCB Editor and PCB Library Editor by:

  • Choosing the Place » Solid Region command from the main menus.
  • Locating and using the Solid Region command () on the Active Bar.
If the command has been recently used from the Active Bar, it will become the active/visible button. Where other commands are available, this is indicated by a triangle at the bottom-right corner of the button. Click and hold on the active button to access a menu of all associated commands for that grouping.
  • Right-clicking in the workspace then choosing the Place » Solid Region command from the context menu (PCB Editor only).

Use

After launching the command, the cursor will change to a cross-hair and you will enter region placement mode. Placement is made by performing the following sequence of actions:

  1. Position the cursor then click or press Enter to anchor the starting vertex for the region.
  2. Move the cursor ready to place the second vertex. The default behavior is to place two edges with each click, with a user-defined corner shape between them. Refer to the Placement Modes section below for more details on changing corner modes.
  3. Continue to move the mouse then click or press Enter to place further vertices.
  4. After placing the final vertex right-click or press Esc to close and complete placement of the region. There is no need to manually close the region since the software will automatically complete the shape by connecting the start point to the final point placed.
  5. Continue placing further regions or right-click or press Esc to exit placement mode.
Press the Tab key to access the Properties panel, from where properties for the solid region can be changed on-the-fly. Pressing Tab pauses placement, allowing you to interact with the panel (or other area of the software) directly. To resume, click the pause symbol that appears over the workspace, or press Esc.

Additional actions that can be performed during placement include:

  • Press the + and - keys on the numeric keypad to cycle forward and backward through all layers currently visible in the design.
  • Press the * key to cycle through the visible signal layers.

Placement Modes

While placing a region there are five available corner modes, four of which also have corner direction sub-modes. During placement:

  • Press Shift+Spacebar to cycle through the five available corner modes: 45 degree, 45 degree with arc, 90 degree, 90 degree with arc, and Any Angle.
  • Press Spacebar to toggle between the two corner direction sub-modes.
  • When in either of the arc corner modes, hold the  or  keys to shrink or grow the arc. Hold the Shift key as you press to accelerate arc resizing.
  • Press the 1 shortcut key to toggle between placing two edges per click, or one edge per click. In this second mode the dashed edge is referred to as the look-ahead segment (as shown in the last image in the set below).
  • Press the Backspace key to remove the last vertex.

Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge. Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge.Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between
two edges or one edge.

Tips

  1. A region will adopt a net name if it is placed over an object that is already connected to a net.
  2. While attributes can be modified during placement (Tab to bring up the Properties panel), keep in mind that these will become the default settings for further placement unless the Permanent option on the PCB Editor – Defaults page of the Preferences dialog is enabled. When this option is enabled, changes made will affect only the object being placed and subsequent objects placed during the same placement session.


Applied Parameters: RegionKind=Cutout|UpdateCaption=False

Summary

This command is used to place a Region object onto the active document, whose Kind property is set to Polygon Cutout. Referred to thereafter as a polygon pour cutout, it is a polygonal-shaped primitive object that can be placed on any layer. It can have any number of sides and vertices (corners). Since it is placed as a negative, this type of region can create a cutout (a void) in a polygon pour. In this mode the region will not be filled with copper when the polygon is poured.

For detailed information about this object type, see Region.

Access

This command can be accessed from the PCB Editor and PCB Library Editor by:

  • Choosing the Place » Polygon Pour Cutout command from the main menus.
  • Locating and using the Polygon Pour Cutout command () on the Active Bar.
If the command has been recently used from the Active Bar, it will become the active/visible button. Where other commands are available, this is indicated by a triangle at the bottom-right corner of the button. Click and hold on the active button to access a menu of all associated commands for that grouping.
  • Right-clicking in the workspace then choosing the Place » Polygon Pour Cutout command from the context menu (PCB Editor only).

Use

After launching the command, the cursor will change to a cross-hair and you will enter region placement mode. You can either place the region within the bounds of the intended polygon pour object, or place elsewhere and move into position afterwards. Placement is made by performing the following sequence of actions:

  1. Position the cursor then click or press Enter to anchor the starting vertex for the region.
  2. Move the cursor ready to place the second vertex. The default behavior is to place two edges with each click, with a user-defined corner shape between them. Refer to the Placement Modes section below for more details on changing corner modes.
  3. Continue to move the mouse then click or press Enter to place further vertices.
  4. After placing the final vertex, right-click or press Esc to close and complete placement of the region. There is no need to manually close the region as the software will automatically complete the shape by connecting the start point to the final point placed.
  5. Continue placing further regions or right-click or press Esc to exit placement mode.
Press the Tab key to access the Properties panel, from where properties for the cutout can be changed on-the-fly. Pressing Tab pauses placement, allowing you to interact with the panel (or other area of the software) directly. To resume, click the pause symbol that appears over the workspace, or press Esc.

Additional actions that can be performed during placement include:

  • Press the + and - keys on the numeric keypad to cycle forward and backward through all layers currently visible in the design.
  • Press the * key to cycle through the visible signal layers.

Placement Modes

While placing a region there are five available corner modes, four of which also have corner direction sub-modes. During placement:

  • Press Shift+Spacebar to cycle through the five available corner modes: 45 degree, 45 degree with arc, 90 degree, 90 degree with arc, and Any Angle.
  • Press Spacebar to toggle between the two corner direction sub-modes.
  • When in either of the arc corner modes, hold the  or  keys to shrink or grow the arc. Hold the Shift key as you press to accelerate arc resizing.
  • Press the 1 shortcut key to toggle between placing two edges per click, or one edge per click. In this second mode the dashed edge is referred to as the look-ahead segment (as shown in the last image in the set below).
  • Press the Backspace key to remove the last vertex.

Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge. Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge.Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between
two edges or one edge.

Tips

  1. While attributes can be modified during placement (Tab to bring up the Properties panel), keep in mind that these will become the default settings for further placement unless the Permanent option on the PCB Editor – Defaults page of the Preferences dialog is enabled. When this option is enabled, changes made will affect only the object being placed and subsequent objects placed during the same placement session.


Applied Parameters: RegionKind=BoardRegion|BoardPlanningMode=True

Summary

This command is used to place a Board Region object onto the active document. A Board Region is a user-defined area of a PCB that can have a unique layer stack assigned to it. A PCB can have a single Board Region (for a traditional rigid PCB), or be made up of multiple Board Regions (for a rigid-flex PCB). The overall outer edge of the Board Region(s) defines the Board Shape.

For detailed information about this object type, see Board Region.

Access

This command is accessed from the PCB Editor when in Board Planning Mode by:

  • Choosing the Place » Board Region command from the main menus.
  • Locating and using the Board Region command () on the Active Bar.
If the command has been recently used from the Active Bar, it will become the active/visible button. Where other commands are available, this is indicated by a triangle at the bottom-right corner of the button. Click and hold on the active button to access a menu of all associated commands for that grouping.
  • Right-clicking in the workspace then choosing the Place » Board Region command from the context menu.

Use

After launching the command, the cursor will change to a cross-hair and you will enter region placement mode. You can either place the region within the bounds of the intended polygon pour object, or place elsewhere and move into position afterwards. Placement is made by performing the following sequence of actions:

  1. Position the cursor then click or press Enter to anchor the starting vertex for the region.
  2. Move the cursor ready to place the second vertex. The default behavior is to place two edges with each click, with a user-defined corner shape between them. Refer to the Placement Modes section below for more details on changing corner modes.
  3. Continue to move the mouse then click or press Enter to place further vertices.
  4. After placing the final vertex, right-click or press Esc to close and complete placement of the region. There is no need to manually close the region as the software will automatically complete the shape by connecting the start point to the final point placed.
  5. Continue placing further regions or right-click or press Esc to exit placement mode.
Press the Tab key to access the Properties panel, from where properties for the cutout can be changed on-the-fly. Pressing Tab pauses placement, allowing you to interact with the panel (or another area of the software) directly. To resume, click the pause symbol that appears over the workspace, or press Esc.

Additional actions that can be performed during placement include:

  • Press the + and - keys on the numeric keypad to cycle forward and backward through all layers currently visible in the design.
  • Press the * key to cycle through the visible signal layers.

Placement Modes

While placing a region there are five available corner modes, four of which also have corner direction sub-modes. During placement:

  • Press Shift+Spacebar to cycle through the five available corner modes: 45 degree, 45 degree with arc, 90 degree, 90 degree with arc, and Any Angle.
  • Press Spacebar to toggle between the two corner direction sub-modes.
  • When in either of the arc corner modes, hold the  or  keys to shrink or grow the arc. Hold the Shift key as you press to accelerate arc resizing.
  • Press the 1 shortcut key to toggle between placing two edges per click, or one edge per click. In this second mode the dashed edge is referred to as the look-ahead segment (as shown in the last image in the set below).
  • Press the Backspace key to remove the last vertex.

Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge. Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge.Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between
two edges or one edge.

Tips

  1. While attributes can be modified during placement (Tab to bring up the Properties panel), keep in mind that these will become the default settings for further placement unless the Permanent option on the PCB Editor – Defaults page of the Preferences dialog is enabled. When this option is enabled, changes made will affect only the object being placed and subsequent objects placed during the same placement session.


Applied Parameters: RegionKind=BoardCutout

Summary

This command is used to place a Region object onto the active document, whose Kind property is set to Board Cutout. Referred to thereafter as a board cutout, it is a polygonal-shaped primitive object that is placed on the Multilayer layer. It can have any number of sides and vertices (corners). Since it is placed as a negative, this type of region defines an area that becomes a hole through the finished board. Board cutout regions are transferred to Gerber and ODB++ files for manufacturing purposes.

For detailed information about this object type, see Region.

Access

This command is accessed from the PCB Editor by choosing the Design » Board Shape » Define Board Cutout command from the main menus.

Use

After launching the command, the cursor will change to a cross-hair and you will enter region placement mode. Placement is made by performing the following sequence of actions:

  1. Position the cursor then click or press Enter to anchor the starting vertex for the region.
  2. Move the cursor ready to place the second vertex. The default behavior is to place two edges with each click, with a user-defined corner shape between them. Refer to the Placement Modes section below for more details on changing corner modes.
  3. Continue to move the mouse then click or press Enter to place further vertices.
  4. After placing the final vertex, right-click or press Esc to close and complete placement of the region. There is no need to manually close the region since the software will automatically complete the shape by connecting the start point to the final point placed.
  5. Continue placing further regions or right-click or press Esc to exit placement mode.
Press the Tab key to access the Properties panel, from where properties for the cutout can be changed on-the-fly. Pressing Tab pauses placement, allowing you to interact with the panel (or other area of the software) directly. To resume, click the pause symbol that appears over the workspace, or press Esc.

Additional actions that can be performed during placement include:

  • Press the + and - keys on the numeric keypad to cycle forward and backward through all layers currently visible in the design.
  • Press the * key to cycle through the visible signal layers.

Placement Modes

While placing a region there are five available corner modes, four of which also have corner direction sub-modes. During placement:

  • Press Shift+Spacebar to cycle through the five available corner modes: 45 degree, 45 degree with arc, 90 degree, 90 degree with arc, and Any Angle.
  • Press Spacebar to toggle between the two corner direction sub-modes.
  • When in either of the arc corner modes, hold the  or  keys to shrink or grow the arc. Hold the Shift key as you press to accelerate arc resizing.
  • Press the 1 shortcut key to toggle between placing two edges per click, or one edge per click. In this second mode the dashed edge is referred to as the look-ahead segment (as shown in the last image in the set below).
  • Press the Backspace key to remove the last vertex.

Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge. Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge.Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between
two edges or one edge.

Tips

  1. While attributes can be modified during placement (Tab to bring up the Properties panel), keep in mind that these will become the default settings for further placement unless the Permanent option on the PCB Editor – Defaults page of the Preferences dialog is enabled. When this option is enabled, changes made will affect only the object being placed and subsequent objects placed during the same placement session.


Applied Parameters: RegionKind=BoardCutout|BoardPlanningMode=True

Summary

This command is used to place a Board Cutout Region object onto the active document, which creates an internal cutout in the board.  A Board Cutout is also a polygonal object, so has the same placement process as the Board Region itself. The images below show a Board Region with two Board Cutouts, these become holes in the board when it is fabricated. Referred to thereafter as a board cutout, it is a polygonal-shaped primitive object that is placed on the Multilayer layer. It can have any number of sides and vertices (corners). Since it is placed as a negative, this type of region defines an area that becomes a hole through the finished board.

For detailed information about this object type, see Board Region.

Access

This command is accessed from the PCB Editor when in Board Planning Mode by:

  • Choosing the Place » Define Board Cutout command from the main menus.
  • Locating and using the Board Cutout Region command () on the Active Bar.
If the command has been recently used from the Active Bar, it will become the active/visible button. Where other commands are available, this is indicated by a triangle at the bottom-right corner of the button. Click and hold on the active button to access a menu of all associated commands for that grouping.
  • Right-clicking in the workspace then choosing the Place » Define Board Cutout command from the context menu.

Use

After launching the command, the cursor will change to a cross-hair and you will enter region placement mode. Placement is made by performing the following sequence of actions:

  1. Position the cursor then click or press Enter to anchor the starting vertex for the region.
  2. Move the cursor ready to place the second vertex. The default behavior is to place two edges with each click, with a user-defined corner shape between them. Refer to the Placement Modes section below for more details on changing corner modes.
  3. Continue to move the mouse then click or press Enter to place further vertices.
  4. After placing the final vertex, right-click or press Esc to close and complete placement of the region. There is no need to manually close the region since the software will automatically complete the shape by connecting the start point to the final point placed.
  5. Continue placing further regions or right-click or press Esc to exit placement mode.
Press the Tab key to access the Properties panel, from where properties for the cutout can be changed on-the-fly. Pressing Tab pauses placement, allowing you to interact with the panel (or other area of the software) directly. To resume, click the pause symbol that appears over the workspace, or press Esc.

Additional actions that can be performed during placement include:

  • Press the + and - keys on the numeric keypad to cycle forward and backward through all layers currently visible in the design.
  • Press the * key to cycle through the visible signal layers.

Placement Modes

While placing a region there are five available corner modes, four of which also have corner direction sub-modes. During placement:

  • Press Shift+Spacebar to cycle through the five available corner modes: 45 degree, 45 degree with arc, 90 degree, 90 degree with arc, and Any Angle.
  • Press Spacebar to toggle between the two corner direction sub-modes.
  • When in either of the arc corner modes, hold the  or  keys to shrink or grow the arc. Hold the Shift key as you press to accelerate arc resizing.
  • Press the 1 shortcut key to toggle between placing two edges per click, or one edge per click. In this second mode the dashed edge is referred to as the look-ahead segment (as shown in the last image in the set below).
  • Press the Backspace key to remove the last vertex.

Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge. Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge.Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between
two edges or one edge.

Tips

  1. While attributes can be modified during placement (Tab to bring up the Properties panel), keep in mind that these will become the default settings for further placement unless the Permanent option on the PCB Editor – Defaults page of the Preferences dialog is enabled. When this option is enabled, changes made will affect only the object being placed and subsequent objects placed during the same placement session.


Applied Parameters: Keepout=True|UpdateCaption=False

Summary

This command is used to place a Keepout Solid Region object onto the active document. A Keepout in PCB design is a user-defined area or perimeter placed in the layout that copper objects cannot intersect. Typically included to control the area used by automated copper placement actions, such as polygon pours and interactive routing, a Keepout also represents an invalid location when manually placing copper objects. 

As specified ‘no go’ areas during design layout, Keepout objects use the existing Clearance Constraint Rules to control routing and detect placement violations, but unlike other placed objects, cannot be assigned to a Net and are not shown in generated Outputs or printouts. In its simplest sense, a Keepout acts as an ‘interference’ object that prevents other copper objects from intersecting its area as specified by the global Clearance Rule.

Access

This command is accessed from the PCB Editor and PCB Library Editor by:

  • Choosing the Place » Keepout » Solid Region command from the main menus.
  • Locating and using the Keepout Solid Region command () on the Active Bar.
If the command has been recently used from the Active Bar, it will become the active/visible button. Where other commands are available, this is indicated by a triangle at the bottom-right corner of the button. Click and hold on the active button to access a menu of all associated commands for that grouping.
  • Right-clicking in the workspace then choosing the Place » Keepout » Solid Region command from the context menu (PCB Editor only).
Keepouts can be placed on all (copper) signal layers, excluding copper planes. When the currently active board layer is not compatible with Keepouts, the command is not available (grayed out).

Use

After launching the command, the cursor will change to a cross-hair and you will enter keepout solid region placement mode. Placement is made by performing the following sequence of actions:

  1. Position the cursor then click or press Enter to anchor the starting vertex for the keepout solid region.
  2. Move the cursor ready to place the second vertex. The default behavior is to place two edges with each click, with a user-defined corner shape between them. Refer to the Placement Modes section below for more details on changing corner modes.
  3. Continue to move the mouse then click or press Enter to place further vertices.
  4. After placing the final vertex, right-click or press Esc to close and complete placement of the keepout solid region. There is no need to manually close the keepout solid region since the software will automatically complete the shape by connecting the start point to the final point placed.
  5. Continue placing further keepout solid regions or right-click or press Esc to exit placement mode.
Press the Tab key to access the Properties panel, from where properties for the keepout solid region can be changed on-the-fly. Pressing Tab pauses placement, allowing you to interact with the panel (or other area of the software) directly. To resume, click the pause symbol that appears over the workspace, or press Esc.

Additional actions that can be performed during placement include:

  • Press the + and - keys on the numeric keypad to cycle forward and backward through all layers currently visible in the design.
  • Press the * key to cycle through the visible signal layers.

Placement Modes

While placing a keepout solid region there are five available corner modes, four of which also have corner direction sub-modes. During placement:

  • Press Shift+Spacebar to cycle through the five available corner modes: 45 degree, 45 degree with arc, 90 degree, 90 degree with arc, and Any Angle.
  • Press Spacebar to toggle between the two corner direction sub-modes.
  • When in either of the arc corner modes, hold the  or  keys to shrink or grow the arc. Hold the Shift key as you press to accelerate arc resizing.
  • Press the 1 shortcut key to toggle between placing two edges per click, or one edge per click. In this second mode the dashed edge is referred to as the look-ahead segment (as shown in the last image in the set below).
  • Press the Backspace key to remove the last vertex.

Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge. Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between

two edges or one edge.Press Shift+Spacebar to cycle through the five available corner modes, press the 1 shortcut to toggle placement between
two edges or one edge.

Tips

  1. To place an all-layer keepout, make the Keepout layer the active layer then place the keepout solid region on that layer. Alternatively, after placement, select the keepout solid region and set its Restricted for Layer field (in the Properties section of the Properties panel) to Keep-Out Layer. Keepouts are indicated by the current Keep-Out layer color. Keepout objects set to a specific signal layer abd Keepouts on the Keep-Out Layer are displayed with cross-hatching.
  2. When editing the properties of the placed keepout solid region, the associated Keepout Restrictions options determine which object types will be restricted by the Keepout. Deselecting an object tyhow as solid colpe will cause the Keepout to allow transgressions by that type of object (not kept out) by not imposing the applicable Clearance Rule.
  3. Keepouts are automatically restricted to the Layer on which they are placed, so Keepouts applied directly to the Keep-Out layer will become All Layer Keepouts. When the Keepout Layer is changed, the Keepout will be limited to and appear on the specified Layer. Note that a conventional (non Keepout) object cannot be placed on the Keep-Out Layer.
  4. While attributes can be modified during placement (Tab to bring up the Properties panel), keep in mind that these will become the default settings for further placement unless the Permanent option on the PCB Editor – Defaults page of the Preferences dialog is enabled. When this option is enabled, changes made will affect only the object being placed and subsequent objects placed during the same placement session.

 

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: