Surface Module

From FreeCAD Documentation
Revision as of 20:43, 5 March 2019 by Mario52 (talk | contribs) (Created page with "Surface Module")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎hrvatski • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎български • ‎русский • ‎українська • ‎中文 • ‎中文(中国大陆)‎ • ‎中文(台灣)‎ • ‎中文(繁體)‎ • ‎日本語

Workbench Surface.svg

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

The Surface workbench provides tools to create and modify surfaces. It has a very similar functionality as Part Shape builder Face from edges, but it is parametric and provides additional options. Its features are:

  • Create surfaces from boundary edges
  • Align the curvature from neighbor faces
  • constrain surfaces to additional curves or vertexes.
  • extend faces (need to find out how!)
  • A mesh can be used as a template to create spline curves on its surface.

introduced in version 0.17


The aim of the surface workbench is to create faces with shapes, which are not available with the standard tools in the other workbenches. The Open Cascade CAD-kernel gives as example a rounded corner of a rectangular box with different radii at the edges. Another example is shown here. It is the form of a plastic toy, created with the surface workbench.

Toy Duck.png The surface workbench generates usually nurb surfaces. The uses does not need to know much about nurbs(correct?). It is sufficient to have a closed border for a face, in order to create the surface. Options are available to further modify its shape.

The Surface workbench integrates with other workbenches of FreeCAD. The above example was created from sketches placed on datum planes in the PartDesign workbench. The design can be fully parametric, when all datum planes and sketches are defined accordingly.

The current state of FreeCAD (v0.17) does not allow to place the surfaces into a body of the PartDesign workbench. But the surfaces can be placed inside of a Part together with the body which holds all datum planes and sketches. The non parametric Part Shape builder must still be used in order to create a shell and a regular solid out of the set of surfaces.

Surface Tools

  • Filling.svg Filling...: fills a series of boundary curves with a surface. The surface can be modified by adding constraint curves and vertexes. The surface changes its shape so that the surface goes through the added constraint elements.
  • BSplineSurf.svg Fill boundary curves: creates a surface from two, three or four boundary edges. Three different filling modes are available: Stretch, Coons, Curved.

Additional Menu Tools

These tools are only found in the Surface menu.

  • Curve on mesh...: A selected mesh from the mesh workbench can serve as a template in order to create manually spline curves on it.
  • Extend face: Extrapolate the surface at the boundaries with its local u-parameter and v-parameter.

How to use


The used surface code from the CAD-kernel OCCT is very fragile and can not handle wrong input properly. This can cause FreeCAD to crash. The following situations cause problems and may crash FreeCAD:

  • adding additional edges or wires as boundary to a surface, that would make up several faces. Add those edges only to Unbound Edges.
  • Using of boundary edges, that fails do build a closed boundary at parametric changes of the document.