Difference between revisions of "PartDesign Body"

From FreeCAD Documentation
Jump to navigation Jump to search
(Reworked page, I think it can be considered complete even if there is no "Limitations" section.)
Line 1: Line 1:
{{Template:UnfinishedDocu}}
+
{{GuiCommand|Name=PartDesign Body|Workbenches=[[PartDesign Workbench|PartDesign]]|MenuLocation=Part Design → Create body|Shortcut=None|SeeAlso=[[Std Part]]}}
 
 
{{GuiCommand|Name=PartDesign Body|Workbenches=[[PartDesign Workbench|PartDesign]], Complete|MenuLocation=PartDesign → Create body|Shortcut=|SeeAlso=}}
 
  
 
==Description==
 
==Description==
  
Bodies keep chains of PartDesign features together. That is, a Body contains a chain of operations to build a single solid shape.
+
The '''PartDesign Body''' contains a series of sketches, datums and PartDesign features that form a single contiguous solid. It provides an Origin (with standard planes and axes) which can be used by the features as references. Furthermore, it can be freely moved as a unit without making it necessary to move the individual features.
 
 
A body is a single solid created from multiple individual PartDesign features. It does group all features used for its creation beneath it in the tree. It does provide an Origin (Planes and axis) which can be used in the features as references. Furthermore it can be freely moved without making it nesseccary to move the individual features.
 
  
Active objects: There is now the notion of active objects. for example your file can hold multiple Bodies. If you create a new feature the feature is added to the active one. To activate a body double click it, the state will be indicated in the tree by background color.
+
{{Version|0.17}}
  
[[File:BodyOrigin.png]]
+
[[File:PartDesign Body tree.png|top]][[File:PartDesign Body example.png]]
  
==Use==
+
===Active Status===
 +
A FreeCAD document can contain multiple Bodies. Therefore, to add a new feature to a specific Body, it needs to be made active. An active body will be displayed in the tree by a light blue background color.
  
# Click on [[Image:PartDesign Body.png|24px]] or choose {{KEY|PartDesign}}  →  {{KEY|[[Image:PartDesign Body.png|24px]] Create body}} from the main menu.
+
Activating a Body also automatically switches the interface to the PartDesign workbench, if it was not already the active workbench.
  
==Options==
+
===Origin===
 +
The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). Sketches can be attached to these planes, and planes along with axes can be used to create other datum (reference) geometry. All elements inside the Body are referenced to the Body's Origin; which means that the body can be moved and rotated in reference to the global coordinate system without affecting the placement of elements inside the body.
  
 +
===Base Feature===
 +
The base feature is by definition the first PartDesign feature created in the Body. But it is possible to use a solid shape, either imported or modelled in other workbenches, as a base feature.
  
==Limitations==
+
===Tip===
 +
The tip is the feature that is exposed outside the Body. It is automatically set to the last feature at the bottom of the tree. But sometimes it can be useful to change it to an earlier feature in the Body tree, which in effect rolls back its history; then it is possible to add features that should have been added earlier. In the Body tree, the feature set to tip displays a green dot with a white down arrow in it.
  
==Scripts==
+
For more details, see the [[PartDesign MoveTip|Move Tip]] page.
  
==Links==
+
===Visibility Management===
 +
The Body's visibility supersedes the visibility of any object it contains. If the Body is hidden, the objects it contains will be hidden as well, even if their visibility is set to true. Only one feature can be visible at a time. Selecting a hidden feature and pressing the {{KEY|space bar}} will make it visible, and automatically hide the previously visible feature.
  
==Notes==
+
==How to use==
  
Available since FreeCAD v 0.17.
+
* Press the {{KEY|[[Image:PartDesign Body.png|24px]] '''Create body'''}} button. The new body automatically becomes active.
 +
* Double-click the Body in the Model tree or right-click and select '''Toggle active body''' to activate or deactivate a body.
 +
* If a solid shape is selected first, a '''BaseFeature''' solid object is added to the Body; the BaseFeature is linked to the original solid shape. Accepted shapes can be an imported solid, or a solid made in any other FreeCAD workbench.
 +
* In a new document, if a sketch is created from the PartDesign workbench toolbar, a new Body will be automatically created.
  
{{clear}}
+
==Properties==
 +
* {{PropertyView|Display}}: sets the display between two modes:
 +
** ''Through'' (default) exposes everything inside the body (features, datums, sketches, etc.). It is the mode used in adding and editing features inside the body.
 +
** ''Tip'' exposed only the shape of the Body itself according to the set tip; everything else including sketches is hidden from view and cannot be displayed. Practical use: "Tip" allows selection of edges and faces of the Body to create operations from other workbenches.
 +
* {{PropertyData|Tip}}: displays/sets the feature defined as tip.
 +
* {{PropertyData|Base Feature}}: displays/sets the external shape used as base feature. Does not apply if a PartDesign feature is the base feature.
 +
* {{PropertyData|Placement}}: specifies the orientation and position of the Box in the 3D space. See [[Placement]].
 +
* {{PropertyData|Label}}: the Label is the name given to the operation. This name can be changed at your convenience.
 +
* {{PropertyData|Group}}: lists the referenced objects inside the Body.

Revision as of 10:00, 4 February 2018

PartDesign Body.svg PartDesign Body

Menu location
Part Design → Create body
Workbenches
PartDesign
Default shortcut
None
Introduced in version
-
See also
Std Part


Description

The PartDesign Body contains a series of sketches, datums and PartDesign features that form a single contiguous solid. It provides an Origin (with standard planes and axes) which can be used by the features as references. Furthermore, it can be freely moved as a unit without making it necessary to move the individual features.

introduced in version 0.17

PartDesign Body tree.pngPartDesign Body example.png

Active Status

A FreeCAD document can contain multiple Bodies. Therefore, to add a new feature to a specific Body, it needs to be made active. An active body will be displayed in the tree by a light blue background color.

Activating a Body also automatically switches the interface to the PartDesign workbench, if it was not already the active workbench.

Origin

The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). Sketches can be attached to these planes, and planes along with axes can be used to create other datum (reference) geometry. All elements inside the Body are referenced to the Body's Origin; which means that the body can be moved and rotated in reference to the global coordinate system without affecting the placement of elements inside the body.

Base Feature

The base feature is by definition the first PartDesign feature created in the Body. But it is possible to use a solid shape, either imported or modelled in other workbenches, as a base feature.

Tip

The tip is the feature that is exposed outside the Body. It is automatically set to the last feature at the bottom of the tree. But sometimes it can be useful to change it to an earlier feature in the Body tree, which in effect rolls back its history; then it is possible to add features that should have been added earlier. In the Body tree, the feature set to tip displays a green dot with a white down arrow in it.

For more details, see the Move Tip page.

Visibility Management

The Body's visibility supersedes the visibility of any object it contains. If the Body is hidden, the objects it contains will be hidden as well, even if their visibility is set to true. Only one feature can be visible at a time. Selecting a hidden feature and pressing the space bar will make it visible, and automatically hide the previously visible feature.

How to use

  • Press the PartDesign Body.png Create body button. The new body automatically becomes active.
  • Double-click the Body in the Model tree or right-click and select Toggle active body to activate or deactivate a body.
  • If a solid shape is selected first, a BaseFeature solid object is added to the Body; the BaseFeature is linked to the original solid shape. Accepted shapes can be an imported solid, or a solid made in any other FreeCAD workbench.
  • In a new document, if a sketch is created from the PartDesign workbench toolbar, a new Body will be automatically created.

Properties

  • ViewDisplay: sets the display between two modes:
    • Through (default) exposes everything inside the body (features, datums, sketches, etc.). It is the mode used in adding and editing features inside the body.
    • Tip exposed only the shape of the Body itself according to the set tip; everything else including sketches is hidden from view and cannot be displayed. Practical use: "Tip" allows selection of edges and faces of the Body to create operations from other workbenches.
  • DataTip: displays/sets the feature defined as tip.
  • DataBase Feature: displays/sets the external shape used as base feature. Does not apply if a PartDesign feature is the base feature.
  • DataPlacement: specifies the orientation and position of the Box in the 3D space. See Placement.
  • DataLabel: the Label is the name given to the operation. This name can be changed at your convenience.
  • DataGroup: lists the referenced objects inside the Body.