PartDesign Chamfer: Difference between revisions

From FreeCAD Documentation
(a more recent approach on displaying the usage section)
(Removed references to V0.19.)
 
(61 intermediate revisions by 3 users not shown)
Line 23: Line 23:


<!--T:5-->
<!--T:5-->
This tool creates chamfers on the selected edges of an object. A new separate Chamfer entry (followed by a consecutive number if there are already existing chamfers in the document) is created in the Project tree.
The [[Image:PartDesign_Chamfer.svg|24px]] '''PartDesign Chamfer''' tool creates chamfers on the selected edges of an object. It adds a '''Chamfer''' object to the document with its corresponding representation in the [[Tree_view|Tree view]].


==Usage== <!--T:3-->
==Usage== <!--T:3-->


=== Add a Chamfer ===
=== Add a chamfer === <!--T:28-->


<!--T:6-->
<!--T:6-->
# Optionally activate the Body to chamfer (by double clicking the [[Tree_view|Tree view]] item).
# Optionally [[PartDesign_Body#Active_status|activate]] the Body to chamfer.
# There are several ways to select edges to chamfer:
# There are several ways to select edges to chamfer:
#* Select one or more edge(s) of the active Body individually.
#* Select one or more edges of the Body individually.
#* Select one or more face(s) on the active Body to select all surrounding edges at once.
#* Select one or more faces of the Body to select all their edges.
#* Select the whole active Body to select all its edges at once. {{Version|0.20}}
#* Select a feature (usually the last feature) of the Body to select all its edges. {{Version|0.20}}
# For a chain of tangentially connected edges only a single edge needs to be selected, the chamfer will propagate along the chain.
# There are several ways to invoke the Chamfer tool:
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:PartDesign_Chamfer.svg|16px|text-top=Chamfer|link=PartDesign_Chamfer]] [[PartDesign_Chamfer|Chamfer]]}} button.
#* Press the {{Button|[[Image:PartDesign_Chamfer.svg|16px]] [[PartDesign_Chamfer|Chamfer]]}} button.
#* Select the {{MenuCommand|Part Design → Apply a dress-up feature → [[Image:PartDesign_Chamfer.svg|16px]] Chamfer}} option from the menu.
#* Select the {{MenuCommand|Part Design → Apply a dress-up feature → [[Image:PartDesign_Chamfer.svg|16px]] Chamfer}} option from the menu.
# If there is no active Body, and there are two or more Bodies in the document, the {{MenuCommand|Active Body Required}} dialog will open and prompt you to activate one. If there is a single Body it will be activated automatically.
# The Chamfer parameters dialog will open in the [[Task_panel|Task panel]] and allows to set several [[#Options|options]].
# The {{MenuCommand|Chamfer parameters}} [[Task_panel|task panel]] opens. See [[#Options|Options]] for more information.
# Click {{Button|OK}} to validate.
# Press the {{Button|OK}} button to finish.


=== Edit a chamfer === <!--T:29-->


<!--T:30-->
:''Remember'':
# Do one of the following:
:* For a chain of edges tangential to one another, one single edge can be selected; the chamfer will propagate along the chain.
#* Double-click the Chamfer object in the [[Tree_view|Tree view]]
:* Since there must be at least one edge for the feature, the last remaining edge or face in the list cannot be removed.
#* Right-click the Chamfer object in the [[Tree_view|Tree view]] and select {{MenuCommand|Edit Chamfer}} from the context menu.
:* Uncheck the {{MenuCommand|Use all edges}} checkbox to add or remove edges and/or faces individually.
# The {{MenuCommand|Chamfer parameters}} [[Task_panel|task panel]] opens. See [[#Options|Options]] for more information.
# Press the {{Button|OK}} button to finish.


== Options == <!--T:31-->
=== Edit a Chamfer ===


<!--T:32-->
# There are two ways to reopen the Chamfer parameters dialog to edit a Chamfer:
* To add edges do one of the following:
#* Double-click on the Chamfer item in the [[Tree_view|Tree view]]
** Press the {{Button|Add}} button to start selecting edges and/or faces in the [[3D_view|3D view]].
#* Right-click on the Chamfer item in the [[Tree_view|Tree view]] and select {{MenuCommand|Edit Chamfer}} from the context menu.
** To select all remaining edges do the following:
# The Chamfer parameters dialog will open in the [[Task_panel|Task panel]] and allows to set several [[#Options|options]].
# Click {{Button|OK}} to validate.
**# If required press the {{Button|Add}} button.
**# Use the {{KEY|Ctrl}}+{{KEY|Shift}}+{{KEY|A}} keyboard shortcut, or right-click the list and select {{MenuCommand|Add all edges}} from the context menu. {{Version|0.20}}

