Mesh Workbench

Inspection Workbench

OpenSCAD Module

Index

Mesh workbench icon

Introduction

The Mesh Workbench handles triangle meshes. Meshes are a special type of 3D object, composed of triangular faces connected by their vertices and edges.

Many 3D applications, like Sketchup, Blender, Maya and 3D Studio Max, use meshes as their primary type of 3D object. Since meshes are very simple objects, containing only vertices (points), edges and triangular faces, they are very easy to create, modify, subdivide, stretch, and can easily be passed from one application to another without any loss of details. In addition, since meshes contain very simple data, 3D applications can usually manage very large quantities of them without using a lot of resources. For these reasons, meshes are often the 3D object type of choice for applications dealing with movies, animation, and image creation.

However, in the field of engineering meshes present one big limitation: they are only made of surfaces, and have no mass information, so they don't behave as solids. This means that all solid-based operations, such as addition or subtraction, are difficult to perform on meshes. The Mesh Workbench is useful to import 3D data in mesh format, to analyse it, detect errors, and finally convert it to a solid, for use with the Part Workbench.

Tools

All Mesh Workbench tools can be accessed from the Meshes menu. Some tools are also available in the Mesh tools toolbar.

• Import mesh...: Imports a mesh object from file.

• Export mesh...: Exports a mesh object to file.

• Create mesh from shape...: Creates mesh objects from shape objects.

• Refinement...: Remeshes a mesh object. introduced in version 0.19

• Analyze
  • Evaluate and repair mesh...: Evaluates and repairs a mesh object.
  • Face info: Shows information about faces of mesh objects.
  • Curvature info: Shows the absolute curvature of curvature objects at selected points.
  • Check solid mesh: Checks if a mesh object is solid.
  • Boundings info...: Shows the bounding box coordinates of a mesh object.

• Curvature plot: Creates Mesh Curvature objects for mesh objects.

• Harmonize normals: Harmonizes the normals of mesh objects.

• Flip normals: Flips the normals of mesh objects.

• Fill holes...: Fills holes in mesh objects.

• Close hole: Fills selected holes in mesh objects.

• Add triangle: Adds faces along a boundary of an open mesh object.

• Remove components...: Removes faces from mesh objects.

• Remove components by hand...: Removes components from mesh objects.

• Create mesh segments...: Creates separate mesh segments for specified surface types of a mesh object.

• Create mesh segments from best-fit surfaces...: Creates separate mesh segments for specified surface types of a mesh object, and can identify their parameters.

• Smooth...: Smooths mesh objects.

• Decimation...: Reduces the number of faces in mesh objects. introduced in version 0.19

• Scale...: Scales mesh objects.

• Regular solid... Creates a regular parametric solid mesh object.

• Boolean
  • Union: Creates a mesh object that is the union of two mesh objects.
  • Intersection: Creates a mesh object that is the intersection of two mesh objects.
  • Difference: Creates a mesh object that is the difference of two mesh objects.

• Cutting
  • Cut mesh: Cuts whole faces from mesh objects.
  • Trim mesh: Trims faces and parts of faces from mesh objects.
  • Trim mesh with a plane: Trims faces and parts of faces on one side of a plane from a mesh object.
  • Create section from mesh and plane: Creates a cross section across a mesh object.
  • Cross-sections...: Creates multiple cross sections across mesh objects. introduced in version 0.19

• Merge: Creates a mesh object by combining the meshes of two or more mesh objects.

• Unwrap Mesh: Creates a flat representation of a mesh object. introduced in version 0.19

• Unwrap Face: Creates a flat representation of a face of a shape object. introduced in version 0.19

Preferences

There are some export preferences related to Mesh Formats but these are not used by commands belonging to this workbench. They are used by the Std Export command.

Mesh Workbench preferences can be found in the following categories of the Preferences Editor:

• Display: On the Mesh view tab several preferences can be set.
• OpenSCAD: The Mesh Union, Mesh Intersection and Mesh Difference commands require OpenSCAD and use the OpenSCAD executable preference to find its executable.

Notes

• More mesh tools are available in the OpenSCAD Workbench.
• Meshes can also be manipulated with Python scripts.
• See also: FreeCAD and Mesh Import

Inspection Workbench

OpenSCAD Module

Index

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

---

• Analyze: Evaluate and repair mesh, Face info, Curvature plot, Curvature info, Check solid mesh, Boundings info
• Additional: Import Export Preferences, OpenSCAD Workbench, Mesh Scripting

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, Start, Surface, TechDraw, Test Framework, Web

---

• Addons: Addon Manager, External workbenches, Scripting and macros

---

• Hubs: User hub, Power users hub, Developer hub