Part RefineShape: Difference between revisions

From FreeCAD Documentation
(Cleaned up GuiCommand template)
(Rewrite the how to use section)
Line 26: Line 26:
{{Caption|Original boolean result (left), and refined shape copy (right).}}
{{Caption|Original boolean result (left), and refined shape copy (right).}}


==Use== <!--T:3-->
==How to use== <!--T:3-->

# Select the shape to be cleaned.
# Select an object that you wish to clean and copy.
# Use the menu {{MenuCommand|Part → Refine shape}}.
# Go to the menu {{MenuCommand|Part → Create a copy → [[File:Part_RefineShape.svg|16px]] Refine shape}}.
* A copy of the object is created and totally cleaned, the original object is rendered hidden.
# A cleaned, independent copy of the original object is created; the original object is hidden.
* 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}}

Starting in FreeCAD 0.19, the result defaults to a parametric (linked) copy.

This behavior can be changed in the [[parameter editor|parameter editor]]. Go to the subgroup
* {{incode|BaseApp/Preferences/Mod/Part}}

and change {{incode|ParametricRefine}} of type {{incode|Boolean}} to {{FALSE}} to get the old behavior (independent copy).

See other parameters in [[Fine-tuning|Fine-tuning]].


==Limitations== <!--T:7-->
==Limitations== <!--T:7-->

Revision as of 05:54, 29 September 2019

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

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 main remain visible. This tool produces a copy of that boolean result, and cleans up those seams.

To produce other non-parametric copies use SimpleCopy, TransformedCopy, and ElementCopy.

Original boolean result (left), and refined shape copy (right).

How to use

  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.

Starting in FreeCAD 0.19, 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

and 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 if your input shape is only a face, wire, edge or vertex then the algorithm does nothing.
  • Opposed to RefineShapeFeature in OpenSCAD workbench, this feature won't update when the preceding shapes are changed.

Scripting

The Python command for refining a shape is the following:

shape.removeSplitter()

Notes

  • 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.