Surface Module

From FreeCAD Documentation
Revision as of 22:12, 17 February 2020 by FuzzyBot (talk | contribs) (Updating to match new version of source page)

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 FreeCAD Surface Workbench Icon

Introduction

The Surface Workbench introduced in FreeCAD 0.17 provides tools to create and modify simple NURBS surfaces. These tools have a similar functionality to the Part Shapebuilder tool when the Face from edges options is used. However, unlike that tool, the tools of the Surface Workbench are parametric and provide additional options. In this respect, the tools in this workbench are similar to features like PartDesign AdditiveLoft and PartDesign AdditivePipe.

Some of the features provided are:

  • Creation of surfaces from boundary edges.
  • Alignment of the curvature from neighboring faces.
  • Constraining of surfaces to additional curves and vertices.
  • Extension of faces.
  • A mesh can be used as a template to create spline curves on its surface.

Use

The Surface Workbench intends to create faces with shapes, which is not possible to do with the standard tools in other workbenches. The OCCT kernel gives as example a rectangular box with a rounded corners of different radii.

Surface created with sketches placed in datum planes with the tools of the PartDesign Workbench

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. In most cases it is sufficient with drawing a closed sketch to define the border for a face; then options are available to further modify its shape.

The current state of FreeCAD (v0.17) does not allow to place the surfaces into a PartDesign Body. However, the surfaces can be placed inside of a Std Part container together with the PartDesign Body which holds all datum planes and sketches. The non parametric Part Shapebuilder tool must still be used in order to create a shell and a regular solid out of the set of surfaces.

Surface Tools

  • 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.
  • 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

Limitations

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.