* To remove edges do one of the following:
=== Options ===
** Press the {{Button|Remove}} button to start deselecting edges and/or faces in the [[3D_view|3D view]]. Selected elements are highlighted in purple.

** Select one or more elements in the list and press the {{KEY|Del}} key, or right-click the list and select {{MenuCommand|Remove}} from the context menu.
* {{MenuCommand|Type}}: Choose one of the Chamfer types:
* Specify a chamfer {{MenuCommand|Type}}:
** {{MenuCommand|Equal distance}}: The chamfer edges are equally distanced from the body edge.
** {{MenuCommand|Two distances}}: The distances of the chamfer edge to the body edge are specified. {{Version|0.19}}
** {{MenuCommand|Equal distance}}: One distance is used to place both chamfer edges.
** {{MenuCommand|Distance and angle}}: One distances of the chamfer edge to the body edge is specified. The second chamfer edge is defined by the angle of the chamfer. {{Version|0.19}}
** {{MenuCommand|Two distances}}: Two distances are used to place the chamfer edges.
** {{MenuCommand|Distance and angle}}: A distance is used to place one chamfer edge, the placement of the other chamfer edge is defined by the angle of the chamfer.
* {{MenuCommand|Flip direction}}: The distance direction can be flipped using the {{Button|[[Image:PartDesign_Flip_Direction.svg|16px]] Flip direction}} button (deactivated for {{MenuCommand|Equal distance}}). {{Version|0.19}}
* Press the {{Button|[[Image:PartDesign_Flip_Direction.svg|16px]] Flip direction}} button to flip the direction of the chamfer (deactivated for {{MenuCommand|Equal distance}}).
* {{MenuCommand|Size, Size2, Angle}}: Set the chamfer Size, and Size2 or Angle either by editing the value or by clicking on the up/down arrows.
* Set the {{MenuCommand|Size}} of the chamfer.
*: {{MenuCommand|Size2}} is only available when {{MenuCommand|Two distances}} is selected and {{MenuCommand|Angle}} only when {{MenuCommand|Distance and angle}} is selected.
* {{MenuCommand|Add}}: Add edges to the selection by pressing the {{Button|Add}} button and selecting more edges or faces.
* Set the {{MenuCommand|Size2}} of the chamfer (only available if {{MenuCommand|Two distances}} is selected).
* Set the {{MenuCommand|Angle}} of the chamfer (only available if {{MenuCommand|Distance and angle}} is selected).
*: To select all remaining edges right-click in the list and select {{MenuCommand|Add all edges}} from the context menu. {{Version|0.20}}
* {{MenuCommand|Remove}}: Choose a way to remove edges from the selection:
* Check the {{MenuCommand|Use all edges}} checkbox to select all edges of the previous feature. This deactivates the selection list and the related buttons. {{Version|0.20}}
** Select each edge or face in the list of the dialog and press the {{KEY|DEL}} key or right-click in the list and select {{MenuCommand|Remove}} from the context menu.
** Press the {{Button|Remove}} button. All edges and faces being previously selected are highlighted in purple. Select each edge or face to be removed.
* {{MenuCommand|Use all edges}}: Select all edges by checking the {{MenuCommand|Use all edges}} checkbox {{Version|0.20}}. This deactivates the selection list and the related buttons.


== Notes == <!--T:13-->
== Notes == <!--T:13-->
Line 77: Line 79:
* Chamfers cannot completely consume the adjacent faces.
* Chamfers cannot completely consume the adjacent faces.


==Properties==
==Properties== <!--T:33-->


<!--T:34-->
See also: [[Property_editor|Property editor]].
See also: [[Property_editor|Property editor]].


Line 84: Line 87:
A PartDesign Chamfer object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties. It also has the following additional properties:
A PartDesign Chamfer object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties. It also has the following additional properties:


===Data===
===Data=== <!--T:35-->


<!--T:36-->
{{Properties_Title|Base}}
{{Properties_Title|Base}}


