Difference between revisions of "Surface Module"

From FreeCAD Documentation
Jump to navigation Jump to search
(Better explanations and icons)
(Move limitations section to Surface_Filling, as they mostly apply to it)
Line 61: Line 61:
 
* [[File:Surface_ExtendFace.svg|32px]] [[Surface_ExtendFace|Extend face]]: extrapolates the surface at the boundaries with its local u-parameter and v-parameter.
 
* [[File:Surface_ExtendFace.svg|32px]] [[Surface_ExtendFace|Extend face]]: extrapolates the surface at the boundaries with its local u-parameter and v-parameter.
 
* [[File:Surface_CurveOnMesh.svg|32px]] [[Surface_CurveOnMesh|Curve on mesh]]: create approximated spline segments on top of a selected [[Mesh_Workbench|mesh]]. If the object is not a [[Mesh|Mesh]], but a parametric [[Shape|Shape]], it must be converted to a mesh using {{Button|[[File:Mesh_FromPartShape.svg|16px]] [[Mesh_FromPartShape|Mesh FromPartShape]]}}.
 
* [[File:Surface_CurveOnMesh.svg|32px]] [[Surface_CurveOnMesh|Curve on mesh]]: create approximated spline segments on top of a selected [[Mesh_Workbench|mesh]]. If the object is not a [[Mesh|Mesh]], but a parametric [[Shape|Shape]], it must be converted to a mesh using {{Button|[[File:Mesh_FromPartShape.svg|16px]] [[Mesh_FromPartShape|Mesh FromPartShape]]}}.
 
== Limitations == <!--T:8-->
 
 
<!--T:9-->
 
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.
 
  
 
<!--T:10-->
 
<!--T:10-->

Revision as of 22:59, 2 October 2020

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 • ‎български • ‎русский • ‎українська • ‎中文 • ‎中文(中国大陆)‎ • ‎中文(台灣)‎ • ‎中文(繁體)‎ • ‎日本語

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

Gui Command explains how tools should be documented. See Draft ShapeString for an example of a well documented tool. Browse Category:UnfinishedDocu to see 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.

Surface workbench icon

Introduction

The Workbench Surface.svg 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 Builder.svg Part Builder tool when the Face from edges option 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 PartDesign AdditiveLoft.svg PartDesign AdditiveLoft and PartDesign AdditivePipe.svg 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.

Surface example.png

Usage

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.

Toy Duck.png

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 Sketcher NewSketch.svg Sketches placed on PartDesign Plane.svg PartDesign Datum planes in the Workbench PartDesign.svg PartDesign Workbench. The design can be fully parametric if all datum planes and sketches are defined accordingly. In most cases it is sufficient to draw a closed sketch to define the boundary of a face, and then use different options to further modify its shape.

As of FreeCAD v0.17, the generated surface cannot be placed inside a PartDesign Body.svg PartDesign Body. However, the generated surface can be contained inside a Std Part.svg Std Part together with the associated PartDesign Body.svg Body that holds the datum planes and sketches. The non parametric Part Builder.svg Part Builder tool can then be used in order to create a shell and finally a solid.

Tools

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