The PCB Library panel enables you to browse footprints stored in the active PCB library document and edit their properties. The panel is accessed from the PCB library editor by choosing View | PCB Library |Library.
![](/documentation/sites/default/files/wiki_attachments/301845/CM_Pnl_PCBLibrary_Access.webp)
![](/documentation/sites/default/files/wiki_attachments/301845/CM_Pnl_PCBLibrary.webp)
Panels can be configured to be floating in the design space or docked to sides of the screen. If the PCB Library panel is currently in a group of panels, use the PCB Library tab located at the bottom of the panels to bring it to the front.
Content Browsing
The panel has three main sections, each offering a different scope or view of the footprints in the active PCB Library:
- Footprints - contents the entry for the currently defined footprint model, with its number of pads and primitive objects.
- Footprint Primitives - the primitive objects and their main properties that make up the footprint. Selecting a primitive object in this section causes the corresponding object to be highlighted in the design space.
- Other - a simplified, overall view of the currently selected footprint with the design space indicated by an overlay graphic.
Double-click the footprint entry, click the Edit button below the footprint list section, or right-click the footprint entry and select Footprint Properties to open the PCB Library Footprint dialog to edit footprint properties.
![](/documentation/sites/default/files/wiki_attachments/301845/CM_Dlg_PCBLibraryFootprint.webp)
Double-click on a footprint primitive entry to access its corresponding properties in the Inspector panel.
Browsing Footprint Primitives
The Footprint Primitives section lists all primitive objects that constitute the footprint. For each primitive entry, the following information is displayed.
![](/documentation/sites/default/files/wiki_attachments/301845/Footprint_Primitives.webp)
As individual object primitives are selected in the panel, the matching object (track, arc, pad, etc.,) is graphically highlighted in the design space.
![](/documentation/sites/default/files/wiki_attachments/301845/Primitive_Highlighted.webp)
Right-Click Menu
Toggle the right-click Show commands to display/not display the specific objects. The commands depend on the types of objects in the selected document. Other Show commands may also be available.
- Select All - quickly select all footprint primitive entries in the list.
- Report - generate a primitive information report for the focused footprint in the Footprints section of the panel. After launching the command, the Report Preview dialog will open containing the primitive information currently displayed in the Footprint Primitives region of the panel. Use the dialog to view, print, and export the report in various file formats.
- Properties - access the corresponding Inspector panel for the focused primitive in which you can view and modify properties as required. The primitive's corresponding Inspector panel also will open when a primitive entry is double-clicked in the panel.
Controlling the Display of Browsed Entries in the Design space
Selecting an entry in the panel's list region applies a filter, essentially using the entry as its scope. The visual result of the applied filtering on the document in the design editor window is determined by a series of highlighting controls located at the top of the panel.
![](/documentation/sites/default/files/wiki_attachments/301845/PCBLibrary_Display_AD19.webp)
Display Functions
- Mask / Dim / Normal - provides the options for visibly contrasting filtered and unfiltered objects within the design editor window.
- When Mask is selected, filtered objects will appear visible in the design editor window, with all other objects being made monochrome. When this option is applied, unfiltered objects will be unavailable for selection or editing.
- When Dim is selected, filtered objects will appear visible in the design editor window, with all other objects retaining their colors but shaded.
- Select - when enabled (default), the filtered objects will be selected in the design space.
- Zoom - when enabled (default), the filtered objects will be zoomed and centered (where possible) in the design space.
- Clear Existing - when enabled (default), an existing filter will be cleared before applying a new one. Disabling this option allows you to extend an existing filter, essentially refining the filter further by applying a new filter in addition to the existing one.
Any combination of these options can be enabled. For example, you might want to have all filtered objects zoomed, centered, and selected in the design space as well as applying masking to take away the clutter of other design objects. Use the Clear button to clear the currently-applied filter. All objects in the design space will become fully visible and available for selection/editing. If you want to re-apply the filter, click the Apply button.
Using the Panel's Mini-viewer
The bottom section provides a mini-viewer for the document, with an image of the active footprint central to its window. The area currently displayed in the design editor window is denoted by white hash marks as highlighted in the following image.
![](/documentation/sites/default/files/wiki_attachments/301845/Other_Highlighted.webp)
Click the Magnify button at the top of the panel to provide a floating magnifying glass and zoom cursor in the design editor window. As you move these around in the design space, the mini-viewer in the panel will contain the magnified image of the active footprint centered on the cursor. This allows you to browse the document at full size in the design editor window while looking at zoomed detail in the mini-viewer window.
Use the Page Up and Page Down keys to increase or decrease the magnification. Right-click, click or press Esc to exit magnify mode.
Notes
- Standard Ctrl+Click and Shift+Click functionality is supported for the selection of multiple footprint primitives in the list.
- Ctrl+Click over a selected primitive in the list to deselect it. If the entry is the only one selected for that section, performing this action will clear the filter.
- The keyboard shortcuts Up Arrow, Home, End, and Down Arrow can be used to display the previous, first, last, and next footprint primitive, respectively.
- In the footprint primitive section of the panel, the data may be sorted by any column by clicking on the header for that column. Clicking once will sort in ascending order; click again to sort by descending order.
- You can change the order in which columns of data are displayed. To move a column, click on its header and drag it horizontally to the required position. A valid position is indicated by the appearance of two positional arrows.
- The filtering applied when browsing design objects is permanent. If the Mask or Dim highlight method has been selected, all objects not falling under the scope of the filter will become faded (depending on settings) in the design space and are not available for selection or editing. Clicking inside the design editor window will not clear the filter. A permanent filter must be cleared by clicking on the Clear button from within the panel.