Part RefineShape: Difference between revisions
mNo edit summary |
(Removed useless info from Scripting paragraph.) |
||
(23 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
<translate> |
<translate> |
||
<!--T:9--> |
<!--T:9--> |
||
{{Docnav |
{{Docnav |
||
|[[Part_ElementCopy|ElementCopy]] |
|||
|[[Part SimpleCopy|Create simple copy]] |
|||
⚫ | |||
|[[Part CheckGeometry|Check geometry]] |
|||
|[[ |
|[[Part_Workbench|Part]] |
||
|IconL= |
|IconL=Part_ElementCopy.svg |
||
⚫ | |||
|IconR=Part_CheckGeometry.svg |
|IconR=Part_CheckGeometry.svg |
||
⚫ | |||
}} |
}} |
||
Line 15: | Line 16: | ||
|Name=Part RefineShape |
|Name=Part RefineShape |
||
|MenuLocation=Part → Create a copy → Refine Shape |
|MenuLocation=Part → Create a copy → Refine Shape |
||
|Workbenches=[[ |
|Workbenches=[[Part_Workbench|Part]] |
||
|SeeAlso=[[Part_SimpleCopy|SimpleCopy]], [[Part_TransformedCopy|TransformedCopy]], [[Part_ElementCopy|ElementCopy]], [[OpenSCAD_RefineShapeFeature|OpenSCAD RefineShapeFeature]] |
|SeeAlso=[[Part_SimpleCopy|Part SimpleCopy]], [[Part_TransformedCopy|Part TransformedCopy]], [[Part_ElementCopy|Part ElementCopy]], [[OpenSCAD_RefineShapeFeature|OpenSCAD RefineShapeFeature]] |
||
}} |
}} |
||
Line 22: | Line 23: | ||
<!--T:13--> |
<!--T:13--> |
||
The {{Button|[[Image:Part_RefineShape.svg|16px]] [[ |
The {{Button|[[Image:Part_RefineShape.svg|16px]] [[Part_RefineShape|Part RefineShape]]}} produces a non-parametric copy with a refined shape, that is, with certain edges and faces cleaned up. |
||
<!--T:14--> |
<!--T:14--> |
||
After certain boolean operations, like [[ |
After certain boolean operations, like [[Part_Fuse|Part Fuse]], some lines from the previous shapes may remain visible. This tool produces a copy of that boolean result, and cleans up those seams. |
||
<!--T:15--> |
<!--T:15--> |
||
Line 34: | Line 35: | ||
<translate> |
<translate> |
||
<!--T:4--> |
<!--T:4--> |
||
{{Caption|Original boolean result (left), and refined shape copy (right).}} |
{{Caption|Original boolean result with 11 faces (left), and refined shape copy with 7 faces (right).}} |
||
==Usage== <!--T:3--> |
==Usage== <!--T:3--> |
||
Line 47: | Line 48: | ||
<!--T:18--> |
<!--T:18--> |
||
This behavior can be changed in the |
This behavior can be changed in the [[Image:Std_DlgParameter.svg|24px|link=Std DlgParameter]] [[Std DlgParameter|Parameter editor]]: |
||
# Go to the subgroup: {{incode|BaseApp/Preferences/Mod/Part}} |
# Go to the subgroup: {{incode|BaseApp/Preferences/Mod/Part}} |
||
# Change {{incode|ParametricRefine}} of type {{incode|Boolean}} to {{FALSE}} to get the old behavior (independent copy). |
# Change {{incode|ParametricRefine}} of type {{incode|Boolean}} to {{FALSE}} to get the old behavior (independent copy). |
||
Line 54: | Line 55: | ||
See other parameters in [[Fine-tuning|Fine-tuning]]. |
See other parameters in [[Fine-tuning|Fine-tuning]]. |
||
== Notes == <!--T:6--> |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
<!--T:22--> |
<!--T:22--> |
||
Line 67: | Line 62: | ||
* This clean up may stop 3D printers from printing unwanted edges once the solid model is exported to a mesh format. |
* This clean up may stop 3D printers from printing unwanted edges once the solid model is exported to a mesh format. |
||
* This function can also be used after converting a mesh to a shape ([[Part_ShapeFromMesh|ShapeFromMesh]]) to clean up the residual edges on flat faces. |
* This function can also be used after converting a mesh to a shape ([[Part_ShapeFromMesh|ShapeFromMesh]]) to clean up the residual edges on flat faces. |
||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
==Scripting== <!--T:5--> |
==Scripting== <!--T:5--> |
||
⚫ | |||
The Python command for refining a shape is the following: |
The Python command for refining a shape is the following: |
||
</translate> |
</translate> |
||
{{Code|code= |
{{Code|code= |
||
Line 75: | Line 79: | ||
}} |
}} |
||
<translate> |
<translate> |
||
<!--T:10--> |
<!--T:10--> |
||
{{Docnav |
{{Docnav |
||
|[[Part_ElementCopy|ElementCopy]] |
|||
|[[Part SimpleCopy|Create simple copy]] |
|||
|[[Part_CheckGeometry|CheckGeometry]] |
|||
|[[Part CheckGeometry|Check geometry]] |
|||
|[[ |
|[[Part_Workbench|Part]] |
||
|IconL= |
|IconL=Part_ElementCopy.svg |
||
|IconR=Part_CheckGeometry.svg |
|||
|IconC=Workbench_Part.svg |
|IconC=Workbench_Part.svg |
||
⚫ | |||
}} |
}} |
||
⚫ | |||
⚫ | |||
<!--T:12--> |
|||
⚫ | |||
</translate> |
</translate> |
||
⚫ | |||
{{clear}} |
|||
⚫ |
Revision as of 10:57, 18 September 2021
Part RefineShape |
Menu location |
---|
Part → Create a copy → Refine Shape |
Workbenches |
Part |
Default shortcut |
None |
Introduced in version |
- |
See also |
Part SimpleCopy, Part TransformedCopy, Part ElementCopy, OpenSCAD RefineShapeFeature |
Description
The Part RefineShape produces a non-parametric copy with a refined shape, that is, with certain edges and faces cleaned up.
After certain boolean operations, like Part Fuse, some lines from the previous shapes may remain visible. This tool produces a copy of that boolean result, and cleans up those seams.
Alternatively, to produce other non-parametric copies use Simple Copy, Transformed Copy, and Element Copy
Original boolean result with 11 faces (left), and refined shape copy with 7 faces (right).
Usage
- Select an object that you wish to clean and copy.
- Go to the menu Part → Create a copy → Refine shape.
- A cleaned, independent copy of the original object is created; the original object is hidden.
As of version 0.19 and above the result defaults to a parametric (linked) copy.
This behavior can be changed in the Parameter editor:
- Go to the subgroup:
BaseApp/Preferences/Mod/Part
- Change
ParametricRefine
of typeBoolean
tofalse
to get the old behavior (independent copy).
See other parameters in Fine-tuning.
Notes
- This function can be used as the last step in the modelling work to clean up shapes in a traditional constructive solid geometry workflow.
- This function may help to clean up the model before applying another feature, such as a Fillet.
- This clean up may stop 3D printers from printing unwanted edges once the solid model is exported to a mesh format.
- This function can also be used after converting a mesh to a shape (ShapeFromMesh) to clean up the residual edges on flat faces.
Limitations
- The refinement algorithm only works on shells. Therefore it iterates over the shells of the input shape and then for each shell it creates a new shell with joined faces wherever possible. This means that if your input shape is only a face, wire, edge or vertex then the algorithm does nothing.
- Unlike the OpenSCAD RefineShapeFeature command, Part RefineShape won't update when the preceding shapes are changed.
Scripting
The Python command for refining a shape is the following:
shape.removeSplitter()
- Primitives: Box, Cylinder, Sphere, Cone, Torus, Tube, Create primitives, Shape builder
- Creation and modification: Extrude, Revolve, Mirror, Fillet, Chamfer, Make face from wires, Ruled Surface, Loft, Sweep, Section, Cross sections, 3D Offset, 2D Offset, Thickness, Projection on surface, Attachment
- Boolean: Make compound, Explode Compound, Compound Filter, Boolean, Cut, Fuse, Common, Connect, Embed, Cutout, Boolean fragments, Slice apart, Slice, XOR
- Measure: Measure Linear, Measure Angular, Measure Refresh, Clear All, Toggle All, Toggle 3D, Toggle Delta
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub