Part RefineShape/en: Difference between revisions

From FreeCAD Documentation
(Importing a new version from external source)
(Updating to match new version of source page)
 
(29 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Part RefineShape|MenuLocation=Part → Refine Shape|Workbenches=[[Part Module|Part]], [[OpenSCAD_Module|OpenSCAD]]|SeeAlso=}}


{{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==
==Description==

Cleans its unnecessary lines. After a Boolean operation some lines defining the previous form remain visible, this tool creates a copy of the totally cleaned.
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.


[[File:PartRefineShape_it.png]]
[[File:PartRefineShape_it.png]]
{{Caption|Original with 11 faces (left), and refined copy with 7 faces (right).}}


==Use==
==Usage==
# 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 hiden.
* The newly created copy is independent of the original.


# Select one or more objects.
==Limitations==
# Select the {{MenuCommand|Part → Create a copy → [[Image:Part_RefineShape.svg|16px]] Refine shape}} option from the menu.
* 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.
# For each object a cleaned, parametric copy is created
* Opposed to [[OpenSCAD RefineShapeFeature|RefineShapeFeature]] in OpenSCAD workbench, this feature won't update when the underlying shapes are changed
# The original objects are hidden.

== Notes ==

* 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.
* This command can also be used after converting a mesh to a shape ([[Part_ShapeFromMesh|Part ShapeFromMesh]]).
* 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==
==Scripting==

The Phyton command for refining a shape is the following:
The Python command for refining a shape is the following:
<syntaxhighlight>

{{Code|code=
shape.removeSplitter()
shape.removeSplitter()
}}
</syntaxhighlight>


Note that the function does not modify the existing shape, but returns a new shape.


{{Docnav
<br />
|[[Part_ElementCopy|ElementCopy]]
<br />
|[[Part_CheckGeometry|CheckGeometry]]
|[[Part_Workbench|Part]]
|IconL=Part_ElementCopy.svg
|IconR=Part_CheckGeometry.svg
|IconC=Workbench_Part.svg
}}


{{Part Tools navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}
<languages/>

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

  1. Select one or more objects.
  2. Select the Part → Create a copy → Refine shape option from the menu.
  3. For each object a cleaned, parametric copy is created
  4. 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()