Component Body Manager

Parent page: PCB Dialogs

The Component Body Manager for component dialog.


This dialog allows the designer to manage the 3D Bodies for the component under the cursor. It provides a central console with which to quickly modify 3D Body attributes, without having to access the 3D Body dialog for each individual body that is being used for that component.

A 3D Body is a primitive polygonal design object that is used to represent the 3 dimensional shape of the physical component that is mounted on the assembled PCB. Any number of 3D Body objects can be used together to create complex shapes.


The dialog is accessed from the PCB Editor, when viewing the board in 2D. Simply right-click over the desired component, and use the Component Actions » Manage 3D Bodies command from the context menu.


  • Existing and Potential Component Bodies - this region of the dialog presents all existing component bodies (3D Bodies) that are being used, or could potentially be used, for the component. Each component body is listed in terms of the following:
    • Description - a description of how the body has been created. This could be a purposefully placed 3D Body (referred to as a Component Body in its description), a rectangular shape created from a bounding rectangle, or an enclosed polygonal shape created from design primitives. Each body's description (whether placed or automatically created) will also include the mechanical layer on which it resides (or on which the object(s) it was created from reside), and its area size. Rectangular and polygonal bodies are distinguished by the  and  icons respectively.
    • Body State - reflects whether the body is being used in the component (In Component <ComponentDesignator>) or not (Not In Component <ComponentDesignator>). Click the entry to quickly toggle the state as required.
    • Standoff Height - the distance from the board surface to the underside of the Extruded Body. Use a negative value for Extruded Bodies that must pass down through the PCB.
    • Overall Height - the distance from the board surface to the topside of the Extruded Body.
    • Body Projection - the side of the board the 3D Body will project from. Use the field's drop-down to choose either Top Side or Bottom Side (project up, or project down). This setting is automatically changed if the 3D Body object is flipped to the other side of the board as part of a component flip.
    • Registration Layer - the mechanical layer that the 3D Body exists on. Use the field's drop-down to choose from all currently enabled mechanical layers. If the chosen mechanical layer is paired, then the when the body is flipped to the other side of the board as part of its component, it will also be moved to the paired mechanical layer.
    • Body 3D Color - the current color used for the 3D Body. Click the color swatch to access the standard Choose Color dialog, with which to assign a different color as required.
    • Body 3D Opacity - the current level of transparency for the 3D Body. Use the field's drop-down to choose from Solid (completely opaque), Hide (rendering the body invisible), 25% Opacity, 50% Opacity, and 75% Opacity.
  • Component bodies in: <ComponentDesignator> - this preview window shows the component's 2D footprint, along with overlayed 3D Bodies whose Body State is currently set to In Component <ComponentDesignator>. The preview is dynamic, and so will change as bodies are included or excluded.
  • Selected Body - this preview window shows the currently selected body in the list above. The title area for the window also reflects the body's description.


You are reporting an issue with the following selected text and/or image within the active document: