Part Chamfer: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
(Marked this version for translation)
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<translate>
<translate>
<!--T:18-->
{{Docnav|[[Part_SectionCross|Cross sections]]|[[Part_Mirror|Mirror]]|[[Part_Module|Part]]|IconL=Part_SectionCross.png|IconC=Workbench_Part.svg|IconR=Part_Mirror.png}}

<!--T:1-->
<!--T:1-->
{{GuiCommand|Name=Part Chamfer|MenuLocation=Part → Chamfer|Workbenches=[[Part Module|Part]], Complete|SeeAlso=}}
{{GuiCommand|Name=Part Chamfer|MenuLocation=Part → Chamfer|Workbenches=[[Part Module|Part]]|SeeAlso=}}


==Description== <!--T:2-->
==Description== <!--T:2-->
Line 7: Line 11:


<!--T:5-->
<!--T:5-->
[[Image:Dialog-chamfer.png|Dialog-chamfer]]
[[Image:Chamfer-example.png|Chamfer example]]


==How to Use== <!--T:3-->
==How to Use== <!--T:3-->
Line 17: Line 21:


==Options== <!--T:4-->
==Options== <!--T:4-->
[[Image:Dialog-chamfer.png|Dialog-chamfer]]
* When selecting edges on the model, you have the option to select by edge or by face. Selecting by face can be more efficient in many situations.
* When selecting edges on the model, you have the option to select by edge or by face. Selecting by face will select all bordering edges of that face.
* Constant length chamfer or variable length chamfer.
* Constant length chamfer or variable length chamfer.
** A constant length chamfer will create a chamfer with edges equidistant to the original edge at the distance specified.
** A constant length chamfer will create a chamfer with edges equidistant to the original edge at the distance specified.
Line 32: Line 37:
*{{PropertyData|Placement}}: Specifies the orientation and position of the shape in the 3D space.
*{{PropertyData|Placement}}: Specifies the orientation and position of the shape in the 3D space.
*{{PropertyData|Label}}: Label given to the object. Change to suit your needs.
*{{PropertyData|Label}}: Label given to the object. Change to suit your needs.
{{clear}}


<br clear=all>
==Scripting== <!--T:8-->
==Scripting== <!--T:8-->
The Chamfer tool can by used in [[macros]] and from the python console by adding a Chamfer object to the document.
The Chamfer tool can by used in [[macros]] and from the python console by adding a Chamfer object to the document.
Line 40: Line 45:
'''Example Script:'''
'''Example Script:'''
</translate>
</translate>
{{Code|code=
<syntaxhighlight>

import Part
import Part
cube = FreeCAD.ActiveDocument.addObject("Part::Feature", "myCube")
cube = FreeCAD.ActiveDocument.addObject("Part::Feature", "myCube")
Line 61: Line 67:
chmfr.Edges = myEdges
chmfr.Edges = myEdges
FreeCADGui.ActiveDocument.myCube.Visibility = False
FreeCADGui.ActiveDocument.myCube.Visibility = False
FreeCAD.ActiveDocument.recompute()
</syntaxhighlight>
}}
<translate>
<translate>


<!--T:10-->
<!--T:10-->
<b>Example Script Explanation:</b>
'''Example Script Explanation:'''
</translate>
</translate>
{{Code|code=
<syntaxhighlight>
import Part
import Part
cube = FreeCAD.ActiveDocument.addObject("Part::Feature", "myCube")
cube = FreeCAD.ActiveDocument.addObject("Part::Feature", "myCube")
cube.Shape = Part.makeBox(5, 5, 5)
cube.Shape = Part.makeBox(5, 5, 5)
}}
</syntaxhighlight>
<translate>
<translate>
<!--T:11-->
<!--T:11-->
Line 77: Line 84:
</translate>
</translate>


{{Code|code=
<syntaxhighlight>
chmfr = FreeCAD.ActiveDocument.addObject("Part::Chamfer", "myChamfer")
chmfr = FreeCAD.ActiveDocument.addObject("Part::Chamfer", "myChamfer")
}}
</syntaxhighlight>
<translate>
<translate>
<!--T:12-->
<!--T:12-->
Line 85: Line 92:
</translate>
</translate>


{{Code|code=
<syntaxhighlight>
chmfr.Base = FreeCAD.ActiveDocument.myCube
chmfr.Base = FreeCAD.ActiveDocument.myCube
}}
</syntaxhighlight>
<translate>
<translate>
<!--T:13-->
<!--T:13-->
Line 93: Line 100:
</translate>
</translate>


{{Code|code=
<syntaxhighlight>
myEdges = []
myEdges = []
myEdges.append((1, 1.5, 1.25)) # (edge number, chamfer start length, chamfer end length)
myEdges.append((1, 1.5, 1.25)) # (edge number, chamfer start length, chamfer end length)
Line 107: Line 114:
myEdges.append((11, 1.5, 1.25))
myEdges.append((11, 1.5, 1.25))
myEdges.append((12, 1.5, 1.25))
myEdges.append((12, 1.5, 1.25))
}}
</syntaxhighlight>
<translate>
<translate>
<!--T:14-->
<!--T:14-->
Line 114: Line 121:


</translate>
</translate>
{{Code|code=
<syntaxhighlight>
chmfr.Edges = myEdges
chmfr.Edges = myEdges
}}
</syntaxhighlight>
<translate>
<translate>
<!--T:15-->
<!--T:15-->
Line 122: Line 129:
</translate>
</translate>


{{Code|code=
<syntaxhighlight>
FreeCADGui.ActiveDocument.myCube.Visibility = False
FreeCADGui.ActiveDocument.myCube.Visibility = False
}}
</syntaxhighlight>
<translate>
<translate>
<!--T:16-->
<!--T:16-->
*This line simply hides "myCube" so that our newly created "myChamfer" object is the only one visible.
*This line simply hides "myCube" so that our newly created "myChamfer" object is the only one visible.
</translate>


{{Code|code=
FreeCAD.ActiveDocument.recompute()
}}
<translate>
<!--T:17-->
*Recomputes all altered components on the screen and refreshes the display.


<!--T:19-->
{{Docnav|[[Part_SectionCross|Cross sections]]|[[Part_Mirror|Mirror]]|[[Part_Module|Part]]|IconL=Part_SectionCross.png|IconC=Workbench_Part.svg|IconR=Part_Mirror.png}}

<!--T:20-->
{{Part Tools navi}}

<!--T:21-->
{{Userdocnavi}}


</translate>
</translate>
{{clear}}
<languages/>

Revision as of 16:49, 13 February 2019

Part Chamfer

Menu location
Part → Chamfer
Workbenches
Part
Default shortcut
None
Introduced in version
-
See also
None

Description

Chamfers the selected edge(s) of an object. A dialog allows you to choose which edge(s) to work on as well as modify various chamfer parameters.

Chamfer example

How to Use

  1. Press the button from the Part Workbench. Alternatively, you can select Part → Chamfer.
  2. Select the shape to chamfer from the dialog.
  3. Select edges to chamfer by checking the corresponding box in the chamfer dialog or by selecting them on the model directly.
  4. Edit chamfer parameters.
  5. Press OK to close the chamfer dialog and apply the chamfer.

Options

Dialog-chamfer

  • When selecting edges on the model, you have the option to select by edge or by face. Selecting by face will select all bordering edges of that face.
  • Constant length chamfer or variable length chamfer.
    • A constant length chamfer will create a chamfer with edges equidistant to the original edge at the distance specified.
    • A variable length chamfer will have edges that may be set to different distances from the original edge, allowing you to create a chamfer at a variable angle.

Properties

Part_Chamfer Properties
Part_Chamfer Properties


Base

  • DataBase: The shape onto which the chamfer is to be applied.
  • DataPlacement: Specifies the orientation and position of the shape in the 3D space.
  • DataLabel: Label given to the object. Change to suit your needs.

Scripting

The Chamfer tool can by used in macros and from the python console by adding a Chamfer object to the document.

Example Script:

import Part
cube = FreeCAD.ActiveDocument.addObject("Part::Feature", "myCube")
cube.Shape = Part.makeBox(5, 5, 5)
chmfr = FreeCAD.ActiveDocument.addObject("Part::Chamfer", "myChamfer")
chmfr.Base = FreeCAD.ActiveDocument.myCube
myEdges = []
myEdges.append((1, 1.5, 1.25)) # (edge number, chamfer start length, chamfer end length)
myEdges.append((2, 1.5, 1.25))
myEdges.append((3, 1.5, 1.25))
myEdges.append((4, 1.5, 1.25))
myEdges.append((5, 1.5, 1.25))
myEdges.append((6, 1.5, 1.25))
myEdges.append((7, 1.5, 1.25))
myEdges.append((8, 1.5, 1.25))
myEdges.append((9, 1.5, 1.25))
myEdges.append((10, 1.5, 1.25))
myEdges.append((11, 1.5, 1.25))
myEdges.append((12, 1.5, 1.25))
chmfr.Edges = myEdges
FreeCADGui.ActiveDocument.myCube.Visibility = False
FreeCAD.ActiveDocument.recompute()

Example Script Explanation:

import Part
cube = FreeCAD.ActiveDocument.addObject("Part::Feature", "myCube")
cube.Shape = Part.makeBox(5, 5, 5)
  • Creates a 5 mm cube for us to apply chamfered edges to. See Part_API for an explanation of the makeBox method.
chmfr = FreeCAD.ActiveDocument.addObject("Part::Chamfer", "myChamfer")
  • Adds a new object to the document of type Chamfer (from the Part module) with label "myChamfer".
chmfr.Base = FreeCAD.ActiveDocument.myCube
  • Specifies that the base shape of the chamfer object should be "myCube".
myEdges = []
myEdges.append((1, 1.5, 1.25)) # (edge number, chamfer start length, chamfer end length)
myEdges.append((2, 1.5, 1.25))
myEdges.append((3, 1.5, 1.25))
myEdges.append((4, 1.5, 1.25))
myEdges.append((5, 1.5, 1.25))
myEdges.append((6, 1.5, 1.25))
myEdges.append((7, 1.5, 1.25))
myEdges.append((8, 1.5, 1.25))
myEdges.append((9, 1.5, 1.25))
myEdges.append((10, 1.5, 1.25))
myEdges.append((11, 1.5, 1.25))
myEdges.append((12, 1.5, 1.25))
  • Creates an empty array "myEdges" and then appends the array with each edge's chamfer parameters.
  • Syntax for each item should be (edge#, chamfer start length, chamfer end length)
chmfr.Edges = myEdges
  • Sets the Edges attribute of our Chamfer object equal to the array we just created.
FreeCADGui.ActiveDocument.myCube.Visibility = False
  • This line simply hides "myCube" so that our newly created "myChamfer" object is the only one visible.
FreeCAD.ActiveDocument.recompute()
  • Recomputes all altered components on the screen and refreshes the display.