Part RefineShape: Difference between revisions

From FreeCAD Documentation
No edit summary
(Brought back Std_DlgParameter.svg (now an official icon). Fixed faulty use of KEY template.)
(29 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
<!--T:9-->
{{Docnav
|[[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:4-->
<!--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.

<!--T:14-->
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.

<!--T:15-->
'''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>
<!--T:4-->
{{Caption|Original boolean result (left), and refined shape copy (right).}}


==Use== <!--T:3-->
==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.


==Limitations== <!--T:7-->
<!--T:16-->
# Select an object that you wish to clean and copy.
* 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.
# Go to the menu {{MenuCommand|Part → Create a copy → [[Image:Part_RefineShape.svg|16px]] Refine shape}}.
* Opposed to [[OpenSCAD RefineShapeFeature|RefineShapeFeature]] in OpenSCAD workbench, this feature won't update when the preceding shapes are changed.
# A cleaned, independent copy of the original object is created; the original object is hidden.

<!--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-->
* 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 [[Image:OpenSCAD_RefineShapeFeature.svg|24px]] [[OpenSCAD RefineShapeFeature|OpenSCAD RefineShapeFeature]] command, [[Image:Part_RefineShape.svg|24px]] [[Part_RefineShape|Part RefineShape]] won't update when the preceding shapes are changed.

=== 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]].
* 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.


==Scripting== <!--T:5-->
==Scripting== <!--T:5-->
Line 28: Line 76:
<translate>
<translate>


==Notes== <!--T:6-->
* 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
* the function can be used after converting a mesh to shape to clean up the residual edges on planar faces.


<!--T:10-->
{{Docnav
|[[Part_ElementCopy|ElementCopy]]
|[[Part_CheckGeometry|CheckGeometry]]
|[[Part_Module|Part]]
|IconL=Part_ElementCopy.svg
|IconR=Part_CheckGeometry.svg
|IconC=Workbench_Part.svg
}}


</translate>
</translate>
{{Part Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{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

  1. Select an object that you wish to clean and copy.
  2. Go to the menu Part → Create a copy → Refine shape.
  3. 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:

  1. Go to the subgroup: BaseApp/Preferences/Mod/Part
  2. Change ParametricRefine of type Boolean to false 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()