Surface Filling

Description
creates a surface from a series of connected boundary edges.

The surface can be modified by adding constraint edges and vertices which the surface must pass through.



Usage

 * 1) Make sure you have at lease three edges or curves in space forming a closed contour. For example, these can be created with tools of the Workbench_Draft.svg Draft Workbench or the Workbench_Sketcher.svg Sketcher. Using three edges would create a triangular surface; four edges a quadrilateral surface.
 * 2) * Optionally, curves can be drawn inside the closed contour, not necessarily touching the edges. These curves can be used to control the curvature of the resulting surface.
 * 3) * Likewise, a number of vertices can be used with the same purpose to indicate where the surface must go through.
 * 4) Press the  button.
 * 5) Inside the  section, press.
 * 6) Use the pointer to pick the desired edges in the 3D view; a preview of the final shape will be shown after selecting valid edges that form a closed contour.
 * 7) * Optionally, to control the curvature of the surface, go to the section, press, and pick the desired edges from the 3D view.
 * 8) * Optionally, to control the curvature by means of vertices, go to the section, press, and pick the desired vertices from the 3D view.
 * 9) Press  to complete the operation.

The base edges that form the closed contour, as well as the auxiliary vertices and edges, can belong to 2D curves from Draft or the  Sketcher, but can also belong to 3D solid objects such as those created with the  Part or  PartDesign Workbenches.

Options

 * Inside the section.
 * : press once to start picking edges in the 3D view. Individual lines such as and  can be chosen, as well as any edge from solid objects, like those of  and.
 * : press once to start picking edges in the 3D view; these must be edges that were previously picked with.
 * : open the context menu and select, or press in the keyboard, to remove the currently selected edge in the list.


 * Inside the section similar  and  buttons are available to pick supporting edges to control the curvature of the original surface.
 * Inside the section similar  and  buttons are available, in this case to pick supporting vertices.
 * Press or  to abort the current operation.

Properties
A Surface Filling ( class) is derived from the basic Part Feature ( class, through the subclass), therefore it shares all the latter's properties.

In addition to the properties described in Part Feature, the Surface Filling has the following properties in the property editor.

Data

 * : boundary edges; C0 is required for edges without a corresponding face.
 * : order of constraint on boundary faces;, , and are possible.
 * : unbound constraint edges; C0 is required for edges without a corresponding face.
 * : order of constraint on unbound faces;, , and are possible.
 * : free constraint on a face.
 * : order of constraint on free faces.
 * : constraint points on surface.
 * : initial surface to use.
 * : starting degree, it defaults to.
 * : number of points on an edge for constraint.
 * : number of iterations, it defaults to.
 * : it defaults to.
 * : 2D tolerance, it defaults to.
 * : 3D tolerance, it defaults to.
 * : G1 tolerance, it defaults to.
 * : G2 tolerance, it defaults to.
 * : maximum curve degree, it defaults to.
 * : maximum number of segments, it defaults to.
 * : maximum curve degree, it defaults to.
 * : maximum number of segments, it defaults to.

View

 * : it defaults to ; if set to, it will show an overlay with the control points of the surface.

Scripting
FreeCAD Scripting Basics.

The Surface Filling tool can be used in macros and from the Python console by adding the object.
 * The edges to be used to define the surface must be assigned as a LinkSubList to the property of the object.
 * Auxiliary edges and vertices must be assigned as a LinkSubLists to the and  properties of the object.
 * All objects with edges need to be computed before they can be used as input for the properties of the Filling object.