Part RefineShape: Difference between revisions
(style improvements) |
(Brought back Std_DlgParameter.svg (now an official icon). Fixed faulty use of KEY template.) |
||
(25 intermediate revisions by 6 users not shown) | |||
Line 2: | Line 2: | ||
<translate> |
<translate> |
||
<!--T:9--> |
<!--T:9--> |
||
{{Docnav |
|||
{{Docnav|[[Part CreateSimpleCopy|Create simple copy]]|[[Part CheckGeometry|Check geometry]]|[[Part_Module|Part]]|IconL=Part_CreateSimpleCopy.svg|IconC=Workbench_Part.svg|IconR=Part CheckGeometry.png}} |
|||
|[[Part_ElementCopy|ElementCopy]] |
|||
|[[Part_CheckGeometry|CheckGeometry]] |
|||
|[[Part_Module|Part]] |
|||
|IconL=Part_ElementCopy.svg |
|||
|IconR=Part_CheckGeometry.svg |
|||
|IconC=Workbench_Part.svg |
|||
}} |
|||
<!--T:1--> |
<!--T:1--> |
||
{{GuiCommand |
|||
{{GuiCommand|Name=Part RefineShape|MenuLocation=Part → Refine Shape|Workbenches=[[Part Module|Part]]|SeeAlso= [[OpenSCAD_RefineShapeFeature|OpenSCAD Refine Shape Feature]]}} |
|||
|Name=Part RefineShape |
|||
|MenuLocation=Part → Create a copy → Refine Shape |
|||
|Workbenches=[[Part Module|Part]] |
|||
|SeeAlso=[[Part_SimpleCopy|SimpleCopy]], [[Part_TransformedCopy|TransformedCopy]], [[Part_ElementCopy|ElementCopy]], [[OpenSCAD_RefineShapeFeature|OpenSCAD RefineShapeFeature]] |
|||
}} |
|||
==Description== <!--T:2--> |
==Description== <!--T:2--> |
||
Cleans unnecessary lines. After a Boolean operation some lines defining the previous form remain visible, this tool creates a totally cleaned copy of the original. |
|||
<!--T: |
<!--T:13--> |
||
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. |
|||
⚫ | |||
After certain boolean operations, like [[Part Union|Part Union]], 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 {{Button|[[Image:Part_SimpleCopy.svg|16px]] [[Part SimpleCopy|Simple Copy]]}}, {{Button|[[Image:Part_TransformedCopy.svg|16px]][[Part TransformedCopy|Transformed Copy]]}}, and {{Button|[[Image:Part_ElementCopy.svg|16px]] [[Part ElementCopy|Element Copy]]}} |
|||
</translate> |
|||
[[File:PartRefineShape_it.png]] |
[[File:PartRefineShape_it.png]] |
||
<translate> |
|||
⚫ | |||
{{Caption|Original boolean result (left), and refined shape copy (right).}} |
|||
== |
==Usage== <!--T:3--> |
||
# Select the shape to be cleaned. |
|||
⚫ | |||
⚫ | |||
* The newly created copy is independent of the original.<br/>In FreeCAD 0.19 the RefineShape feature defaults to a parametric (linked) copy. This behavior can be changed with '''ParametricRefine''' parameter described in [[Fine-tuning]]. {{Version|0.19}} |
|||
<!--T:16--> |
|||
# Select an object that you wish to clean and copy. |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
<!--T:17--> |
|||
As of {{VersionPlus|0.19}} the result defaults to a parametric (linked) copy. |
|||
<!--T:18--> |
|||
This behavior can be changed in the [[Image:Std_DlgParameter.svg|16px]] [[Std DlgParameter|parameter editor]]: |
|||
# 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). |
|||
<!--T:20--> |
|||
See other parameters in [[Fine-tuning|Fine-tuning]]. |
|||
=== Limitations === <!--T:7--> |
|||
<!--T:21--> |
|||
⚫ | |||
⚫ | |||
=== Notes === <!--T:6--> |
|||
<!--T:22--> |
|||
* This function can be used as the last step in the modelling work to clean up shapes in a traditional [[constructive solid geometry|constructive solid geometry]] workflow. |
|||
* This function may help to clean up the model before applying another feature, such as a [[Part_Fillet|Fillet]]. |
|||
⚫ | |||
⚫ | |||
==Scripting== <!--T:5--> |
==Scripting== <!--T:5--> |
||
Line 30: | Line 75: | ||
}} |
}} |
||
<translate> |
<translate> |
||
⚫ | |||
* the function does not modify the existing shape, but returns a new shape |
|||
* the function is normally used as last step in the modelling history |
|||
* the function can help to get difficult fillets to work |
|||
⚫ | |||
⚫ | |||
<!--T:10--> |
<!--T:10--> |
||
{{Docnav |
|||
{{Docnav|[[Part CreateSimpleCopy|Create simple copy]]|[[Part CheckGeometry|Check geometry]]|[[Part_Module|Part]]|IconL=Part_CreateSimpleCopy.svg|IconC=Workbench_Part.svg|IconR=Part CheckGeometry.png}} |
|||
|[[Part_ElementCopy|ElementCopy]] |
|||
|[[Part_CheckGeometry|CheckGeometry]] |
|||
⚫ | |||
|[[Part_Module|Part]] |
|||
⚫ | |||
|IconL=Part_ElementCopy.svg |
|||
|IconR=Part_CheckGeometry.svg |
|||
⚫ | |||
|IconC=Workbench_Part.svg |
|||
⚫ | |||
}} |
|||
</translate> |
</translate> |
||
⚫ | |||
⚫ | |||
{{clear}} |
{{clear}} |
Revision as of 17:16, 23 November 2020
Part RefineShape |
Menu location |
---|
Part → Create a copy → Refine Shape |
Workbenches |
Part |
Default shortcut |
None |
Introduced in version |
- |
See also |
SimpleCopy, TransformedCopy, 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 Union, 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 (left), and refined shape copy (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.
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.
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.
Scripting
The Python command for refining a shape is the following:
shape.removeSplitter()
Part
- 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
User documentation
- 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