GuiCommand: Name: Mesh TrimByPlane MenuLocation: Meshes , Cutting , Trim mesh with a plane Workbenches: Mesh_Workbench SeeAlso: Mesh_PolyCut, Mesh_PolyTrim
Mesh TrimByPlane
Description
The Mesh TrimByPlane command trims faces and parts of faces on one side of a plane from a mesh object.
Usage
-
Select a single mesh object and a single Part plane. The (extended) plane should intersect the mesh object.
-
There are several ways to invoke the command:
- Press the
Trim mesh with a plane button. - Select the Meshes → Cutting → Trim mesh with a plane option from the menu.
- Press the
-
The Trim by plane dialog box opens.
-
Select the side you want to keepby pressing one of the buttons:
-
{{button|Below}}
-
{{button|Above}}
-
{{button|Split}}
: removes the faces and parts of faces above the plane, and creates a new mesh object containing them.
-
Scripting
See also: FreeCAD Scripting Basics.
To trim a mesh with a plane use its trimByPlane method.
import FreeCAD as App
import Mesh
# Create a non-parametric box-shaped mesh:
msh = App.ActiveDocument.addObject("Mesh::Feature", "Mesh")
msh.Mesh = Mesh.createBox(30, 40, 50)
msh.ViewObject.DisplayMode = "Flat Lines"
# Define a plane by a base point and a normal vector:
pnt = App.Vector(25, 0, 0)
nor = App.Vector(0, 0, 1)
# We need to work on a copy of the msh.Mesh object:
new_msh = msh.Mesh.copy()
# Trim that copy:
new_msh.trimByPlane(pnt, nor)
# Update msh.Mesh:
msh.Mesh = new_msh{{Mesh Tools navi}}
⏵ documentation index > Mesh > Mesh TrimByPlane
This page is retrieved from https://github.com/FreeCAD/FreeCAD-documentation/blob/main/wiki/Mesh_TrimByPlane.md