Part RefineShape: Difference between revisions
(Typo, added item to Notes) |
No edit summary |
||
(68 intermediate revisions by 14 users not shown) | |||
Line 1: | Line 1: | ||
⚫ | |||
<translate> |
<translate> |
||
⚫ | |||
{{GuiCommand|Name=Part RefineShape|MenuLocation=Part → Refine Shape|Workbenches=[[Part Module|Part]], [[OpenSCAD_Module|OpenSCAD]]|SeeAlso=}} |
|||
<!--T:9--> |
|||
{{Docnav |
|||
|[[Part_ElementCopy|ElementCopy]] |
|||
|[[Part_CheckGeometry|CheckGeometry]] |
|||
|[[Part_Workbench|Part]] |
|||
|IconL=Part_ElementCopy.svg |
|||
|IconR=Part_CheckGeometry.svg |
|||
|IconC=Workbench_Part.svg |
|||
}} |
|||
⚫ | |||
{{GuiCommand |
|||
|Name=Part RefineShape |
|||
|MenuLocation=Part → Create a copy → Refine Shape |
|||
|Workbenches=[[Part_Workbench|Part]] |
|||
|SeeAlso=[[Part_SimpleCopy|Part SimpleCopy]], [[Part_TransformedCopy|Part TransformedCopy]], [[Part_ElementCopy|Part 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 copy of the totally cleaned. |
|||
<!--T: |
<!--T:13--> |
||
The [[Image:Part_RefineShape.svg|24px]] '''Part RefineShape''' command produces parametric copies with a refined shape from selected objects. It can for example be used to remove unnecessary edges left over after a [[Part_Fuse|Part Fuse]] operation. |
|||
</translate> |
|||
[[File:PartRefineShape_it.png]] |
[[File:PartRefineShape_it.png]] |
||
<translate> |
|||
⚫ | |||
{{Caption|Original with 11 faces (left), and refined copy with 7 faces (right).}} |
|||
== |
==Usage== <!--T:3--> |
||
# Select the shape to be cleaned. |
|||
# Click the {{KEY|Part → Refine shape}} menu. |
|||
* A copy of the object is created and totally cleaned, the original object is rendered hidden. |
|||
* The newly created copy is independent of the original. |
|||
<!--T:16--> |
|||
# Select one or more objects. |
|||
* 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 if your input shape is only a face, wire, edge or vertex then the algorithm does nothing. |
|||
# Select the {{MenuCommand|Part → Create a copy → [[Image:Part_RefineShape.svg|16px]] Refine shape}} option from the menu. |
|||
* Opposed to [[OpenSCAD RefineShapeFeature|RefineShapeFeature]] in OpenSCAD workbench, this feature won't update when the underlying shapes are changed |
|||
# For each object a cleaned, parametric copy is created |
|||
# The original objects are hidden. |
|||
== Notes == <!--T:6--> |
|||
<!--T:22--> |
|||
* This command can be used as the last step in a traditional [[constructive solid geometry|constructive solid geometry]] workflow. |
|||
* It may help to clean up the model before applying other features, such as [[Part_Fillet|fillets]]. |
|||
* Cleaning up an object may prevent 3D printers from printing unwanted edges once the object is exported to a mesh format. |
|||
⚫ | |||
* By default this command creates parametric (linked) copies. There is [[Fine-tuning|fine-tuning]] parameter to change this to non-parametric copies. More information about parametric/non-parametric copy behavior can be found in this [https://forum.freecad.org/viewtopic.php?t=42993 forum post]. |
|||
* Some interesting information about what is happening with placement and how to access by Python can be found in this [https://forum.freecad.org/viewtopic.php?t=77568#p675456 forum post]. |
|||
==Scripting== <!--T:5--> |
==Scripting== <!--T:5--> |
||
⚫ | |||
<!--T:23--> |
|||
⚫ | |||
</translate> |
</translate> |
||
{{Code|code= |
|||
<syntaxhighlight> |
|||
shape.removeSplitter() |
shape.removeSplitter() |
||
}} |
|||
</syntaxhighlight> |
|||
<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 |
|||
* the function is intended to stop 3D printers from printing unwanted edges |
|||
⚫ | |||
<!--T: |
<!--T:10--> |
||
{{Docnav |
|||
<br /> |
|||
|[[Part_ElementCopy|ElementCopy]] |
|||
<br /> |
|||
|[[Part_CheckGeometry|CheckGeometry]] |
|||
|[[Part_Workbench|Part]] |
|||
|IconL=Part_ElementCopy.svg |
|||
|IconR=Part_CheckGeometry.svg |
|||
|IconC=Workbench_Part.svg |
|||
}} |
|||
</translate> |
</translate> |
||
{{Part Tools navi{{#translation:}}}} |
|||
{{clear}} |
|||
{{Userdocnavi{{#translation:}}}} |
|||
⚫ |
Latest revision as of 14:13, 5 February 2024
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 command produces parametric copies with a refined shape from selected objects. It can for example be used to remove unnecessary edges left over after a Part Fuse operation.
Original with 11 faces (left), and refined copy with 7 faces (right).
Usage
- Select one or more objects.
- Select the Part → Create a copy → Refine shape option from the menu.
- For each object a cleaned, parametric copy is created
- The original objects are hidden.
Notes
- This command can be used as the last step in a traditional constructive solid geometry workflow.
- It may help to clean up the model before applying other features, such as fillets.
- Cleaning up an object may prevent 3D printers from printing unwanted edges once the object is exported to a mesh format.
- This command can also be used after converting a mesh to a shape (Part ShapeFromMesh).
- By default this command creates parametric (linked) copies. There is fine-tuning parameter to change this to non-parametric copies. More information about parametric/non-parametric copy behavior can be found in this forum post.
- Some interesting information about what is happening with placement and how to access by Python can be found in this forum post.
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, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub