PartDesign Boolean: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Template:UnfinishedDocu}} {{GuiCommand|Name=PartDesign Boolean|Workbenches=PartDesign, Complete|MenuLocation=PartDesign → Boolean operation|Short...")
 
(Created page.)
Line 5: Line 5:
==Description==
==Description==


'''PartDesign Boolean''' imports one or more PartDesign Bodies (said to be "tool Bodies") into the active Body and applies a Boolean operation (fuse, cut or common). [[PartDesign Clone]] can also be used.
==Use==


{{Version|0.17}}
==Options==


==Limitations==
==How to use==
# Activate the Body which is to receive the Boolean feature.
# Press the {{KEY|[[Image:PartDesign Boolean.png|24px]] '''Boolean'''}} button.
# In '''Boolean Parameters''', click on the {{KEY|Add body}} button. (The active body temporarily disappears from the 3D view)
# In the 3D view, select the Body to use in the Boolean feature. Repeat to add more Bodies.
# Select the type of Boolean operation in the drop down menu (Fuse, Cut or Common)
# Click {{KEY|OK}}.
Alternatively, a Body can be selected prior to pressing the '''Boolean''' button; it will be automatically be added and steps 3 & 4 won't be necessary.


==Scripts==
==Options==
* '''Fuse:''' merges the tool body or bodies to the active body.
* '''Cut:''' subtracts the tool body or bodies from the active body.
* '''Common:''' extracts the intersection from the selected body or bodies with the active body
* Press the {{KEY|Remove body}} button to remove a body, by selecting it in the 3D view.


==Links==
==Properties==
* {{PropertyData|Type}}: sets the Boolean operation (Fuse, Cut, Common)
* {{PropertyData|Label}}: name given to the operation, this name can be changed at convenience.
* {{PropertyData|Group}}: lists the tool bodies.
* {{PropertyView|Display}}: sets the display between 2 modes:
** Result (default): displays the result of the Boolean feature. In this mode, the tool Bodies cannot be displayed in their original state, even when their visibility is toggled on.
** Tools: displays the tool Bodies in their original state. This mode is useful when editing tool Bodies is needed.
* {{PropertyView|Selectable}}: true or false. If set to false, the feature cannot be selected in the 3D view.
* {{PropertyView|Visibility}}: true or false. Toggles the feature's visibility in the 3D view.


==Notes==


==Limitations==
Available since FreeCAD v 0.17.
* For Common to work with more than one tool Body, they must all intersect each other along with the active Body.

{{clear}}

Revision as of 06:44, 29 January 2018

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

PartDesign Boolean

Menu location
PartDesign → Boolean operation
Workbenches
PartDesign, Complete
Default shortcut
None
Introduced in version
-
See also
None

Description

PartDesign Boolean imports one or more PartDesign Bodies (said to be "tool Bodies") into the active Body and applies a Boolean operation (fuse, cut or common). PartDesign Clone can also be used.

introduced in version 0.17

How to use

  1. Activate the Body which is to receive the Boolean feature.
  2. Press the Boolean button.
  3. In Boolean Parameters, click on the Add body button. (The active body temporarily disappears from the 3D view)
  4. In the 3D view, select the Body to use in the Boolean feature. Repeat to add more Bodies.
  5. Select the type of Boolean operation in the drop down menu (Fuse, Cut or Common)
  6. Click OK.

Alternatively, a Body can be selected prior to pressing the Boolean button; it will be automatically be added and steps 3 & 4 won't be necessary.

Options

  • Fuse: merges the tool body or bodies to the active body.
  • Cut: subtracts the tool body or bodies from the active body.
  • Common: extracts the intersection from the selected body or bodies with the active body
  • Press the Remove body button to remove a body, by selecting it in the 3D view.

Properties

  • DataType: sets the Boolean operation (Fuse, Cut, Common)
  • DataLabel: name given to the operation, this name can be changed at convenience.
  • DataGroup: lists the tool bodies.
  • ViewDisplay: sets the display between 2 modes:
    • Result (default): displays the result of the Boolean feature. In this mode, the tool Bodies cannot be displayed in their original state, even when their visibility is toggled on.
    • Tools: displays the tool Bodies in their original state. This mode is useful when editing tool Bodies is needed.
  • ViewSelectable: true or false. If set to false, the feature cannot be selected in the 3D view.
  • ViewVisibility: true or false. Toggles the feature's visibility in the 3D view.


Limitations

  • For Common to work with more than one tool Body, they must all intersect each other along with the active Body.