Mesh PolyTrim

Description
The Mesh PolyTrim command uses a polyline tool to split a mesh object into two or more objects, or removes the mesh inside or outside the polyline. The polyline splits any facet (triangle) it runs over and creates a smooth dividing line/border.

Usage

 * 1) During the command the 3D view cannot be changed. It is advisable to properly line up the 3d view first.
 * 2) Select one or more mesh objects.
 * 3) There are several ways to invoke the command:
 * 4) * Press the button.
 * 5) * Select the option from the menu.
 * 6) Define a polygon by picking points in the 3D view.
 * 7) Select an option from the 3D view context menu:
 * : removes the faces and parts of faces that are inside the polygon.
 * : removes the faces and parts of faces that are outside the polygon.
 * : removes the faces and parts of faces that are outside the polygon, and creates a new mesh object containing them.
 * : cancels the command.

Scripting
See also: FreeCAD Scripting Basics.

To trim a mesh with a polygon use its method.