Mesh PolyTrim: Difference between revisions
(Added Scripting paragraph.) |
(Button text.) |
||
(6 intermediate revisions by 2 users not shown) | |||
Line 31: | Line 31: | ||
# Select one or more mesh objects. |
# Select one or more mesh objects. |
||
# There are several ways to invoke the command: |
# There are several ways to invoke the command: |
||
#* Press the {{Button|[[Image:Mesh_PolyTrim.svg|16px]] [[Mesh_PolyTrim| |
#* Press the {{Button|[[Image:Mesh_PolyTrim.svg|16px]] [[Mesh_PolyTrim|Trim mesh]]}} button. |
||
#* Select the {{MenuCommand|Meshes → Cutting → [[Image:Mesh_PolyTrim.svg|16px]] Trim mesh}} option from the menu. |
#* Select the {{MenuCommand|Meshes → Cutting → [[Image:Mesh_PolyTrim.svg|16px]] Trim mesh}} option from the menu. |
||
# Define a polygon by picking points in the 3D view. |
# Define a polygon by picking points in the 3D view. |
||
Line 40: | Line 40: | ||
#* {{MenuCommand|Cancel}}: cancels the command. |
#* {{MenuCommand|Cancel}}: cancels the command. |
||
==Scripting== |
==Scripting== <!--T:8--> |
||
<!--T:9--> |
|||
See also: [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]]. |
See also: [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]]. |
||
<!--T:10--> |
|||
To trim a mesh use |
To trim a mesh with a polygon use its {{incode|trim}} method. |
||
</translate> |
</translate> |
||
Line 65: | Line 67: | ||
# Trim that copy: |
# Trim that copy: |
||
new_msh.trim([p1, p2, p3], 0) |
new_msh.trim([p1, p2, p3], 0) # 2nd argument: 0=inner, 1=outer. |
||
# Update msh.Mesh: |
# Update msh.Mesh: |
Latest revision as of 16:43, 25 November 2023
Mesh PolyTrim |
Menu location |
---|
Meshes → Cutting → Trim mesh |
Workbenches |
Mesh |
Default shortcut |
None |
Introduced in version |
- |
See also |
Mesh PolyCut, Mesh TrimByPlane |
Description
The Mesh PolyTrim command trims faces and parts of faces from mesh objects.
Usage
- During the command the 3D view cannot be changed. It is advisable to properly line up the 3d view first.
- Select one or more mesh objects.
- There are several ways to invoke the command:
- Press the Trim mesh button.
- Select the Meshes → Cutting → Trim mesh option from the menu.
- Define a polygon by picking points in the 3D view.
- Select an option from the 3D view context menu:
- Inner: removes the faces and parts of faces that are inside the polygon.
- Outer: removes the faces and parts of faces that are outside the polygon.
- Split: removes the faces and parts of faces that are outside the polygon, and creates a new mesh object containing them.
- Cancel: cancels the command.
Scripting
See also: FreeCAD Scripting Basics.
To trim a mesh with a polygon use its trim
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 some points:
p1 = App.Vector(0, 0, 0)
p2 = App.Vector(60, 0, 0)
p3 = App.Vector(60, 60, 0)
# We need to work on a copy of the msh.Mesh object:
new_msh = msh.Mesh.copy()
# Trim that copy:
new_msh.trim([p1, p2, p3], 0) # 2nd argument: 0=inner, 1=outer.
# Update msh.Mesh:
msh.Mesh = new_msh
Mesh
- Miscellaneous: Import mesh, Export mesh, Create mesh from shape, Regular solid, Unwrap Mesh, Unwrap Face
- Modifying: Harmonize normals, Flip normals, Fill holes, Close hole, Add triangle, Remove components, Remove components by hand, Smooth, Refinement, Decimation, Scale
- Boolean: Union, Intersection, Difference
- Cutting: Cut mesh, Trim mesh, Trim mesh with a plane, Create section from mesh and plane, Cross-sections
- Components and segments: Merge, Split by components, Create mesh segments, Create mesh segments from best-fit surfaces
User documentation
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub