- GuiCommand: Name: Mesh FromPartShape MenuLocation: Meshes -> Create mesh from shape... Workbenches: Mesh_Workbench
The Mesh_FromPartShape command creates non-parametric mesh objects (Mesh Features) from shape objects (Part Features).
The inverse operation is Part ShapeFromMesh from the Part Workbench.
- Optionally select one or more objects.
- There are several ways to invoke the command:
- Press the Mesh FromPartShape button.
- Select the Meshes → Create mesh from shape... option from the menu.
- The Tessellation task panel opens.
- While the task panel is open you can create a new selection or change an existing selection.
- Select the tab for the mesher you wish to use.
- Specify the required settings. See Meshers.
- Press the OK button to close the task panel and finish the command.
These are the available meshers and their settings:
-
Surface deviation: the maximum linear deviation of a mesh section from the surface of the object.
-
Angular deviation: the maximum angular deviation from one mesh section to the next. This setting is used when meshing curved surfaces.
-
Relative surface deviation: if checked, the maximum linear deviation of a mesh segment will be the specified Surface deviation multiplied by the length of the current mesh segment (edge).
-
Apply face colors to mesh: if checked, the mesh will get the face colors of the object.
-
Define segments by face colors: if checked, mesh segments will be grouped according to the colors of the object's faces. These groups will be exported for mesh output formats supporting this feature (the OBJ format for example).
- Maximum edge length: the maximum edge length of the mesh. A smaller value results in a finer mesh. Specifying {{Value|0}}, or unchecking the checkbox, results in a very coarse mesh.
- If you press the **Estimate** button the mesher will enter an estimated value for the **Maximum edge length**. This value is not very reliable if multiple objects have been selected.
- Fineness: select an options for the finesse of the mesh:
-
**Very coarse**
-
**Coarse**
-
**Moderate**
-
**Fine**
-
**Very fine**
-
**User defined**
: for this option the following settings can be specified:
-
**Mesh size grading**
: a smaller value results in a finer mesh. The value must be in the {{Value|0.1}} - {{Value|1.0}} range.
-
**Element per edge**
: a larger value results in a finer mesh. The value must be in the {{Value|0.2}} - {{Value|10.0}} range.
-
**Element per curvature radius**
: a larger value results in a finer mesh. The value must be in the {{Value|0.2}} - {{Value|10}} range.
-
Optimize surface: if checked, the surface shape will be optimized.
-
Second order elements: if checked, second order elements will be generated resulting in a finer mesh.
-
Quad dominated: if checked, the mesh will preferably use quadrilateral faces.
For Linux users: the external Gmsh module is required.
- Meshing: select a meshing option:
-
**Automatic**
-
**Adaptive**
-
**Delaunay**
-
**Frontal**
-
**BAMG**
-
**Frontal Quad**
-
**Parallelograms**
-
Max. element size: a smaller value results in a finer mesh. Specify {{Value|0}} to have this size automatically determined.
-
Min. element size: a smaller value results in a finer mesh. The value should be smaller than the Max. element size. Specify {{Value|0}} to have this size automatically determined.
-
Angle: seems to be unsupported at this time.
-
Path: press the ... button and browse to the gmsh.exe path.
-
If the meshing process takes too long you can press the Kill button to abort it.
-
Press the Clear button to remove the information in the text area.
- This command is not restricted to objects created with the Part workbench. It can create a mesh from any object that has a shape including objects created with the PartDesign workbench.
- The Std Export command can export shape objects directly to a mesh format.
- See also: Export to STL or OBJ tutorial.
- The Surface deviation setting is stored: Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Meshing → Standard → LinearDeflection.
- The Angular deviation setting is stored: Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Meshing → Standard → AngularDeflection.
- The Relative surface deviation setting is stored: Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Meshing → Standard → RelativeLinearDeflection.
- The Path is stored: Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Meshing → gmshExe.
See: Mesh Feature.
See also: FreeCAD Scripting Basics.
To create a mesh object from a shape object use the meshFromShape
method of the MeshPart module. This method has several signatures. The signature determines the mesher that will be used. The example below uses the Mefisto mesher signature.
import FreeCAD, Part, Mesh, MeshPart
cyl = FreeCAD.ActiveDocument.addObject("Part::Cylinder","Cylinder")
FreeCAD.ActiveDocument.recompute()
msh = FreeCAD.ActiveDocument.addObject("Mesh::Feature", "Mesh")
msh.Mesh = MeshPart.meshFromShape(Shape=cyl.Shape, MaxLength=1)
msh.ViewObject.DisplayMode = "Flat Lines"
{{Mesh Tools navi}}
⏵ documentation index > Mesh > Mesh FromPartShape