Mesh Workbench

From FreeCAD Documentation
Revision as of 22:42, 3 March 2016 by FuzzyBot (talk | contribs) (Updating to match new version of source page)
Jump to: navigation, search

The Mesh Workbench handles triangle meshes. Meshes are a special type of 3D object, composed of triangles connected by their edges and their corners (also called vertices).

An example of a mesh object

An example of a mesh object

Many 3D applications use meshes as their primary type of 3D object, like sketchup, blender, maya or 3d studio max. 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. Besides, since they contain very simple data, 3D applications can usually manage very large quantities of them without any problem. For those reasons, meshes are often the 3D object type of choice for applications dealing with movies, animation, and image creation.

In the field of engineering, however, meshes present one big limitation: They are very dumb objects, only composed of points,lines and faces. They are only made of surfaces, and have no mass information, so they don't behave as solids. In a mesh there is no automatic way to know if a point is inside or outside the object. This means that all solid-based operations, such as addition or subtraction, are always a bit difficult to perform on meshes, and return errors often.

In FreeCAD, since it is an engineering application, we would obviously prefer to work with more intelligent types of 3D objects, that can carry more informations, such as mass, solid behaviour, or even custom parameters. The mesh module was first created to serve as a testbed, but to be able to read, manipulate and convert meshes is also highly important for FreeCAD. Very often, in your workflow, you will receive 3D data in mesh format. You will need to handle that data, analyse it to detect errors or other problems that prevent converting them to more intelligent objects, and finally, convert them to more intelligent objects, handled by the Part Module.

Using the mesh module

The mesh module has currently a very simple interface, all its functions are grouped in the Mesh menu entry. The most important operations you can currently do with meshes are:

  • Mesh Import Mesh.svg Import meshes in several file formats
  • Mesh Export Mesh.svg Export meshes in several file formats
  • Mesh Mesh from Shape.svg Convert Part objects into meshes
  • Mesh Harmonize Normals.svg Harmonize normals
  • Mesh Flip Normals.svg Flip normals
  • Mesh boundary.svg Close holes in meshes
  • Mesh Remove Components.svg Remove components of meshes
  • Mesh cut.svg Cut meshes along a line


Analyse curvature, faces, and check if a mesh can be safely converted into a solid


  • Mesh Regular Solid.svg Regular solid... Create mesh primitives, like cubes, cylinders, cones, or spheres:
    • Mesh Cube.svg Create a mesh cube
    • Mesh Cylinder.svg Create a mesh cylinder
    • Mesh Cone.svg Create a mesh cone
    • Mesh Sphere.svg Create a mesh sphere
    • Mesh Ellipsoid.svg Create a mesh ellipsoid
    • Mesh Torus.svg Create a mesh torus


  • Union, subtract and intersect meshes


These are only some of the basic operations currently present in the Mesh module interface. But the FreeCAD meshes can also be handled in many more ways by scripting.

Links


Other languages:
български • ‎čeština • ‎Deutsch • ‎English • ‎español • ‎français • ‎hrvatski • ‎magyar • ‎Bahasa Indonesia • ‎italiano • ‎日本語 • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎svenska • ‎Türkçe • ‎українська • ‎中文 • ‎中文(中国大陆)‎ • ‎中文(台灣)‎