Altium NEXUS Documentation

Compile Mask

Modified by Tiffany Cullen on Jul 20, 2020
This documentation page references Altium Vault, which is no longer a supported product. Altium Vault and its component management features have migrated to Altium Concord Pro.
All Contents

Parent page: Schematic Objects

A placed Compile Mask, shown on the left side of the above schematic.

Summary

A Compile Mask is a design directive that is used to effectively hide the area of the design it contains from the Compiler. It provides a way to manually prevent error checking for circuitry that may not yet be complete and will generated compile errors. The Compile Mask is useful in circumstances where the current document or project needs to be compiled to check the integrity of the design in other specific areas, but the clutter of compiler-generated messages associated with unfinished portions of the design is not desired.

Availability

Compile Masks are available for placement in the Schematic Editor only. To place a Compile Mask:

  • Click the Place » Directives » Compile Mask command from the main menus.
  • Click the Compile Mask button () in the directives drop down on the Active Bar located at the top of the workspace. Click and hold an Active Bar button to access other related commands. Once a command has been used, it will become the topmost item on that section of the Active Bar.
  • Right-click in the schematic editor then click Place » Directives » Compile Mask.

Placement

After launching the command, the cursor will change to a cross-hair indicating Compile Mask placement mode. Placement is made by performing the following sequence of actions:

  1. Position the cursor then click or press Enter to anchor the first corner of the mask.
  2. Move the cursor to adjust the size of the mask so that it completely encapsulates the area of the design that needs to be hidden from the Compiler, then click or press Enter to anchor the diagonally-opposite corner and complete placement of the mask. Design objects falling completely within the bounds of the mask will become grayed-out.
  3. Continue placing further compile masks or right-click or press Esc to exit placement mode.

Graphical Editing

This method of editing allows you to select a placed compile mask object directly in the workspace and change its size, shape or location graphically.

A compile mask can be displayed in either active (full frame) or collapsed (boxed triangle) modes, which correspond to the mask being enabled and disabled, respectively. Toggle the display mode by clicking on the or icon in the top-left corner of a placed compile mask.

Click the triangle in the top-left corner to collapse (and disable) a compile mask.

When an active (expanded) compile mask object is selected, the following editing handles are available:

A selected Compile Mask (when active).

  • Click and drag A to resize the compile mask in the vertical and horizontal directions simultaneously.
  • Click and drag B to resize the compile mask in the vertical and horizontal directions separately.
  • Click anywhere on the compile mask – away from editing handles – and drag to reposition it. While dragging, the compile mask can be rotated (Spacebar/Shift+Spacebar) or mirrored (X or Y keys to mirror along the X-axis or Y-axis, respectively).
Note that when a Compile Mask is in its collapsed state, only its position may be graphically changed by dragging it to a new location.
If attempting to graphically modify an object that has its Locked property enabled, a dialog will appear asking for confirmation to proceed with the edit. If the Protect Locked Objects option is enabled on the Schematic – Graphical Editing page of the Preferences dialog, and the Locked option for that design object is enabled as well, then that object cannot be selected or graphically edited. Click the locked object to select it then disable the Locked property in the List panel or disable the Protect Locked Objects option to graphically edit the object.

Non-Graphical Editing

The following methods of non-graphical editing are available:

Via the Properties Panel

Panel page: Properties Panel 

This method of editing uses the associated Properties panel mode to modify the properties of a Compile Mask object.

The Compile Mask mode of the Properties panel

During placement, the Compile Mask mode of the Properties panel can be accessed by pressing the Tab key.

After placement, the Compile Mask mode of the Properties panel can be accessed in one of the following ways:

  • Double-clicking on the placed Compile Mask object.
  • Placing the cursor over the Compile Mask object, right-clicking then choosing Properties from the context menu.
  • If the Properties panel is already active, by selecting the Compile Mask object.
The Compile Mask properties can be accessed prior to entering placement mode from the Schematic – Defaults page of the Preferences dialog. This allows the default properties for the object to be changed, which will be applied when placing subsequent Compile Mask objects.

Editing Multiple objects

The Properties panel supports multiple object editing, where the property settings that are identical in all currently selected objects may be modified. When multiples of the same object type are selected manually, via the Find Similar Objects dialog or through a Filter or List panel, a Properties panel field entry that is not shown as an asterisk (*) may be edited for all selected objects.

Via the SCH List Panel

Panel pages: SCH List, SCH Filter

List panel displays design object types from one or more documents in tabular format, enabling quick inspection and modification of object attributes.

Used in conjunction with appropriate filtering – by selecting object types (using the panel's Include options), or by using the applicable Filter panel or the Find Similar Objects dialog – it enables the display of just those objects falling under the scope of the active filter. The properties for the listed objects may then be edited directly in the List panel.

 

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?
You are reporting an issue with the following selected text
and/or image within the active document:
ALTIUM DESIGNER FREE TRIAL
Altium Designer Free Trial
Let’s get started. First off, are you or your organization already using Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

In that case, why do you need an evaluation license?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You actually don’t need an evaluation license for that.

Click the button below to download the latest Altium Designer installer.

Download Altium Designer Installer

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Please fill out the form below to get a quote for a new seat of Altium Designer.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

If you are on Altium Subscription, you don’t need an evaluation license.

If you are not an active Altium Subscription member, please fill out the form below to get your free trial.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Why are you looking to evaluate Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

You came to the right place! Please fill out the form below to get your free trial started.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Great News!

Valid students can get their very own 6-month Altium Designer Student License for FREE! Just fill out the form below to request your Student License today.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

That’s great! Making things is awesome. We have the perfect program for you.

Upverter is a free community-driven platform designed specifically to meet the needs of makers like you.

Click here to give it a try!

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.