<!--T:37-->
* {{PropertyData|Base|LinkSub}}: Base. Sub-link to the parent feature's list of selected edges and faces.
* {{PropertyData|Base|LinkSub}}: Link to the selected edges and faces of the parent feature. Can be a link to only the parent feature if {{PropertyData|Use All Edges}} is {{TRUE}}.
* {{PropertyData|SupportTransform|Bool}}: Support Transform. "Include the base additive/subtractive shape when used in pattern features.
* {{PropertyData|Support Transform|Bool}}: If {{TRUE}} the chamfered shape of the additive/subtractive parent feature will be used when the chamfer object is included in a [[PartDesign_Workbench#Transformation_tools|pattern]], else only the shape of the chamfer itself will be used. The default is {{FALSE}}.
: If disabled, only the dressed part of the shape is used for patterning. Default: {{FALSE}}.
* {{PropertyData|AddSubShape|PartShape|hidden}}: Add Sub Shape.
* {{PropertyData|Add Sub Shape|PartShape|hidden}}
* {{PropertyData|BaseFeature|Link|hidden}}: Base Feature. Link to the parent feature.
* {{PropertyData|Base Feature|Link|hidden}}: Link to the parent feature.
* {{PropertyData|_Body|LinkHidden|hidden}}: _Body. Hidden link to the parent body.
* {{PropertyData|_ Body|LinkHidden|hidden}}: Link to the parent body.



<!--T:38-->
{{Properties_Title|Chamfer}}
{{Properties_Title|Chamfer}}


<!--T:39-->
* {{PropertyData|CamferType|Enumeration}}: Chamfer Type. "Type of chamfer".{{value|Equal distance}} (default), {{value|Two distances}}.
* {{PropertyData|Size|QuantityConstraint}}: Size. "Size of chamfer". Default: {{value|1,00 mm}}.
* {{PropertyData|Chamfer Type|Enumeration}}: The chamfer type: {{value|Equal distance}} (default), {{value|Two distances}} or {{value|Distance and Angle}}.
* {{PropertyData|Size2|QuantityConstraint}}: Size2. "Second size of chamfer". Default: {{value|1,00 mm}}.
* {{PropertyData|Size|QuantityConstraint}}: The first chamfer distance. The default is {{value|1 mm}}.
* {{PropertyData|Angle|Angle}}: Angle. "Angle of chamfer". Default: {{value|45,00 °}}.
* {{PropertyData|Size2|QuantityConstraint}}: The second chamfer distance. Only used if {{PropertyData|Chamfer Type}} is {{Value|Two distances}}. The default is {{value|1 mm}}.
* {{PropertyData|FlipDirection|Bool}}: Flip Direction. "Flip direction". Default: {{FALSE}}.
* {{PropertyData|Angle|Angle}}: The chamfer angle. Only used if {{PropertyData|Chamfer Type}} is {{Value|Distance and Angle}}. The default is {{value|45 °}}.
* {{PropertyData|UseAllEdges|Bool}}: Use All Edges. "Chamfer all edges if {{TRUE}}, else use only those edges in Base property.
* {{PropertyData|Flip Direction|Bool}}: If {{TRUE}} the direction of the chamfer is flipped. Not used if {{PropertyData|Chamfer Type}} is {{Value|Equal distance}}. The default is {{FALSE}}.
: If {{TRUE}}, then this overrides any edge changes made to the Base property or in the dialog". Default: {{FALSE}}.
* {{PropertyData|Use All Edges|Bool}}: If {{TRUE}} all edges of the feature are chamfered, and the edges specified by {{PropertyData|Base}} are ignored. The default is {{FALSE}}.


<!--T:40-->
{{Properties_Title|Part Design}}
{{Properties_Title|Part Design}}


<!--T:41-->
* {{PropertyData|Refine|Bool}}: "Refine shape (clean up redundant edges) after adding/subtracting". Default: {{TRUE}}.
* {{PropertyData|Refine|Bool}}: If {{TRUE}} redundant edges are removed from the result of the operation. The default value is determined by the {{MenuCommand|Automatically refine model after sketch-based operation}} preference. See [[PartDesign_Preferences#General|PartDesign Preferences]].


== Known issues == <!--T:14-->
== Known issues == <!--T:14-->

Latest revision as of 15:35, 20 May 2023

PartDesign Chamfer

Menu location
Part Design → Apply a dress-up feature → Chamfer
Workbenches
PartDesign
Default shortcut
None
Introduced in version
-
See also
PartDesign Fillet

Description

The PartDesign Chamfer tool creates chamfers on the selected edges of an object. It adds a Chamfer object to the document with its corresponding representation in the Tree view.

Usage

Add a chamfer

  1. Optionally activate the Body to chamfer.
  2. There are several ways to select edges to chamfer:
    • Select one or more edges of the Body individually.
    • Select one or more faces of the Body to select all their edges.
    • Select a feature (usually the last feature) of the Body to select all its edges. introduced in version 0.20
  3. For a chain of tangentially connected edges only a single edge needs to be selected, the chamfer will propagate along the chain.
  4. There are several ways to invoke the tool:
    • Press the Chamfer button.
    • Select the Part Design → Apply a dress-up feature → Chamfer option from the menu.
  5. If there is no active Body, and there are two or more Bodies in the document, the Active Body Required dialog will open and prompt you to activate one. If there is a single Body it will be activated automatically.
  6. The Chamfer parameters task panel opens. See Options for more information.
  7. Press the OK button to finish.

Edit a chamfer

  1. Do one of the following:
    • Double-click the Chamfer object in the Tree view
    • Right-click the Chamfer object in the Tree view and select Edit Chamfer from the context menu.
  2. The Chamfer parameters task panel opens. See Options for more information.
  3. Press the OK button to finish.

Options

  • To add edges do one of the following:
    • Press the Add button to start selecting edges and/or faces in the 3D view.
    • To select all remaining edges do the following:
      1. If required press the Add button.
      2. Use the Ctrl+Shift+A keyboard shortcut, or right-click the list and select Add all edges from the context menu. introduced in version 0.20
  • To remove edges do one of the following:
    • Press the Remove button to start deselecting edges and/or faces in the 3D view. Selected elements are highlighted in purple.
    • Select one or more elements in the list and press the Del key, or right-click the list and select Remove from the context menu.
  • Specify a chamfer Type:
    • Equal distance: One distance is used to place both chamfer edges.
    • Two distances: Two distances are used to place the chamfer edges.
    • Distance and angle: A distance is used to place one chamfer edge, the placement of the other chamfer edge is defined by the angle of the chamfer.
  • Press the Flip direction button to flip the direction of the chamfer (deactivated for Equal distance).
  • Set the Size of the chamfer.
  • Set the Size2 of the chamfer (only available if Two distances is selected).
  • Set the Angle of the chamfer (only available if Distance and angle is selected).
  • Check the Use all edges checkbox to select all edges of the previous feature. This deactivates the selection list and the related buttons. introduced in version 0.20

Notes

  • PartDesign Chamfer should not be confused with Part Chamfer. Unless you know what you are doing, Part Chamfer should not be used on a PartDesign Body. See Part and PartDesign.
  • Chamfers cannot completely consume the adjacent faces.

Properties

See also: Property editor.

A PartDesign Chamfer object is derived from a Part Feature object and inherits all its properties. It also has the following additional properties:

Data

Base

  • DataBase (LinkSub): Link to the selected edges and faces of the parent feature. Can be a link to only the parent feature if DataUse All Edges is true.
  • DataSupport Transform (Bool): If true the chamfered shape of the additive/subtractive parent feature will be used when the chamfer object is included in a pattern, else only the shape of the chamfer itself will be used. The default is false.
  • Data (hidden)Add Sub Shape (PartShape)
  • Data (hidden)Base Feature (Link): Link to the parent feature.
  • Data (hidden)_ Body (LinkHidden): Link to the parent body.

Chamfer

  • DataChamfer Type (Enumeration): The chamfer type: Equal distance (default), Two distances or Distance and Angle.
  • DataSize (QuantityConstraint): The first chamfer distance. The default is 1 mm.
  • DataSize2 (QuantityConstraint): The second chamfer distance. Only used if DataChamfer Type is Two distances. The default is 1 mm.
  • DataAngle (Angle): The chamfer angle. Only used if DataChamfer Type is Distance and Angle. The default is 45 °.
  • DataFlip Direction (Bool): If true the direction of the chamfer is flipped. Not used if DataChamfer Type is Equal distance. The default is false.
  • DataUse All Edges (Bool): If true all edges of the feature are chamfered, and the edges specified by DataBase are ignored. The default is false.

Part Design

  • DataRefine (Bool): If true redundant edges are removed from the result of the operation. The default value is determined by the Automatically refine model after sketch-based operation preference. See PartDesign Preferences.

Known issues

See PartDesign Fillet.